Metrics (Trace Connected) For JavaScript

[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 10.25.0 of the JavaScript SDK or higher.

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

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

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

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

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

You can also set a unit on the metric

Sentry.metrics.distribution('cart.amount_usd', 187.5, {
  unit: 'usd',
  attributes: {
    currency: 'USD',
    tenant: 'acme',
  },
});

[ian-schu]

Hi folks,
Very excited about this feature – in a previous job I used metrics heavily (within Datadog) and it gave us a ton of power to monitor specific aspects of our app.

I've just set up metrics this morning in the app I currently operate, and they're working beautifully.

Two questions for you:

1. Are there plans to include Metrics as the basis for Alerts?
2. Are there plans to include Metrics as a dataset for dashboard widgets?

Both of these would really complete the package for us, in terms of using Sentry as our home base for observing our app in production. Thanks!

[Dhrumil-Sentry]

@ian-schu - We will have support for both Alerting and dashboard widgets based on Metrics - We're working towards having support by early Feb

getsentry/sentry#102275 (reply in thread)

[ian-schu]

Outstanding, thanks!