Tags

Tags power UI features such as filters and tag-distribution maps. Tags also help you quickly access related events and view the tag distribution for a set of events.

Tags are key/value string pairs that are both indexed and searchable. Tags power features in sentry.io such as filters and tag-distribution maps. Tags also help you quickly both access related events and view the tag distribution for a set of events. Common uses for tags include hostname, platform version, and user language.

We’ll automatically index all tags for an event, as well as the frequency and the last time that Sentry has seen a tag. We also keep track of the number of distinct tags and can assist you in determining hotspots for various issues.

Tag keys have a maximum length of 32 characters and can contain only letters (a-zA-Z), numbers (0-9), underscores (_), periods (.), colons (:), and dashes (-).

Tag values have a maximum length of 200 characters and they cannot contain the newline (\n) character.

Defining tags is easy, and will bind them to the isolation scope ensuring all future events within scope contain the same tags.

You'll first need to import the SDK, as usual:

Copied
import * as Sentry from "@sentry/browser";

Define the tag:

Copied
Sentry.setTag("page_locale", "de-at");

Some tags are automatically set by Sentry. We strongly recommend against overwriting these tags. Instead, name your tags with your organization's nomenclature. If you overwrite an automatically set tag, you must use explicit tag syntax to search for it.

Once you've started sending tagged data, you'll see it when logged in to sentry.io. There, you can view the filters within the sidebar on the Project page, summarized within an event, and on the Tags page for an aggregated event.

Tags

Help improve this content
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").