diff --git a/build.gradle.kts b/build.gradle.kts index aac6f02..bcb4451 100644 --- a/build.gradle.kts +++ b/build.gradle.kts @@ -16,7 +16,7 @@ val snapshot = true // end // The release version of https://github.com/open-telemetry/semantic-conventions used to generate classes -var semanticConventionsVersion = "1.21.0" +var semanticConventionsVersion = "1.22.0" // Compute the artifact version, which includes the "-alpha" suffix and includes "-SNAPSHOT" suffix if not releasing // Release example: version=1.21.0-alpha @@ -66,7 +66,7 @@ dependencies { } // start - define tasks to download, unzip, and generate from opentelemetry/semantic-conventions -var generatorVersion = "0.18.0" +var generatorVersion = "0.22.0" val semanticConventionsRepoZip = "https://github.com/open-telemetry/semantic-conventions/archive/v$semanticConventionsVersion.zip" val schemaUrl = "https://opentelemetry.io/schemas/$semanticConventionsVersion" diff --git a/src/main/java/io/opentelemetry/semconv/ResourceAttributes.java b/src/main/java/io/opentelemetry/semconv/ResourceAttributes.java index 8e3ebe6..954b19d 100644 --- a/src/main/java/io/opentelemetry/semconv/ResourceAttributes.java +++ b/src/main/java/io/opentelemetry/semconv/ResourceAttributes.java @@ -18,7 +18,14 @@ @SuppressWarnings("unused") public final class ResourceAttributes { /** The URL of the OpenTelemetry schema for these keys and values. */ - public static final String SCHEMA_URL = "https://opentelemetry.io/schemas/1.21.0"; + public static final String SCHEMA_URL = "https://opentelemetry.io/schemas/1.22.0"; + + /** + * Uniquely identifies the framework API revision offered by a version ({@code os.version}) of the + * android operating system. More information can be found here. + */ + public static final AttributeKey ANDROID_OS_API_LEVEL = stringKey("android.os.api_level"); /** * Array of brand name and version separated by a space @@ -33,6 +40,30 @@ public final class ResourceAttributes { */ public static final AttributeKey> BROWSER_BRANDS = stringArrayKey("browser.brands"); + /** + * Preferred language of the user using the browser + * + *

Notes: + * + *

+ */ + public static final AttributeKey BROWSER_LANGUAGE = stringKey("browser.language"); + + /** + * A boolean that is true if the browser is running on a mobile device + * + *

Notes: + * + *

    + *
  • This value is intended to be taken from the UA client hints API ({@code + * navigator.userAgentData.mobile}). If unavailable, this attribute SHOULD be left unset. + *
+ */ + public static final AttributeKey BROWSER_MOBILE = booleanKey("browser.mobile"); + /** * The platform on which the browser is running * @@ -53,36 +84,36 @@ public final class ResourceAttributes { */ public static final AttributeKey BROWSER_PLATFORM = stringKey("browser.platform"); + /** The cloud account ID the resource is assigned to. */ + public static final AttributeKey CLOUD_ACCOUNT_ID = stringKey("cloud.account.id"); + /** - * A boolean that is true if the browser is running on a mobile device + * Cloud regions often have multiple, isolated locations known as zones to increase availability. + * Availability zone represents the zone where the resource is running. * *

Notes: * *

    - *
  • This value is intended to be taken from the UA client hints API ({@code - * navigator.userAgentData.mobile}). If unavailable, this attribute SHOULD be left unset. + *
  • Availability zones are called "zones" on Alibaba Cloud and Google Cloud. *
*/ - public static final AttributeKey BROWSER_MOBILE = booleanKey("browser.mobile"); + public static final AttributeKey CLOUD_AVAILABILITY_ZONE = + stringKey("cloud.availability_zone"); /** - * Preferred language of the user using the browser + * The cloud platform in use. * *

Notes: * *

    - *
  • This value is intended to be taken from the Navigator API {@code navigator.language}. + *
  • The prefix of the service SHOULD match the one specified in {@code cloud.provider}. *
*/ - public static final AttributeKey BROWSER_LANGUAGE = stringKey("browser.language"); + public static final AttributeKey CLOUD_PLATFORM = stringKey("cloud.platform"); /** Name of the cloud provider. */ public static final AttributeKey CLOUD_PROVIDER = stringKey("cloud.provider"); - /** The cloud account ID the resource is assigned to. */ - public static final AttributeKey CLOUD_ACCOUNT_ID = stringKey("cloud.account.id"); - /** * The geographical region the resource is running. * @@ -136,28 +167,11 @@ public final class ResourceAttributes { public static final AttributeKey CLOUD_RESOURCE_ID = stringKey("cloud.resource_id"); /** - * Cloud regions often have multiple, isolated locations known as zones to increase availability. - * Availability zone represents the zone where the resource is running. - * - *

Notes: - * - *

    - *
  • Availability zones are called "zones" on Alibaba Cloud and Google Cloud. - *
- */ - public static final AttributeKey CLOUD_AVAILABILITY_ZONE = - stringKey("cloud.availability_zone"); - - /** - * The cloud platform in use. - * - *

Notes: - * - *

    - *
  • The prefix of the service SHOULD match the one specified in {@code cloud.provider}. - *
+ * The ARN of an ECS + * cluster. */ - public static final AttributeKey CLOUD_PLATFORM = stringKey("cloud.platform"); + public static final AttributeKey AWS_ECS_CLUSTER_ARN = stringKey("aws.ecs.cluster.arn"); /** * The Amazon Resource Name (ARN) of an AWS_ECS_CONTAINER_ARN = stringKey("aws.ecs.container.arn"); - /** - * The ARN of an ECS - * cluster. - */ - public static final AttributeKey AWS_ECS_CLUSTER_ARN = stringKey("aws.ecs.cluster.arn"); - /** * The launch @@ -199,35 +206,31 @@ public final class ResourceAttributes { public static final AttributeKey AWS_EKS_CLUSTER_ARN = stringKey("aws.eks.cluster.arn"); /** - * The name(s) of the AWS log group(s) an application is writing to. + * The Amazon Resource Name(s) (ARN) of the AWS log group(s). * *

Notes: * *

*/ - public static final AttributeKey> AWS_LOG_GROUP_NAMES = - stringArrayKey("aws.log.group.names"); + public static final AttributeKey> AWS_LOG_GROUP_ARNS = + stringArrayKey("aws.log.group.arns"); /** - * The Amazon Resource Name(s) (ARN) of the AWS log group(s). + * The name(s) of the AWS log group(s) an application is writing to. * *

Notes: * *

    - *
  • See the log - * group ARN format documentation. + *
  • Multiple log groups must be supported for cases like multi-container applications, where + * a single application has sidecar containers, and each write to their own log group. *
*/ - public static final AttributeKey> AWS_LOG_GROUP_ARNS = - stringArrayKey("aws.log.group.arns"); - - /** The name(s) of the AWS log stream(s) an application is writing to. */ - public static final AttributeKey> AWS_LOG_STREAM_NAMES = - stringArrayKey("aws.log.stream.names"); + public static final AttributeKey> AWS_LOG_GROUP_NAMES = + stringArrayKey("aws.log.group.names"); /** * The ARN(s) of the AWS log stream(s). @@ -244,6 +247,10 @@ public final class ResourceAttributes { public static final AttributeKey> AWS_LOG_STREAM_ARNS = stringArrayKey("aws.log.stream.arns"); + /** The name(s) of the AWS log stream(s) an application is writing to. */ + public static final AttributeKey> AWS_LOG_STREAM_NAMES = + stringArrayKey("aws.log.stream.names"); + /** * The name of the Cloud Run execution being run for @@ -262,6 +269,13 @@ public final class ResourceAttributes { public static final AttributeKey GCP_CLOUD_RUN_JOB_TASK_INDEX = longKey("gcp.cloud_run.job.task_index"); + /** + * The hostname of a GCE instance. This is the full value of the default or custom hostname. + */ + public static final AttributeKey GCP_GCE_INSTANCE_HOSTNAME = + stringKey("gcp.gce.instance.hostname"); + /** * The instance name of a GCE instance. This is the value provided by {@code host.name}, the * visible name of the instance in the Cloud Console UI, and the prefix for the default hostname @@ -272,26 +286,38 @@ public final class ResourceAttributes { public static final AttributeKey GCP_GCE_INSTANCE_NAME = stringKey("gcp.gce.instance.name"); - /** - * The hostname of a GCE instance. This is the full value of the default or custom hostname. - */ - public static final AttributeKey GCP_GCE_INSTANCE_HOSTNAME = - stringKey("gcp.gce.instance.hostname"); + /** Unique identifier for the application */ + public static final AttributeKey HEROKU_APP_ID = stringKey("heroku.app.id"); + + /** Commit hash for the current release */ + public static final AttributeKey HEROKU_RELEASE_COMMIT = + stringKey("heroku.release.commit"); /** Time and date the release was created */ public static final AttributeKey HEROKU_RELEASE_CREATION_TIMESTAMP = stringKey("heroku.release.creation_timestamp"); - /** Commit hash for the current release */ - public static final AttributeKey HEROKU_RELEASE_COMMIT = - stringKey("heroku.release.commit"); + /** + * The command used to run the container (i.e. the command name). + * + *

Notes: + * + *

    + *
  • If using embedded credentials or sensitive data, it is recommended to remove them to + * prevent potential leakage. + *
+ */ + public static final AttributeKey CONTAINER_COMMAND = stringKey("container.command"); - /** Unique identifier for the application */ - public static final AttributeKey HEROKU_APP_ID = stringKey("heroku.app.id"); + /** + * All the command arguments (including the command/executable itself) run by the container. [2] + */ + public static final AttributeKey> CONTAINER_COMMAND_ARGS = + stringArrayKey("container.command_args"); - /** Container name used by container runtime. */ - public static final AttributeKey CONTAINER_NAME = stringKey("container.name"); + /** The full command run by the container as a single string representing the full command. [2] */ + public static final AttributeKey CONTAINER_COMMAND_LINE = + stringKey("container.command_line"); /** * Container ID. Usually a UUID, as for example used to CONTAINER_ID = stringKey("container.id"); - /** The container runtime managing this container. */ - public static final AttributeKey CONTAINER_RUNTIME = stringKey("container.runtime"); - - /** Name of the image the container was built on. */ - public static final AttributeKey CONTAINER_IMAGE_NAME = stringKey("container.image.name"); - - /** Container image tag. */ - public static final AttributeKey CONTAINER_IMAGE_TAG = stringKey("container.image.tag"); - /** * Runtime specific image identifier. Usually a hash algorithm followed by a UUID. * @@ -321,32 +338,46 @@ public final class ResourceAttributes { * endpoint. K8s defines a link to the container registry repository with digest {@code * "imageID": "registry.azurecr.io * /namespace/service/dockerfile@sha256:bdeabd40c3a8a492eaf9e8e44d0ebbb84bac7ee25ac0cf8a7159d25f62555625"}. - * OCI defines a digest of manifest. + * The ID is assinged by the container runtime and can vary in different environments. + * Consider using {@code oci.manifest.digest} if it is important to identify the same image + * in different environments/runtimes. * */ public static final AttributeKey CONTAINER_IMAGE_ID = stringKey("container.image.id"); + /** Name of the image the container was built on. */ + public static final AttributeKey CONTAINER_IMAGE_NAME = stringKey("container.image.name"); + /** - * The command used to run the container (i.e. the command name). + * Repo digests of the container image as provided by the container runtime. * *

Notes: * *

*/ - public static final AttributeKey CONTAINER_COMMAND = stringKey("container.command"); - - /** The full command run by the container as a single string representing the full command. [2] */ - public static final AttributeKey CONTAINER_COMMAND_LINE = - stringKey("container.command_line"); + public static final AttributeKey> CONTAINER_IMAGE_REPO_DIGESTS = + stringArrayKey("container.image.repo_digests"); /** - * All the command arguments (including the command/executable itself) run by the container. [2] + * Container image tags. An example can be found in Docker Image + * Inspect. Should be only the {@code } section of the full name for example from {@code + * registry.example.com/my-org/my-image:}. */ - public static final AttributeKey> CONTAINER_COMMAND_ARGS = - stringArrayKey("container.command_args"); + public static final AttributeKey> CONTAINER_IMAGE_TAGS = + stringArrayKey("container.image.tags"); + + /** Container name used by container runtime. */ + public static final AttributeKey CONTAINER_NAME = stringKey("container.name"); + + /** The container runtime managing this container. */ + public static final AttributeKey CONTAINER_RUNTIME = stringKey("container.runtime"); /** * Name of the deployment @@ -376,6 +407,19 @@ public final class ResourceAttributes { */ public static final AttributeKey DEVICE_ID = stringKey("device.id"); + /** + * The name of the device manufacturer + * + *

Notes: + * + *

+ */ + public static final AttributeKey DEVICE_MANUFACTURER = stringKey("device.manufacturer"); + /** * The model identifier for the device * @@ -402,17 +446,30 @@ public final class ResourceAttributes { public static final AttributeKey DEVICE_MODEL_NAME = stringKey("device.model.name"); /** - * The name of the device manufacturer + * The execution environment ID as a string, that will be potentially reused for other invocations + * to the same function/function version. * *

Notes: * *

    - *
  • The Android OS provides this field via Build. - * iOS apps SHOULD hardcode the value {@code Apple}. + *
  • AWS Lambda: Use the (full) log stream name. *
*/ - public static final AttributeKey DEVICE_MANUFACTURER = stringKey("device.manufacturer"); + public static final AttributeKey FAAS_INSTANCE = stringKey("faas.instance"); + + /** + * The amount of memory available to the serverless function converted to Bytes. + * + *

Notes: + * + *

    + *
  • It's recommended to set this attribute since e.g. too little memory can easily stop a + * Java AWS Lambda function from working correctly. On AWS Lambda, the environment variable + * {@code AWS_LAMBDA_FUNCTION_MEMORY_SIZE} provides this information (which must be + * multiplied by 1,048,576). + *
+ */ + public static final AttributeKey FAAS_MAX_MEMORY = longKey("faas.max_memory"); /** * The name of the single function that this runtime instance executes. @@ -422,8 +479,8 @@ public final class ResourceAttributes { *
    *
  • 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 - * code.namespace}/{@code code.function} span attributes). + * href="/docs/general/attributes.md#source-code-attributes">{@code code.namespace}/{@code + * code.function} span attributes). *
  • For some cloud providers, the above definition is ambiguous. The following definition of * function name MUST be used for this attribute (and consequently the span name) for the * listed cloud providers/products: @@ -457,38 +514,40 @@ public final class ResourceAttributes { */ public static final AttributeKey FAAS_VERSION = stringKey("faas.version"); + /** The CPU architecture the host system is running on. */ + public static final AttributeKey HOST_ARCH = stringKey("host.arch"); + /** - * The execution environment ID as a string, that will be potentially reused for other invocations - * to the same function/function version. - * - *

    Notes: - * - *

      - *
    • AWS Lambda: Use the (full) log stream name. - *
    + * Unique host ID. For Cloud, this must be the instance_id assigned by the cloud provider. For + * non-containerized systems, this should be the {@code machine-id}. See the table below for the + * sources to use to determine the {@code machine-id} based on operating system. */ - public static final AttributeKey FAAS_INSTANCE = stringKey("faas.instance"); + public static final AttributeKey HOST_ID = stringKey("host.id"); + + /** VM image ID or host OS image ID. For Cloud, this value is from the provider. */ + public static final AttributeKey HOST_IMAGE_ID = stringKey("host.image.id"); + + /** Name of the VM image or OS install the host was instantiated from. */ + public static final AttributeKey HOST_IMAGE_NAME = stringKey("host.image.name"); /** - * The amount of memory available to the serverless function converted to Bytes. + * The version string of the VM image or host OS as defined in Version Attributes. + */ + public static final AttributeKey HOST_IMAGE_VERSION = stringKey("host.image.version"); + + /** + * Available IP addresses of the host, excluding loopback interfaces. * *

    Notes: * *

      - *
    • It's recommended to set this attribute since e.g. too little memory can easily stop a - * Java AWS Lambda function from working correctly. On AWS Lambda, the environment variable - * {@code AWS_LAMBDA_FUNCTION_MEMORY_SIZE} provides this information (which must be - * multiplied by 1,048,576). + *
    • IPv4 Addresses MUST be specified in dotted-quad notation. IPv6 addresses MUST be + * specified in the RFC 5952 + * format. *
    */ - public static final AttributeKey FAAS_MAX_MEMORY = longKey("faas.max_memory"); - - /** - * Unique host ID. For Cloud, this must be the instance_id assigned by the cloud provider. For - * non-containerized systems, this should be the {@code machine-id}. See the table below for the - * sources to use to determine the {@code machine-id} based on operating system. - */ - public static final AttributeKey HOST_ID = stringKey("host.id"); + public static final AttributeKey> HOST_IP = stringArrayKey("host.ip"); /** * Name of the host. On Unix systems, it may contain what the hostname command returns, or the @@ -499,20 +558,36 @@ public final class ResourceAttributes { /** Type of host. For Cloud, this must be the machine type. */ public static final AttributeKey HOST_TYPE = stringKey("host.type"); - /** The CPU architecture the host system is running on. */ - public static final AttributeKey HOST_ARCH = stringKey("host.arch"); + /** The amount of level 2 memory cache available to the processor (in Bytes). */ + public static final AttributeKey HOST_CPU_CACHE_L2_SIZE = longKey("host.cpu.cache.l2.size"); - /** Name of the VM image or OS install the host was instantiated from. */ - public static final AttributeKey HOST_IMAGE_NAME = stringKey("host.image.name"); + /** Numeric value specifying the family or generation of the CPU. */ + public static final AttributeKey HOST_CPU_FAMILY = longKey("host.cpu.family"); - /** VM image ID or host OS image ID. For Cloud, this value is from the provider. */ - public static final AttributeKey HOST_IMAGE_ID = stringKey("host.image.id"); + /** + * Model identifier. It provides more granular information about the CPU, distinguishing it from + * other CPUs within the same family. + */ + public static final AttributeKey HOST_CPU_MODEL_ID = longKey("host.cpu.model.id"); + + /** Model designation of the processor. */ + public static final AttributeKey HOST_CPU_MODEL_NAME = stringKey("host.cpu.model.name"); + + /** Stepping or core revisions. */ + public static final AttributeKey HOST_CPU_STEPPING = longKey("host.cpu.stepping"); /** - * The version string of the VM image or host OS as defined in Version Attributes. + * Processor manufacturer identifier. A maximum 12-character string. + * + *

    Notes: + * + *

      + *
    • CPUID command returns the vendor ID string in + * EBX, EDX and ECX registers. Writing these to memory in this order results in a + * 12-character string. + *
    */ - public static final AttributeKey HOST_IMAGE_VERSION = stringKey("host.image.version"); + public static final AttributeKey HOST_CPU_VENDOR_ID = stringKey("host.cpu.vendor.id"); /** The name of the cluster. */ public static final AttributeKey K8S_CLUSTER_NAME = stringKey("k8s.cluster.name"); @@ -551,12 +626,12 @@ public final class ResourceAttributes { /** The name of the namespace that the pod is running in. */ public static final AttributeKey K8S_NAMESPACE_NAME = stringKey("k8s.namespace.name"); - /** The UID of the Pod. */ - public static final AttributeKey K8S_POD_UID = stringKey("k8s.pod.uid"); - /** The name of the Pod. */ public static final AttributeKey K8S_POD_NAME = stringKey("k8s.pod.name"); + /** The UID of the Pod. */ + public static final AttributeKey K8S_POD_UID = stringKey("k8s.pod.uid"); + /** * The name of the Container from Pod specification, must be unique within a Pod. Container * runtime usually uses different globally unique name ({@code container.name}). @@ -570,44 +645,61 @@ public final class ResourceAttributes { public static final AttributeKey K8S_CONTAINER_RESTART_COUNT = longKey("k8s.container.restart_count"); + /** The name of the ReplicaSet. */ + public static final AttributeKey K8S_REPLICASET_NAME = stringKey("k8s.replicaset.name"); + /** The UID of the ReplicaSet. */ public static final AttributeKey K8S_REPLICASET_UID = stringKey("k8s.replicaset.uid"); - /** The name of the ReplicaSet. */ - public static final AttributeKey K8S_REPLICASET_NAME = stringKey("k8s.replicaset.name"); + /** The name of the Deployment. */ + public static final AttributeKey K8S_DEPLOYMENT_NAME = stringKey("k8s.deployment.name"); /** The UID of the Deployment. */ public static final AttributeKey K8S_DEPLOYMENT_UID = stringKey("k8s.deployment.uid"); - /** The name of the Deployment. */ - public static final AttributeKey K8S_DEPLOYMENT_NAME = stringKey("k8s.deployment.name"); + /** The name of the StatefulSet. */ + public static final AttributeKey K8S_STATEFULSET_NAME = stringKey("k8s.statefulset.name"); /** The UID of the StatefulSet. */ public static final AttributeKey K8S_STATEFULSET_UID = stringKey("k8s.statefulset.uid"); - /** The name of the StatefulSet. */ - public static final AttributeKey K8S_STATEFULSET_NAME = stringKey("k8s.statefulset.name"); + /** The name of the DaemonSet. */ + public static final AttributeKey K8S_DAEMONSET_NAME = stringKey("k8s.daemonset.name"); /** The UID of the DaemonSet. */ public static final AttributeKey K8S_DAEMONSET_UID = stringKey("k8s.daemonset.uid"); - /** The name of the DaemonSet. */ - public static final AttributeKey K8S_DAEMONSET_NAME = stringKey("k8s.daemonset.name"); + /** The name of the Job. */ + public static final AttributeKey K8S_JOB_NAME = stringKey("k8s.job.name"); /** The UID of the Job. */ public static final AttributeKey K8S_JOB_UID = stringKey("k8s.job.uid"); - /** The name of the Job. */ - public static final AttributeKey K8S_JOB_NAME = stringKey("k8s.job.name"); + /** The name of the CronJob. */ + public static final AttributeKey K8S_CRONJOB_NAME = stringKey("k8s.cronjob.name"); /** The UID of the CronJob. */ public static final AttributeKey K8S_CRONJOB_UID = stringKey("k8s.cronjob.uid"); - /** The name of the CronJob. */ - public static final AttributeKey K8S_CRONJOB_NAME = stringKey("k8s.cronjob.name"); + /** + * The digest of the OCI image manifest. For container images specifically is the digest by which + * the container image is known. + * + *

    Notes: + * + *

    + */ + public static final AttributeKey OCI_MANIFEST_DIGEST = stringKey("oci.manifest.digest"); - /** The operating system type. */ - public static final AttributeKey OS_TYPE = stringKey("os.type"); + /** Unique identifier for a particular build or compilation of the operating system. */ + public static final AttributeKey OS_BUILD_ID = stringKey("os.build_id"); /** * Human readable (not intended to be parsed) OS version information, like e.g. reported by {@code @@ -618,17 +710,37 @@ public final class ResourceAttributes { /** Human readable operating system name. */ public static final AttributeKey OS_NAME = stringKey("os.name"); + /** The operating system type. */ + public static final AttributeKey OS_TYPE = stringKey("os.type"); + /** * The version string of the operating system as defined in Version Attributes. */ public static final AttributeKey OS_VERSION = stringKey("os.version"); - /** Process identifier (PID). */ - public static final AttributeKey PROCESS_PID = longKey("process.pid"); + /** + * The command used to launch the process (i.e. the command name). On Linux based systems, can be + * set to the zeroth string in {@code proc/[pid]/cmdline}. On Windows, can be set to the first + * parameter extracted from {@code GetCommandLineW}. + */ + public static final AttributeKey PROCESS_COMMAND = stringKey("process.command"); - /** Parent Process identifier (PID). */ - public static final AttributeKey PROCESS_PARENT_PID = longKey("process.parent_pid"); + /** + * All the command arguments (including the command/executable itself) as received by the process. + * On Linux-based systems (and some other Unixoid systems supporting procfs), can be set according + * to the list of null-delimited strings extracted from {@code proc/[pid]/cmdline}. For libc-based + * executables, this would be the full argv vector passed to {@code main}. + */ + public static final AttributeKey> PROCESS_COMMAND_ARGS = + stringArrayKey("process.command_args"); + + /** + * The full command used to launch the process as a single string representing the full command. + * On Windows, can be set to the result of {@code GetCommandLineW}. Do not set this if you have to + * assemble it just for monitoring; use {@code process.command_args} instead. + */ + public static final AttributeKey PROCESS_COMMAND_LINE = stringKey("process.command_line"); /** * The name of the process executable. On Linux based systems, can be set to the {@code Name} in @@ -646,31 +758,21 @@ public final class ResourceAttributes { public static final AttributeKey PROCESS_EXECUTABLE_PATH = stringKey("process.executable.path"); - /** - * The command used to launch the process (i.e. the command name). On Linux based systems, can be - * set to the zeroth string in {@code proc/[pid]/cmdline}. On Windows, can be set to the first - * parameter extracted from {@code GetCommandLineW}. - */ - public static final AttributeKey PROCESS_COMMAND = stringKey("process.command"); + /** The username of the user that owns the process. */ + public static final AttributeKey PROCESS_OWNER = stringKey("process.owner"); - /** - * The full command used to launch the process as a single string representing the full command. - * On Windows, can be set to the result of {@code GetCommandLineW}. Do not set this if you have to - * assemble it just for monitoring; use {@code process.command_args} instead. - */ - public static final AttributeKey PROCESS_COMMAND_LINE = stringKey("process.command_line"); + /** Parent Process identifier (PID). */ + public static final AttributeKey PROCESS_PARENT_PID = longKey("process.parent_pid"); + + /** Process identifier (PID). */ + public static final AttributeKey PROCESS_PID = longKey("process.pid"); /** - * All the command arguments (including the command/executable itself) as received by the process. - * On Linux-based systems (and some other Unixoid systems supporting procfs), can be set according - * to the list of null-delimited strings extracted from {@code proc/[pid]/cmdline}. For libc-based - * executables, this would be the full argv vector passed to {@code main}. + * An additional description about the runtime of the process, for example a specific vendor + * customization of the runtime environment. */ - public static final AttributeKey> PROCESS_COMMAND_ARGS = - stringArrayKey("process.command_args"); - - /** The username of the user that owns the process. */ - public static final AttributeKey PROCESS_OWNER = stringKey("process.owner"); + public static final AttributeKey PROCESS_RUNTIME_DESCRIPTION = + stringKey("process.runtime.description"); /** * The name of the runtime of this process. For compiled native binaries, this SHOULD be the name @@ -684,13 +786,6 @@ public final class ResourceAttributes { public static final AttributeKey PROCESS_RUNTIME_VERSION = stringKey("process.runtime.version"); - /** - * An additional description about the runtime of the process, for example a specific vendor - * customization of the runtime environment. - */ - public static final AttributeKey PROCESS_RUNTIME_DESCRIPTION = - stringKey("process.runtime.description"); - /** * Logical name of the service. * @@ -712,22 +807,6 @@ public final class ResourceAttributes { */ public static final AttributeKey SERVICE_VERSION = stringKey("service.version"); - /** - * A namespace for {@code service.name}. - * - *

    Notes: - * - *

      - *
    • A string value having a meaning that helps to distinguish a group of services, for - * example the team name that owns a group of services. {@code service.name} is expected to - * be unique within the same namespace. If {@code service.namespace} is not specified in the - * Resource then {@code service.name} is expected to be unique for all services that have no - * explicit namespace defined (so the empty/unspecified namespace is simply one more valid - * namespace). Zero-length namespace string is assumed equal to unspecified namespace. - *
    - */ - public static final AttributeKey SERVICE_NAMESPACE = stringKey("service.namespace"); - /** * The string ID of the service instance. * @@ -748,6 +827,26 @@ public final class ResourceAttributes { */ public static final AttributeKey SERVICE_INSTANCE_ID = stringKey("service.instance.id"); + /** + * A namespace for {@code service.name}. + * + *

    Notes: + * + *

      + *
    • A string value having a meaning that helps to distinguish a group of services, for + * example the team name that owns a group of services. {@code service.name} is expected to + * be unique within the same namespace. If {@code service.namespace} is not specified in the + * Resource then {@code service.name} is expected to be unique for all services that have no + * explicit namespace defined (so the empty/unspecified namespace is simply one more valid + * namespace). Zero-length namespace string is assumed equal to unspecified namespace. + *
    + */ + public static final AttributeKey SERVICE_NAMESPACE = stringKey("service.namespace"); + + /** The language of the telemetry SDK. */ + public static final AttributeKey TELEMETRY_SDK_LANGUAGE = + stringKey("telemetry.sdk.language"); + /** * The name of the telemetry SDK as defined above. * @@ -765,17 +864,31 @@ public final class ResourceAttributes { */ public static final AttributeKey TELEMETRY_SDK_NAME = stringKey("telemetry.sdk.name"); - /** The language of the telemetry SDK. */ - public static final AttributeKey TELEMETRY_SDK_LANGUAGE = - stringKey("telemetry.sdk.language"); - /** The version string of the telemetry SDK. */ public static final AttributeKey TELEMETRY_SDK_VERSION = stringKey("telemetry.sdk.version"); - /** The version string of the auto instrumentation agent, if used. */ - public static final AttributeKey TELEMETRY_AUTO_VERSION = - stringKey("telemetry.auto.version"); + /** + * The name of the auto instrumentation agent or distribution, if used. + * + *

    Notes: + * + *

      + *
    • Official auto instrumentation agents and distributions SHOULD set the {@code + * telemetry.distro.name} attribute to a string starting with {@code opentelemetry-}, e.g. + * {@code opentelemetry-java-instrumentation}. + *
    + */ + public static final AttributeKey TELEMETRY_DISTRO_NAME = + stringKey("telemetry.distro.name"); + + /** The version string of the auto instrumentation agent or distribution, if used. */ + public static final AttributeKey TELEMETRY_DISTRO_VERSION = + stringKey("telemetry.distro.version"); + + /** Additional description of the web engine (e.g. detailed version and edition information). */ + public static final AttributeKey WEBENGINE_DESCRIPTION = + stringKey("webengine.description"); /** The name of the web engine. */ public static final AttributeKey WEBENGINE_NAME = stringKey("webengine.name"); @@ -783,10 +896,6 @@ public final class ResourceAttributes { /** The version of the web engine. */ public static final AttributeKey WEBENGINE_VERSION = stringKey("webengine.version"); - /** Additional description of the web engine (e.g. detailed version and edition information). */ - public static final AttributeKey WEBENGINE_DESCRIPTION = - stringKey("webengine.description"); - /** The name of the instrumentation scope - ({@code InstrumentationScope.Name} in OTLP). */ public static final AttributeKey OTEL_SCOPE_NAME = stringKey("otel.scope.name"); @@ -810,31 +919,6 @@ public final class ResourceAttributes { public static final AttributeKey OTEL_LIBRARY_VERSION = stringKey("otel.library.version"); // Enum definitions - public static final class CloudProviderValues { - /** Alibaba Cloud. */ - public static final String ALIBABA_CLOUD = "alibaba_cloud"; - - /** Amazon Web Services. */ - public static final String AWS = "aws"; - - /** Microsoft Azure. */ - public static final String AZURE = "azure"; - - /** Google Cloud Platform. */ - public static final String GCP = "gcp"; - - /** Heroku Platform as a Service. */ - public static final String HEROKU = "heroku"; - - /** IBM Cloud. */ - public static final String IBM_CLOUD = "ibm_cloud"; - - /** Tencent Cloud. */ - public static final String TENCENT_CLOUD = "tencent_cloud"; - - private CloudProviderValues() {} - } - public static final class CloudPlatformValues { /** Alibaba Cloud Elastic Compute Service. */ public static final String ALIBABA_CLOUD_ECS = "alibaba_cloud_ecs"; @@ -920,6 +1004,31 @@ public static final class CloudPlatformValues { private CloudPlatformValues() {} } + public static final class CloudProviderValues { + /** Alibaba Cloud. */ + public static final String ALIBABA_CLOUD = "alibaba_cloud"; + + /** Amazon Web Services. */ + public static final String AWS = "aws"; + + /** Microsoft Azure. */ + public static final String AZURE = "azure"; + + /** Google Cloud Platform. */ + public static final String GCP = "gcp"; + + /** Heroku Platform as a Service. */ + public static final String HEROKU = "heroku"; + + /** IBM Cloud. */ + public static final String IBM_CLOUD = "ibm_cloud"; + + /** Tencent Cloud. */ + public static final String TENCENT_CLOUD = "tencent_cloud"; + + private CloudProviderValues() {} + } + public static final class AwsEcsLaunchtypeValues { /** ec2. */ public static final String EC2 = "ec2"; diff --git a/src/main/java/io/opentelemetry/semconv/SemanticAttributes.java b/src/main/java/io/opentelemetry/semconv/SemanticAttributes.java index d778c4c..5a6eae7 100644 --- a/src/main/java/io/opentelemetry/semconv/SemanticAttributes.java +++ b/src/main/java/io/opentelemetry/semconv/SemanticAttributes.java @@ -19,282 +19,295 @@ @SuppressWarnings("unused") public final class SemanticAttributes { /** The URL of the OpenTelemetry schema for these keys and values. */ - public static final String SCHEMA_URL = "https://opentelemetry.io/schemas/1.21.0"; + public static final String SCHEMA_URL = "https://opentelemetry.io/schemas/1.22.0"; /** - * Client address - unix domain socket name, IPv4 or IPv6 address. + * Client address - domain name if available without reverse DNS lookup, otherwise IP address or + * Unix domain socket name. * *

    Notes: * *

      *
    • When observed from the server side, and when communicating through an intermediary, - * {@code client.address} SHOULD represent client address behind any intermediaries (e.g. - * proxies) if it's available. + * {@code client.address} SHOULD represent the client address behind any intermediaries + * (e.g. proxies) if it's available. *
    */ public static final AttributeKey CLIENT_ADDRESS = stringKey("client.address"); /** - * Client port number + * Client port number. * *

    Notes: * *

      *
    • When observed from the server side, and when communicating through an intermediary, - * {@code client.port} SHOULD represent client port behind any intermediaries (e.g. proxies) - * if it's available. + * {@code client.port} SHOULD represent the client port behind any intermediaries (e.g. + * proxies) if it's available. *
    */ public static final AttributeKey CLIENT_PORT = longKey("client.port"); - /** Immediate client peer address - unix domain socket name, IPv4 or IPv6 address. */ - public static final AttributeKey CLIENT_SOCKET_ADDRESS = - stringKey("client.socket.address"); - - /** Immediate client peer port number */ - public static final AttributeKey CLIENT_SOCKET_PORT = longKey("client.socket.port"); - /** - * Deprecated, use {@code http.request.method} instead. + * Deprecated, use {@code server.address}. * - * @deprecated Deprecated, use `http.request.method` instead. + * @deprecated Deprecated, use `server.address`. */ - @Deprecated public static final AttributeKey HTTP_METHOD = stringKey("http.method"); + @Deprecated public static final AttributeKey NET_HOST_NAME = stringKey("net.host.name"); /** - * Deprecated, use {@code http.response.status_code} instead. + * Deprecated, use {@code server.port}. * - * @deprecated Deprecated, use `http.response.status_code` instead. + * @deprecated Deprecated, use `server.port`. */ - @Deprecated public static final AttributeKey HTTP_STATUS_CODE = longKey("http.status_code"); + @Deprecated public static final AttributeKey NET_HOST_PORT = longKey("net.host.port"); /** - * Deprecated, use {@code url.scheme} instead. + * Deprecated, use {@code server.address} on client spans and {@code client.address} on server + * spans. * - * @deprecated Deprecated, use `url.scheme` instead. + * @deprecated Deprecated, use `server.address` on client spans and `client.address` on server + * spans. */ - @Deprecated public static final AttributeKey HTTP_SCHEME = stringKey("http.scheme"); + @Deprecated public static final AttributeKey NET_PEER_NAME = stringKey("net.peer.name"); /** - * Deprecated, use {@code url.full} instead. + * Deprecated, use {@code server.port} on client spans and {@code client.port} on server spans. * - * @deprecated Deprecated, use `url.full` instead. + * @deprecated Deprecated, use `server.port` on client spans and `client.port` on server spans. */ - @Deprecated public static final AttributeKey HTTP_URL = stringKey("http.url"); + @Deprecated public static final AttributeKey NET_PEER_PORT = longKey("net.peer.port"); /** - * Deprecated, use {@code url.path} and {@code url.query} instead. + * Deprecated, use {@code network.protocol.name}. * - * @deprecated Deprecated, use `url.path` and `url.query` instead. + * @deprecated Deprecated, use `network.protocol.name`. */ - @Deprecated public static final AttributeKey HTTP_TARGET = stringKey("http.target"); + @Deprecated + public static final AttributeKey NET_PROTOCOL_NAME = stringKey("net.protocol.name"); /** - * Deprecated, use {@code http.request.body.size} instead. + * Deprecated, use {@code network.protocol.version}. * - * @deprecated Deprecated, use `http.request.body.size` instead. + * @deprecated Deprecated, use `network.protocol.version`. */ @Deprecated - public static final AttributeKey HTTP_REQUEST_CONTENT_LENGTH = - longKey("http.request_content_length"); + public static final AttributeKey NET_PROTOCOL_VERSION = stringKey("net.protocol.version"); /** - * Deprecated, use {@code http.response.body.size} instead. + * Deprecated, use {@code network.transport} and {@code network.type}. * - * @deprecated Deprecated, use `http.response.body.size` instead. + * @deprecated Deprecated, use `network.transport` and `network.type`. */ @Deprecated - public static final AttributeKey HTTP_RESPONSE_CONTENT_LENGTH = - longKey("http.response_content_length"); + public static final AttributeKey NET_SOCK_FAMILY = stringKey("net.sock.family"); /** - * Deprecated, use {@code server.socket.domain} on client spans. + * Deprecated, use {@code network.local.address}. * - * @deprecated Deprecated, use `server.socket.domain` on client spans. + * @deprecated Deprecated, use `network.local.address`. */ @Deprecated - public static final AttributeKey NET_SOCK_PEER_NAME = stringKey("net.sock.peer.name"); + public static final AttributeKey NET_SOCK_HOST_ADDR = stringKey("net.sock.host.addr"); /** - * Deprecated, use {@code server.socket.address} on client spans and {@code client.socket.address} - * on server spans. + * Deprecated, use {@code network.local.port}. * - * @deprecated Deprecated, use `server.socket.address` on client spans and `client.socket.address` - * on server spans. + * @deprecated Deprecated, use `network.local.port`. */ @Deprecated - public static final AttributeKey NET_SOCK_PEER_ADDR = stringKey("net.sock.peer.addr"); + public static final AttributeKey NET_SOCK_HOST_PORT = longKey("net.sock.host.port"); /** - * Deprecated, use {@code server.socket.port} on client spans and {@code client.socket.port} on - * server spans. + * Deprecated, use {@code network.peer.address}. * - * @deprecated Deprecated, use `server.socket.port` on client spans and `client.socket.port` on - * server spans. + * @deprecated Deprecated, use `network.peer.address`. */ @Deprecated - public static final AttributeKey NET_SOCK_PEER_PORT = longKey("net.sock.peer.port"); + public static final AttributeKey NET_SOCK_PEER_ADDR = stringKey("net.sock.peer.addr"); /** - * Deprecated, use {@code server.address} on client spans and {@code client.address} on server - * spans. + * Deprecated, no replacement at this time. * - * @deprecated Deprecated, use `server.address` on client spans and `client.address` on server - * spans. + * @deprecated Deprecated, no replacement at this time. */ - @Deprecated public static final AttributeKey NET_PEER_NAME = stringKey("net.peer.name"); + @Deprecated + public static final AttributeKey NET_SOCK_PEER_NAME = stringKey("net.sock.peer.name"); /** - * Deprecated, use {@code server.port} on client spans and {@code client.port} on server spans. + * Deprecated, use {@code network.peer.port}. * - * @deprecated Deprecated, use `server.port` on client spans and `client.port` on server spans. + * @deprecated Deprecated, use `network.peer.port`. */ - @Deprecated public static final AttributeKey NET_PEER_PORT = longKey("net.peer.port"); + @Deprecated + public static final AttributeKey NET_SOCK_PEER_PORT = longKey("net.sock.peer.port"); /** - * Deprecated, use {@code server.address}. + * Deprecated, use {@code network.transport}. * - * @deprecated Deprecated, use `server.address`. + * @deprecated Deprecated, use `network.transport`. */ - @Deprecated public static final AttributeKey NET_HOST_NAME = stringKey("net.host.name"); + @Deprecated public static final AttributeKey NET_TRANSPORT = stringKey("net.transport"); /** - * Deprecated, use {@code server.port}. + * Destination address - domain name if available without reverse DNS lookup, otherwise IP address + * or Unix domain socket name. * - * @deprecated Deprecated, use `server.port`. - */ - @Deprecated public static final AttributeKey NET_HOST_PORT = longKey("net.host.port"); - - /** - * Deprecated, use {@code server.socket.address}. + *

    Notes: * - * @deprecated Deprecated, use `server.socket.address`. + *

      + *
    • When observed from the source side, and when communicating through an intermediary, + * {@code destination.address} SHOULD represent the destination address behind any + * intermediaries (e.g. proxies) if it's available. + *
    */ - @Deprecated - public static final AttributeKey NET_SOCK_HOST_ADDR = stringKey("net.sock.host.addr"); + public static final AttributeKey DESTINATION_ADDRESS = stringKey("destination.address"); + + /** Destination port number */ + public static final AttributeKey DESTINATION_PORT = longKey("destination.port"); /** - * Deprecated, use {@code server.socket.port}. + * Describes a class of error the operation ended with. + * + *

    Notes: * - * @deprecated Deprecated, use `server.socket.port`. + *

      + *
    • The {@code error.type} SHOULD be predictable and SHOULD have low cardinality. + * Instrumentations SHOULD document the list of errors they report. + *
    • The cardinality of {@code error.type} within one instrumentation library SHOULD be low, + * but telemetry consumers that aggregate data from multiple instrumentation libraries and + * applications should be prepared for {@code error.type} to have high cardinality at query + * time, when no additional filters are applied. + *
    • If the operation has completed successfully, instrumentations SHOULD NOT set {@code + * error.type}. + *
    • If a specific domain defines its own set of error codes (such as HTTP or gRPC status + * codes), it's RECOMMENDED to use a domain-specific attribute and also set {@code + * error.type} to capture all errors, regardless of whether they are defined within the + * domain-specific set or not. + *
    */ - @Deprecated - public static final AttributeKey NET_SOCK_HOST_PORT = longKey("net.sock.host.port"); + public static final AttributeKey ERROR_TYPE = stringKey("error.type"); + + /** The exception message. */ + public static final AttributeKey EXCEPTION_MESSAGE = stringKey("exception.message"); /** - * Deprecated, use {@code network.transport}. - * - * @deprecated Deprecated, use `network.transport`. + * A stacktrace as a string in the natural representation for the language runtime. The + * representation is to be determined and documented by each language SIG. */ - @Deprecated public static final AttributeKey NET_TRANSPORT = stringKey("net.transport"); + public static final AttributeKey EXCEPTION_STACKTRACE = stringKey("exception.stacktrace"); /** - * Deprecated, use {@code network.protocol.name}. - * - * @deprecated Deprecated, use `network.protocol.name`. + * The type of the exception (its fully-qualified class name, if applicable). The dynamic type of + * the exception should be preferred over the static type in languages that support it. */ - @Deprecated - public static final AttributeKey NET_PROTOCOL_NAME = stringKey("net.protocol.name"); + public static final AttributeKey EXCEPTION_TYPE = stringKey("exception.type"); /** - * Deprecated, use {@code network.protocol.version}. + * The name of the invoked function. * - * @deprecated Deprecated, use `network.protocol.version`. + *

    Notes: + * + *

      + *
    • SHOULD be equal to the {@code faas.name} resource attribute of the invoked function. + *
    */ - @Deprecated - public static final AttributeKey NET_PROTOCOL_VERSION = stringKey("net.protocol.version"); + public static final AttributeKey FAAS_INVOKED_NAME = stringKey("faas.invoked_name"); /** - * Deprecated, use {@code network.transport} and {@code network.type}. + * The cloud provider of the invoked function. * - * @deprecated Deprecated, use `network.transport` and `network.type`. + *

    Notes: + * + *

      + *
    • SHOULD be equal to the {@code cloud.provider} resource attribute of the invoked function. + *
    */ - @Deprecated - public static final AttributeKey NET_SOCK_FAMILY = stringKey("net.sock.family"); + public static final AttributeKey FAAS_INVOKED_PROVIDER = + stringKey("faas.invoked_provider"); /** - * The domain name of the destination system. + * The cloud region of the invoked function. * *

    Notes: * *

      - *
    • This value may be a host name, a fully qualified domain name, or another host naming - * format. + *
    • SHOULD be equal to the {@code cloud.region} resource attribute of the invoked function. *
    */ - public static final AttributeKey DESTINATION_DOMAIN = stringKey("destination.domain"); + public static final AttributeKey FAAS_INVOKED_REGION = stringKey("faas.invoked_region"); - /** Peer address, for example IP address or UNIX socket name. */ - public static final AttributeKey DESTINATION_ADDRESS = stringKey("destination.address"); + /** Type of the trigger which caused this function invocation. */ + public static final AttributeKey FAAS_TRIGGER = stringKey("faas.trigger"); - /** Peer port number */ - public static final AttributeKey DESTINATION_PORT = longKey("destination.port"); + /** + * The {@code service.name} of the remote service. + * SHOULD be equal to the actual {@code service.name} resource attribute of the remote service if + * any. + */ + public static final AttributeKey PEER_SERVICE = stringKey("peer.service"); /** - * The type of the exception (its fully-qualified class name, if applicable). The dynamic type of - * the exception should be preferred over the static type in languages that support it. + * Username or client_id extracted from the access token or Authorization header in the inbound + * request from outside the system. */ - public static final AttributeKey EXCEPTION_TYPE = stringKey("exception.type"); + public static final AttributeKey ENDUSER_ID = stringKey("enduser.id"); - /** The exception message. */ - public static final AttributeKey EXCEPTION_MESSAGE = stringKey("exception.message"); + /** + * Actual/assumed role the client is making the request under extracted from token or application + * security context. + */ + public static final AttributeKey ENDUSER_ROLE = stringKey("enduser.role"); /** - * A stacktrace as a string in the natural representation for the language runtime. The - * representation is to be determined and documented by each language SIG. + * Scopes or granted authorities the client currently possesses extracted from token or + * application security context. The value would come from the scope associated with an OAuth 2.0 Access Token or an + * attribute value in a SAML + * 2.0 Assertion. */ - public static final AttributeKey EXCEPTION_STACKTRACE = stringKey("exception.stacktrace"); + public static final AttributeKey ENDUSER_SCOPE = stringKey("enduser.scope"); + + /** Whether the thread is daemon or not. */ + public static final AttributeKey THREAD_DAEMON = booleanKey("thread.daemon"); + + /** Current "managed" thread ID (as opposed to OS thread ID). */ + public static final AttributeKey THREAD_ID = longKey("thread.id"); + + /** Current thread name. */ + public static final AttributeKey THREAD_NAME = stringKey("thread.name"); /** - * HTTP request method. - * - *

    Notes: - * - *

      - *
    • HTTP request method value SHOULD be "known" to the instrumentation. By default, - * this convention defines "known" methods as the ones listed in RFC9110 and the PATCH - * method defined in RFC5789. - *
    • If the HTTP request method is not known to instrumentation, it MUST set the {@code - * http.request.method} attribute to {@code _OTHER} and, except if reporting a metric, MUST - * set the exact method received in the request line as value of the {@code - * http.request.method_original} attribute. - *
    • If the HTTP instrumentation could end up converting valid HTTP request methods to {@code - * _OTHER}, then it MUST provide a way to override the list of known HTTP methods. If this - * override is done via environment variable, then the environment variable MUST be named - * OTEL_INSTRUMENTATION_HTTP_KNOWN_METHODS and support a comma-separated list of - * case-sensitive known HTTP methods (this list MUST be a full override of the default known - * method, it is not a list of known methods in addition to the defaults). - *
    • HTTP method names are case-sensitive and {@code http.request.method} attribute value MUST - * match a known HTTP method name exactly. Instrumentations for specific web frameworks that - * consider HTTP methods to be case insensitive, SHOULD populate a canonical equivalent. - * Tracing instrumentations that do so, MUST also set {@code http.request.method_original} - * to the original value. - *
    + * The column number in {@code code.filepath} best representing the operation. It SHOULD point + * within the code unit named in {@code code.function}. */ - public static final AttributeKey HTTP_REQUEST_METHOD = stringKey("http.request.method"); + public static final AttributeKey CODE_COLUMN = longKey("code.column"); - /** HTTP response status code. */ - public static final AttributeKey HTTP_RESPONSE_STATUS_CODE = - longKey("http.response.status_code"); + /** + * The source code file name that identifies the code unit as uniquely as possible (preferably an + * absolute file path). + */ + public static final AttributeKey CODE_FILEPATH = stringKey("code.filepath"); /** - * The matched route (path template in the format used by the respective server framework). See - * note below - * - *

    Notes: - * - *

      - *
    • MUST NOT be populated when this is not supported by the HTTP server framework as the - * route attribute should have low-cardinality and the URI path can NOT substitute it. - * SHOULD include the application - * root if there is one. - *
    + * The method or function name, or equivalent (usually rightmost part of the code unit's name). */ - public static final AttributeKey HTTP_ROUTE = stringKey("http.route"); + public static final AttributeKey CODE_FUNCTION = stringKey("code.function"); - /** The name identifies the event. */ - public static final AttributeKey EVENT_NAME = stringKey("event.name"); + /** + * The line number in {@code code.filepath} best representing the operation. It SHOULD point + * within the code unit named in {@code code.function}. + */ + public static final AttributeKey CODE_LINENO = longKey("code.lineno"); + + /** + * The "namespace" within which {@code code.function} is defined. Usually the qualified + * class or module name, such that {@code code.namespace} + some separator + {@code code.function} + * form a unique identifier for the code unit. + */ + public static final AttributeKey CODE_NAMESPACE = stringKey("code.namespace"); /** * The domain identifies the business context for the events. @@ -308,6 +321,9 @@ public final class SemanticAttributes { */ public static final AttributeKey EVENT_DOMAIN = stringKey("event.domain"); + /** The name identifies the event. */ + public static final AttributeKey EVENT_NAME = stringKey("event.name"); + /** * A unique identifier for the Log Record. * @@ -329,263 +345,565 @@ public final class SemanticAttributes { /** The basename of the file. */ public static final AttributeKey LOG_FILE_NAME = stringKey("log.file.name"); - /** The full path to the file. */ - public static final AttributeKey LOG_FILE_PATH = stringKey("log.file.path"); - /** The basename of the file, with symlinks resolved. */ public static final AttributeKey LOG_FILE_NAME_RESOLVED = stringKey("log.file.name_resolved"); + /** The full path to the file. */ + public static final AttributeKey LOG_FILE_PATH = stringKey("log.file.path"); + /** The full path to the file, with symlinks resolved. */ public static final AttributeKey LOG_FILE_PATH_RESOLVED = stringKey("log.file.path_resolved"); - /** The type of memory. */ - public static final AttributeKey TYPE = stringKey("type"); + /** + * The name of the connection pool; unique within the instrumented application. In case the + * connection pool implementation does not provide a name, then the db.connection_string + * should be used + */ + public static final AttributeKey POOL_NAME = stringKey("pool.name"); + + /** The state of a connection in the pool */ + public static final AttributeKey STATE = stringKey("state"); /** - * Name of the memory pool. + * Name of the buffer pool. * *

    Notes: * *

      *
    • Pool names are generally obtained via MemoryPoolMXBean#getName(). + * href="https://docs.oracle.com/en/java/javase/11/docs/api/java.management/java/lang/management/BufferPoolMXBean.html#getName()">BufferPoolMXBean#getName(). *
    */ - public static final AttributeKey POOL = stringKey("pool"); + public static final AttributeKey JVM_BUFFER_POOL_NAME = stringKey("jvm.buffer.pool.name"); /** - * Logical server hostname, matches server FQDN if available, and IP or socket address if FQDN is - * not known. + * Name of the memory pool. + * + *

    Notes: + * + *

    */ - public static final AttributeKey SERVER_ADDRESS = stringKey("server.address"); + public static final AttributeKey JVM_MEMORY_POOL_NAME = stringKey("jvm.memory.pool.name"); - /** Logical server port number */ - public static final AttributeKey SERVER_PORT = longKey("server.port"); + /** The type of memory. */ + public static final AttributeKey JVM_MEMORY_TYPE = stringKey("jvm.memory.type"); + + /** The device identifier */ + public static final AttributeKey SYSTEM_DEVICE = stringKey("system.device"); + + /** The logical CPU number [0..n-1] */ + public static final AttributeKey SYSTEM_CPU_LOGICAL_NUMBER = + longKey("system.cpu.logical_number"); + + /** The state of the CPU */ + public static final AttributeKey SYSTEM_CPU_STATE = stringKey("system.cpu.state"); + + /** The memory state */ + public static final AttributeKey SYSTEM_MEMORY_STATE = stringKey("system.memory.state"); + + /** The paging access direction */ + public static final AttributeKey SYSTEM_PAGING_DIRECTION = + stringKey("system.paging.direction"); + + /** The memory paging state */ + public static final AttributeKey SYSTEM_PAGING_STATE = stringKey("system.paging.state"); + + /** The memory paging type */ + public static final AttributeKey SYSTEM_PAGING_TYPE = stringKey("system.paging.type"); + + /** The disk operation direction */ + public static final AttributeKey SYSTEM_DISK_DIRECTION = + stringKey("system.disk.direction"); + + /** The filesystem mode */ + public static final AttributeKey SYSTEM_FILESYSTEM_MODE = + stringKey("system.filesystem.mode"); + + /** The filesystem mount path */ + public static final AttributeKey SYSTEM_FILESYSTEM_MOUNTPOINT = + stringKey("system.filesystem.mountpoint"); + + /** The filesystem state */ + public static final AttributeKey SYSTEM_FILESYSTEM_STATE = + stringKey("system.filesystem.state"); + + /** The filesystem type */ + public static final AttributeKey SYSTEM_FILESYSTEM_TYPE = + stringKey("system.filesystem.type"); + + /** */ + public static final AttributeKey SYSTEM_NETWORK_DIRECTION = + stringKey("system.network.direction"); + + /** A stateless protocol MUST NOT set this attribute */ + public static final AttributeKey SYSTEM_NETWORK_STATE = stringKey("system.network.state"); + + /** + * The process state, e.g., Linux Process State + * Codes + */ + public static final AttributeKey SYSTEM_PROCESSES_STATUS = + stringKey("system.processes.status"); + + /** Local address of the network connection - IP address or Unix domain socket name. */ + public static final AttributeKey NETWORK_LOCAL_ADDRESS = + stringKey("network.local.address"); + + /** Local port number of the network connection. */ + public static final AttributeKey NETWORK_LOCAL_PORT = longKey("network.local.port"); + + /** Peer address of the network connection - IP address or Unix domain socket name. */ + public static final AttributeKey NETWORK_PEER_ADDRESS = stringKey("network.peer.address"); + + /** Peer port number of the network connection. */ + public static final AttributeKey NETWORK_PEER_PORT = longKey("network.peer.port"); /** - * The domain name of an immediate peer. + * OSI application layer or non-OSI + * equivalent. * *

    Notes: * *

      - *
    • Typically observed from the client side, and represents a proxy or other intermediary - * domain name. + *
    • The value SHOULD be normalized to lowercase. *
    */ - public static final AttributeKey SERVER_SOCKET_DOMAIN = stringKey("server.socket.domain"); + public static final AttributeKey NETWORK_PROTOCOL_NAME = + stringKey("network.protocol.name"); /** - * Physical server IP address or Unix socket address. If set from the client, should simply use - * the socket's peer address, and not attempt to find any actual server IP (i.e., if set from - * client, this may represent some proxy server instead of the logical server). + * Version of the protocol specified in {@code network.protocol.name}. + * + *

    Notes: + * + *

      + *
    • {@code network.protocol.version} refers to the version of the protocol used and might be + * different from the protocol client's version. If the HTTP client used has a version of + * {@code 0.27.2}, but sends HTTP version {@code 1.1}, this attribute should be set to + * {@code 1.1}. + *
    */ - public static final AttributeKey SERVER_SOCKET_ADDRESS = - stringKey("server.socket.address"); - - /** Physical server port. */ - public static final AttributeKey SERVER_SOCKET_PORT = longKey("server.socket.port"); + public static final AttributeKey NETWORK_PROTOCOL_VERSION = + stringKey("network.protocol.version"); /** - * The domain name of the source system. + * OSI transport layer or inter-process communication + * method. * *

    Notes: * *

      - *
    • This value may be a host name, a fully qualified domain name, or another host naming - * format. + *
    • The value SHOULD be normalized to lowercase. + *
    • Consider always setting the transport when setting a port number, since a port number is + * ambiguous without knowing the transport, for example different processes could be + * listening on TCP port 12345 and UDP port 12345. *
    */ - public static final AttributeKey SOURCE_DOMAIN = stringKey("source.domain"); - - /** Source address, for example IP address or Unix socket name. */ - public static final AttributeKey SOURCE_ADDRESS = stringKey("source.address"); - - /** Source port number */ - public static final AttributeKey SOURCE_PORT = longKey("source.port"); + public static final AttributeKey NETWORK_TRANSPORT = stringKey("network.transport"); /** - * The full invoked ARN as provided on the {@code Context} passed to the function ({@code - * Lambda-Runtime-Invoked-Function-Arn} header on the {@code /runtime/invocation/next} - * applicable). + * OSI network layer or non-OSI equivalent. * *

    Notes: * *

      - *
    • This may be different from {@code cloud.resource_id} if an alias is involved. + *
    • The value SHOULD be normalized to lowercase. *
    */ - public static final AttributeKey AWS_LAMBDA_INVOKED_ARN = - stringKey("aws.lambda.invoked_arn"); + public static final AttributeKey NETWORK_TYPE = stringKey("network.type"); + + /** The ISO 3166-1 alpha-2 2-character country code associated with the mobile carrier network. */ + public static final AttributeKey NETWORK_CARRIER_ICC = stringKey("network.carrier.icc"); + + /** The mobile carrier country code. */ + public static final AttributeKey NETWORK_CARRIER_MCC = stringKey("network.carrier.mcc"); + + /** The mobile carrier network code. */ + public static final AttributeKey NETWORK_CARRIER_MNC = stringKey("network.carrier.mnc"); + + /** The name of the mobile carrier. */ + public static final AttributeKey NETWORK_CARRIER_NAME = stringKey("network.carrier.name"); /** - * The event_id - * uniquely identifies the event. + * 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. */ - public static final AttributeKey CLOUDEVENTS_EVENT_ID = stringKey("cloudevents.event_id"); + public static final AttributeKey NETWORK_CONNECTION_SUBTYPE = + stringKey("network.connection.subtype"); + + /** The internet connection type. */ + public static final AttributeKey NETWORK_CONNECTION_TYPE = + stringKey("network.connection.type"); /** - * The source - * identifies the context in which an event happened. + * Deprecated, use {@code http.request.method} instead. + * + * @deprecated Deprecated, use `http.request.method` instead. */ - public static final AttributeKey CLOUDEVENTS_EVENT_SOURCE = - stringKey("cloudevents.event_source"); + @Deprecated public static final AttributeKey HTTP_METHOD = stringKey("http.method"); /** - * The version - * of the CloudEvents specification which the event uses. + * Deprecated, use {@code http.request.body.size} instead. + * + * @deprecated Deprecated, use `http.request.body.size` instead. */ - public static final AttributeKey CLOUDEVENTS_EVENT_SPEC_VERSION = - stringKey("cloudevents.event_spec_version"); + @Deprecated + public static final AttributeKey HTTP_REQUEST_CONTENT_LENGTH = + longKey("http.request_content_length"); /** - * The event_type - * contains a value describing the type of event related to the originating occurrence. + * Deprecated, use {@code http.response.body.size} instead. + * + * @deprecated Deprecated, use `http.response.body.size` instead. */ - public static final AttributeKey CLOUDEVENTS_EVENT_TYPE = - stringKey("cloudevents.event_type"); + @Deprecated + public static final AttributeKey HTTP_RESPONSE_CONTENT_LENGTH = + longKey("http.response_content_length"); /** - * The subject - * of the event in the context of the event producer (identified by source). + * Deprecated, use {@code url.scheme} instead. + * + * @deprecated Deprecated, use `url.scheme` instead. */ - public static final AttributeKey CLOUDEVENTS_EVENT_SUBJECT = - stringKey("cloudevents.event_subject"); + @Deprecated public static final AttributeKey HTTP_SCHEME = stringKey("http.scheme"); /** - * Parent-child Reference type - * - *

    Notes: + * Deprecated, use {@code http.response.status_code} instead. * - *

      - *
    • The causal relationship between a child Span and a parent Span. - *
    + * @deprecated Deprecated, use `http.response.status_code` instead. */ - public static final AttributeKey OPENTRACING_REF_TYPE = stringKey("opentracing.ref_type"); + @Deprecated public static final AttributeKey HTTP_STATUS_CODE = longKey("http.status_code"); /** - * An identifier for the database management system (DBMS) product being used. See below for a - * list of well-known identifiers. + * Deprecated, use {@code url.path} and {@code url.query} instead. + * + * @deprecated Deprecated, use `url.path` and `url.query` instead. */ - public static final AttributeKey DB_SYSTEM = stringKey("db.system"); + @Deprecated public static final AttributeKey HTTP_TARGET = stringKey("http.target"); /** - * The connection string used to connect to the database. It is recommended to remove embedded - * credentials. + * Deprecated, use {@code url.full} instead. + * + * @deprecated Deprecated, use `url.full` instead. */ - public static final AttributeKey DB_CONNECTION_STRING = stringKey("db.connection_string"); - - /** Username for accessing the database. */ - public static final AttributeKey DB_USER = stringKey("db.user"); + @Deprecated public static final AttributeKey HTTP_URL = stringKey("http.url"); /** - * The fully-qualified class name of the Java Database Connectivity - * (JDBC) driver used to connect. + * The size of the request payload body in bytes. This is the number of bytes transferred + * excluding headers and is often, but not always, present as the Content-Length + * header. For requests using transport encoding, this should be the compressed size. */ - public static final AttributeKey DB_JDBC_DRIVER_CLASSNAME = - stringKey("db.jdbc.driver_classname"); + public static final AttributeKey HTTP_REQUEST_BODY_SIZE = longKey("http.request.body.size"); /** - * This attribute is used to report the name of the database being accessed. For commands that - * switch the database, this should be set to the target database (even if the command fails). + * HTTP request method. * *

    Notes: * *

      - *
    • In some SQL databases, the database name to be used is called "schema name". In - * case there are multiple layers that could be considered for database name (e.g. Oracle - * instance name and schema name), the database name to be used is the more specific layer - * (e.g. Oracle schema name). + *
    • HTTP request method value SHOULD be "known" to the instrumentation. By default, + * this convention defines "known" methods as the ones listed in RFC9110 and the PATCH + * method defined in RFC5789. + *
    • If the HTTP request method is not known to instrumentation, it MUST set the {@code + * http.request.method} attribute to {@code _OTHER}. + *
    • If the HTTP instrumentation could end up converting valid HTTP request methods to {@code + * _OTHER}, then it MUST provide a way to override the list of known HTTP methods. If this + * override is done via environment variable, then the environment variable MUST be named + * OTEL_INSTRUMENTATION_HTTP_KNOWN_METHODS and support a comma-separated list of + * case-sensitive known HTTP methods (this list MUST be a full override of the default known + * method, it is not a list of known methods in addition to the defaults). + *
    • HTTP method names are case-sensitive and {@code http.request.method} attribute value MUST + * match a known HTTP method name exactly. Instrumentations for specific web frameworks that + * consider HTTP methods to be case insensitive, SHOULD populate a canonical equivalent. + * Tracing instrumentations that do so, MUST also set {@code http.request.method_original} + * to the original value. *
    */ - public static final AttributeKey DB_NAME = stringKey("db.name"); + public static final AttributeKey HTTP_REQUEST_METHOD = stringKey("http.request.method"); - /** The database statement being executed. */ - public static final AttributeKey DB_STATEMENT = stringKey("db.statement"); + /** Original HTTP method sent by the client in the request line. */ + public static final AttributeKey HTTP_REQUEST_METHOD_ORIGINAL = + stringKey("http.request.method_original"); /** - * The name of the operation being executed, e.g. the MongoDB command - * name such as {@code findAndModify}, or the SQL keyword. + * The ordinal number of request resending attempt (for any reason, including redirects). * *

    Notes: * *

      - *
    • When setting this to an SQL keyword, it is not recommended to attempt any client-side - * parsing of {@code db.statement} just to get this property, but it should be set if the - * operation name is provided by the library being instrumented. If the SQL statement has an - * ambiguous operation, or performs more than one operation, this value may be omitted. + *
    • The resend count SHOULD be updated each time an HTTP request gets resent by the client, + * regardless of what was the cause of the resending (e.g. redirection, authorization + * failure, 503 Server Unavailable, network issues, or any other). *
    */ - public static final AttributeKey DB_OPERATION = stringKey("db.operation"); + public static final AttributeKey HTTP_RESEND_COUNT = longKey("http.resend_count"); /** - * The Microsoft SQL Server instance - * name connecting to. This name is used to determine the port of a named instance. + * The size of the response payload body in bytes. This is the number of bytes transferred + * excluding headers and is often, but not always, present as the Content-Length + * header. For requests using transport encoding, this should be the compressed size. + */ + public static final AttributeKey HTTP_RESPONSE_BODY_SIZE = + longKey("http.response.body.size"); + + /** HTTP response status code. */ + public static final AttributeKey HTTP_RESPONSE_STATUS_CODE = + longKey("http.response.status_code"); + + /** + * The matched route (path template in the format used by the respective server framework). See + * note below * *

    Notes: * *

      - *
    • If setting a {@code db.mssql.instance_name}, {@code server.port} is no longer required - * (but still recommended if non-standard). + *
    • MUST NOT be populated when this is not supported by the HTTP server framework as the + * route attribute should have low-cardinality and the URI path can NOT substitute it. + * SHOULD include the application + * root if there is one. *
    */ - public static final AttributeKey DB_MSSQL_INSTANCE_NAME = - stringKey("db.mssql.instance_name"); - - /** The fetch size used for paging, i.e. how many rows will be returned at once. */ - public static final AttributeKey DB_CASSANDRA_PAGE_SIZE = longKey("db.cassandra.page_size"); + public static final AttributeKey HTTP_ROUTE = stringKey("http.route"); /** - * The consistency level of the query. Based on consistency values from CQL. + * Server address - domain name if available without reverse DNS lookup, otherwise IP address or + * Unix domain socket name. + * + *

    Notes: + * + *

      + *
    • When observed from the client side, and when communicating through an intermediary, + * {@code server.address} SHOULD represent the server address behind any intermediaries + * (e.g. proxies) if it's available. + *
    */ - public static final AttributeKey DB_CASSANDRA_CONSISTENCY_LEVEL = - stringKey("db.cassandra.consistency_level"); + public static final AttributeKey SERVER_ADDRESS = stringKey("server.address"); /** - * The name of the primary table that the operation is acting upon, including the keyspace name - * (if applicable). + * Server port number. * *

    Notes: * *

      - *
    • This mirrors the db.sql.table attribute but references cassandra rather than sql. It is - * not recommended to attempt any client-side parsing of {@code db.statement} just to get - * this property, but it should be set if it is provided by the library being instrumented. - * If the operation is acting upon an anonymous table, or more than one table, this value - * MUST NOT be set. + *
    • When observed from the client side, and when communicating through an intermediary, + * {@code server.port} SHOULD represent the server port behind any intermediaries (e.g. + * proxies) if it's available. *
    */ - public static final AttributeKey DB_CASSANDRA_TABLE = stringKey("db.cassandra.table"); + public static final AttributeKey SERVER_PORT = longKey("server.port"); - /** Whether or not the query is idempotent. */ - public static final AttributeKey DB_CASSANDRA_IDEMPOTENCE = - booleanKey("db.cassandra.idempotence"); + /** A unique id to identify a session. */ + public static final AttributeKey SESSION_ID = stringKey("session.id"); /** - * The number of times a query was speculatively executed. Not set or {@code 0} if the query was - * not executed speculatively. + * Source address - domain name if available without reverse DNS lookup, otherwise IP address or + * Unix domain socket name. + * + *

    Notes: + * + *

      + *
    • When observed from the destination side, and when communicating through an intermediary, + * {@code source.address} SHOULD represent the source address behind any intermediaries + * (e.g. proxies) if it's available. + *
    */ - public static final AttributeKey DB_CASSANDRA_SPECULATIVE_EXECUTION_COUNT = - longKey("db.cassandra.speculative_execution_count"); + public static final AttributeKey SOURCE_ADDRESS = stringKey("source.address"); - /** The ID of the coordinating node for a query. */ - public static final AttributeKey DB_CASSANDRA_COORDINATOR_ID = - stringKey("db.cassandra.coordinator.id"); + /** Source port number */ + public static final AttributeKey SOURCE_PORT = longKey("source.port"); + + /** + * The full invoked ARN as provided on the {@code Context} passed to the function ({@code + * Lambda-Runtime-Invoked-Function-Arn} header on the {@code /runtime/invocation/next} + * applicable). + * + *

    Notes: + * + *

      + *
    • This may be different from {@code cloud.resource_id} if an alias is involved. + *
    + */ + public static final AttributeKey AWS_LAMBDA_INVOKED_ARN = + stringKey("aws.lambda.invoked_arn"); + + /** + * The event_id + * uniquely identifies the event. + */ + public static final AttributeKey CLOUDEVENTS_EVENT_ID = stringKey("cloudevents.event_id"); + + /** + * The source + * identifies the context in which an event happened. + */ + public static final AttributeKey CLOUDEVENTS_EVENT_SOURCE = + stringKey("cloudevents.event_source"); + + /** + * The version + * of the CloudEvents specification which the event uses. + */ + public static final AttributeKey CLOUDEVENTS_EVENT_SPEC_VERSION = + stringKey("cloudevents.event_spec_version"); + + /** + * The subject + * of the event in the context of the event producer (identified by source). + */ + public static final AttributeKey CLOUDEVENTS_EVENT_SUBJECT = + stringKey("cloudevents.event_subject"); + + /** + * The event_type + * contains a value describing the type of event related to the originating occurrence. + */ + public static final AttributeKey CLOUDEVENTS_EVENT_TYPE = + stringKey("cloudevents.event_type"); + + /** + * Parent-child Reference type + * + *

    Notes: + * + *

      + *
    • The causal relationship between a child Span and a parent Span. + *
    + */ + public static final AttributeKey OPENTRACING_REF_TYPE = stringKey("opentracing.ref_type"); + + /** + * The connection string used to connect to the database. It is recommended to remove embedded + * credentials. + */ + public static final AttributeKey DB_CONNECTION_STRING = stringKey("db.connection_string"); + + /** + * The fully-qualified class name of the Java Database Connectivity + * (JDBC) driver used to connect. + */ + public static final AttributeKey DB_JDBC_DRIVER_CLASSNAME = + stringKey("db.jdbc.driver_classname"); + + /** + * This attribute is used to report the name of the database being accessed. For commands that + * switch the database, this should be set to the target database (even if the command fails). + * + *

    Notes: + * + *

      + *
    • In some SQL databases, the database name to be used is called "schema name". In + * case there are multiple layers that could be considered for database name (e.g. Oracle + * instance name and schema name), the database name to be used is the more specific layer + * (e.g. Oracle schema name). + *
    + */ + public static final AttributeKey DB_NAME = stringKey("db.name"); + + /** + * The name of the operation being executed, e.g. the MongoDB command + * name such as {@code findAndModify}, or the SQL keyword. + * + *

    Notes: + * + *

      + *
    • When setting this to an SQL keyword, it is not recommended to attempt any client-side + * parsing of {@code db.statement} just to get this property, but it should be set if the + * operation name is provided by the library being instrumented. If the SQL statement has an + * ambiguous operation, or performs more than one operation, this value may be omitted. + *
    + */ + public static final AttributeKey DB_OPERATION = stringKey("db.operation"); + + /** The database statement being executed. */ + public static final AttributeKey DB_STATEMENT = stringKey("db.statement"); + + /** + * An identifier for the database management system (DBMS) product being used. See below for a + * list of well-known identifiers. + */ + public static final AttributeKey DB_SYSTEM = stringKey("db.system"); + + /** Username for accessing the database. */ + public static final AttributeKey DB_USER = stringKey("db.user"); + + /** + * The Microsoft SQL Server instance + * name connecting to. This name is used to determine the port of a named instance. + * + *

    Notes: + * + *

      + *
    • If setting a {@code db.mssql.instance_name}, {@code server.port} is no longer required + * (but still recommended if non-standard). + *
    + */ + public static final AttributeKey DB_MSSQL_INSTANCE_NAME = + stringKey("db.mssql.instance_name"); + + /** + * The consistency level of the query. Based on consistency values from CQL. + */ + public static final AttributeKey DB_CASSANDRA_CONSISTENCY_LEVEL = + stringKey("db.cassandra.consistency_level"); /** The data center of the coordinating node for a query. */ public static final AttributeKey DB_CASSANDRA_COORDINATOR_DC = stringKey("db.cassandra.coordinator.dc"); + /** The ID of the coordinating node for a query. */ + public static final AttributeKey DB_CASSANDRA_COORDINATOR_ID = + stringKey("db.cassandra.coordinator.id"); + + /** Whether or not the query is idempotent. */ + public static final AttributeKey DB_CASSANDRA_IDEMPOTENCE = + booleanKey("db.cassandra.idempotence"); + + /** The fetch size used for paging, i.e. how many rows will be returned at once. */ + public static final AttributeKey DB_CASSANDRA_PAGE_SIZE = longKey("db.cassandra.page_size"); + + /** + * The number of times a query was speculatively executed. Not set or {@code 0} if the query was + * not executed speculatively. + */ + public static final AttributeKey DB_CASSANDRA_SPECULATIVE_EXECUTION_COUNT = + longKey("db.cassandra.speculative_execution_count"); + + /** + * The name of the primary table that the operation is acting upon, including the keyspace name + * (if applicable). + * + *

    Notes: + * + *

      + *
    • This mirrors the db.sql.table attribute but references cassandra rather than sql. It is + * not recommended to attempt any client-side parsing of {@code db.statement} just to get + * this property, but it should be set if it is provided by the library being instrumented. + * If the operation is acting upon an anonymous table, or more than one table, this value + * MUST NOT be set. + *
    + */ + public static final AttributeKey DB_CASSANDRA_TABLE = stringKey("db.cassandra.table"); + /** * The index of the database being accessed as used in the {@code SELECT} command, provided as an integer. To @@ -598,6 +916,16 @@ public final class SemanticAttributes { public static final AttributeKey DB_MONGODB_COLLECTION = stringKey("db.mongodb.collection"); + /** Represents the identifier of an Elasticsearch cluster. */ + public static final AttributeKey DB_ELASTICSEARCH_CLUSTER_NAME = + stringKey("db.elasticsearch.cluster.name"); + + /** + * Represents the human-readable identifier of the node/instance to which a request was routed. + */ + public static final AttributeKey DB_ELASTICSEARCH_NODE_NAME = + stringKey("db.elasticsearch.node.name"); + /** * The name of the primary table that the operation is acting upon, including the database name * (if applicable). @@ -617,10 +945,6 @@ public final class SemanticAttributes { public static final AttributeKey DB_COSMOSDB_CLIENT_ID = stringKey("db.cosmosdb.client_id"); - /** CosmosDB Operation Type. */ - public static final AttributeKey DB_COSMOSDB_OPERATION_TYPE = - stringKey("db.cosmosdb.operation_type"); - /** Cosmos client connection mode. */ public static final AttributeKey DB_COSMOSDB_CONNECTION_MODE = stringKey("db.cosmosdb.connection_mode"); @@ -629,6 +953,14 @@ public final class SemanticAttributes { public static final AttributeKey DB_COSMOSDB_CONTAINER = stringKey("db.cosmosdb.container"); + /** CosmosDB Operation Type. */ + public static final AttributeKey DB_COSMOSDB_OPERATION_TYPE = + stringKey("db.cosmosdb.operation_type"); + + /** RU consumed for that operation */ + public static final AttributeKey DB_COSMOSDB_REQUEST_CHARGE = + doubleKey("db.cosmosdb.request_charge"); + /** Request payload size in bytes */ public static final AttributeKey DB_COSMOSDB_REQUEST_CONTENT_LENGTH = longKey("db.cosmosdb.request_content_length"); @@ -641,10 +973,6 @@ public final class SemanticAttributes { public static final AttributeKey DB_COSMOSDB_SUB_STATUS_CODE = longKey("db.cosmosdb.sub_status_code"); - /** RU consumed for that operation */ - public static final AttributeKey DB_COSMOSDB_REQUEST_CHARGE = - doubleKey("db.cosmosdb.request_charge"); - /** * Name of the code, either "OK" or "ERROR". MUST NOT be set if the status * code is UNSET. @@ -655,22 +983,6 @@ public final class SemanticAttributes { public static final AttributeKey OTEL_STATUS_DESCRIPTION = stringKey("otel.status_description"); - /** - * Type of the trigger which caused this function invocation. - * - *

    Notes: - * - *

      - *
    • For the server/consumer span on the incoming side, {@code faas.trigger} MUST be set. - *
    • Clients invoking FaaS instances usually cannot set {@code faas.trigger}, since they would - * typically need to look in the payload to determine the event type. If clients set it, it - * should be the same as the trigger that corresponding incoming would have (i.e., this has - * nothing to do with the underlying transport used to make the API call to invoke the - * lambda, which is often HTTP). - *
    - */ - public static final AttributeKey FAAS_TRIGGER = stringKey("faas.trigger"); - /** The invocation ID of the current function invocation. */ public static final AttributeKey FAAS_INVOCATION_ID = stringKey("faas.invocation_id"); @@ -681,6 +993,12 @@ public final class SemanticAttributes { public static final AttributeKey FAAS_DOCUMENT_COLLECTION = stringKey("faas.document.collection"); + /** + * The document name/table subjected to the operation. For example, in Cloud Storage or S3 is the + * name of the file, and in Cosmos DB the table name. + */ + public static final AttributeKey FAAS_DOCUMENT_NAME = stringKey("faas.document.name"); + /** Describes the type of the operation that was performed on the data. */ public static final AttributeKey FAAS_DOCUMENT_OPERATION = stringKey("faas.document.operation"); @@ -693,10 +1011,11 @@ public final class SemanticAttributes { public static final AttributeKey FAAS_DOCUMENT_TIME = stringKey("faas.document.time"); /** - * The document name/table subjected to the operation. For example, in Cloud Storage or S3 is the - * name of the file, and in Cosmos DB the table name. + * A string containing the schedule period as Cron + * Expression. */ - public static final AttributeKey FAAS_DOCUMENT_NAME = stringKey("faas.document.name"); + public static final AttributeKey FAAS_CRON = stringKey("faas.cron"); /** * A string containing the function invocation time in the FAAS_TIME = stringKey("faas.time"); - /** - * A string containing the schedule period as Cron - * Expression. - */ - public static final AttributeKey FAAS_CRON = stringKey("faas.cron"); - /** * A boolean that is true if the serverless function is executed for the first time (aka * cold-start). */ public static final AttributeKey FAAS_COLDSTART = booleanKey("faas.coldstart"); + /** The unique identifier of the feature flag. */ + public static final AttributeKey FEATURE_FLAG_KEY = stringKey("feature_flag.key"); + + /** The name of the service provider that performs the flag evaluation. */ + public static final AttributeKey FEATURE_FLAG_PROVIDER_NAME = + stringKey("feature_flag.provider_name"); + /** - * The name of the invoked function. - * - *

    Notes: - * - *

      - *
    • SHOULD be equal to the {@code faas.name} resource attribute of the invoked function. - *
    - */ - public static final AttributeKey FAAS_INVOKED_NAME = stringKey("faas.invoked_name"); - - /** - * The cloud provider of the invoked function. - * - *

    Notes: - * - *

      - *
    • SHOULD be equal to the {@code cloud.provider} resource attribute of the invoked function. - *
    - */ - public static final AttributeKey FAAS_INVOKED_PROVIDER = - stringKey("faas.invoked_provider"); - - /** - * The cloud region of the invoked function. - * - *

    Notes: - * - *

      - *
    • SHOULD be equal to the {@code cloud.region} resource attribute of the invoked function. - *
    - */ - public static final AttributeKey FAAS_INVOKED_REGION = stringKey("faas.invoked_region"); - - /** The unique identifier of the feature flag. */ - public static final AttributeKey FEATURE_FLAG_KEY = stringKey("feature_flag.key"); - - /** The name of the service provider that performs the flag evaluation. */ - public static final AttributeKey FEATURE_FLAG_PROVIDER_NAME = - stringKey("feature_flag.provider_name"); - - /** - * SHOULD be a semantic identifier for a value. If one is unavailable, a stringified version of - * the value can be used. + * SHOULD be a semantic identifier for a value. If one is unavailable, a stringified version of + * the value can be used. * *

    Notes: * @@ -777,182 +1055,39 @@ public final class SemanticAttributes { */ public static final AttributeKey FEATURE_FLAG_VARIANT = stringKey("feature_flag.variant"); - /** - * OSI Transport Layer or Inter-process Communication - * method. The value SHOULD be normalized to lowercase. - */ - public static final AttributeKey NETWORK_TRANSPORT = stringKey("network.transport"); - - /** - * OSI Network Layer or non-OSI equivalent. The - * value SHOULD be normalized to lowercase. - */ - public static final AttributeKey NETWORK_TYPE = stringKey("network.type"); - - /** - * OSI Application Layer or non-OSI - * equivalent. The value SHOULD be normalized to lowercase. - */ - public static final AttributeKey NETWORK_PROTOCOL_NAME = - stringKey("network.protocol.name"); - - /** - * Version of the application layer protocol used. See note below. - * - *

    Notes: - * - *

      - *
    • {@code network.protocol.version} refers to the version of the protocol used and might be - * different from the protocol client's version. If the HTTP client used has a version of - * {@code 0.27.2}, but sends HTTP version {@code 1.1}, this attribute should be set to - * {@code 1.1}. - *
    - */ - public static final AttributeKey NETWORK_PROTOCOL_VERSION = - stringKey("network.protocol.version"); - - /** The internet connection type. */ - public static final AttributeKey NETWORK_CONNECTION_TYPE = - stringKey("network.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. - */ - public static final AttributeKey NETWORK_CONNECTION_SUBTYPE = - stringKey("network.connection.subtype"); - - /** The name of the mobile carrier. */ - public static final AttributeKey NETWORK_CARRIER_NAME = stringKey("network.carrier.name"); - - /** The mobile carrier country code. */ - public static final AttributeKey NETWORK_CARRIER_MCC = stringKey("network.carrier.mcc"); - - /** The mobile carrier network code. */ - public static final AttributeKey NETWORK_CARRIER_MNC = stringKey("network.carrier.mnc"); - - /** The ISO 3166-1 alpha-2 2-character country code associated with the mobile carrier network. */ - public static final AttributeKey NETWORK_CARRIER_ICC = stringKey("network.carrier.icc"); - - /** - * The {@code service.name} of the remote service. - * SHOULD be equal to the actual {@code service.name} resource attribute of the remote service if - * any. - */ - public static final AttributeKey PEER_SERVICE = stringKey("peer.service"); - - /** - * Username or client_id extracted from the access token or Authorization header in the inbound - * request from outside the system. - */ - public static final AttributeKey ENDUSER_ID = stringKey("enduser.id"); - - /** - * Actual/assumed role the client is making the request under extracted from token or application - * security context. - */ - public static final AttributeKey ENDUSER_ROLE = stringKey("enduser.role"); - - /** - * Scopes or granted authorities the client currently possesses extracted from token or - * application security context. The value would come from the scope associated with an OAuth 2.0 Access Token or an - * attribute value in a SAML - * 2.0 Assertion. - */ - public static final AttributeKey ENDUSER_SCOPE = stringKey("enduser.scope"); - - /** Current "managed" thread ID (as opposed to OS thread ID). */ - public static final AttributeKey THREAD_ID = longKey("thread.id"); - - /** Current thread name. */ - public static final AttributeKey THREAD_NAME = stringKey("thread.name"); - - /** - * The method or function name, or equivalent (usually rightmost part of the code unit's name). - */ - public static final AttributeKey CODE_FUNCTION = stringKey("code.function"); - - /** - * The "namespace" within which {@code code.function} is defined. Usually the qualified - * class or module name, such that {@code code.namespace} + some separator + {@code code.function} - * form a unique identifier for the code unit. - */ - public static final AttributeKey CODE_NAMESPACE = stringKey("code.namespace"); - - /** - * The source code file name that identifies the code unit as uniquely as possible (preferably an - * absolute file path). - */ - public static final AttributeKey CODE_FILEPATH = stringKey("code.filepath"); - - /** - * The line number in {@code code.filepath} best representing the operation. It SHOULD point - * within the code unit named in {@code code.function}. - */ - public static final AttributeKey CODE_LINENO = longKey("code.lineno"); - - /** - * The column number in {@code code.filepath} best representing the operation. It SHOULD point - * within the code unit named in {@code code.function}. - */ - public static final AttributeKey CODE_COLUMN = longKey("code.column"); - - /** Original HTTP method sent by the client in the request line. */ - public static final AttributeKey HTTP_REQUEST_METHOD_ORIGINAL = - stringKey("http.request.method_original"); - - /** - * The size of the request payload body in bytes. This is the number of bytes transferred - * excluding headers and is often, but not always, present as the Content-Length - * header. For requests using transport encoding, this should be the compressed size. - */ - public static final AttributeKey HTTP_REQUEST_BODY_SIZE = longKey("http.request.body.size"); - - /** - * The size of the response payload body in bytes. This is the number of bytes transferred - * excluding headers and is often, but not always, present as the Content-Length - * header. For requests using transport encoding, this should be the compressed size. - */ - public static final AttributeKey HTTP_RESPONSE_BODY_SIZE = - longKey("http.response.body.size"); - - /** - * The ordinal number of request resending attempt (for any reason, including redirects). - * - *

    Notes: - * - *

      - *
    • The resend count SHOULD be updated each time an HTTP request gets resent by the client, - * regardless of what was the cause of the resending (e.g. redirection, authorization - * failure, 503 Server Unavailable, network issues, or any other). - *
    - */ - public static final AttributeKey HTTP_RESEND_COUNT = longKey("http.resend_count"); - /** * The AWS request ID as returned in the response headers {@code x-amz-request-id} or {@code * x-amz-requestid}. */ public static final AttributeKey AWS_REQUEST_ID = stringKey("aws.request_id"); - /** The keys in the {@code RequestItems} object field. */ - public static final AttributeKey> AWS_DYNAMODB_TABLE_NAMES = - stringArrayKey("aws.dynamodb.table_names"); + /** The value of the {@code AttributesToGet} request parameter. */ + public static final AttributeKey> AWS_DYNAMODB_ATTRIBUTES_TO_GET = + stringArrayKey("aws.dynamodb.attributes_to_get"); + + /** The value of the {@code ConsistentRead} request parameter. */ + public static final AttributeKey AWS_DYNAMODB_CONSISTENT_READ = + booleanKey("aws.dynamodb.consistent_read"); /** The JSON-serialized value of each item in the {@code ConsumedCapacity} response field. */ public static final AttributeKey> AWS_DYNAMODB_CONSUMED_CAPACITY = stringArrayKey("aws.dynamodb.consumed_capacity"); + /** The value of the {@code IndexName} request parameter. */ + public static final AttributeKey AWS_DYNAMODB_INDEX_NAME = + stringKey("aws.dynamodb.index_name"); + /** The JSON-serialized value of the {@code ItemCollectionMetrics} response field. */ public static final AttributeKey AWS_DYNAMODB_ITEM_COLLECTION_METRICS = stringKey("aws.dynamodb.item_collection_metrics"); + /** The value of the {@code Limit} request parameter. */ + public static final AttributeKey AWS_DYNAMODB_LIMIT = longKey("aws.dynamodb.limit"); + + /** The value of the {@code ProjectionExpression} request parameter. */ + public static final AttributeKey AWS_DYNAMODB_PROJECTION = + stringKey("aws.dynamodb.projection"); + /** The value of the {@code ProvisionedThroughput.ReadCapacityUnits} request parameter. */ public static final AttributeKey AWS_DYNAMODB_PROVISIONED_READ_CAPACITY = doubleKey("aws.dynamodb.provisioned_read_capacity"); @@ -961,28 +1096,13 @@ public final class SemanticAttributes { public static final AttributeKey AWS_DYNAMODB_PROVISIONED_WRITE_CAPACITY = doubleKey("aws.dynamodb.provisioned_write_capacity"); - /** The value of the {@code ConsistentRead} request parameter. */ - public static final AttributeKey AWS_DYNAMODB_CONSISTENT_READ = - booleanKey("aws.dynamodb.consistent_read"); - - /** The value of the {@code ProjectionExpression} request parameter. */ - public static final AttributeKey AWS_DYNAMODB_PROJECTION = - stringKey("aws.dynamodb.projection"); - - /** The value of the {@code Limit} request parameter. */ - public static final AttributeKey AWS_DYNAMODB_LIMIT = longKey("aws.dynamodb.limit"); - - /** The value of the {@code AttributesToGet} request parameter. */ - public static final AttributeKey> AWS_DYNAMODB_ATTRIBUTES_TO_GET = - stringArrayKey("aws.dynamodb.attributes_to_get"); - - /** The value of the {@code IndexName} request parameter. */ - public static final AttributeKey AWS_DYNAMODB_INDEX_NAME = - stringKey("aws.dynamodb.index_name"); - /** The value of the {@code Select} request parameter. */ public static final AttributeKey AWS_DYNAMODB_SELECT = stringKey("aws.dynamodb.select"); + /** The keys in the {@code RequestItems} object field. */ + public static final AttributeKey> AWS_DYNAMODB_TABLE_NAMES = + stringArrayKey("aws.dynamodb.table_names"); + /** The JSON-serialized value of each item of the {@code GlobalSecondaryIndexes} request field */ public static final AttributeKey> AWS_DYNAMODB_GLOBAL_SECONDARY_INDEXES = stringArrayKey("aws.dynamodb.global_secondary_indexes"); @@ -1003,13 +1123,6 @@ public final class SemanticAttributes { public static final AttributeKey AWS_DYNAMODB_SCAN_FORWARD = booleanKey("aws.dynamodb.scan_forward"); - /** The value of the {@code Segment} request parameter. */ - public static final AttributeKey AWS_DYNAMODB_SEGMENT = longKey("aws.dynamodb.segment"); - - /** The value of the {@code TotalSegments} request parameter. */ - public static final AttributeKey AWS_DYNAMODB_TOTAL_SEGMENTS = - longKey("aws.dynamodb.total_segments"); - /** The value of the {@code Count} response parameter. */ public static final AttributeKey AWS_DYNAMODB_COUNT = longKey("aws.dynamodb.count"); @@ -1017,6 +1130,13 @@ public final class SemanticAttributes { public static final AttributeKey AWS_DYNAMODB_SCANNED_COUNT = longKey("aws.dynamodb.scanned_count"); + /** The value of the {@code Segment} request parameter. */ + public static final AttributeKey AWS_DYNAMODB_SEGMENT = longKey("aws.dynamodb.segment"); + + /** The value of the {@code TotalSegments} request parameter. */ + public static final AttributeKey AWS_DYNAMODB_TOTAL_SEGMENTS = + longKey("aws.dynamodb.total_segments"); + /** The JSON-serialized value of each item in the {@code AttributeDefinitions} request field. */ public static final AttributeKey> AWS_DYNAMODB_ATTRIBUTE_DEFINITIONS = stringArrayKey("aws.dynamodb.attribute_definitions"); @@ -1044,15 +1164,49 @@ public final class SemanticAttributes { public static final AttributeKey AWS_S3_BUCKET = stringKey("aws.s3.bucket"); /** - * The S3 object key the request refers to. Corresponds to the {@code --key} parameter of the S3 API operations. + * The source object (in the form {@code bucket}/{@code key}) for the copy operation. * *

    Notes: * *

      - *
    • The {@code key} attribute is applicable to all object-related S3 operations, i.e. that - * require the object key as a mandatory parameter. This applies in particular to the - * following operations: + *
    • The {@code copy_source} attribute applies to S3 copy operations and corresponds to the + * {@code --copy-source} parameter of the copy-object + * operation within the S3 API. This applies in particular to the following operations: + *
    • copy-object + *
    • upload-part-copy + *
    + */ + public static final AttributeKey AWS_S3_COPY_SOURCE = stringKey("aws.s3.copy_source"); + + /** + * The delete request container that specifies the objects to be deleted. + * + *

    Notes: + * + *

    + */ + public static final AttributeKey AWS_S3_DELETE = stringKey("aws.s3.delete"); + + /** + * The S3 object key the request refers to. Corresponds to the {@code --key} parameter of the S3 API operations. + * + *

    Notes: + * + *

    */ public static final AttributeKey EXCEPTION_ESCAPED = booleanKey("exception.escaped"); - - /** - * The URI scheme component - * identifying the used protocol. - */ - public static final AttributeKey URL_SCHEME = stringKey("url.scheme"); + + /** The URI fragment component */ + public static final AttributeKey URL_FRAGMENT = stringKey("url.fragment"); /** * Absolute URL describing a network resource according to URL_QUERY = stringKey("url.query"); - /** The URI fragment component */ - public static final AttributeKey URL_FRAGMENT = stringKey("url.fragment"); + /** + * The URI scheme component + * identifying the used protocol. + */ + public static final AttributeKey URL_SCHEME = stringKey("url.scheme"); /** * Value of the HTTP @@ -1533,6 +1689,19 @@ public final class SemanticAttributes { public static final AttributeKey USER_AGENT_ORIGINAL = stringKey("user_agent.original"); // Enum definitions + public static final class NetSockFamilyValues { + /** IPv4 address. */ + public static final String INET = "inet"; + + /** IPv6 address. */ + public static final String INET6 = "inet6"; + + /** Unix domain socket path. */ + public static final String UNIX = "unix"; + + private NetSockFamilyValues() {} + } + public static final class NetTransportValues { /** ip_tcp. */ public static final String IP_TCP = "ip_tcp"; @@ -1543,26 +1712,404 @@ public static final class NetTransportValues { /** Named or anonymous pipe. */ public static final String PIPE = "pipe"; - /** In-process communication. */ - public static final String INPROC = "inproc"; + /** In-process communication. */ + public static final String INPROC = "inproc"; + + /** Something else (non IP-based). */ + public static final String OTHER = "other"; + + private NetTransportValues() {} + } + + public static final class ErrorTypeValues { + /** + * A fallback error value to be used when the instrumentation does not define a custom value for + * it. + */ + public static final String OTHER = "_OTHER"; + + private ErrorTypeValues() {} + } + + public static final class FaasInvokedProviderValues { + /** Alibaba Cloud. */ + public static final String ALIBABA_CLOUD = "alibaba_cloud"; + + /** Amazon Web Services. */ + public static final String AWS = "aws"; + + /** Microsoft Azure. */ + public static final String AZURE = "azure"; + + /** Google Cloud Platform. */ + public static final String GCP = "gcp"; + + /** Tencent Cloud. */ + public static final String TENCENT_CLOUD = "tencent_cloud"; + + private FaasInvokedProviderValues() {} + } + + public static final class FaasTriggerValues { + /** A response to some data source operation such as a database or filesystem read/write. */ + public static final String DATASOURCE = "datasource"; + + /** To provide an answer to an inbound HTTP request. */ + public static final String HTTP = "http"; + + /** A function is set to be executed when messages are sent to a messaging system. */ + public static final String PUBSUB = "pubsub"; + + /** A function is scheduled to be executed regularly. */ + public static final String TIMER = "timer"; + + /** If none of the others apply. */ + public static final String OTHER = "other"; + + private FaasTriggerValues() {} + } + + public static final class EventDomainValues { + /** Events from browser apps. */ + public static final String BROWSER = "browser"; + + /** Events from mobile apps. */ + public static final String DEVICE = "device"; + + /** Events from Kubernetes. */ + public static final String K8S = "k8s"; + + private EventDomainValues() {} + } + + public static final class LogIostreamValues { + /** Logs from stdout stream. */ + public static final String STDOUT = "stdout"; + + /** Events from stderr stream. */ + public static final String STDERR = "stderr"; + + private LogIostreamValues() {} + } + + public static final class StateValues { + /** idle. */ + public static final String IDLE = "idle"; + + /** used. */ + public static final String USED = "used"; + + private StateValues() {} + } + + public static final class JvmMemoryTypeValues { + /** Heap memory. */ + public static final String HEAP = "heap"; + + /** Non-heap memory. */ + public static final String NON_HEAP = "non_heap"; + + private JvmMemoryTypeValues() {} + } + + public static final class SystemCpuStateValues { + /** user. */ + public static final String USER = "user"; + + /** system. */ + public static final String SYSTEM = "system"; + + /** nice. */ + public static final String NICE = "nice"; + + /** idle. */ + public static final String IDLE = "idle"; + + /** iowait. */ + public static final String IOWAIT = "iowait"; + + /** interrupt. */ + public static final String INTERRUPT = "interrupt"; + + /** steal. */ + public static final String STEAL = "steal"; + + private SystemCpuStateValues() {} + } + + public static final class SystemMemoryStateValues { + /** total. */ + public static final String TOTAL = "total"; + + /** used. */ + public static final String USED = "used"; + + /** free. */ + public static final String FREE = "free"; + + /** shared. */ + public static final String SHARED = "shared"; + + /** buffers. */ + public static final String BUFFERS = "buffers"; + + /** cached. */ + public static final String CACHED = "cached"; + + private SystemMemoryStateValues() {} + } + + public static final class SystemPagingDirectionValues { + /** in. */ + public static final String IN = "in"; + + /** out. */ + public static final String OUT = "out"; + + private SystemPagingDirectionValues() {} + } + + public static final class SystemPagingStateValues { + /** used. */ + public static final String USED = "used"; + + /** free. */ + public static final String FREE = "free"; + + private SystemPagingStateValues() {} + } + + public static final class SystemPagingTypeValues { + /** major. */ + public static final String MAJOR = "major"; + + /** minor. */ + public static final String MINOR = "minor"; + + private SystemPagingTypeValues() {} + } + + public static final class SystemDiskDirectionValues { + /** read. */ + public static final String READ = "read"; + + /** write. */ + public static final String WRITE = "write"; + + private SystemDiskDirectionValues() {} + } + + public static final class SystemFilesystemStateValues { + /** used. */ + public static final String USED = "used"; + + /** free. */ + public static final String FREE = "free"; + + /** reserved. */ + public static final String RESERVED = "reserved"; + + private SystemFilesystemStateValues() {} + } + + public static final class SystemFilesystemTypeValues { + /** fat32. */ + public static final String FAT32 = "fat32"; + + /** exfat. */ + public static final String EXFAT = "exfat"; + + /** ntfs. */ + public static final String NTFS = "ntfs"; + + /** refs. */ + public static final String REFS = "refs"; + + /** hfsplus. */ + public static final String HFSPLUS = "hfsplus"; + + /** ext4. */ + public static final String EXT4 = "ext4"; + + private SystemFilesystemTypeValues() {} + } + + public static final class SystemNetworkDirectionValues { + /** transmit. */ + public static final String TRANSMIT = "transmit"; + + /** receive. */ + public static final String RECEIVE = "receive"; + + private SystemNetworkDirectionValues() {} + } + + public static final class SystemNetworkStateValues { + /** close. */ + public static final String CLOSE = "close"; + + /** close_wait. */ + public static final String CLOSE_WAIT = "close_wait"; + + /** closing. */ + public static final String CLOSING = "closing"; + + /** delete. */ + public static final String DELETE = "delete"; + + /** established. */ + public static final String ESTABLISHED = "established"; + + /** fin_wait_1. */ + public static final String FIN_WAIT_1 = "fin_wait_1"; + + /** fin_wait_2. */ + public static final String FIN_WAIT_2 = "fin_wait_2"; + + /** last_ack. */ + public static final String LAST_ACK = "last_ack"; + + /** listen. */ + public static final String LISTEN = "listen"; + + /** syn_recv. */ + public static final String SYN_RECV = "syn_recv"; + + /** syn_sent. */ + public static final String SYN_SENT = "syn_sent"; + + /** time_wait. */ + public static final String TIME_WAIT = "time_wait"; + + private SystemNetworkStateValues() {} + } + + public static final class SystemProcessesStatusValues { + /** running. */ + public static final String RUNNING = "running"; + + /** sleeping. */ + public static final String SLEEPING = "sleeping"; + + /** stopped. */ + public static final String STOPPED = "stopped"; + + /** defunct. */ + public static final String DEFUNCT = "defunct"; + + private SystemProcessesStatusValues() {} + } + + public static final class NetworkTransportValues { + /** TCP. */ + public static final String TCP = "tcp"; + + /** UDP. */ + public static final String UDP = "udp"; + + /** Named or anonymous pipe. See note below. */ + public static final String PIPE = "pipe"; + + /** Unix domain socket. */ + public static final String UNIX = "unix"; + + private NetworkTransportValues() {} + } + + public static final class NetworkTypeValues { + /** IPv4. */ + public static final String IPV4 = "ipv4"; + + /** IPv6. */ + public static final String IPV6 = "ipv6"; + + private NetworkTypeValues() {} + } + + public static final class NetworkConnectionSubtypeValues { + /** GPRS. */ + public static final String GPRS = "gprs"; + + /** EDGE. */ + public static final String EDGE = "edge"; + + /** UMTS. */ + public static final String UMTS = "umts"; + + /** CDMA. */ + public static final String CDMA = "cdma"; + + /** EVDO Rel. 0. */ + public static final String EVDO_0 = "evdo_0"; + + /** EVDO Rev. A. */ + public static final String EVDO_A = "evdo_a"; + + /** CDMA2000 1XRTT. */ + public static final String CDMA2000_1XRTT = "cdma2000_1xrtt"; + + /** HSDPA. */ + public static final String HSDPA = "hsdpa"; + + /** HSUPA. */ + public static final String HSUPA = "hsupa"; + + /** HSPA. */ + public static final String HSPA = "hspa"; + + /** IDEN. */ + public static final String IDEN = "iden"; + + /** EVDO Rev. B. */ + public static final String EVDO_B = "evdo_b"; + + /** LTE. */ + public static final String LTE = "lte"; + + /** EHRPD. */ + public static final String EHRPD = "ehrpd"; + + /** HSPAP. */ + public static final String HSPAP = "hspap"; + + /** GSM. */ + public static final String GSM = "gsm"; + + /** TD-SCDMA. */ + public static final String TD_SCDMA = "td_scdma"; + + /** IWLAN. */ + public static final String IWLAN = "iwlan"; + + /** 5G NR (New Radio). */ + public static final String NR = "nr"; - /** Something else (non IP-based). */ - public static final String OTHER = "other"; + /** 5G NRNSA (New Radio Non-Standalone). */ + public static final String NRNSA = "nrnsa"; - private NetTransportValues() {} + /** LTE CA. */ + public static final String LTE_CA = "lte_ca"; + + private NetworkConnectionSubtypeValues() {} } - public static final class NetSockFamilyValues { - /** IPv4 address. */ - public static final String INET = "inet"; + public static final class NetworkConnectionTypeValues { + /** wifi. */ + public static final String WIFI = "wifi"; - /** IPv6 address. */ - public static final String INET6 = "inet6"; + /** wired. */ + public static final String WIRED = "wired"; - /** Unix domain socket path. */ - public static final String UNIX = "unix"; + /** cell. */ + public static final String CELL = "cell"; - private NetSockFamilyValues() {} + /** unavailable. */ + public static final String UNAVAILABLE = "unavailable"; + + /** unknown. */ + public static final String UNKNOWN = "unknown"; + + private NetworkConnectionTypeValues() {} } public static final class HttpRequestMethodValues { @@ -1599,39 +2146,6 @@ public static final class HttpRequestMethodValues { private HttpRequestMethodValues() {} } - public static final class EventDomainValues { - /** Events from browser apps. */ - public static final String BROWSER = "browser"; - - /** Events from mobile apps. */ - public static final String DEVICE = "device"; - - /** Events from Kubernetes. */ - public static final String K8S = "k8s"; - - private EventDomainValues() {} - } - - public static final class LogIostreamValues { - /** Logs from stdout stream. */ - public static final String STDOUT = "stdout"; - - /** Events from stderr stream. */ - public static final String STDERR = "stderr"; - - private LogIostreamValues() {} - } - - public static final class TypeValues { - /** Heap memory. */ - public static final String HEAP = "heap"; - - /** Non-heap memory. */ - public static final String NON_HEAP = "non_heap"; - - private TypeValues() {} - } - public static final class OpentracingRefTypeValues { /** The parent Span depends on the child Span in some capacity. */ public static final String CHILD_OF = "child_of"; @@ -1839,6 +2353,16 @@ public static final class DbCassandraConsistencyLevelValues { private DbCassandraConsistencyLevelValues() {} } + public static final class DbCosmosdbConnectionModeValues { + /** Gateway (HTTP) connections mode. */ + public static final String GATEWAY = "gateway"; + + /** Direct connection. */ + public static final String DIRECT = "direct"; + + private DbCosmosdbConnectionModeValues() {} + } + public static final class DbCosmosdbOperationTypeValues { /** invalid. */ public static final String INVALID = "Invalid"; @@ -1888,16 +2412,6 @@ public static final class DbCosmosdbOperationTypeValues { private DbCosmosdbOperationTypeValues() {} } - public static final class DbCosmosdbConnectionModeValues { - /** Gateway (HTTP) connections mode. */ - public static final String GATEWAY = "gateway"; - - /** Direct connection. */ - public static final String DIRECT = "direct"; - - private DbCosmosdbConnectionModeValues() {} - } - public static final class OtelStatusCodeValues { /** * The operation has been validated by an Application developer or Operator to have completed @@ -1911,25 +2425,6 @@ public static final class OtelStatusCodeValues { private OtelStatusCodeValues() {} } - public static final class FaasTriggerValues { - /** A response to some data source operation such as a database or filesystem read/write. */ - public static final String DATASOURCE = "datasource"; - - /** To provide an answer to an inbound HTTP request. */ - public static final String HTTP = "http"; - - /** A function is set to be executed when messages are sent to a messaging system. */ - public static final String PUBSUB = "pubsub"; - - /** A function is scheduled to be executed regularly. */ - public static final String TIMER = "timer"; - - /** If none of the others apply. */ - public static final String OTHER = "other"; - - private FaasTriggerValues() {} - } - public static final class FaasDocumentOperationValues { /** When a new object is created. */ public static final String INSERT = "insert"; @@ -1943,137 +2438,6 @@ public static final class FaasDocumentOperationValues { private FaasDocumentOperationValues() {} } - public static final class FaasInvokedProviderValues { - /** Alibaba Cloud. */ - public static final String ALIBABA_CLOUD = "alibaba_cloud"; - - /** Amazon Web Services. */ - public static final String AWS = "aws"; - - /** Microsoft Azure. */ - public static final String AZURE = "azure"; - - /** Google Cloud Platform. */ - public static final String GCP = "gcp"; - - /** Tencent Cloud. */ - public static final String TENCENT_CLOUD = "tencent_cloud"; - - private FaasInvokedProviderValues() {} - } - - public static final class NetworkTransportValues { - /** TCP. */ - public static final String TCP = "tcp"; - - /** UDP. */ - public static final String UDP = "udp"; - - /** Named or anonymous pipe. See note below. */ - public static final String PIPE = "pipe"; - - /** Unix domain socket. */ - public static final String UNIX = "unix"; - - private NetworkTransportValues() {} - } - - public static final class NetworkTypeValues { - /** IPv4. */ - public static final String IPV4 = "ipv4"; - - /** IPv6. */ - public static final String IPV6 = "ipv6"; - - private NetworkTypeValues() {} - } - - public static final class NetworkConnectionTypeValues { - /** wifi. */ - public static final String WIFI = "wifi"; - - /** wired. */ - public static final String WIRED = "wired"; - - /** cell. */ - public static final String CELL = "cell"; - - /** unavailable. */ - public static final String UNAVAILABLE = "unavailable"; - - /** unknown. */ - public static final String UNKNOWN = "unknown"; - - private NetworkConnectionTypeValues() {} - } - - public static final class NetworkConnectionSubtypeValues { - /** GPRS. */ - public static final String GPRS = "gprs"; - - /** EDGE. */ - public static final String EDGE = "edge"; - - /** UMTS. */ - public static final String UMTS = "umts"; - - /** CDMA. */ - public static final String CDMA = "cdma"; - - /** EVDO Rel. 0. */ - public static final String EVDO_0 = "evdo_0"; - - /** EVDO Rev. A. */ - public static final String EVDO_A = "evdo_a"; - - /** CDMA2000 1XRTT. */ - public static final String CDMA2000_1XRTT = "cdma2000_1xrtt"; - - /** HSDPA. */ - public static final String HSDPA = "hsdpa"; - - /** HSUPA. */ - public static final String HSUPA = "hsupa"; - - /** HSPA. */ - public static final String HSPA = "hspa"; - - /** IDEN. */ - public static final String IDEN = "iden"; - - /** EVDO Rev. B. */ - public static final String EVDO_B = "evdo_b"; - - /** LTE. */ - public static final String LTE = "lte"; - - /** EHRPD. */ - public static final String EHRPD = "ehrpd"; - - /** HSPAP. */ - public static final String HSPAP = "hspap"; - - /** GSM. */ - public static final String GSM = "gsm"; - - /** TD-SCDMA. */ - public static final String TD_SCDMA = "td_scdma"; - - /** IWLAN. */ - public static final String IWLAN = "iwlan"; - - /** 5G NR (New Radio). */ - public static final String NR = "nr"; - - /** 5G NRNSA (New Radio Non-Standalone). */ - public static final String NRNSA = "nrnsa"; - - /** LTE CA. */ - public static final String LTE_CA = "lte_ca"; - - private NetworkConnectionSubtypeValues() {} - } - public static final class GraphqlOperationTypeValues { /** GraphQL query. */ public static final String QUERY = "query"; @@ -2100,6 +2464,16 @@ public static final class MessagingOperationValues { private MessagingOperationValues() {} } + public static final class MessagingRocketmqConsumptionModelValues { + /** Clustering consumption model. */ + public static final String CLUSTERING = "clustering"; + + /** Broadcasting consumption model. */ + public static final String BROADCASTING = "broadcasting"; + + private MessagingRocketmqConsumptionModelValues() {} + } + public static final class MessagingRocketmqMessageTypeValues { /** Normal message. */ public static final String NORMAL = "normal"; @@ -2116,16 +2490,6 @@ public static final class MessagingRocketmqMessageTypeValues { private MessagingRocketmqMessageTypeValues() {} } - public static final class MessagingRocketmqConsumptionModelValues { - /** Clustering consumption model. */ - public static final String CLUSTERING = "clustering"; - - /** Broadcasting consumption model. */ - public static final String BROADCASTING = "broadcasting"; - - private MessagingRocketmqConsumptionModelValues() {} - } - public static final class RpcSystemValues { /** gRPC. */ public static final String GRPC = "grpc";