Set Up Metrics
Learn how to measure the data points you care about by configuring Metrics in your React Native app.
Upcoming API Changes
We'll be updating our API to ensure that metrics are explicitly connected to spans. This change will improve debugging capabilities by ensuring that metrics are always contextually linked with all your Sentry data through traces. You'll eventually need to migrate to the new APIs once released. Learn more.
Metrics for React Native are supported in Sentry React Native SDK version 5.19.0
and above.
Sentry metrics help you pinpoint and solve issues that impact user experience and app performance by measuring the data points that are important to you. You can track things like processing time, event size, user signups, and conversion rates, then correlate them back to tracing data in order to get deeper insights and solve issues faster.
Metrics work out of the box by calling Sentry.init
, no further setup is required.
Sentry.init({
dsn: 'https://examplePublicKey@o0.ingest.sentry.io/0',
// Only needed for SDK versions < 8.0.0
// integrations: [
// Sentry.metrics.metricsAggregatorIntegration(),
// ],
});
Counters are one of the more basic types of metrics and can be used to count certain event occurrences.
To emit a counter, do the following:
// Increment a counter by one for each button click.
Sentry.metrics.increment("button_click", 1, {
tags: { browser: "Firefox", app_version: "1.0.0" },
});
Distributions help you get the most insights from your data by allowing you to obtain aggregations such as p90
, min
, max
, and avg
.
To emit a distribution, do the following:
// Add '15.0' to a distribution used for tracking the loading times for component.
Sentry.metrics.distribution("component_load_time", 15.0, {
tags: { type: "important" },
unit: "millisecond",
});
Sets are useful for looking at unique occurrences and counting the unique elements you added.
To emit a set, do the following:
// Add 'jane' to a set used for tracking the number of users that viewed a page.
Sentry.metrics.set("user_view", "jane");
Gauges let you obtain aggregates like min
, max
, avg
, sum
, and count
. They can be represented in a more space-efficient way than distributions, but they can't be used to get percentiles. If percentiles aren't important to you, we recommend using gauges.
To emit a gauge, do the following:
// Add 2 to a gauge tracking CPU usage.
Sentry.metrics.gauge("cpu_usage", 34, {
tags: { os: "MacOS" },
unit: "percent",
});
Adding a unit as a metric parameter will give meaning to what may otherwise look like abstract numbers. It also allows Sentry to offer controls - unit conversions, filters, and so on - based on the unit you select. You can pass a unit as an optional parameter of the third argument of the increment
, distribution
, set
, and gauge
methods. If a value has no units, you can supply an empty string or none
.
The following units are understood by the Sentry backend, but you can add any arbitrary unit you want.
nanosecond
microsecond
millisecond
second
minute
hour
day
week
bit
byte
kilobyte
kibibyte
megabyte
mebibyte
gigabyte
gibibyte
terabyte
tebibyte
petabyte
pebibyte
exabyte
exbibyte
ratio
percent
You can find additional details about supported units in our event ingestion documentation.
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").