semconv.com

Kubernetes and containers

as of v1.44.0

Pods, nodes, workloads and the container runtime underneath them — the largest namespace in the registry.

k8s 90container 18openshift 2oci 1

attributes
111
metrics
191
signals
22
stable
46
deprecated
4

Signals

What this domain emits, and the attributes each one carries, most strongly required first. An attribute marked * is required on that signal; * is conditionally required.

Entities 22

Metrics 191

Specification

Requirements that name this domain 3

  • MUSTOverviewStable

    The Baggage container MUST be immutable, so that the containing Context also remains immutable.

  • Custom resource detectors related to generic platforms (e.g. Docker, Kubernetes) or vendor specific environments (e.g. EKS, AKS, GKE) MUST be implemented as packages separate from the SDK.

  • SHOULDValidation RequirementsDevelopment

    Entity types SHOULD follow existing OpenTelemetry entity naming conventions (e.g., "service", "host", "container", "k8s.pod")

On the wire, this lands in metrics/v1/metrics, resource/v1/resource. Field-by-field definitions are under OTLP.

Attributes 111

k8s90 attributes

container18 attributes

openshift2 attributes

oci1 attributes

  • oci.manifest.digest
    DevelopmentThe digest of the OCI image manifest. For container images specifically is the digest by which the container image is known.

Recent changes

Breaking and notable changes to this domain across the last 6 semantic-conventions releases.

  • instrumentmetriccontainer.memory.usageInstrument changed from counter to updowncounter.
  • instrumentmetrick8s.node.memory.usageInstrument changed from gauge to updowncounter.
  • instrumentmetrick8s.pod.memory.usageInstrument changed from gauge to updowncounter.
  • renamedmetriccontainer.memory.paging.faultsRenamed to container.paging.faults.
  • renamedmetrick8s.node.memory.paging.faultsRenamed to k8s.node.paging.faults.
  • renamedmetrick8s.pod.memory.paging.faultsRenamed to k8s.pod.paging.faults.
  • stabilitymetriccontainer.memory.availablePromoted to release_candidate.
  • stabilitymetriccontainer.memory.rssPromoted to release_candidate.
  • stabilitymetriccontainer.memory.usagePromoted to release_candidate.
  • stabilitymetriccontainer.memory.working_setPromoted to release_candidate.

109 more in the full release history

Topics are this site's grouping of upstream namespaces, not a structure the OpenTelemetry project publishes. JSON · All domains