Skip to content

Commit 0fa6554

Browse files
fixed menu (#9446)
1 parent 646a51e commit 0fa6554

File tree

1 file changed

+42
-0
lines changed
  • docs/platforms/php/guides/symfony/enriching-events/tags

1 file changed

+42
-0
lines changed
Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
---
2+
title: Tags
3+
description: "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."
4+
---
5+
6+
**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.
7+
8+
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.
9+
10+
_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 (`-`).
11+
12+
_Tag values_ have a maximum length of 200 characters and they cannot contain the newline (`\n`) character.
13+
14+
<Note>
15+
16+
Some tags are automatically set by Sentry. We strongly recommend against overwriting these [tags](/product/reference/search/searchable-properties/#search-properties). Instead, name your tags with your organization's nomenclature. If you overwrite an automatically set tag, you must use [explicit tag syntax](/product/reference/search/#explicit-tag-syntax) to search for it.
17+
18+
</Note>
19+
20+
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.
21+
22+
![](/platforms/php/common/enriching-events/tags/tags.png)
23+
24+
## Symfony configuration
25+
26+
You can also add a tag via the [Symfony configuration options](/platforms/php/guides/symfony/configuration/symfony-options/) in `config/packages/sentry.yaml`.
27+
28+
29+
{/* <!-- prettier-ignore --> */}
30+
```yaml {filename:config/packages/sentry.yaml}
31+
sentry:
32+
options:
33+
tags:
34+
app_tag1: "%env(APP_CUSTOM_TAG1)%"
35+
app_tag2: "value2"
36+
```
37+
38+
## Callback
39+
40+
Define the tag:
41+
42+
<PlatformContent includePath="enriching-events/set-tag" />

0 commit comments

Comments
 (0)