Docs » Instrument back-end applications to send spans to Splunk APM » Instrument Python applications for Splunk Observability Cloud » Metrics and attributes collected by the Splunk Distribution of OpenTelemetry Python

Metrics and attributes collected by the Splunk Distribution of OpenTelemetry Python 🔗

The Splunk Distribution of OpenTelemetry Python collects runtime and custom metrics. To automatically collect metrics from your Python applications, you must have splunk-otel-python version 1.14.0 or higher. For more information, see About the Splunk Distribution of OpenTelemetry Python.

To learn about the different metric types, see Metric types.

For examples of custom metrics instrumentation and instrument types, see Create custom metrics.

Caution

This feature is experimental, and exported metric data and configuration properties might change. To learn more, see https://github.com/signalfx/splunk-otel-python/blob/main/docs/advanced-config.md.

Application metrics 🔗

The agent of the Splunk Distribution of OpenTelemetry Python collects the following application metrics.

Default metrics dimensions 🔗

The following dimensions are automatically added to all metrics exported by the agent:

Dimension

Description

deployment.environment

Value of the deployment.environment resource attribute, if present.

service.name

Name of the service.

telemetry.sdk.name

Name of the SDK, set to opentelemetry.

telemetry.sdk.language

Language of the SDK, set to python.

telemetry.sdk.version

Version of the OpenTelemetry SDK.

Supported libraries 🔗

The Python agent collects metrics through the following supported libraries:

Library/Framework

Instrumentation

Supported versions

Django

opentelemetry-instrumentation-django

Django version 1.10 or higher

Pyramid

opentelemetry-instrumentation-pyramid

Pyramid version 1.7 or higher

Runtime metrics 🔗

The Python agent automatically collects and exports the following application runtime metrics:

Metric

Type

Description

process.runtime.cpython.memory

Counter

Memory used by the Python runtime.

process.runtime.cpython.cpu_time

Cumulative counter

CPU time used by the Python runtime.

process.runtime.cpython.gc_count

Cumulative counter

Garbage collections executed by the Python runtime.

System metrics 🔗

The Python agent automatically collects and exports the following system metrics:

Metric

Type

Description

system.cpu.time

Counter

Total seconds each logical CPU spent on each mode.

system.cpu.utilization

Gauge

Difference in system.cpu.time since the last measurement per logical CPU, divided by the elapsed time (value in interval [0,1]).

system.memory.usage

Counter

Bytes of memory in use.

system.memory.utilization

Gauge

Percentage of memory bytes in use.

system.swap.usage

Counter

Bytes of swap space in use.

system.swap.utilization

Gauge

Percentage of swap space bytes in use.

system.disk.io

Counter

Disk bytes transferred.

system.disk.operations

Counter

Disk operations count.

system.disk.time

Counter

Time disk spent activated.

system.network.dropped.packets

Counter

The number of packets dropped.

system.network.packets

Counter

The number of packets transferred.

system.network.errors

Counter

The number of errors encountered.

system.network.io

Counter

The number of bytes transmitted and received.

system.network.connections

Counter

The number of connections.

system.thread_count

Counter

The number of threads.