opentelemetry.sdk.resources package

This package implements OpenTelemetry Resources:

A Resource is an immutable representation of the entity producing telemetry. For example, a process producing telemetry that is running in a container on Kubernetes has a Pod name, it is in a namespace and possibly is part of a Deployment which also has a name. All three of these attributes can be included in the Resource.

Resource objects are created with Resource.create, which accepts attributes (key-values). Resources should NOT be created via constructor, and working with Resource objects should only be done via the Resource API methods. Resource attributes can also be passed at process invocation in the OTEL_RESOURCE_ATTRIBUTES environment variable. You should register your resource with the opentelemetry.sdk.trace.TracerProvider by passing them into their constructors. The Resource passed to a provider is available to the exporter, which can send on this information as it sees fit.

trace.set_tracer_provider(
    TracerProvider(
        resource=Resource.create({
            "service.name": "shoppingcart",
            "service.instance.id": "instance-12",
        }),
    ),
)
print(trace.get_tracer_provider().resource.attributes)

{'telemetry.sdk.language': 'python',
'telemetry.sdk.name': 'opentelemetry',
'telemetry.sdk.version': '0.13.dev0',
'service.name': 'shoppingcart',
'service.instance.id': 'instance-12'}

Note that the OpenTelemetry project documents certain “standard attributes” that have prescribed semantic meanings, for example service.name in the above example.

class opentelemetry.sdk.resources.Resource(attributes, schema_url=None)[source]

Bases: object

A Resource is an immutable representation of the entity producing telemetry as Attributes.

static create(attributes=None, schema_url=None)[source]

Creates a new Resource from attributes.

Parameters:

attributes (Optional[Dict[str, Union[str, bool, int, float, Sequence[str], Sequence[bool], Sequence[int], Sequence[float]]]]) – Optional zero or more key-value pairs.
schema_url (Optional[str]) – Optional URL pointing to the schema

Return type:

Resource

Returns:

The newly-created Resource.

static get_empty()[source]

Return type:: Resource

property attributes: Dict[str, str | bool | int | float | Sequence[str] | Sequence[bool] | Sequence[int] | Sequence[float]]

property schema_url: str

merge(other)[source]

Merges this resource and an updating resource into a new Resource.

If a key exists on both the old and updating resource, the value of the updating resource will override the old resource value.

The updating resource’s schema_url will be used only if the old schema_url is empty. Attempting to merge two resources with different, non-empty values for schema_url will result in an error and return the old resource.

Parameters:: other (Resource) – The other resource to be merged.
Return type:: Resource
Returns:: The newly-created Resource.

to_json(indent=4)[source]

Return type:: str

class opentelemetry.sdk.resources.ResourceDetector(raise_on_error=False)[source]

Bases: ABC

abstract detect()[source]

Return type:: Resource

class opentelemetry.sdk.resources.OTELResourceDetector(raise_on_error=False)[source]

Bases: ResourceDetector

detect()[source]

Return type:: Resource

class opentelemetry.sdk.resources.ProcessResourceDetector(raise_on_error=False)[source]