Telemetry reference¶

TelemetryManager ¶

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

enabled: bool

Whether the user has not dissented to telemetry.

log: LogTelemetryWriter

trace: TraceTelemetryWriter

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

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:

Parameters:

Name	Type	Description	Default
`data`	`dict[str, Any]`	The span to send.	required