Metrics (Trace Connected) For Python

[AbhiPrasad]

Sentry is introducing metrics that let you send counters, gauges, and distributions from your code to track things like email.sent, checkout.failed, or queue.depth — and pivot directly into the related traces, logs, and errors when something looks off.

TraceConnectedMetrics.mp4

Note

To get early access to the Sentry metrics product and to see how it works, see the announcement post.

To use the new Metric APIs to send metrics directly to Sentry, you'll have to upgrade to 2.44.0 of the Python SDK or higher. An experimental API is available in 2.43.0.

Once the SDK is initialized, you can send metrics using the sentry_sdk.metrics APIs.

The metrics namespace exposes three methods that you can use to capture different types of metric information: count, gauge, and distribution.

from sentry_sdk import metrics

metrics.count("checkout.failed", 1)
metrics.gauge("queue.depth", 42)
metrics.distribution("cart.amount_usd", 187.5)

You can also pass additional attributes directly to count, gauge, and distribution via the attributes kwarg.

from sentry_sdk import metrics

metrics.count(
    "checkout.failed",
    1,
    attributes={
        "route": "/checkout",
        "tenant": "acme",
        "provider": "stripe",
    },
)

[JoshFerge]

is there any reason why we can't alias incr to count as well?

[AbhiPrasad]

These metrics are not pre-aggregated, which incr/increment might suggest because of how the statds apis work. Therefore we elected to not alias it for now, but we may explore it in the future.