Azure-docs: Document states items will not get sampled when below MaxTelemetryItemsPerSecond

[Dhugal]

Can your just confirm if the following statement is correct please or should it say that items will get sampled when below the MaxTelemetryItemsPerSecond rate?

If the application produces a low amount of telemetry, such as when debugging or due to low usage, items won't get sampled as long as volume is below MaxTelemetryItemsPerSecond. As the volume of telemetry increases, sampling rate is adjusted so as to achieve the target volume.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 2f4c906d-7abe-eab7-331a-120230344583
• Version Independent ID: ab24ade5-5e4c-b430-c3f8-2a00073e9e81
• Content: Telemetry sampling in Azure Application Insights
• Content Source: articles/azure-monitor/app/sampling.md
• Service: application-insights
• GitHub Login: @cijothomas
• Microsoft Alias: cithomas

[BhargaviAnnadevara-MSFT]

@Dhugal Thanks for the question!

As the doc states, the intent of employing Sampling is to reduce telemetry traffic and storage, while preserving a statistically correct analysis of your application data. Sampling reduces traffic and data costs, and helps you avoid throttling.

So indeed, as far as I understand, data wouldn't need to be sampled if the volume of telemetry is below the threshold set by the MaxTelemetryItemsPerSecond setting. Having said that, please note that this setting is configurable via ApplicationInsights.config or programmatically so it helps you remain within your target rate of traffic.

@cijothomas Please share your insights about the same, if there's more to this.

[Dhugal]

@BhargaviAnnadevara-MSFT - thank you.

I assumed that the MaxTelemetryItemsPerSecond was an upper rather than lower limit for capturing telemetry - have I misunderstood?

[cijothomas]

Lets modify like below:

If the application produces a low amount of telemetry, such as when debugging or due to low usage, items won't be dropped by sampling processor as long as volume is below MaxTelemetryItemsPerSecond. As the volume of telemetry increases, sampling rate is adjusted so as to achieve the target volume.

[cijothomas]

MaxTelemetryItemsPerSecond is the upper limit sampling attempts to achieve.

[Dhugal]

@cijothomas - great, thanks for the clarification.

[BhargaviAnnadevara-MSFT]

@cijothomas Thanks for the additional clarification!

@Dhugal I've submitted a PR with this change, which is merged internally and will go live in the public docs soon! Thanks again for the feedback! We will now proceed to close this thread as resolved, but if there are any further questions regarding the documentation, please tag me in your reply and we will be happy to continue the conversation.