Skip to content

Commit becc164

Browse files
committed
alphabetize variables
1 parent 011875a commit becc164

File tree

1 file changed

+58
-58
lines changed

1 file changed

+58
-58
lines changed

docs/concepts/data-management/event-grouping/fingerprint-rules.mdx

Lines changed: 58 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -67,12 +67,12 @@ error.value:"connection error (code: *)" -> connection-error
6767
error.value:"could not connect (*)" -> connection-error
6868
```
6969

70-
### `message`
70+
### `level`
7171

72-
Matches on a log message. It will also automatically check for the additional exception value as they can be hard to keep apart. The matching is case insensitive.
72+
Matches on the log level. The match is case insensitive.
7373

7474
```bash {tabTitle:Fingerprinting Config}
75-
message:"system encountered a fatal problem: *" -> fatal-log
75+
logger:"com.myapp.FooLogger" level:"error" -> mylogger-error
7676
```
7777

7878
### `logger`
@@ -83,20 +83,12 @@ Matches on the name of the logger, which is useful to combine all messages of a
8383
logger:"com.myapp.mypackage.*" -> mypackage-logger
8484
```
8585

86-
### `level`
87-
88-
Matches on the log level. The match is case insensitive.
89-
90-
```bash {tabTitle:Fingerprinting Config}
91-
logger:"com.myapp.FooLogger" level:"error" -> mylogger-error
92-
```
93-
94-
### `tags.tag_name`
86+
### `message`
9587

96-
Matches on the value of the tag `tag_name`. This can be useful to filter down certain types of events. For instance, you can separate events caused by a specific server:
88+
Matches on a log message. It will also automatically check for the additional exception value as they can be hard to keep apart. The matching is case insensitive.
9789

9890
```bash {tabTitle:Fingerprinting Config}
99-
tags.server_name:"canary-*.mycompany.internal" -> canary-events
91+
message:"system encountered a fatal problem: *" -> fatal-log
10092
```
10193

10294
### `stack.abs_path`
@@ -109,24 +101,24 @@ Matches on the path of an event and is case insensitive. It uses path globbing s
109101
stack.abs_path:"**/my-utils/*.js" -> my-utils, {{ error.type }}
110102
```
111103

112-
### `stack.module`
104+
### `stack.function`
113105

114-
alias: `module`
106+
alias: `function`
115107

116-
Similar to `stack.abs_path` but matches on the module name instead. The match is case-sensitive and regular globbing rules apply (`*` also matches slashes).
108+
Checks if any of the functions in the stack trace match the glob. The match is case-sensitive:
117109

118110
```bash {tabTitle:Fingerprinting Config}
119-
stack.module:"*/my-utils/*" -> my-utils, {{ error.type }}
111+
stack.function:"my_assertion_failed" -> my-assertion-failed
120112
```
121113

122-
### `stack.function`
114+
### `stack.module`
123115

124-
alias: `function`
116+
alias: `module`
125117

126-
Checks if any of the functions in the stack trace match the glob. The match is case-sensitive:
118+
Similar to `stack.abs_path` but matches on the module name instead. The match is case-sensitive and regular globbing rules apply (`*` also matches slashes).
127119

128120
```bash {tabTitle:Fingerprinting Config}
129-
stack.function:"my_assertion_failed" -> my-assertion-failed
121+
stack.module:"*/my-utils/*" -> my-utils, {{ error.type }}
130122
```
131123

132124
### `stack.package`
@@ -140,12 +132,12 @@ stack.package:"**/libcurl.dylib" -> libcurl
140132
stack.package:"**/libcurl.so" -> libcurl
141133
```
142134

143-
### `family`
135+
### `tags.tag_name`
144136

145-
Used to "scope" down the matcher. The following families exist: `javascript` for any type of JavaScript event, `native` for any type of Native event. Any other platform is called `other`.
137+
Matches on the value of the tag `tag_name`. This can be useful to filter down certain types of events. For instance, you can separate events caused by a specific server:
146138

147139
```bash {tabTitle:Fingerprinting Config}
148-
family:native !stack.module:"myproject::*" -> not-from-my-project
140+
tags.server_name:"canary-*.mycompany.internal" -> canary-events
149141
```
150142

151143
Additionally, the folowing utility matchers are available:
@@ -158,6 +150,14 @@ Checks if the frame is in-app or not. It is particularly useful when combined wi
158150
app:yes stack.function:"assert" -> assert
159151
```
160152

153+
### `family`
154+
155+
Used to "scope" down the matcher. The following families exist: `javascript` for any type of JavaScript event, `native` for any type of Native event. Any other platform is called `other`.
156+
157+
```bash {tabTitle:Fingerprinting Config}
158+
family:native !stack.module:"myproject::*" -> not-from-my-project
159+
```
160+
161161
</DefinitionList>
162162

163163
## Combining Matchers
@@ -188,14 +188,6 @@ This fills in the default fingerprint that would be produced by the normal group
188188
stack.function:"query_database" -> {{ default }}, {{ transaction }}
189189
```
190190

191-
### `{{ transaction }}`
192-
193-
This fills in the name of the transaction into the fingerprint. It will force the creation of a group per transaction:
194-
195-
```bash {tabTitle:Fingerprinting Config}
196-
error.type:"ApiError" -> api-error, {{ transaction }}
197-
```
198-
199191
### `{{ error.type }}`
200192

201193
alias: `{{ type }}`
@@ -216,14 +208,30 @@ This fills in the stringified value of the error that occurred. When chained exc
216208
error.type:"ScriptError" -> script-evaluation, {{ error.value }}
217209
```
218210

219-
### `{{ stack.function }}`
211+
### `{{ level }}`
220212

221-
alias: `{{ function }}`
213+
This fills in the name of the log level that was used to create an event.
222214

223-
This fills in the function name of the "crashing frame," also known as the application code's topmost frame.
215+
```bash {tabTitle:Fingerprinting Config}
216+
message:"connection error*" -> connection-error, {{ logger }}, {{ level }}
217+
```
218+
219+
### `{{ logger }}`
220+
221+
This fills in the name of the logger that caused an event.
224222

225223
```bash {tabTitle:Fingerprinting Config}
226-
error.type:"ScriptError" -> script-evaluation, {{ stack.function }}
224+
message:"critical connection error*" -> connection-error, {{ logger }}
225+
```
226+
227+
### `{{ message }}`
228+
229+
This fills in the message of the event (similar to `error.value` but for
230+
captured messages). Note that this can produce groups with poor data quality if
231+
messages are changing frequently:
232+
233+
```bash {tabTitle:Fingerprinting Config}
234+
logger:"com.foo.auditlogger.*" -> audit-log, {{ message }}
227235
```
228236

229237
### `{{ stack.abs_path }}`
@@ -244,6 +252,16 @@ This is like `stack.abs_path` but will only fill in the relative file name:
244252
error.type:"ScriptError" -> script-evaluation, {{ stack.filename }}
245253
```
246254

255+
### `{{ stack.function }}`
256+
257+
alias: `{{ function }}`
258+
259+
This fills in the function name of the "crashing frame," also known as the application code's topmost frame.
260+
261+
```bash {tabTitle:Fingerprinting Config}
262+
error.type:"ScriptError" -> script-evaluation, {{ stack.function }}
263+
```
264+
247265
### `{{ stack.module }}`
248266

249267
alias: `{{ module }}`
@@ -264,22 +282,6 @@ This fills in the package name (object file) of the "crashing frame," also known
264282
stack.function:"assert" -> assertion, {{ stack.package }}
265283
```
266284

267-
### `{{ logger }}`
268-
269-
This fills in the name of the logger that caused an event.
270-
271-
```bash {tabTitle:Fingerprinting Config}
272-
message:"critical connection error*" -> connection-error, {{ logger }}
273-
```
274-
275-
### `{{ level }}`
276-
277-
This fills in the name of the log level that was used to create an event.
278-
279-
```bash {tabTitle:Fingerprinting Config}
280-
message:"connection error*" -> connection-error, {{ logger }}, {{ level }}
281-
```
282-
283285
### `{{ tags.tag_name }}`
284286

285287
This fills in the value of a tag into the fingerprint, which can, for instance, be used to split events by server name or something similar.
@@ -288,14 +290,12 @@ This fills in the value of a tag into the fingerprint, which can, for instance,
288290
message:"connection error*" -> connection-error, {{ tags.server_name }}
289291
```
290292

291-
### `{{ message }}`
293+
### `{{ transaction }}`
292294

293-
This fills in the message of the event (similar to `error.value` but for
294-
captured messages). Note that this can produce groups with poor data quality if
295-
messages are changing frequently:
295+
This fills in the name of the transaction into the fingerprint. It will force the creation of a group per transaction:
296296

297297
```bash {tabTitle:Fingerprinting Config}
298-
logger:"com.foo.auditlogger.*" -> audit-log, {{ message }}
298+
error.type:"ApiError" -> api-error, {{ transaction }}
299299
```
300300

301301
</DefinitionList>

0 commit comments

Comments
 (0)