Package io.opentelemetry.semconv.incubating

Class K8sIncubatingAttributes

java.lang.Object
io.opentelemetry.semconv.incubating.K8sIncubatingAttributes
public final class K8sIncubatingAttributes extends Object

  • Field Details

    • K8S_CLUSTER_NAME

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_CLUSTER_NAME
      The name of the cluster.

    • K8S_CLUSTER_UID

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_CLUSTER_UID
      A pseudo-ID for the cluster, set to the UID of the kube-system namespace.

      Notes:

      K8s doesn't have support for obtaining a cluster ID. If this is ever added, we will recommend collecting the k8s.cluster.uid through the official APIs. In the meantime, we are able to use the uid of the kube-system namespace as a proxy for cluster ID. Read on for the rationale.

      Every object created in a K8s cluster is assigned a distinct UID. The kube-system namespace is used by Kubernetes itself and will exist for the lifetime of the cluster. Using the uid of the kube-system namespace is a reasonable proxy for the K8s ClusterID as it will only change if the cluster is rebuilt. Furthermore, Kubernetes UIDs are UUIDs as standardized by ISO/IEC 9834-8 and ITU-T X.667. Which states:

      If generated according to one of the mechanisms defined in Rec. ITU-T X.667 | ISO/IEC 9834-8, a UUID is either guaranteed to be different from all other UUIDs generated before 3603 A.D., or is extremely likely to be different (depending on the mechanism chosen).

      Therefore, UIDs between clusters should be extremely unlikely to conflict.

    • K8S_CONTAINER_NAME

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_CONTAINER_NAME
      The name of the Container from Pod specification, must be unique within a Pod. Container runtime usually uses different globally unique name (container.name).

    • K8S_CONTAINER_RESTART_COUNT

      public static final io.opentelemetry.api.common.AttributeKey<Long> K8S_CONTAINER_RESTART_COUNT
      Number of times the container was restarted. This attribute can be used to identify a particular container (running or stopped) within a container spec.

    • K8S_CONTAINER_STATUS_LAST_TERMINATED_REASON

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_CONTAINER_STATUS_LAST_TERMINATED_REASON
      Last terminated reason of the Container.

    • K8S_CRONJOB_ANNOTATION

      public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> K8S_CRONJOB_ANNOTATION
      The cronjob annotation placed on the CronJob, the <key> being the annotation name, the value being the annotation value.

      Notes:

      Examples:

      • An annotation retries with value 4 SHOULD be recorded as the k8s.cronjob.annotation.retries attribute with value "4".
      • An annotation data with empty string value SHOULD be recorded as the k8s.cronjob.annotation.data attribute with value "".

    • K8S_CRONJOB_LABEL

      public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> K8S_CRONJOB_LABEL
      The label placed on the CronJob, the <key> being the label name, the value being the label value.

      Notes:

      Examples:

      • A label type with value weekly SHOULD be recorded as the k8s.cronjob.label.type attribute with value "weekly".
      • A label automated with empty string value SHOULD be recorded as the k8s.cronjob.label.automated attribute with value "".

    • K8S_CRONJOB_NAME

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_CRONJOB_NAME
      The name of the CronJob.

    • K8S_CRONJOB_UID

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_CRONJOB_UID
      The UID of the CronJob.

    • K8S_DAEMONSET_ANNOTATION

      public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> K8S_DAEMONSET_ANNOTATION
      The annotation key-value pairs placed on the DaemonSet.

      Notes:

      The <key> being the annotation name, the value being the annotation value, even if the value is empty.

    • K8S_DAEMONSET_LABEL

      public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> K8S_DAEMONSET_LABEL
      The label key-value pairs placed on the DaemonSet.

      Notes:

      The <key> being the label name, the value being the label value, even if the value is empty.

    • K8S_DAEMONSET_NAME

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_DAEMONSET_NAME
      The name of the DaemonSet.

    • K8S_DAEMONSET_UID

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_DAEMONSET_UID
      The UID of the DaemonSet.

    • K8S_DEPLOYMENT_ANNOTATION

      public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> K8S_DEPLOYMENT_ANNOTATION
      The annotation key-value pairs placed on the Deployment.

      Notes:

      The <key> being the annotation name, the value being the annotation value, even if the value is empty.

    • K8S_DEPLOYMENT_LABEL

      public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> K8S_DEPLOYMENT_LABEL
      The label key-value pairs placed on the Deployment.

      Notes:

      The <key> being the label name, the value being the label value, even if the value is empty.

    • K8S_DEPLOYMENT_NAME

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_DEPLOYMENT_NAME
      The name of the Deployment.

    • K8S_DEPLOYMENT_UID

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_DEPLOYMENT_UID
      The UID of the Deployment.

    • K8S_HPA_NAME

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_HPA_NAME
      The name of the horizontal pod autoscaler.

    • K8S_HPA_UID

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_HPA_UID
      The UID of the horizontal pod autoscaler.

    • K8S_JOB_ANNOTATION

      public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> K8S_JOB_ANNOTATION
      The annotation key-value pairs placed on the Job.

      Notes:

      The <key> being the annotation name, the value being the annotation value, even if the value is empty.

    • K8S_JOB_LABEL

      public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> K8S_JOB_LABEL
      The label key-value pairs placed on the Job.

      Notes:

      The <key> being the label name, the value being the label value, even if the value is empty.

    • K8S_JOB_NAME

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_JOB_NAME
      The name of the Job.

    • K8S_JOB_UID

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_JOB_UID
      The UID of the Job.

    • K8S_NAMESPACE_ANNOTATION

      public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> K8S_NAMESPACE_ANNOTATION
      The annotation key-value pairs placed on the Namespace.

      Notes:

      The <key> being the annotation name, the value being the annotation value, even if the value is empty.

    • K8S_NAMESPACE_LABEL

      public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> K8S_NAMESPACE_LABEL
      The label key-value pairs placed on the Namespace.

      Notes:

      The <key> being the label name, the value being the label value, even if the value is empty.

    • K8S_NAMESPACE_NAME

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_NAMESPACE_NAME
      The name of the namespace that the pod is running in.

    • K8S_NAMESPACE_PHASE

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_NAMESPACE_PHASE
      The phase of the K8s namespace.

      Notes:

      This attribute aligns with the phase field of the K8s NamespaceStatus

    • K8S_NODE_ANNOTATION

      public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> K8S_NODE_ANNOTATION
      The annotation placed on the Node, the <key> being the annotation name, the value being the annotation value, even if the value is empty.

      Notes:

      Examples:

      • An annotation node.alpha.kubernetes.io/ttl with value 0 SHOULD be recorded as the k8s.node.annotation.node.alpha.kubernetes.io/ttl attribute with value "0".
      • An annotation data with empty string value SHOULD be recorded as the k8s.node.annotation.data attribute with value "".

    • K8S_NODE_LABEL

      public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> K8S_NODE_LABEL
      The label placed on the Node, the <key> being the label name, the value being the label value, even if the value is empty.

      Notes:

      Examples:

      • A label kubernetes.io/arch with value arm64 SHOULD be recorded as the k8s.node.label.kubernetes.io/arch attribute with value "arm64".
      • A label data with empty string value SHOULD be recorded as the k8s.node.label.data attribute with value "".

    • K8S_NODE_NAME

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_NODE_NAME
      The name of the Node.

    • K8S_NODE_UID

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_NODE_UID
      The UID of the Node.

    • K8S_POD_ANNOTATION

      public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> K8S_POD_ANNOTATION
      The annotation placed on the Pod, the <key> being the annotation name, the value being the annotation value.

      Notes:

      Examples:

      • An annotation kubernetes.io/enforce-mountable-secrets with value true SHOULD be recorded as the k8s.pod.annotation.kubernetes.io/enforce-mountable-secrets attribute with value "true".
      • An annotation mycompany.io/arch with value x64 SHOULD be recorded as the k8s.pod.annotation.mycompany.io/arch attribute with value "x64".
      • An annotation data with empty string value SHOULD be recorded as the k8s.pod.annotation.data attribute with value "".

    • K8S_POD_LABEL

      public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> K8S_POD_LABEL
      The label placed on the Pod, the <key> being the label name, the value being the label value.

      Notes:

      Examples:

      • A label app with value my-app SHOULD be recorded as the k8s.pod.label.app attribute with value "my-app".
      • A label mycompany.io/arch with value x64 SHOULD be recorded as the k8s.pod.label.mycompany.io/arch attribute with value "x64".
      • A label data with empty string value SHOULD be recorded as the k8s.pod.label.data attribute with value "".

    • K8S_POD_LABELS

      @Deprecated public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> K8S_POD_LABELS
      Deprecated.
      Replaced by k8s.pod.label.
      Deprecated, use k8s.pod.label instead.

    • K8S_POD_NAME

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_POD_NAME
      The name of the Pod.

    • K8S_POD_UID

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_POD_UID
      The UID of the Pod.

    • K8S_REPLICASET_ANNOTATION

      public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> K8S_REPLICASET_ANNOTATION
      The annotation key-value pairs placed on the ReplicaSet.

      Notes:

      The <key> being the annotation name, the value being the annotation value, even if the value is empty.

    • K8S_REPLICASET_LABEL

      public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> K8S_REPLICASET_LABEL
      The label key-value pairs placed on the ReplicaSet.

      Notes:

      The <key> being the label name, the value being the label value, even if the value is empty.

    • K8S_REPLICASET_NAME

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_REPLICASET_NAME
      The name of the ReplicaSet.

    • K8S_REPLICASET_UID

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_REPLICASET_UID
      The UID of the ReplicaSet.

    • K8S_REPLICATIONCONTROLLER_NAME

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_REPLICATIONCONTROLLER_NAME
      The name of the replication controller.

    • K8S_REPLICATIONCONTROLLER_UID

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_REPLICATIONCONTROLLER_UID
      The UID of the replication controller.

    • K8S_RESOURCEQUOTA_NAME

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_RESOURCEQUOTA_NAME
      The name of the resource quota.

    • K8S_RESOURCEQUOTA_UID

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_RESOURCEQUOTA_UID
      The UID of the resource quota.

    • K8S_STATEFULSET_ANNOTATION

      public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> K8S_STATEFULSET_ANNOTATION
      The annotation key-value pairs placed on the StatefulSet.

      Notes:

      The <key> being the annotation name, the value being the annotation value, even if the value is empty.

    • K8S_STATEFULSET_LABEL

      public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> K8S_STATEFULSET_LABEL
      The label key-value pairs placed on the StatefulSet.

      Notes:

      The <key> being the label name, the value being the label value, even if the value is empty.

    • K8S_STATEFULSET_NAME

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_STATEFULSET_NAME
      The name of the StatefulSet.

    • K8S_STATEFULSET_UID

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_STATEFULSET_UID
      The UID of the StatefulSet.

    • K8S_VOLUME_NAME

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_VOLUME_NAME
      The name of the K8s volume.

    • K8S_VOLUME_TYPE

      public static final io.opentelemetry.api.common.AttributeKey<String> K8S_VOLUME_TYPE
      The type of the K8s volume.