Container
May 29, 2026 ยท View on GitHub
Status:
type: container
Description: A container instance.
Warning
This entity definition contains attributes without a role. Stable Entities MUST NOT have attributes without a defined role.
Attributes:
| Role | Key | Stability | Requirement Level | Value Type | Description | Example Values |
|---|---|---|---|---|---|---|
| Other | container.id | Recommended | string | Container ID. Usually a UUID, as for example used to identify Docker containers. The UUID might be abbreviated. | a3bf90e006b2 | |
| Other | container.label.<key> | Recommended | string | Container labels, <key> being the label name, the value being the label value. [1] | nginx | |
| Other | container.name | Recommended | string | Container name used by container runtime. | opentelemetry-autoconf | |
| Other | oci.manifest.digest | Recommended | string | The digest of the OCI image manifest. For container images specifically is the digest by which the container image is known. [2] | sha256:e4ca62c0d62f3e886e684806dfe9d4e0cda60d54986898173c1083856cfda0f4 | |
| Other | container.command | Opt-In | string | The command used to run the container (i.e. the command name). [3] | otelcontribcol | |
| Other | container.command_args | Opt-In | string[] | All the command arguments (including the command/executable itself) run by the container. | ["otelcontribcol", "--config", "config.yaml"] | |
| Other | container.command_line | Opt-In | string | The full command run by the container as a single string representing the full command. | otelcontribcol --config config.yaml |
[1] container.label.<key>: For example, a docker container label app with value nginx SHOULD be recorded as the container.label.app attribute with value "nginx".
[2] oci.manifest.digest: Follows OCI Image Manifest Specification, and specifically the Digest property.
An example can be found in Example Image Manifest.
[3] container.command: If using embedded credentials or sensitive data, it is recommended to remove them to prevent potential leakage.