Stacktrace configuration options
editStacktrace configuration options
editApplicationNamespaces
(
[1.5]
Added in 1.5.
)
editThis is used to determine whether a stack trace frame is an in-app frame or a library frame. When defined, all namespaces that do not start with one of the values of this collection are ignored when determining error culprit.
Multiple namespaces can be configured as a comma separated list. For example: "MyAppA, MyAppB"
.
This suppresses any configuration of ExcludedNamespaces
.
Default | Type |
---|---|
<empty string> |
String |
Environment variable name | IConfiguration or web.config key |
---|---|
|
|
ExcludedNamespaces
(
[1.5]
Added in 1.5.
)
editA list of namespaces to exclude when reading an exception StackTrace to determine the culprit.
Namespaces are checked with string.StartsWith()
, so "System." matches all System namespaces.
Default | Type |
---|---|
"System., Microsoft., MS., FSharp., Newtonsoft.Json, Serilog, NLog, Giraffe." |
String |
Environment variable name | IConfiguration or web.config key |
---|---|
|
|
StackTraceLimit
(performance)
editSetting this to 0
disables stack trace collection. Any positive integer value will be used as the maximum number of frames to collect. Setting it to -1 means that all frames will be collected.
Default | Type |
---|---|
|
Integer |
Environment variable name | IConfiguration or web.config key |
---|---|
|
|
If you would like to disable stack trace capturing only for spans, but still capture stack traces for errors, set the SpanStackTraceMinDuration
(performance) config to -1
.
SpanStackTraceMinDuration
(performance)
editIn its default settings,
the APM agent collects a stack trace for every recorded span with duration longer than 5ms
.
While this is very helpful to find the exact place in your code that causes the span,
collecting this stack trace does have some overhead.
When setting this option to zero (regardless of the time unit), like 0ms
, stack traces are collected for all spans.
Setting it to a positive value, e.g. 5ms
,
limits stack trace collection to spans with durations equal to or longer than the given value,
e.g. 5 milliseconds.
To disable stack trace collection for spans completely, set this option to a negative value,
like -1ms
.
Supports the duration suffixes ms
, s
and m
.
Example: 5ms
.
The default unit for this option is ms
Default | Type |
---|---|
|
TimeDuration |
Environment variable name | IConfiguration or web.config key |
---|---|
|
|
Use of SpanFramesMinDuration
is deprecated. Use SpanStackTraceMinDuration
.