From 88ae710db34fc180ef2c7be0a59beae4d5ff2286 Mon Sep 17 00:00:00 2001
From: Bartlomiej Obecny <bobecny@gmail.com>
Date: Mon, 10 Aug 2020 22:17:24 +0200
Subject: [PATCH] semantic conventions for operating system (#1407)

* chore: semantic conventions for operating system

* chore: adding link to doc

Co-authored-by: Mayur Kale <mayurkale@google.com>
---
 .../src/trace/index.ts                        |  1 +
 .../src/trace/os.ts                           | 63 +++++++++++++++++++
 2 files changed, 64 insertions(+)
 create mode 100644 packages/opentelemetry-semantic-conventions/src/trace/os.ts

diff --git a/packages/opentelemetry-semantic-conventions/src/trace/index.ts b/packages/opentelemetry-semantic-conventions/src/trace/index.ts
index a923ac0a36..ca18acaea6 100644
--- a/packages/opentelemetry-semantic-conventions/src/trace/index.ts
+++ b/packages/opentelemetry-semantic-conventions/src/trace/index.ts
@@ -18,3 +18,4 @@ export * from './general';
 export * from './rpc';
 export * from './http';
 export * from './database';
+export * from './os';
diff --git a/packages/opentelemetry-semantic-conventions/src/trace/os.ts b/packages/opentelemetry-semantic-conventions/src/trace/os.ts
new file mode 100644
index 0000000000..1ffa94ff56
--- /dev/null
+++ b/packages/opentelemetry-semantic-conventions/src/trace/os.ts
@@ -0,0 +1,63 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * The operating system (OS) on which the process represented by this resource is running.
+ *
+ * In case of virtualized environments, this is the operating system as it
+ * is observed by the process, i.e., the virtualized guest rather than the
+ * underlying host.
+ * https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/resource/semantic_conventions/os.md
+ */
+export const OperatingSystem = {
+  /**
+   * The operating system type.
+   * This should be set to one of {@link OperatingSystemValues}
+   * E.g., "WINDOWS"
+   *
+   * @remarks
+   * Required.
+   */
+  TYPE: 'os.type',
+  /**
+   * Human readable (not intended to be parsed) OS version information.
+   * E.g., "Microsoft Windows [Version 10.0.18363.778]"
+   *
+   * @remarks
+   * Required if applicable.
+   */
+  DESCRIPTION: 'os.description',
+};
+
+/**
+ * {@link OperatingSystem.TYPE} SHOULD be set to one of the values
+ * listed below.
+ * If none of the listed values apply, a custom value best describing
+ * the family the operating system belongs to CAN be used.
+ */
+export const OperatingSystemValues = {
+  WINDOWS: 'WINDOWS',
+  LINUX: 'LINUX',
+  DARWIN: 'DARWIN',
+  FREEBSD: 'FREEBSD',
+  NETBSD: 'NETBSD',
+  OPENBSD: 'OPENBSD',
+  DRAGONFLYBSD: 'DRAGONFLYBSD',
+  HPUX: 'HPUX',
+  AIX: 'AIX',
+  SOLARIS: 'SOLARIS',
+  ZOS: 'ZOS',
+};