Skip to content

Telemetry reference


TelemetryManager

A class for sending various forms of telemetry. This is available as the Application.telemetry property.

enabled

enabled: bool

Whether the user has consented to telemetry.

trace

LogTelemetryWriter

write

write(data: dict[str, Any]) -> None

Send a log message to Datadog. Example:

app.telemetry.log.write({
    "message": "Hello, world!",
    "level": "info",
    "ddtags": "foo:bar,baz:qux",
})

The following fields have default values:

Field Default value
service dda

Parameters:

Name Type Description Default
data dict[str, Any]

The log attributes to send.

required

TraceTelemetryWriter

span

span(data: dict[str, Any]) -> None

Send a trace span to Datadog. Example:

app.telemetry.trace.span({
    "start": time.time_ns(),
    "error": 0,
    "meta": {
        "foo.bar": "baz",
    },
})

The following fields have default values:

Field Default value
service dda
trace_id A random 64-bit integer.
span_id A random 64-bit integer.
parent_id 0

Parameters:

Name Type Description Default
data dict[str, Any]

The span to send.

required