opentelemetry-semantic_conventions 1.4.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7261c53b0d437137673f0fb895979531cd58fa578ed5e15724589529846f7666
-  data.tar.gz: 4a05344287b655f8a234b26b7ab3f82eee281dc87ea4691e029c5c9d89d08474
+  metadata.gz: 7b2e30b39ac99397bc4fcde80c93bbcc2c37f9c58eb7e8c5b3eecb1006d88bbb
+  data.tar.gz: 8224d53a53dc13ea2d1db99a2658347007593652fe9aeff5c66cda52a4baa0b1
 SHA512:
-  metadata.gz: 6319b1f937665aa42a70eb3b9ea737eb18d66576ae4c2e865b1cbcd8210742fa2be965bfb2a51c703a928d0807332749d5e66d77eb8deada62cb8cb4a68b752d
-  data.tar.gz: e3612d95c3a7a4614fdf994c6aaf5a50d4f6f233def10570b3b23ca2acf27e95acad595a4560adb21f3c8f80d48d2b2be50527a69dafeec3d9974788360e36ce
+  metadata.gz: a3d8ac39512ab4a7fae32f930c768ac05ab835d95914b33fc53a22466f3b4cd706188dd75df1014d82b8bc878d06bd83a546a2d92337345aa3828343927f9db3
+  data.tar.gz: e6d68dddd026284b87f4cd37a0f7bedc743b851df9adb4a96b4fcab21636dfa4be3403778c74d467256a817edceacbd1532aabaf303ea1be863b1c69719e5248

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Release History: opentelemetry-semantic_conventions
 
+### v1.6.0 / 2021-08-12
+
+* BREAKING CHANGE: Update opentelemetry-semantic_conventions to the 1.5.0 spec release 
+
+* ADDED: Update opentelemetry-semantic_conventions to the 1.5.0 spec release 
+* ADDED: Update to semantic conventions v1.6.0 
+
 ### v1.4.0 / 2021-07-07
 
 * Initial release.

data/lib/opentelemetry/semantic_conventions/resource.rb

@@ -13,11 +13,11 @@ module OpenTelemetry
       # The cloud account ID the resource is assigned to
       CLOUD_ACCOUNT_ID = 'cloud.account.id'
 
-      # The geographical region the resource is running. Refer to your provider's docs to see the available regions, for example [AWS regions](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/), [Azure regions](https://azure.microsoft.com/en-us/global-infrastructure/geographies/), or [Google Cloud regions](https://cloud.google.com/about/locations)
+      # The geographical region the resource is running. Refer to your provider's docs to see the available regions, for example [Alibaba Cloud regions](https://www.alibabacloud.com/help/doc-detail/40654.htm), [AWS regions](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/), [Azure regions](https://azure.microsoft.com/en-us/global-infrastructure/geographies/), or [Google Cloud regions](https://cloud.google.com/about/locations)
       CLOUD_REGION = 'cloud.region'
 
       # Cloud regions often have multiple, isolated locations known as zones to increase availability. Availability zone represents the zone where the resource is running
-      # @note Availability zones are called "zones" on Google Cloud
+      # @note Availability zones are called "zones" on Alibaba Cloud and Google Cloud
       CLOUD_AVAILABILITY_ZONE = 'cloud.availability_zone'
 
       # The cloud platform in use
@@ -90,17 +90,41 @@ module OpenTelemetry
       # @note It's recommended this value represents a human readable version of the device model rather than a machine readable alternative
       DEVICE_MODEL_NAME = 'device.model.name'
 
-      # The name of the function being executed
+      # The name of the single function that this runtime instance executes
+      # @note This is the name of the function as configured/deployed on the FaaS platform and is usually different from the name of the callback function (which may be stored in the [`code.namespace`/`code.function`](../../trace/semantic_conventions/span-general.md#source-code-attributes) span attributes)
       FAAS_NAME = 'faas.name'
 
-      # The unique ID of the function being executed
-      # @note For example, in AWS Lambda this field corresponds to the [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) value, in GCP to the URI of the resource, and in Azure to the [FunctionDirectory](https://github.com/Azure/azure-functions-host/wiki/Retrieving-information-about-the-currently-running-function) field
+      # The unique ID of the single function that this runtime instance executes
+      # @note Depending on the cloud provider, use:
+      #  
+      #  * **AWS Lambda:** The function [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
+      #  Take care not to use the "invoked ARN" directly but replace any
+      #  [alias suffix](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html) with the resolved function version, as the same runtime instance may be invokable with multiple
+      #  different aliases.
+      #  * **GCP:** The [URI of the resource](https://cloud.google.com/iam/docs/full-resource-names)
+      #  * **Azure:** The [Fully Qualified Resource ID](https://docs.microsoft.com/en-us/rest/api/resources/resources/get-by-id).
+      #  
+      #  On some providers, it may not be possible to determine the full ID at startup,
+      #  which is why this field cannot be made required. For example, on AWS the account ID
+      #  part of the ARN is not available without calling another AWS API
+      #  which may be deemed too slow for a short-running lambda function.
+      #  As an alternative, consider setting `faas.id` as a span attribute instead
       FAAS_ID = 'faas.id'
 
-      # The version string of the function being executed as defined in [Version Attributes](../../resource/semantic_conventions/README.md#version-attributes)
+      # The immutable version of the function being executed
+      # @note Depending on the cloud provider and platform, use:
+      #  
+      #  * **AWS Lambda:** The [function version](https://docs.aws.amazon.com/lambda/latest/dg/configuration-versions.html)
+      #    (an integer represented as a decimal string).
+      #  * **Google Cloud Run:** The [revision](https://cloud.google.com/run/docs/managing/revisions)
+      #    (i.e., the function name plus the revision suffix).
+      #  * **Google Cloud Functions:** The value of the
+      #    [`K_REVISION` environment variable](https://cloud.google.com/functions/docs/env-var#runtime_environment_variables_set_automatically).
+      #  * **Azure Functions:** Not applicable. Do not set this attribute
       FAAS_VERSION = 'faas.version'
 
-      # The execution environment ID as a string
+      # The execution environment ID as a string, that will be potentially reused for other invocations to the same function/function version
+      # @note * **AWS Lambda:** Use the (full) log stream name
       FAAS_INSTANCE = 'faas.instance'
 
       # The amount of memory available to the serverless function in MiB

data/lib/opentelemetry/semantic_conventions/trace.rb

@@ -7,6 +7,10 @@
 module OpenTelemetry
   module SemanticConventions
     module Trace
+      # The full invoked ARN as provided on the `Context` passed to the function (`Lambda-Runtime-Invoked-Function-Arn` header on the `/runtime/invocation/next` applicable)
+      # @note This may be different from `faas.id` if an alias is involved
+      AWS_LAMBDA_INVOKED_ARN = 'aws.lambda.invoked_arn'
+
       # An identifier for the database management system (DBMS) product being used. See below for a list of well-known identifiers
       DB_SYSTEM = 'db.system'
 
@@ -189,6 +193,24 @@ module OpenTelemetry
       # Local hostname or similar, see note below
       NET_HOST_NAME = 'net.host.name'
 
+      # The internet connection type currently being used by the host
+      NET_HOST_CONNECTION_TYPE = 'net.host.connection.type'
+
+      # This describes more details regarding the connection.type. It may be the type of cell technology connection, but it could be used for describing details about a wifi connection
+      NET_HOST_CONNECTION_SUBTYPE = 'net.host.connection.subtype'
+
+      # The name of the mobile carrier
+      NET_HOST_CARRIER_NAME = 'net.host.carrier.name'
+
+      # The mobile carrier country code
+      NET_HOST_CARRIER_MCC = 'net.host.carrier.mcc'
+
+      # The mobile carrier network code
+      NET_HOST_CARRIER_MNC = 'net.host.carrier.mnc'
+
+      # The ISO 3166-1 alpha-2 2-character country code associated with the mobile carrier network
+      NET_HOST_CARRIER_ICC = 'net.host.carrier.icc'
+
       # A string identifying the messaging system
       MESSAGING_SYSTEM = 'messaging.system'
 
@@ -277,9 +299,11 @@ module OpenTelemetry
       RPC_SYSTEM = 'rpc.system'
 
       # The name of the service to which a request is made, as returned by the AWS SDK
+      # @note This is the logical name of the service from the RPC interface perspective, which can be different from the name of any implementing class. The `code.namespace` attribute may be used to store the latter (despite the attribute name, it may include a class name; e.g., class with method actually executing the call on the server side, RPC client stub class on the client side)
       RPC_SERVICE = 'rpc.service'
 
       # The name of the operation corresponding to the request, as returned by the AWS SDK
+      # @note This is the logical name of the method from the RPC interface perspective, which can be different from the name of any implementing method/function. The `code.function` attribute may be used to store the latter (e.g., method actually executing the call on the server side, RPC client stub method on the client side)
       RPC_METHOD = 'rpc.method'
 
       # The keys in the `RequestItems` object field
@@ -376,9 +400,6 @@ module OpenTelemetry
       # Protocol version as in `jsonrpc` property of request/response. Since JSON-RPC 1.0 does not specify this, the value can be omitted
       RPC_JSONRPC_VERSION = 'rpc.jsonrpc.version'
 
-      # `method` property from request. Unlike `rpc.method`, this may not relate to the actual method being called. Useful for client-side traces since client does not know what will be called on the server
-      RPC_JSONRPC_METHOD = 'rpc.jsonrpc.method'
-
       # `id` property of request or response. Since protocol allows id to be int, string, `null` or missing (for notifications), value is expected to be cast to string for simplicity. Use empty string in case of `null` value. Omit entirely if this is a notification
       RPC_JSONRPC_REQUEST_ID = 'rpc.jsonrpc.request_id'
 

data/lib/opentelemetry/semantic_conventions/version.rb

@@ -6,6 +6,6 @@
 
 module OpenTelemetry
   module SemanticConventions
-    VERSION = '1.4.0'
+    VERSION = '1.6.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: opentelemetry-semantic_conventions
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.6.0
 platform: ruby
 authors:
 - OpenTelemetry Authors
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-07 00:00:00.000000000 Z
+date: 2021-08-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: opentelemetry-api
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc2
+        version: 1.0.0.rc3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc2
+        version: 1.0.0.rc3
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -142,10 +142,10 @@ homepage: https://github.com/open-telemetry/opentelemetry-ruby
 licenses:
 - Apache-2.0
 metadata:
-  changelog_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-semantic_conventions/v1.4.0/file.CHANGELOG.html
+  changelog_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-semantic_conventions/v1.6.0/file.CHANGELOG.html
   source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby/tree/main/semantic_conventions
   bug_tracker_uri: https://github.com/open-telemetry/opentelemetry-ruby/issues
-  documentation_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-semantic_conventions/v1.4.0
+  documentation_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-semantic_conventions/v1.6.0
 post_install_message: 
 rdoc_options: []
 require_paths: