Steekproeven in Application Insights

Sampling is een functie in Azure-toepassing Insights. Het is de aanbevolen manier om telemetrieverkeer, gegevenskosten en opslagkosten te verlagen, met behoud van een statistisch juiste analyse van toepassingsgegevens. Steekproeven helpen u ook om te voorkomen Insights van uw telemetrie. Het samplingfilter selecteert items die gerelateerd zijn, zodat u tussen items kunt navigeren wanneer u diagnostische onderzoeken doet.

Wanneer metrische gegevens worden weergegeven in de portal, worden ze opnieuw genormaliseerd om rekening te houden met steekproeven. Hierdoor wordt elk effect op de statistieken geminimaliseerd.

Korte samenvatting

• Er zijn drie verschillende soorten steekproeven: adaptieve steekproeven, steekproeven met vaste snelheid en opnamesampling.
• Adaptieve steekproeven zijn standaard ingeschakeld in alle nieuwste versies van application Insights ASP.NET en ASP.NET Core Software Development Kits (SDK's). Het wordt ook gebruikt door Azure Functions.
• Steekproeven met vaste snelheid zijn beschikbaar in recente versies van de Application Insights SDK's voor ASP.NET, ASP.NET Core, Java (zowel de agent als de SDK) en Python.
• In Java zijn sampling-overschrijvingen beschikbaar en zijn ze handig wanneer u verschillende samplingfrequenties moet toepassen op geselecteerde afhankelijkheden, aanvragen en statuscontrole. Gebruik sampling-overschrijvingen om een aantal ruisafhankelijkheden af te stemmen, terwijl bijvoorbeeld alle belangrijke fouten op 100% worden gehouden. Dit is een vorm van vaste steekproeven die u een fijnkeurig niveau van controle over uw telemetrie biedt.
• Opnamesampling werkt op het Application Insights service-eindpunt. Dit is alleen van toepassing wanneer er geen andere steekproeven van kracht zijn. Als de SDK uw telemetrievoorbeelden heeft, is opnamesampling uitgeschakeld.
• Als u voor webtoepassingen aangepaste gebeurtenissen vastlegt en ervoor moet zorgen dat een reeks gebeurtenissen samen wordt bewaard of verwijderd, moeten de gebeurtenissen dezelfde waarde OperationId hebben.
• Als u Analytics-query's schrijft, moet u rekening houden met steekproeven. Gebruik met name in plaats van alleen records te summarize sum(itemCount) tellen.
• Sommige telemetrietypen, waaronder metrische prestatiegegevens en aangepaste metrische gegevens, worden altijd bewaard, ongeacht of steekproeven al dan niet zijn ingeschakeld.

De volgende tabel bevat een overzicht van de samplingtypen die beschikbaar zijn voor elke SDK en elk type toepassing:

Typen steekproeven

Er zijn drie verschillende samplingmethoden:

• Adaptieve steekproeven passen automatisch het volume aan telemetrie aan dat vanuit de SDK wordt verzonden in uw ASP.NET/ASP.NET Core-app en vanuit Azure Functions. Dit is de standaardsampling wanneer u de ASP.NET of ASP.NET Core SDK gebruikt. Adaptieve steekproeven zijn momenteel alleen beschikbaar ASP.NET telemetrie aan de serverzijde en voor Azure Functions.

• Steekproeven met vaste snelheid verminderen de hoeveelheid telemetrie die wordt verzonden vanuit zowel uw ASP.NET- of ASP.NET Core- of Java-server als vanuit de browsers van uw gebruikers. U stelt de snelheid in. De client en server synchroniseren hun steekproef, zodat u in Zoeken kunt navigeren tussen gerelateerde paginaweergaven en aanvragen.

• Opnamesampling vindt plaats op het application Insights service-eindpunt. Een deel van de telemetrie die vanuit uw app binnenkomt, wordt verwijderd met een samplingfrequentie die u hebt ingesteld. Het vermindert niet het telemetrieverkeer dat vanuit uw app wordt verzonden, maar helpt u om binnen uw maandelijkse quotum te blijven. Het belangrijkste voordeel van opnamesampling is dat u de samplingfrequentie kunt instellen zonder uw app opnieuw te moeten uitvoeren. Opnamesampling werkt op uniforme wijze voor alle servers en clients, maar is niet van toepassing wanneer er andere typen steekproeven worden uitgevoerd.

Adaptieve steekproeven

Adaptieve steekproeven zijn van invloed op het volume van de telemetrie die vanuit uw webserver-app naar het Application Insights service-eindpunt wordt verzonden.

Het volume wordt automatisch aangepast om binnen een opgegeven maximale verkeerssnelheid te blijven en wordt beheerd via de instelling MaxTelemetryItemsPerSecond . Als de toepassing een lage hoeveelheid telemetrie produceert, zoals bij het debuggen of vanwege een laag gebruik, worden items niet verwijderd door de samplingprocessor zolang het volume lager MaxTelemetryItemsPerSecond is. Naarmate het volume van de telemetrie toeneemt, wordt de steekproeffrequentie aangepast om het doelvolume te bereiken. De aanpassing wordt regelmatig opnieuw berekend en is gebaseerd op een bewegend gemiddelde van de uitgaande overdrachtssnelheid.

Om het doelvolume te bereiken, wordt een deel van de gegenereerde telemetrie verwijderd. Maar net als andere typen steekproeven behoudt het algoritme gerelateerde telemetrie-items. Wanneer u bijvoorbeeld de telemetrie inspecteert in Zoeken, kunt u de aanvraag vinden die betrekking heeft op een bepaalde uitzondering.

Metrische gegevens zoals aanvraagsnelheid en uitzonderingsfrequentie worden aangepast om de steekproeffrequentie te compenseren, zodat ze ongeveer de juiste waarden weergeven in Metric Explorer.

Adaptieve steekproeven configureren voor ASP.NET toepassingen

In ApplicationInsights.config kunt u verschillende parameters in het AdaptiveSamplingTelemetryProcessor knooppunt aanpassen. De weergegeven cijfers zijn de standaardwaarden:

• <MaxTelemetryItemsPerSecond>5</MaxTelemetryItemsPerSecond>

  De doelsnelheid van logische bewerkingen die het adaptieve algoritme op elke serverhost wil verzamelen. Als uw web-app op veel hosts wordt uitgevoerd, vermindert u deze waarde zodat deze binnen de doelsnelheid van het verkeer blijft in de Application Insights portal.

• <EvaluationInterval>00:00:15</EvaluationInterval>

  Het interval waarmee de huidige telemetriesnelheid opnieuw wordt geëvalueerd. Evaluatie wordt uitgevoerd als een bewegend gemiddelde. Mogelijk wilt u dit interval verkorten als uw telemetrie aansprakelijk is voor plotselinge bursts.

• <SamplingPercentageDecreaseTimeout>00:02:00</SamplingPercentageDecreaseTimeout>

  Wanneer de waarde van het steekproefpercentage verandert, hoe snel daarna mogen we het steekproefpercentage opnieuw verlagen om minder gegevens vast te leggen?

• <SamplingPercentageIncreaseTimeout>00:15:00</SamplingPercentageIncreaseTimeout>

  Wanneer de waarde van het steekproefpercentage verandert, hoe snel daarna mogen we het steekproefpercentage opnieuw verhogen om meer gegevens vast te leggen?

• <MinSamplingPercentage>0.1</MinSamplingPercentage>

  Als het steekproefpercentage varieert, wat is de minimumwaarde die we mogen instellen?

• <MaxSamplingPercentage>100.0</MaxSamplingPercentage>

  Als het steekproefpercentage varieert, wat is de maximale waarde die we mogen instellen?

• <MovingAverageRatio>0.25</MovingAverageRatio>

  In de berekening van het bewegende gemiddelde geeft dit het gewicht aan dat moet worden toegewezen aan de meest recente waarde. Gebruik een waarde die gelijk is aan of kleiner is dan 1. Kleinere waarden zorgen ervoor dat het algoritme minder reactief is op plotselinge wijzigingen.

• <InitialSamplingPercentage>100</InitialSamplingPercentage>

  De hoeveelheid telemetrie die moet worden genomen wanneer de app net is gestart. Verminder deze waarde niet terwijl u debuggen bent.

• <ExcludedTypes>Trace;Exception</ExcludedTypes>

  Een lijst met door puntma's en dubbele puntsefinen met scheidingstekens van typen die u niet wilt bemonsteren. Herkende typen zijn: Dependency , , , , , Event Exception PageView Request Trace . Alle telemetrie van de opgegeven typen wordt verzonden; De typen die niet worden opgegeven, worden als steekproef genomen.

• <IncludedTypes>Request;Dependency</IncludedTypes>

  Een lijst met door puntma's met puntma's scheidingstekens van typen die u aan een steekproef wilt onderwerpen. Herkende typen zijn: Dependency , , , , , Event Exception PageView Request Trace . Er wordt een steekproef genomen van de opgegeven typen; alle telemetrie van de andere typen wordt altijd verzonden.

Als u adaptieve steekproeven wilt uitschakelen, verwijdert u AdaptiveSamplingTelemetryProcessor de knooppunten uit ApplicationInsights.config .

Alternatief: Adaptieve steekproeven in code configureren

In plaats van de steekproefparameter in het bestand in te .config stellen, kunt u deze waarden programmatisch instellen.

1. Verwijder alle AdaptiveSamplingTelemetryProcessor knooppunt(en) uit het .config bestand.

2. Gebruik het volgende codefragment om adaptieve steekproeven te configureren:

   using Microsoft.ApplicationInsights;
   using Microsoft.ApplicationInsights.Extensibility;
   using Microsoft.ApplicationInsights.WindowsServer.Channel.Implementation;
   using Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel;
   
   // ...
   
   var builder = TelemetryConfiguration.Active.DefaultTelemetrySink.TelemetryProcessorChainBuilder;
   // For older versions of the Application Insights SDK, use the following line instead:
   // var builder = TelemetryConfiguration.Active.TelemetryProcessorChainBuilder;
   
   // Enable AdaptiveSampling so as to keep overall telemetry volume to 5 items per second.
   builder.UseAdaptiveSampling(maxTelemetryItemsPerSecond:5);
   
   // If you have other telemetry processors:
   builder.Use((next) => new AnotherProcessor(next));
   
   builder.Build();
   

   (Meer informatie over telemetrieprocessors.)

U kunt ook de steekproeffrequentie voor elk telemetrietype afzonderlijk aanpassen of zelfs bepaalde typen uitsluiten van het nemen van steekproeven:

// The following configures adaptive sampling with 5 items per second, and also excludes Dependency telemetry from being subjected to sampling.
builder.UseAdaptiveSampling(maxTelemetryItemsPerSecond:5, excludedTypes: "Dependency");

Adaptieve steekproeven configureren voor ASP.NET Core toepassingen

Er is geen ApplicationInsights.config voor ASP.NET Core toepassingen, dus alle configuratie wordt uitgevoerd via code. Adaptieve steekproeven zijn standaard ingeschakeld voor alle ASP.NET Core toepassingen. U kunt het steekproefgedrag uitschakelen of aanpassen.

Adaptieve steekproeven uitschakelen

De standaardsamplingfunctie kan worden uitgeschakeld tijdens het toevoegen Insights Application Insights-service, in de methode ConfigureServices , met behulp van in het bestand ApplicationInsightsServiceOptions Startup.cs :

public void ConfigureServices(IServiceCollection services)
{
    // ...

    var aiOptions = new Microsoft.ApplicationInsights.AspNetCore.Extensions.ApplicationInsightsServiceOptions();
    aiOptions.EnableAdaptiveSampling = false;
    services.AddApplicationInsightsTelemetry(aiOptions);

    //...
}

Met de bovenstaande code wordt adaptieve steekproeven uitgeschakeld. Volg de onderstaande stappen om steekproeven toe te voegen met meer aanpassingsopties.

Steekproefinstellingen configureren

Gebruik uitbreidingsmethoden van TelemetryProcessorChainBuilder zoals hieronder wordt weergegeven om het steekproefgedrag aan te passen.

using Microsoft.ApplicationInsights.Extensibility

public void Configure(IApplicationBuilder app, IHostingEnvironment env, TelemetryConfiguration configuration)
{
    var builder = configuration.DefaultTelemetrySink.TelemetryProcessorChainBuilder;
    // For older versions of the Application Insights SDK, use the following line instead:
    // var builder = configuration.TelemetryProcessorChainBuilder;

    // Using adaptive sampling
    builder.UseAdaptiveSampling(maxTelemetryItemsPerSecond:5);

    // Alternately, the following configures adaptive sampling with 5 items per second, and also excludes DependencyTelemetry from being subject to sampling.
    // builder.UseAdaptiveSampling(maxTelemetryItemsPerSecond:5, excludedTypes: "Dependency");

    // If you have other telemetry processors:
    builder.Use((next) => new AnotherProcessor(next));
    
    builder.Build();

    // ...
}

Adaptieve steekproeven configureren voor Azure Functions

Volg de instructies op deze pagina om adaptieve steekproeven te configureren voor apps die worden uitgevoerd in Azure Functions.

Steekproeven met vaste snelheid

Steekproeven met vaste snelheid verminderen het verkeer dat vanaf uw webserver en webbrowsers wordt verzonden. In tegenstelling tot adaptieve steekproeven, vermindert dit de telemetrie met een vaste snelheid die door u is bepaald. Sampling met vaste snelheid is beschikbaar voor ASP.NET-, ASP.NET Core-, Java- en Python-toepassingen.

Net als bij andere samplingtechnieken blijven hier ook gerelateerde items behouden. Ook worden de steekproeven van de client en de server gesynchroniseerd, zodat gerelateerde items behouden blijven. Wanneer u bijvoorbeeld een paginaweergave in Zoeken bekijkt, kunt u de gerelateerde serveraanvragen vinden.

In Metrics Explorer worden percentages zoals het aantal aanvragen en uitzonderingen vermenigvuldigd met een factor om de steekproeffrequentie te compenseren, zodat ze ongeveer juist zijn.

Sampling met vaste snelheid configureren voor ASP.NET toepassingen

1. Adaptieve steekproeven uitschakelen: in ApplicationInsights.config verwijdert u het knooppunt of maakt u commentaar van AdaptiveSamplingTelemetryProcessor het knooppunt.

   <TelemetryProcessors>
       <!-- Disabled adaptive sampling:
       <Add Type="Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel.AdaptiveSamplingTelemetryProcessor, Microsoft.AI.ServerTelemetryChannel">
           <MaxTelemetryItemsPerSecond>5</MaxTelemetryItemsPerSecond>
       </Add>
       -->
   

2. Schakel de module steekproeven met vaste snelheid in. Voeg dit fragment toe aan ApplicationInsights.config :

   <TelemetryProcessors>
       <Add Type="Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel.SamplingTelemetryProcessor, Microsoft.AI.ServerTelemetryChannel">
           <!-- Set a percentage close to 100/N where N is an integer. -->
           <!-- E.g. 50 (=100/2), 33.33 (=100/3), 25 (=100/4), 20, 1 (=100/100), 0.1 (=100/1000) -->
           <SamplingPercentage>10</SamplingPercentage>
       </Add>
   </TelemetryProcessors>
   

   U kunt de volgende waarden ook programmatisch instellen in plaats van de steekproefparameter in te ApplicationInsights.config stellen in het bestand:

   using Microsoft.ApplicationInsights.Extensibility;
   using Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel;
   
   // ...
   
   var builder = TelemetryConfiguration.Active.DefaultTelemetrySink.TelemetryProcessorChainBuilder;
   // For older versions of the Application Insights SDK, use the following line instead:
   // var builder = TelemetryConfiguration.Active.TelemetryProcessorChainBuilder;
   
   builder.UseSampling(10.0); // percentage
   
   // If you have other telemetry processors:
   builder.Use((next) => new AnotherProcessor(next));
   
   builder.Build();
   

   (Meer informatie over telemetrieprocessors.)

Steekproeven met vaste snelheid configureren voor ASP.NET Core toepassingen

1. Adaptieve steekproeven uitschakelen: wijzigingen kunnen worden aangebracht in de ConfigureServices methode met behulp van ApplicationInsightsServiceOptions :

   public void ConfigureServices(IServiceCollection services)
   {
       // ...
   
       var aiOptions = new Microsoft.ApplicationInsights.AspNetCore.Extensions.ApplicationInsightsServiceOptions();
       aiOptions.EnableAdaptiveSampling = false;
       services.AddApplicationInsightsTelemetry(aiOptions);
   
       //...
   }
   

2. Schakel de module steekproeven met vaste snelheid in. Wijzigingen kunnen worden aangebracht in de Configure methode , zoals wordt weergegeven in het onderstaande fragment:

   public void Configure(IApplicationBuilder app, IHostingEnvironment env)
   {
       var configuration = app.ApplicationServices.GetService<TelemetryConfiguration>();
   
       var builder = configuration.DefaultTelemetrySink.TelemetryProcessorChainBuilder;
       // For older versions of the Application Insights SDK, use the following line instead:
       // var builder = configuration.TelemetryProcessorChainBuilder;
   
       // Using fixed rate sampling
       double fixedSamplingPercentage = 10;
       builder.UseSampling(fixedSamplingPercentage);
   
       builder.Build();
   
       // ...
   }
   

Sampling-overschrijvingen en steekproeven met vaste snelheid configureren voor Java-toepassingen

Er is standaard geen sampling ingeschakeld in de automatische instrumentatie en SDK van Java. Momenteel worden automatische instrumentatie van Java, sampling-overschrijvingen en steekproeven met vaste snelheid ondersteund. Adaptieve steekproeven worden niet ondersteund in Java.

Automatische instrumentatie van Java configureren

• Als u sampling-overschrijvingen wilt configureren die het aantal defaulrsampling overschrijven en verschillende steekproeffrequenties toepassen op geselecteerde aanvragen en afhankelijkheden, gebruikt u de handleiding voor het overschrijven van steekproeven.
• Als u samping met vaste snelheid wilt configureren die van toepassing is op al uw telemetrie, gebruikt u de gids voor steekproeven met vaste snelheid.

Java 2.x SDK configureren

1. Download en configureer uw webtoepassing met de nieuwste Application Insights Java SDK.

2. Schakel de module steekproeven met vaste snelheid in door het volgende fragment toe te voegen aan het ApplicationInsights.xml bestand:

   <TelemetryProcessors>
       <BuiltInProcessors>
           <Processor type="FixedRateSamplingTelemetryProcessor">
               <!-- Set a percentage close to 100/N where N is an integer. -->
               <!-- E.g. 50 (=100/2), 33.33 (=100/3), 25 (=100/4), 20, 1 (=100/100), 0.1 (=100/1000) -->
               <Add name="SamplingPercentage" value="50" />
           </Processor>
       </BuiltInProcessors>
   </TelemetryProcessors>
   

3. U kunt specifieke typen telemetrie opnemen of uitsluiten van steekproeven met behulp van de volgende tags in de Processor van de tag FixedRateSamplingTelemetryProcessor :

   <ExcludedTypes>
       <ExcludedType>Request</ExcludedType>
   </ExcludedTypes>
   
   <IncludedTypes>
       <IncludedType>Exception</IncludedType>
   </IncludedTypes>
   

De telemetrietypen die kunnen worden opgenomen of uitgesloten van steekproeven zijn: Dependency , , , , en Event Exception PageView Request Trace .

Sampling met vaste snelheid configureren voor OpenCensus Python-toepassingen

Instrumenteren van uw toepassing met de meest recente OpenCensus Azure Monitor export.

Steekproeven met vaste snelheid voor tracering

U kunt een sampler opgeven als onderdeel van uw Tracer-configuratie. Als er geen expliciete sampler is opgegeven, ProbabilitySampler wordt standaard de gebruikt. De gebruikt standaard een snelheid van 1/10000, wat betekent dat één van elke 10000 aanvragen wordt verzonden naar ProbabilitySampler Application Insights. Zie hieronder als u zelf een samplefrequentie wilt opgeven.

Als u de steekproeffrequentie wilt opgeven, moet u ervoor zorgen dat u een sampler opgeeft met een steekproeffrequentie tussen Tracer 0,0 en 1,0. Een steekproeffrequentie van 1,0 vertegenwoordigt 100%, wat betekent dat al uw aanvragen als telemetrie worden verzonden naar Application Insights.

tracer = Tracer(
    exporter=AzureExporter(
        instrumentation_key='00000000-0000-0000-0000-000000000000',
    ),
    sampler=ProbabilitySampler(1.0),
)

Steekproeven met vaste snelheid voor logboeken

U kunt steekproeven met vaste snelheid voor AzureLogHandler configureren door het optionele logging_sampling_rate argument te wijzigen. Als er geen argument wordt opgegeven, wordt een samplefrequentie van 1,0 gebruikt. Een steekproeffrequentie van 1,0 vertegenwoordigt 100%, wat betekent dat al uw aanvragen als telemetrie worden verzonden naar Application Insights.

handler = AzureLogHandler(
    instrumentation_key='00000000-0000-0000-0000-000000000000',
    logging_sampling_rate=0.5,
)

Steekproeven met vaste snelheid configureren voor webpagina's met JavaScript

JavaScript-webpagina's kunnen worden geconfigureerd voor het gebruik van Application Insights. Telemetrie wordt verzonden vanuit de clienttoepassing die wordt uitgevoerd in de browser van de gebruiker en de pagina's kunnen vanaf elke server worden gehost.

Wanneer u uw op JavaScript gebaseerde webpagina'sconfigureert voor Application Insights, wijzigt u het JavaScript-fragment dat u uit de Application Insights portal.

Voeg een regel in zoals samplingPercentage: 10, vóór de instrumentatiesleutel:

<script>
    var appInsights = // ... 
    ({ 
      // Value must be 100/N where N is an integer.
      // Valid examples: 50, 25, 20, 10, 5, 1, 0.1, ...
      samplingPercentage: 10, 

      instrumentationKey: ...
    }); 

    window.appInsights = appInsights; 
    appInsights.trackPageView(); 
</script>

Kies voor het steekproefpercentage een percentage dat dicht bij 100/N ligt, waarbij N een geheel getal is. Steekproeven bieden momenteel geen ondersteuning voor andere waarden.

Coördinatie van steekproeven aan serverzijde en clientzijde

De JavaScript SDK aan de clientzijde neemt deel aan steekproeven met vaste snelheid in combinatie met de SDK aan de serverzijde. De instrumentatiepagina's verzenden alleen telemetrie aan de clientzijde van dezelfde gebruiker waarvoor de SDK aan de serverzijde heeft besloten om op te nemen in de steekproef. Deze logica is ontworpen om de integriteit van gebruikerssessies in client- en servertoepassingen te behouden. Als gevolg hiervan kunt u vanuit een bepaald telemetrie-item in Application Insights alle andere telemetrie-items voor deze gebruiker of sessie vinden en kunt u in Zoeken navigeren tussen gerelateerde paginaweergaven en -aanvragen.

Als uw client- en server-side telemetrie geen gecoördineerde voorbeelden tonen:

• Controleer of u steekproeven zowel op de server als op de client hebt ingeschakeld.
• Controleer of u hetzelfde steekproefpercentage in zowel de client als de server hebt ingesteld.
• Zorg ervoor dat de SDK-versie 2.0 of hoger is.

Opnamesampling

Opnamesampling wordt uitgevoerd op het punt waar de telemetrie van uw webserver, browsers en apparaten het Application Insights-service-eindpunt bereikt. Hoewel het telemetrieverkeer dat vanuit uw app wordt verzonden niet wordt beperkt, wordt de hoeveelheid verwerkt en bewaard (en in rekening gebracht) door Application Insights.

Gebruik dit type steekproeven als uw app vaak het maandelijkse quotum overschrijdt en u niet de mogelijkheid hebt om een van de SDK-typen steekproeven te gebruiken.

Stel de steekproeffrequentie in op de pagina Gebruik en geschatte kosten:

Net als andere typen steekproeven behoudt het algoritme gerelateerde telemetrie-items. Wanneer u bijvoorbeeld de telemetrie inspecteert in Zoeken, kunt u de aanvraag vinden die betrekking heeft op een bepaalde uitzondering. Metrische gegevens zoals aanvraagsnelheid en uitzonderingsfrequentie worden correct bewaard.

Gegevenspunten die worden verwijderd door steekproeven zijn niet beschikbaar in een Application Insights-functie, zoals Continue export.

Opnamesampling werkt niet terwijl adaptieve steekproeven of steekproeven met een vaste snelheid worden uitgevoerd. Adaptieve steekproeven worden standaard ingeschakeld wanneer de ASP.NET SDK of de ASP.NET Core SDK wordt gebruikt, of wanneer Application Insights is ingeschakeld in Azure App Service of met behulp van Status Monitor. Wanneer telemetrie wordt ontvangen door het Application Insights-service-eindpunt, wordt de telemetrie onderzocht en als wordt gerapporteerd dat de steekproeffrequentie minder dan 100% is (wat aangeeft dat er een steekproef wordt genomen van telemetrie), wordt de opnamesamplingsfrequentie genegeerd die u hebt ingesteld.

Wanneer steekproeven gebruiken

Over het algemeen hebt u voor de meeste kleine en middelgrote toepassingen geen steekproeven nodig. De nuttigste diagnostische gegevens en de meest nauwkeurige statistieken worden verkregen door gegevens over al uw gebruikersactiviteiten te verzamelen.

De belangrijkste voordelen van steekproeven zijn:

• Application Insights-service daalt ('beperkt') gegevenspunten wanneer uw app een zeer hoge snelheid van telemetrie verzendt in een kort tijdsinterval. Sampling vermindert de kans dat er een beperking optreedt in uw toepassing.
• Om binnen het quotum van gegevenspunten voor uw prijscategorie te blijven.
• Om netwerkverkeer van het verzamelen van telemetrie te verminderen.

Welk type steekproeven moet ik gebruiken?

Gebruik opnamesampling als:

• U gebruikt vaak uw maandelijkse quotum voor telemetrie.
• U krijgt te veel telemetrie van de webbrowsers van uw gebruikers.
• U gebruikt een versie van de SDK die geen ondersteuning biedt voor steekproeven, bijvoorbeeld ASP.NET eerdere versies dan 2.

Gebruik steekproeven met vaste snelheid als:

• U wilt gesynchroniseerde steekproeven tussen client en server, zodat u, wanneer u gebeurtenissen in Zoekenonderzoekt, kunt navigeren tussen gerelateerde gebeurtenissen op de client en server, zoals paginaweergaven en HTTP-aanvragen.
• U bent zeker van het juiste steekproefpercentage voor uw app. Deze moet hoog genoeg zijn om nauwkeurige metrische gegevens te krijgen, maar onder het tarief dat uw prijsquotum en de beperkingslimieten overschrijdt.

Adaptieve steekproeven gebruiken:

Als de voorwaarden voor het gebruik van de andere vormen van steekproeven niet van toepassing zijn, raden we adaptieve steekproeven aan. Deze instelling is standaard ingeschakeld in de ASP.NET/ASP.NET Core SDK. Het vermindert het verkeer pas als een bepaald minimumpercentage is bereikt. Daarom wordt er waarschijnlijk helemaal geen steekproef genomen van sites voor weinig gebruik.

Weten wanneer voorbeelden actief zijn

Als u de werkelijke steekproeffrequentie wilt achterhalen, ongeacht waar deze is toegepast, gebruikt u een Analytics-query zoals deze:

union requests,dependencies,pageViews,browserTimings,exceptions,traces
| where timestamp > ago(1d)
| summarize RetainedPercentage = 100/avg(itemCount) by bin(timestamp, 1h), itemType

Als u ziet dat voor elk type kleiner is dan 100, wordt er een steekproef genomen van dat RetainedPercentage type telemetrie.

Hoe steekproeven werken

Het samplingalgoritme bepaalt welke telemetrie-items moeten worden wegvallen en welke moeten worden behouden. Dit geldt ongeacht of steekproeven worden uitgevoerd door de SDK of in de Application Insights service. De steekproefbeslissing is gebaseerd op verschillende regels die zijn gericht op het intact houden van alle gerelateerde gegevenspunten, met behoud van een diagnostische ervaring in Application Insights die bruikbaar en betrouwbaar is, zelfs bij een gereduceerde gegevensset. Als uw app bijvoorbeeld een mislukte aanvraag heeft opgenomen in een voorbeeld, blijven de aanvullende telemetrie-items (zoals uitzonderingen en traceringen die zijn vastgelegd voor deze aanvraag) behouden. Steekproeven houden ze bij elkaar of vallen ze allemaal samen. Als u de aanvraagdetails in Application Insights bekijkt, ziet u daarom altijd de aanvraag samen met de bijbehorende telemetrie-items.

De steekproefbeslissing is gebaseerd op de bewerkings-id van de aanvraag, wat betekent dat alle telemetrie-items die bij een bepaalde bewerking horen, behouden blijven of worden uitgevallen. Voor de telemetrie-items die geen bewerkings-id-set hebben (zoals telemetrie-items die zijn gerapporteerd vanuit asynchrone threads zonder HTTP-context), wordt met steekproeven gewoon een percentage telemetrie-items van elk type vast leggen.

Wanneer u telemetriegegevens aan u presenteert, past de Application Insights-service de metrische gegevens aan met hetzelfde steekproefpercentage dat werd gebruikt op het moment van de verzameling, om de ontbrekende gegevenspunten te compenseren. Daarom zien de gebruikers bij het bekijken van de telemetrie in Application Insights statistisch juiste benaderingen die zeer dicht bij de werkelijke getallen liggen.

De nauwkeurigheid van de benadering is grotendeels afhankelijk van het geconfigureerde steekproefpercentage. Bovendien neemt de nauwkeurigheid toe voor toepassingen die een groot aantal in het algemeen vergelijkbare aanvragen van veel gebruikers verwerken. Aan de andere kant is er geen sampling nodig voor toepassingen die niet met een aanzienlijke belasting werken, omdat deze toepassingen meestal al hun telemetrie kunnen verzenden terwijl ze binnen het quotum blijven, zonder dat dit leidt tot gegevensverlies door beperking.

Veelgestelde vragen

Wat is het standaardsamplinggedrag in de ASP.NET en ASP.NET Core SDK's?

• Als u een van de nieuwste versies van de bovenstaande SDK gebruikt, is Adaptieve steekproeven standaard ingeschakeld met vijf telemetrie-items per seconde. Er zijn standaard twee knooppunten toegevoegd en één bevat het type in de steekproef, terwijl de andere het AdaptiveSamplingTelemetryProcessor Event type Event uitsluit van steekproeven. Deze configuratie betekent dat de SDK telemetrie-items probeert te beperken tot vijf telemetrie-items van de typen en vijf telemetrie-items van alle andere typen gecombineerd, zodat er afzonderlijk van andere telemetrietypen steek worden Event Events genomen. Gebeurtenissen worden doorgaans gebruikt voor zakelijke telemetrie en mogen waarschijnlijk niet worden beïnvloed door diagnostische telemetrievolumes.

  Hieronder ziet u het standaardbestand ApplicationInsights.config dat is gegenereerd. In ASP.NET Core is hetzelfde standaardgedrag ingeschakeld in code. Gebruik de voorbeelden in de vorige sectie van deze pagina om dit standaardgedrag te wijzigen.

  <TelemetryProcessors>
      <Add Type="Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel.AdaptiveSamplingTelemetryProcessor, Microsoft.AI.ServerTelemetryChannel">
          <MaxTelemetryItemsPerSecond>5</MaxTelemetryItemsPerSecond>
          <ExcludedTypes>Event</ExcludedTypes>
      </Add>
      <Add Type="Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel.AdaptiveSamplingTelemetryProcessor, Microsoft.AI.ServerTelemetryChannel">
          <MaxTelemetryItemsPerSecond>5</MaxTelemetryItemsPerSecond>
          <IncludedTypes>Event</IncludedTypes>
      </Add>
  </TelemetryProcessors>
  

Kan een steekproef van telemetrie meer dan één keer worden genomen?

• Nee. SamplingTelemetryProcessors negeren items uit steekproefoverwegingen als het item al in de steekproef is opgenomen. Hetzelfde geldt voor opnamesampling, die geen steekproeven zal toepassen op de items die al zijn opgenomen in de SDK zelf.

Waarom wordt er geen eenvoudig 'X procent van elk telemetrietype verzameld'?

• Hoewel deze samplingmethode een hoge mate van precisie biedt in metrische benaderingen, zou dit de mogelijkheid om diagnostische gegevens per gebruiker, sessie en aanvraag te correleren, breken, wat essentieel is voor diagnostische gegevens. Daarom werkt steekproeven beter met beleidsregels zoals 'verzamel alle telemetrie-items voor X procent van de app-gebruikers' of 'verzamel alle telemetrie voor X procent van app-aanvragen'. Voor de telemetrie-items die niet zijn gekoppeld aan de aanvragen (zoals asynchrone verwerking op de achtergrond), is de terugvalbewerking het verzamelen van X procent van alle items voor elk telemetrietype.

Kan het steekproefpercentage na een periode veranderen?

• Ja, adaptieve steekproeven wijzigen geleidelijk het steekproefpercentage, op basis van het momenteel waargenomen volume van de telemetrie.

Als ik steekproeven met vaste snelheid gebruik, hoe weet ik dan welk samplingpercentage het beste werkt voor mijn app?

• Eén manier is om te beginnen met adaptieve steekproeven, uit te zoeken op welke snelheid deze zich vereffent (zie de bovenstaande vraag) en vervolgens over te schakelen naar steekproeven met een vaste snelheid met behulp van die snelheid.

  Anders moet u raden. Analyseer uw huidige telemetriegebruik in Application Insights, observeer eventuele bandbreedtebeperking en schat het volume van de verzamelde telemetrie. Deze drie invoer, samen met de geselecteerde prijscategorie, stellen voor hoeveel u het volume van de verzamelde telemetrie wilt verminderen. Een toename van het aantal gebruikers of een andere verschuiving in het volume van telemetrie kan uw schatting echter ongeldig maken.

Wat gebeurt er als ik het steekproefpercentage zo configureren dat dit te laag is?

• Overmatig lage steekproefpercentages veroorzaken te agressieve steekproeven en verminderen de nauwkeurigheid van de benaderingen wanneer Application Insights probeert de visualisatie van de gegevens te compenseren voor de gegevensvolumevermindering. Ook kan uw diagnostische ervaring negatief worden beïnvloed, omdat er een steekproef kan worden genomen van een aantal van de niet-vaak mislukte of trage aanvragen.

Wat gebeurt er als ik het steekproefpercentage zo configureren dat dit te hoog is?

• Het configureren van een te hoog steekproefpercentage (niet agressief genoeg) resulteert in een onvoldoende vermindering van het volume van de verzamelde telemetrie. Mogelijk treedt er nog steeds telemetriegegevensverlies op met betrekking tot beperking en kunnen de kosten voor het gebruik van Application Insights hoger zijn dan u had gepland vanwege uitvalkosten.

Op welke platforms kan ik steekproeven gebruiken?

• Opnamesampling kan automatisch plaatsvinden voor telemetrie boven een bepaald volume, als de SDK geen steekproeven maakt. Deze configuratie werkt bijvoorbeeld als u een oudere versie van de ASP.NET SDK of Java SDK gebruikt.
• Als u de huidige ASP.NET- of ASP.NET Core-SDK's gebruikt (gehost in Azure of op uw eigen server), krijgt u standaard adaptieve steekproeven, maar u kunt overschakelen naar een vaste snelheid zoals hierboven wordt beschreven. Met steekproeven met vaste snelheid wordt de browser-SDK automatisch gesynchroniseerd met voorbeeldgerelateerde gebeurtenissen.
• Als u de huidige Java-agent gebruikt, kunt u applicationinsights.json configureren (voor Java SDK configureren) om steekproeven met vaste snelheid ApplicationInsights.xml in te schakelen. Steekproeven zijn standaard uitgeschakeld. Met steekproeven met vaste snelheid worden de browser-SDK en de server automatisch gesynchroniseerd met voorbeeldgerelateerde gebeurtenissen.

Er zijn bepaalde zeldzame gebeurtenissen die ik altijd wil zien. Hoe kom ik voorbij de steekproefmodule?

• De beste manier om dit te bereiken, is door een aangepaste TelemetryInitializerte schrijven, die de in stelt op 100 voor het telemetrie-item dat u wilt behouden, zoals hieronder wordt SamplingPercentage weergegeven. Omdat initialisaties gegarandeerd worden uitgevoerd vóór telemetrieprocessors (inclusief steekproeven), zorgt dit ervoor dat alle samplingtechnieken dit item negeren bij eventuele steekproefoverwegingen. Aangepaste initialisaties voor telemetrie zijn beschikbaar in de ASP.NET-SDK, de ASP.NET Core-SDK, de JavaScript-SDK en de Java SDK. U kunt bijvoorbeeld een initialisatie voor telemetrie configureren met behulp van de ASP.NET SDK:

  public class MyTelemetryInitializer : ITelemetryInitializer
  {
      public void Initialize(ITelemetry telemetry)
      {
          if(somecondition)
          {
              ((ISupportSampling)telemetry).SamplingPercentage = 100;
          }
      }
  }
  

Oudere SDK-versies

Adaptieve steekproeven zijn beschikbaar voor de Application Insights SDK voor ASP.NET v2.0.0-beta3 en hoger, Microsoft.ApplicationInsights.AspNetCore SDK v2.2.0-beta1 en hoger en is standaard ingeschakeld.

Sampling met vaste snelheid is een functie van de SDK in ASP.NET-versies van 2.0.0 en Java SDK versie 2.0.1 en hoger.

Vóór v2.5.0-beta2 van de ASP.NET SDK en v2.2.0-beta3 van de ASP.NET Core-SDK werd de steekproefbeslissing gebaseerd op de hash van de gebruikers-id voor toepassingen die 'gebruiker' definiëren (dat wil zeggen, de meeste typische webtoepassingen). Voor de typen toepassingen die geen gebruikers (zoals webservices) definieerde, werd de steekproefbeslissing gebaseerd op de bewerkings-id van de aanvraag. Recente versies van de ASP.NET en ASP.NET Core SDK's gebruiken de bewerkings-id voor de steekproefbeslissing.

Volgende stappen

• Filteren kan een striktere controle bieden over wat uw SDK verzendt.
• Lees het artikel Telemetrie optimaliseren met Application Insights.