Metrics (Trace Connected) in Beta

[Dhrumil-Sentry]

We’re 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

If you'd like access for JavaScript or Python please comment with your org slug below or drop us a note at [email protected]

Why we built this

Metrics in most tools stop at charts — they show that something changed, but not why. When a checkout.failed counter spikes, you’re forced to switch tools and manually line up logs or traces to find the cause.

With Sentry, every metric event carries a trace_id.

That means you can:

• click into a sample and see the exact trace that produced the metric,
• open the related spans, logs, and errors,
• understand why the metric moved — slow database query, failed API call, bad deploy, etc.

So instead of “metric alert → guesswork,” debugging becomes a single flow: Metric spike → open a sample → trace waterfall → root cause.

How the UX works

Aggregates tab shows trends and totals across any attributes (e.g. sum(metrics_value) grouped by email_type).

Samples tab shows individual metric events with direct links to their trace — so you can jump straight into the logs, spans, and errors that occurred at the same moment. Allowing you to drill into any spikes or dips in your metrics and find relevant errors,traces or logs to look at.

How to get started

If you'd like access please comment with your org slug below or drop us a note at [email protected]

Python

You need to be on a min version of 2.43.0 of our Python SDKs

import sentry_sdk
from sentry_sdk import metrics

sentry_sdk.init(
    dsn="___PUBLIC_DSN___",
    _experiments={
        "enable_metrics": True,
    },
)
metrics.count("checkout.failed", 1, attributes={"route": "/checkout", "tenant": "acme"})
metrics.gauge("queue.depth", 42, attributes={"queue": "emails"})
metrics.distribution("cart.amount_usd", 187.5, attributes={"currency": "USD", "tenant": "acme"})

More details: getsentry/sentry-python#5042

JavaScript

You need to be on a min version of 10.20.0 for our JavaScript SDKs

Sentry.init({
  dsn: '<your-dsn>',
  _experiments: { enableMetrics: true },
});

// Counter — increment a metric (defaults to +1)
Sentry.metrics.count('checkout.failed', 1, {
  attributes: {
    route: '/checkout',
    tenant: 'acme',
    provider: 'stripe',
  },
});

// Gauge — set a current value
Sentry.metrics.gauge('queue.depth', 42, {
  unit: 'items',
  attributes: {
    queue: 'emails',
    region: 'us-east-1',
  },
});

// Distribution — record numeric values to compute p95, avg, sum, etc.
Sentry.metrics.distribution('cart.amount_usd', 187.5, {
  unit: 'usd',
  attributes: {
    currency: 'USD',
    tenant: 'acme',
  },
});

Each metric event includes:

• name, kind, value, attributes
• trace_id, span_id → used to link with other telemetry
• optional unit, byte_size

More details: getsentry/sentry-javascript#18055

When (and why) to use Metrics

Metrics are best for application and code based health signals — numeric indicators of whether your application logic is behaving as expected.

You should reach for metrics when you want to quantify what your code is doing

Examples:

• email.sent / email.failed
• job.processed / job.retried
• checkout.started / checkout.failed
• payment.declined / refund.issued
• queue.depth / pool.in_use
• search.zero_results

Feedback

We’re working on shipping Alerts, Saved Queries and dashboard widget building support very soon

We’d love to hear your feedback about the following

• Are the SDK APIs easy enough to send your desired metrics ?
• Any feedback about the Metrics Explorer UX - What could make this a better experience for you ?
• Any default metrics that you’d like Sentry to send automatically

[mohitpatel-ghl]

@Dhrumil-Sentry We would like to try this out
This is our sentry org url https://gohighlevel.sentry.io/

[Dhrumil-Sentry]

@mohitpatel-ghl - That was a bug in the copy we're showing - It's supported for all JS platforms - please see the SDK instructions here: getsentry/sentry-javascript#18055

[mohitpatel-ghl]

Any default metrics that you’d like Sentry to send automatically
@Dhrumil-Sentry

We want to track the heap memory consumption, sometimes on users side page is becomes unresponsive or crashes due to excessing memory consumption.
We already have the logic on our code which computes memory at every certain interval, i'm just thinking if this metric feature could be a good approach to log it to sentry & then analyze it over there. Any suggestions over here in respect to metrics feautre

[Dhrumil-Sentry]

@mohitpatel-ghl Given you already have the logic to compute this - you can add this as a distribution metric so that you can track the p50,p90 of memory consumption across users. Def a good use case for metrics

[mohitpatel-ghl]

And @Dhrumil-Sentry does this metrics feature depends on any sampling like trace sampling rate or any other. Because sometimes we observed that all data is not being logged on dashboard

[Dhrumil-Sentry]

@mohitpatel-ghl the trace sample rate only applies to spans and not to these metrics. There can be a few mins of delay in us ingesting metrics and making them available to query. You can also go to the Stats page in the Org settings and select Metrics and confirm nothing was dropped on our server side.

If you still think any data is being dropped - Can you please open an issue here: https://github.com/getsentry/sentry-javascript/issues - we'd need a few more details from you to be able to debug

[eddie-at-stan]

stan-yz please! This came just in time.

[Dhrumil-Sentry]

@eddie-at-stan you should have access now -Would love to hear any feedback !

[TwoTau]

I'd love to try this! Our org slug is scorecard

[Dhrumil-Sentry]

@TwoTau You should have access now

Here's the JS: getsentry/sentry-javascript#18055 and Python: getsentry/sentry-python#5042 SDK instructions

Please let us know if you hit any friction

[pshomov]

Will you support high cardnality attribute values - user id, tenant id, etc.? What will you consider as a billable metric item?
Would love to try this 🤩 . Our org slug is spectaflow.

[Dhrumil-Sentry]

@pshomov We're using a high volume event store for this solution - So we can definitely support high cardinality values like user_id etc.

We don't know pricing details yet but there will be no charge to using these Metrics while we're on Open Beta for a few months atleast.

I will say that the solution is mean to help developers track metrics with high cardinality tags and we're more likely to restrict how many attributes you could attach vs causing a cost explosion due to high cardinality - But all of this is TBD and we'd appreciate any feedback

Your org has access now. Here's the JS: getsentry/sentry-javascript#18055 and Python: getsentry/sentry-python#5042 SDK instructions

Any feedback appreciated !

[matt-roberts-navi]

Exactly what we need right now! Great timing with the availability. navi-ventures as the slug

[Dhrumil-Sentry]

@matt-roberts-navi Your org has access now. Here's the JS: getsentry/sentry-javascript#18055 and Python: getsentry/sentry-python#5042 SDK instructions . Let us know what you think !

[leoht]

Hey, really excited to read this is available – we'd love to try this out.
Our Sentry org URL is https://oddboxhq.sentry.io – let me know if you need anything else!

[Dhrumil-Sentry]

@leoht Your org has access now. Here's the JS: getsentry/sentry-javascript#18055 and Python: getsentry/sentry-python#5042 SDK instructions. Let me know if you hit any snags

[leoht]

Great thanks! Will give it a try

[leoht]

@Dhrumil-Sentry Just tried to implement a few metrics (using the Python SDK), though it seems they're not showing up in the UI at all. I'm still only able to see the default landing page with the tutorial/demo, though I'm able to see the corresponding trace in the UI.

What's the best way to give feedback on this one? Happy to open an issue

[Dhrumil-Sentry]

@leoht Can you please leave a comment on the Python SDK discussion with an example of a metric you're sending with the SDK: getsentry/sentry-python#5042

We'd need the version of the SDK you're using as well 🙏 - Thanks a lot for sharing feedback

[KyGuy2002]

I would like to try with kylan-ph org slug. Thanks!

[Dhrumil-Sentry]

@KyGuy2002 Your org has access now. Here's the JS: getsentry/sentry-javascript#18055 and Python: getsentry/sentry-python#5042 SDK instructions .

[KyGuy2002]

Thank you! Does this not work with the cloudflare sdk yet? Im not seeing the method on "@sentry/cloudflare": "^10.23.0" but I do see it on "@sentry/react": "^10.23.0"

[Dhrumil-Sentry]

@KyGuy2002 - thanks for the catch - We need to export these changes from the Cloudflare side - We'll do this very soon

[KyGuy2002]

Ok sounds good. Thanks for the response.

[lirigithub]

Hello, we would like to try the beta. Slug is dealzone. Thanks!

[Dhrumil-Sentry]

@lirigithub Your org has access now. Here's the JS: getsentry/sentry-javascript#18055 and Python: getsentry/sentry-python#5042 SDK instructions .

Let us know if you have any feedback or face any troubles

[EandrewJones]

Perfect timing for this feature! We would love to try: homa-ej.

[Dhrumil-Sentry]

@EandrewJones Your org should have access now - Please find the JS/Python instructions here:

https://docs.sentry.io/platforms/javascript/guides/nextjs/metrics/
https://docs.sentry.io/platforms/python/metrics/

Let us know if you have any trouble getting started !

[idobenamram]

we would love to try the beta! slug is nexus-ai-0s. Thanks!!

[Dhrumil-Sentry]

@idobenamram Your org should has access- Please find the JS/Python instructions here:

https://docs.sentry.io/platforms/javascript/guides/nextjs/metrics/
https://docs.sentry.io/platforms/python/metrics/

Would love to hear any feedback about the UX/SDK experience once you try this 🙏

[mjlescano]

nice! could we try out the beta at foil? 🙏 (using the Node.js lib)

[Dhrumil-Sentry]

@mjlescano Your org should has access- Please find the JS/Python instructions here:

https://docs.sentry.io/platforms/javascript/guides/nextjs/metrics/
https://docs.sentry.io/platforms/python/metrics/

Let us know if you hit any snags

[olena-gurushots]

Would love to try it out! The org is datascenes. Thank you!

[Dhrumil-Sentry]

@olena-gurushots Your org should has access- Please find the JS/Python instructions here:

https://docs.sentry.io/platforms/javascript/guides/nextjs/metrics/
https://docs.sentry.io/platforms/python/metrics/

Let us know if you hit face any troubles

[boris-w]

I really need this, my Organization Slug is teable

[Dhrumil-Sentry]

@boris-w Your org should has access- Please find the JS/Python instructions here:

https://docs.sentry.io/platforms/javascript/guides/nextjs/metrics/
https://docs.sentry.io/platforms/python/metrics/

Any feedback is appreciated

[ClemannD]

Requesting access for https://clemann-developments.sentry.io please

[Dhrumil-Sentry]

@ClemannD You should have access. Please see these docs to get started: https://docs.sentry.io/platforms/javascript/guides/nextjs/metrics/

Let us know if you hit any snags

[gaurav-peswani-truva]

We really want to try this out. Can we please get access for the organization truva?

[gaurav-peswani-truva]

Also are the metric examples mentioned in the description the only supported values or we can send any key as desired? We are planning to use this for sending Prisma metrics mentioned at https://www.prisma.io/docs/orm/prisma-client/observability-and-logging/metrics.

[Dhrumil-Sentry]

@gaurav-peswani-truva You should have access. Please see these docs to get started: https://docs.sentry.io/platforms/javascript/guides/nextjs/metrics/

You can send any counter/gauge/distribution type metric using the Sentry SDK - the examples I mentioned are only representative

Let us know if you hit any snags

[marek5050]

I'd like this enabled for its-today-media-l4

[Dhrumil-Sentry]

@marek5050 You should have access. Please see these docs to get started: https://docs.sentry.io/platforms/javascript/guides/nextjs/metrics/ - Let us know if you have any feedback !

[dosmond]

Requesting access for https://remi-2g.sentry.io/

[Dhrumil-Sentry]

@dosmond You should have access. Please see these docs to get started: https://docs.sentry.io/platforms/javascript/guides/nextjs/metrics/ - Let us know if you hit any friction !

[ericsampson]

I really hope that OpenTelemetry Metrics will get automatically picked up and sent to Sentry, just like happens with Otel Traces.

That would be a hugely powerful feature in making Sentry Metrics easy to adopt/"light up".

Thanks!

[ericsampson]

Understood. This sounds like a great topic to engage the OTel Foundation about (or if you have already, you can use our customer interest as leverage :) open-telemetry/opentelemetry-specification#617

Anytime we have to use Sentry-specific code instead of generic OTel methods in our applications, it's much less palatable of a feature.

Cheers!

[ericsampson]

What about exemplars?
https://opentelemetry.io/docs/specs/otel/metrics/data-model/#exemplars
https://opentelemetry.io/docs/specs/otel/metrics/sdk/#exemplar

[Dhrumil-Sentry]

@ericsampson thanks a lot for these inputs - we're discussing this feedback internally too. For the near term we're focussed on support Alerting/Dashboards based on Metrics and support for more SDKs including (Laravel, .NET, Mobile etc). We'll def revisit OTEL support after these basics are in

[ericsampson]

Understood! Look forward to using this new functionality and seeing it evolve. Best

[AbhiPrasad]

@ericsampson I created a GitHub issue for us to track OTLP metrics support. Feel free to subscribe to that! #103487

[ltbits]

Having OTLP support in this initial phase will greatly increase the number of applications that are able to integrate Sentry metrics.

[sechols223]

Would love to get access to this!

Org slug is envoc

[Dhrumil-Sentry]

@sechols223 would love to understand what type of metrics you want to track. Do you want to sent metrics using .NET ? We only have support for JavaScript and Python platforms currently, does that work for you ?

[aurewill-gavel]

Does this allow for creating metrics that span multiple projects?

[Dhrumil-Sentry]

@aurewill-gavel could you please explain your use case a bit more ? Currently you can send metrics for a given project only since the SDK is tied to the project's DSN as well

[aurewill-gavel]

yeah, makes sense. Same thing with span metrics. Don't really have a good use case for ya, just curious.

[mquezada]

we want in! cero

[Dhrumil-Sentry]

@mquezada Your org should have access. Here are the docs to get started: https://docs.sentry.io/product/explore/metrics/getting-started/

What type of metrics do you want to track ?

[dosmond]

I see that there are plans to allow notifications / alerts based on metric queries. How far away do we think that is?

[Dhrumil-Sentry]

@dosmond - We're going to start tackling this soon and we should have alerting support by early Jan - What type of metrics do you want to be alerted for ?

[dosmond]

That's great to hear!

We are wanting to be alerted to:

• count/sec reaching a threshold.
• P99 or P50 distributions hitting a threshold
• Gauge limit reached
• Count sum > threshold over past x time

[msnelling]

Requesting access for https://sociaei.sentry.io/ please

[Dhrumil-Sentry]

@msnelling You should have access now - Here are our docs to get started: https://docs.sentry.io/product/explore/metrics/getting-started/

Would love to understand what type of metrics are you trying to track