semantic-conventions/docs/attributes-registry/container.md

3.9 KiB

Container

Container Attributes

Attribute Type Description Examples
container.command string The command used to run the container (i.e. the command name). [1] otelcontribcol
container.command_args string[] All the command arguments (including the command/executable itself) run by the container. [2] [otelcontribcol, --config, config.yaml]
container.command_line string The full command run by the container as a single string representing the full command. [2] otelcontribcol --config config.yaml
container.cpu.state string The CPU state for this data point. user; kernel
container.id string Container ID. Usually a UUID, as for example used to identify Docker containers. The UUID might be abbreviated. a3bf90e006b2
container.image.id string Runtime specific image identifier. Usually a hash algorithm followed by a UUID. [2] sha256:19c92d0a00d1b66d897bceaa7319bee0dd38a10a851c60bcec9474aa3f01e50f
container.image.name string Name of the image the container was built on. gcr.io/opentelemetry/operator
container.image.repo_digests string[] Repo digests of the container image as provided by the container runtime. [3] [example@sha256:afcc7f1ac1b49db317a7196c902e61c6c3c4607d63599ee1a82d702d249a0ccb, internal.registry.example.com:5000/example@sha256:b69959407d21e8a062e0416bf13405bb2b71ed7a84dde4158ebafacfa06f5578]
container.image.tags string[] Container image tags. An example can be found in Docker Image Inspect. Should be only the <tag> section of the full name for example from registry.example.com/my-org/my-image:<tag>. [v1.27.1, 3.5.7-0]
container.label.<key> string Container labels, <key> being the label name, the value being the label value. container.label.app=nginx
container.name string Container name used by container runtime. opentelemetry-autoconf
container.runtime string The container runtime managing this container. docker; containerd; rkt

[1]: If using embedded credentials or sensitive data, it is recommended to remove them to prevent potential leakage.

[2]: Docker defines a sha256 of the image id; container.image.id corresponds to the Image field from the Docker container inspect API endpoint. K8s defines a link to the container registry repository with digest "imageID": "registry.azurecr.io /namespace/service/dockerfile@sha256:bdeabd40c3a8a492eaf9e8e44d0ebbb84bac7ee25ac0cf8a7159d25f62555625". The ID is assinged by the container runtime and can vary in different environments. Consider using oci.manifest.digest if it is important to identify the same image in different environments/runtimes.

[3]: Docker and CRI report those under the RepoDigests field.

container.cpu.state has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.

Value Description
user When tasks of the cgroup are in user mode (Linux). When all container processes are in user mode (Windows).
system When CPU is used by the system (host OS)
kernel When tasks of the cgroup are in kernel mode (Linux). When all container processes are in kernel mode (Windows).