opentelemetry-resource-detector-containerid

What it is and what it does

This package extends OpenTelemetry's resource detection system to automatically capture container runtime metadata and attach it to traces and metrics. When initialized, the ContainerResourceDetector inspects the container environment and extracts identifiers like container ID, image name, and pod information, then registers these as resource attributes that flow through all telemetry signals.

It's designed for containerized applications running on platforms like Docker, Kubernetes, or other container orchestrators. By adding container context to your telemetry, you enable better correlation of traces and metrics with the actual container instances that generated them, making it easier to debug and monitor distributed systems. The package integrates directly into OpenTelemetry's standard resource aggregation pipeline.

Use it for:

• Attach container ID and image metadata to traces in Kubernetes-deployed services for better observability
• Correlate metrics and traces with specific container instances in multi-container environments
• Automatically enrich telemetry with pod and container names for easier debugging in orchestrated deployments
• Build container-aware resource attributes for OpenTelemetry exporters without manual environment parsing

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Detects and registers container runtime metadata (container ID, image name, pod details) as OpenTelemetry resource attributes for traces and metrics.

Yes, if you run containerized applications and use OpenTelemetry for tracing or metrics. It automates container metadata capture with minimal setup and active maintenance. The single dependency and low install friction make it a straightforward addition to any OpenTelemetry stack.

Install

opentelemetry-resource-detector-containerid on PyPI

pip install opentelemetry-resource-detector-containerid

uv add opentelemetry-resource-detector-containerid

poetry add opentelemetry-resource-detector-containerid

Installing opentelemetry-resource-detector-containerid

Before you install

Low friction install with a single runtime dependency on opentelemetry-sdk. Active maintenance with a recent release (29 days old) and ongoing repository activity.

License in practice

Apache-2.0 permissive license allows use in commercial and open-source projects with minimal restrictions.

Quickstart

pip install opentelemetry-resource-detector-containerid

from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.resource.detector.containerid import ContainerResourceDetector
from opentelemetry.sdk.resources import get_aggregated_resources

TracerProvider(resource=get_aggregated_resources([ContainerResourceDetector()]))

Requires Python 3.10 or later; opentelemetry-sdk must be installed.

Verify before relying

• Which container platforms (Docker, Kubernetes, ECS, etc.) are actually supported by this detector
• Whether the detector automatically discovers container metadata or requires environment configuration

Package facts

Evidence: opentelemetry_resource_detector_containerid-0.65b0-py3-none-any.whl

Tags

More Monitoring packages