This is a cache of https://www.elastic.co/guide/en/apm/agent/dotnet/current/performance-tuning.html. It is a snapshot of the page at 2024-08-28T01:02:41.867+0000.
Performance tuning | APM .NET Agent Reference [1.x] | Elastic

Performance tuning

edit

There are many options available to tune agent performance. Which option to adjust depends on whether you are optimizing for speed, memory usage, bandwidth or storage.

Sampling

edit

The first knob to reach for when tuning the performance of the agent is TransactionSampleRate. Adjusting the sample rate controls what percent of requests are traced. By default, the sample rate is set at 1.0, meaning all requests are traced.

The sample rate will impact all four performance categories, so simply turning down the sample rate is an easy way to improve performance.

Here’s an example of setting the sample rate to 20% using Configuration on ASP.NET Core:

{
    "ElasticApm": {
        "TransactionSampleRate": 0.2
    }
}

Stack traces

edit

In a complex application, a request may produce many spans. Capturing a stack trace for every span can result in significant memory usage. Stack traces are also captured for every error. There are several settings to adjust how stack traces are captured.

Disable capturing stack traces

edit

To disable capturing stack traces (for both spans and errors), set StackTraceLimit to 0.

Capture stack traces only for long running spans

edit

In its default settings, the APM agent collects a stack trace for every recorded span with duration longer than 5ms. To increase the duration threshold, set SpanStackTraceMinDuration.

Reduce number of captured stack trace frames

edit

The StackTraceLimit controls how many stack frames should be collected when a capturing stack trace.

Disable capturing HTTP request and response headers

edit

Capturing HTTP request and response headers increases memory allocations, network bandwidth and disk space used by elasticsearch. To disable capturing HTTP request and response headers, set CaptureHeaders to false.

Increase metrics collection interval

edit

The .NET agent tracks certain system and application metrics. These metrics are regularly collected and sent to the APM Server and from there to elasticsearch. You can adjust the interval for metrics collection with the setting MetricsInterval.