Telemetrie filteren en voorverwerken in de Application Insights-SDK

Artikel
11/15/2023

U kunt code schrijven om uw telemetrie te filteren, te wijzigen of te verrijken voordat deze wordt verzonden vanuit de SDK. De verwerking omvat gegevens die worden verzonden vanuit de standaardtelemetriemodules, zoals het verzamelen van HTTP-aanvragen en het verzamelen van afhankelijkheden.

Filteren kan telemetrie wijzigen of verwijderen voordat deze wordt verzonden vanuit de SDK door deze te implementeren ITelemetryProcessor. U kunt bijvoorbeeld het volume van telemetrie verminderen door aanvragen van robots uit te sluiten. In tegenstelling tot steekproeven hebt u volledige controle over wat er wordt verzonden of verwijderd, maar dit heeft invloed op metrische gegevens op basis van geaggregeerde logboeken. Afhankelijk van hoe u items negeert, verliest u mogelijk ook de mogelijkheid om tussen gerelateerde items te navigeren.
Voeg eigenschappen toe aan of wijzig deze voor alle telemetrie die vanuit uw app wordt verzonden door een ITelemetryInitializer. U kunt bijvoorbeeld berekende waarden of versienummers toevoegen waarmee de gegevens in de portal moeten worden gefilterd.
Steekproeven verminderen het volume van telemetrie zonder dat dit van invloed is op uw statistieken. Hiermee worden gerelateerde gegevenspunten bijeengehouden, zodat u ertussen kunt navigeren wanneer u een probleem diagnosticeren. In de portal worden de totale aantallen vermenigvuldigd om de steekproef te compenseren.

Notitie

De SDK-API wordt gebruikt om aangepaste gebeurtenissen en metrische gegevens te verzenden.

Voordat u begint:

Installeer de juiste SDK voor uw toepassing: ASP.NET, ASP.NET Core, Niet-HTTP/Worker voor .NET/.NET Core of JavaScript.

Filteren

Deze techniek geeft u directe controle over wat er is opgenomen of uitgesloten van de telemetriestroom. Filteren kan worden gebruikt om telemetrie-items te verwijderen van verzonden naar Application Insights. U kunt filteren met steekproeven of afzonderlijk gebruiken.

Als u telemetrie wilt filteren, schrijft u een telemetrieprocessor en registreert u deze bij TelemetryConfiguration. Alle telemetrie gaat via uw processor. U kunt ervoor kiezen om deze uit de stream te verwijderen of deze aan de volgende processor in de keten te geven. Telemetrie van de standaardmodules, zoals de HTTP-aanvraagverzamelaar en de afhankelijkheidsverzamelaar, en telemetrie die u zelf hebt bijgehouden, wordt opgenomen. U kunt bijvoorbeeld telemetrie filteren over aanvragen van robots of geslaagde afhankelijkheidsaanroepen.

Waarschuwing

Het filteren van de telemetrie die vanuit de SDK wordt verzonden met behulp van processors, kan de statistieken die u in de portal ziet, scheeftrekken en het lastig maken om gerelateerde items te volgen.

Overweeg in plaats daarvan steekproeven te gebruiken.

Een telemetrieprocessor maken

C#

Als u een filter wilt maken, implementeert u ITelemetryProcessor.

Telemetrieprocessors bouwen een keten van verwerking. Wanneer u een telemetrieprocessor instantiëren, krijgt u een verwijzing naar de volgende processor in de keten. Wanneer een telemetriegegevenspunt wordt doorgegeven aan de procesmethode, wordt het werk uitgevoerd en wordt vervolgens de volgende telemetrieprocessor in de keten aangeroepen (of wordt deze niet aangeroepen).

using Microsoft.ApplicationInsights.Channel;
using Microsoft.ApplicationInsights.Extensibility;
using Microsoft.ApplicationInsights.DataContracts;

public class SuccessfulDependencyFilter : ITelemetryProcessor
{
    private ITelemetryProcessor Next { get; set; }

    // next will point to the next TelemetryProcessor in the chain.
    public SuccessfulDependencyFilter(ITelemetryProcessor next)
    {
        this.Next = next;
    }

    public void Process(ITelemetry item)
    {
        // To filter out an item, return without calling the next processor.
        if (!OKtoSend(item)) { return; }

        this.Next.Process(item);
    }

    // Example: replace with your own criteria.
    private bool OKtoSend (ITelemetry item)
    {
        var dependency = item as DependencyTelemetry;
        if (dependency == null) return true;

        return dependency.Success != true;
    }
}

Voeg uw processor toe.

apps ASP.NET

Voeg dit fragment in ApplicationInsights.config in:

<TelemetryProcessors>
  <Add Type="WebApplication9.SuccessfulDependencyFilter, WebApplication9">
     <!-- Set public property -->
     <MyParamFromConfigFile>2-beta</MyParamFromConfigFile>
  </Add>
</TelemetryProcessors>

U kunt tekenreekswaarden uit het .config-bestand doorgeven door openbare benoemde eigenschappen in uw klasse op te geven.

Waarschuwing

Zorg ervoor dat u de naam van het type en eventuele eigenschapsnamen in het .config-bestand koppelt aan de klasse- en eigenschapsnamen in de code. Als het .config-bestand verwijst naar een niet-bestaand type of een niet-bestaande eigenschap, kan de SDK op de achtergrond geen telemetrie verzenden.

U kunt het filter ook initialiseren in code. Voeg in een geschikte initialisatieklasse, bijvoorbeeld AppStart in Global.asax.cs, uw processor in de keten in:

var builder = TelemetryConfiguration.Active.DefaultTelemetrySink.TelemetryProcessorChainBuilder;
builder.Use((next) => new SuccessfulDependencyFilter(next));

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

builder.Build();

Telemetrieclients die na dit punt zijn gemaakt, gebruiken uw processors.

ASP.NET Core-/Worker-service-apps

Notitie

Het toevoegen van een processor met behulp van ApplicationInsights.config of TelemetryConfiguration.Active is niet geldig voor ASP.NET Core-toepassingen of als u de Microsoft.ApplicationInsights.WorkerService SDK gebruikt.

Voor apps die zijn geschreven met behulp van ASP.NET Core of WorkerService, wordt het toevoegen van een nieuwe telemetrieprocessor uitgevoerd met behulp van de AddApplicationInsightsTelemetryProcessor extensiemethode op IServiceCollection, zoals wordt weergegeven. Deze methode wordt aangeroepen in de ConfigureServices methode van uw Startup.cs klasse.

    public void ConfigureServices(IServiceCollection services)
    {
        // ...
        services.AddApplicationInsightsTelemetry();
        services.AddApplicationInsightsTelemetryProcessor<SuccessfulDependencyFilter>();

        // If you have more processors:
        services.AddApplicationInsightsTelemetryProcessor<AnotherProcessor>();
    }

Als u telemetrieprocessors wilt registreren die parameters nodig hebben in ASP.NET Core, maakt u een aangepaste klasse die ITelemetryProcessorFactory implementeert. Roep de constructor aan met de gewenste parameters in de methode Create en gebruik vervolgens AddSingleton<ITelemetryProcessorFactory, MyTelemetryProcessorFactory>().

Voorbeeldfilters

Synthetische aanvragen

Filter bots en webtests uit. Hoewel Metrics Explorer u de mogelijkheid biedt om synthetische bronnen te filteren, vermindert deze optie het verkeer en de opnamegrootte door ze te filteren op de SDK zelf.

public void Process(ITelemetry item)
{
  if (!string.IsNullOrEmpty(item.Context.Operation.SyntheticSource)) {return;}

  // Send everything else:
  this.Next.Process(item);
}

Mislukte verificatie

Filter aanvragen met een 401-antwoord.

public void Process(ITelemetry item)
{
    var request = item as RequestTelemetry;

    if (request != null &&
    request.ResponseCode.Equals("401", StringComparison.OrdinalIgnoreCase))
    {
        // To filter out an item, return without calling the next processor.
        return;
    }

    // Send everything else
    this.Next.Process(item);
}

Snelle externe afhankelijkheidsaanroepen filteren

Als u alleen gesprekken wilt diagnosticeren die traag zijn, filtert u de snelle oproepen.

Notitie

Met dit filter worden de statistieken die u in de portal ziet, scheefgetrokken.

public void Process(ITelemetry item)
{
    var request = item as DependencyTelemetry;

    if (request != null && request.Duration.TotalMilliseconds < 100)
    {
        return;
    }
    this.Next.Process(item);
}

Problemen als gevolg van diagnoseafhankelijkheid

In dit blog wordt een project beschreven voor het diagnosticeren van afhankelijkheidsproblemen door automatisch regelmatige pings naar afhankelijkheden te verzenden.

Java

Raadpleeg de documentatie over Java-telemetrieprocessors voor meer informatie over telemetrieprocessors en hun implementatie in Java.

JavaScript-webtoepassingen

Filteren met behulp van ITelemetryInitializer

Een callbackfunctie voor telemetrie-initialisatiefunctie maken. De callback-functie wordt ITelemetryItem gebruikt als een parameter. Dit is de gebeurtenis die wordt verwerkt. Als false u deze callback retourneert, wordt het telemetrie-item uitgefilterd.
```
var filteringFunction = (envelope) => {
  if (envelope.data.someField === 'tobefilteredout') {
      return false;
  }

  return true;
};
```
Voeg de callback van uw telemetrie-initialisatiefunctie toe:
```
appInsights.addTelemetryInitializer(filteringFunction);
```

Eigenschappen toevoegen/wijzigen: ITelemetryInitializer

Gebruik telemetrie-initialisatiefuncties om telemetrie te verrijken met aanvullende informatie of om telemetrie-eigenschappen te overschrijven die zijn ingesteld door de standaardtelemetriemodules.

Application Insights voor een webpakket verzamelt bijvoorbeeld telemetrie over HTTP-aanvragen. Standaard wordt een aanvraag met een antwoordcode >=400 als mislukt gevlagd. Maar als u 400 wilt behandelen als een succes, kunt u een telemetrie-initialisatiefunctie opgeven waarmee de eigenschap succes wordt ingesteld.

Als u een initialisatiefunctie voor telemetrie opgeeft, wordt deze aangeroepen wanneer een van de methoden Track*() wordt aangeroepen. Deze initialisatiefunctie bevat Track() methoden die worden aangeroepen door de standaardtelemetriemodules. Deze modules stellen standaard geen eigenschappen in die al door een initialisatiefunctie zijn ingesteld. Initialisatiefuncties voor telemetrie worden aangeroepen voordat telemetrieprocessors worden aangeroepen. Alle verrijkingen die door initialisaties worden uitgevoerd, zijn dus zichtbaar voor processors.

Uw initialisatiefunctie definiëren

using System;
using Microsoft.ApplicationInsights.Channel;
using Microsoft.ApplicationInsights.DataContracts;
using Microsoft.ApplicationInsights.Extensibility;

namespace MvcWebRole.Telemetry
{
  /*
   * Custom TelemetryInitializer that overrides the default SDK
   * behavior of treating response codes >= 400 as failed requests
   *
   */
  public class MyTelemetryInitializer : ITelemetryInitializer
  {
    public void Initialize(ITelemetry telemetry)
    {
        var requestTelemetry = telemetry as RequestTelemetry;
        // Is this a TrackRequest() ?
        if (requestTelemetry == null) return;
        int code;
        bool parsed = Int32.TryParse(requestTelemetry.ResponseCode, out code);
        if (!parsed) return;
        if (code >= 400 && code < 500)
        {
            // If we set the Success property, the SDK won't change it:
            requestTelemetry.Success = true;

            // Allow us to filter these requests in the portal:
            requestTelemetry.Properties["Overridden400s"] = "true";
        }
        // else leave the SDK to set the Success property
    }
  }
}

ASP.NET-apps: Uw initialisatiefunctie laden

In ApplicationInsights.config:

<ApplicationInsights>
  <TelemetryInitializers>
    <!-- Fully qualified type name, assembly name: -->
    <Add Type="MvcWebRole.Telemetry.MyTelemetryInitializer, MvcWebRole"/>
    ...
  </TelemetryInitializers>
</ApplicationInsights>

U kunt de initialisatiefunctie ook instantiëren in code, bijvoorbeeld in Global.aspx.cs:

protected void Application_Start()
{
    // ...
    TelemetryConfiguration.Active.TelemetryInitializers.Add(new MyTelemetryInitializer());
}

Bekijk meer van dit voorbeeld.

ASP.NET Core/Worker-service-apps: Uw initialisatiefunctie laden

Notitie

Het toevoegen van een initialisatiefunctie met behulp van ApplicationInsights.config of TelemetryConfiguration.Active is niet geldig voor ASP.NET Core-toepassingen of als u de Microsoft.ApplicationInsights.WorkerService SDK gebruikt.

Voor apps die zijn geschreven met ASP.NET Core of WorkerService, wordt het toevoegen van een nieuwe telemetrie-initialisatie uitgevoerd door deze toe te voegen aan de container Afhankelijkheidsinjectie, zoals wordt weergegeven. Voer deze stap uit in de Startup.ConfigureServices methode.

 using Microsoft.ApplicationInsights.Extensibility;
 using CustomInitializer.Telemetry;
 public void ConfigureServices(IServiceCollection services)
{
    services.AddSingleton<ITelemetryInitializer, MyTelemetryInitializer>();
}

Initialisatiefuncties voor JavaScript-telemetrie

Voeg indien nodig een Initialisatiefunctie voor JavaScript-telemetrie in. Zie Initializers voor telemetrie voor de JavaScript SDK voor Application Insights voor meer informatie over de initialisatiefuncties voor telemetrie.

JavaScript (Web) SDK Loader Script
NPM-pakket

Voeg een telemetrie-initialisatiefunctie in door de callback-functie onInit toe te voegen in de JavaScript-SDK-configuratie (Web) SDK Loader Script:

<script type="text/javascript">
!(function (cfg){function e(){cfg.onInit&&cfg.onInit(i)}var S,u,D,t,n,i,C=window,x=document,w=C.location,I="script",b="ingestionendpoint",E="disableExceptionTracking",A="ai.device.";"instrumentationKey"[S="toLowerCase"](),u="crossOrigin",D="POST",t="appInsightsSDK",n=cfg.name||"appInsights",(cfg.name||C[t])&&(C[t]=n),i=C[n]||function(l){var d=!1,g=!1,f={initialize:!0,queue:[],sv:"7",version:2,config:l};function m(e,t){var n={},i="Browser";function a(e){e=""+e;return 1===e.length?"0"+e:e}return n[A+"id"]=i[S](),n[A+"type"]=i,n["ai.operation.name"]=w&&w.pathname||"_unknown_",n["ai.internal.sdkVersion"]="javascript:snippet_"+(f.sv||f.version),{time:(i=new Date).getUTCFullYear()+"-"+a(1+i.getUTCMonth())+"-"+a(i.getUTCDate())+"T"+a(i.getUTCHours())+":"+a(i.getUTCMinutes())+":"+a(i.getUTCSeconds())+"."+(i.getUTCMilliseconds()/1e3).toFixed(3).slice(2,5)+"Z",iKey:e,name:"Microsoft.ApplicationInsights."+e.replace(/-/g,"")+"."+t,sampleRate:100,tags:n,data:{baseData:{ver:2}},ver:4,seq:"1",aiDataContract:undefined}}var h=-1,v=0,y=["js.monitor.azure.com","js.cdn.applicationinsights.io","js.cdn.monitor.azure.com","js0.cdn.applicationinsights.io","js0.cdn.monitor.azure.com","js2.cdn.applicationinsights.io","js2.cdn.monitor.azure.com","az416426.vo.msecnd.net"],k=l.url||cfg.src;if(k){if((n=navigator)&&(~(n=(n.userAgent||"").toLowerCase()).indexOf("msie")||~n.indexOf("trident/"))&&~k.indexOf("ai.3")&&(k=k.replace(/(\/)(ai\.3\.)([^\d]*)$/,function(e,t,n){return t+"ai.2"+n})),!1!==cfg.cr)for(var e=0;e<y.length;e++)if(0<k.indexOf(y[e])){h=e;break}var i=function(e){var a,t,n,i,o,r,s,c,p,u;f.queue=[],g||(0<=h&&v+1<y.length?(a=(h+v+1)%y.length,T(k.replace(/^(.*\/\/)([\w\.]*)(\/.*)$/,function(e,t,n,i){return t+y[a]+i})),v+=1):(d=g=!0,o=k,c=(p=function(){var e,t={},n=l.connectionString;if(n)for(var i=n.split(";"),a=0;a<i.length;a++){var o=i[a].split("=");2===o.length&&(t[o[0][S]()]=o[1])}return t[b]||(e=(n=t.endpointsuffix)?t.location:null,t[b]="https://"+(e?e+".":"")+"dc."+(n||"services.visualstudio.com")),t}()).instrumentationkey||l.instrumentationKey||"",p=(p=p[b])?p+"/v2/track":l.endpointUrl,(u=[]).push((t="SDK LOAD Failure: Failed to load Application Insights SDK script (See stack for details)",n=o,r=p,(s=(i=m(c,"Exception")).data).baseType="ExceptionData",s.baseData.exceptions=[{typeName:"SDKLoadFailed",message:t.replace(/\./g,"-"),hasFullStack:!1,stack:t+"\nSnippet failed to load ["+n+"] -- Telemetry is disabled\nHelp Link: https://go.microsoft.com/fwlink/?linkid=2128109\nHost: "+(w&&w.pathname||"_unknown_")+"\nEndpoint: "+r,parsedStack:[]}],i)),u.push((s=o,t=p,(r=(n=m(c,"Message")).data).baseType="MessageData",(i=r.baseData).message='AI (Internal): 99 message:"'+("SDK LOAD Failure: Failed to load Application Insights SDK script (See stack for details) ("+s+")").replace(/\"/g,"")+'"',i.properties={endpoint:t},n)),o=u,c=p,JSON&&((r=C.fetch)&&!cfg.useXhr?r(c,{method:D,body:JSON.stringify(o),mode:"cors"}):XMLHttpRequest&&((s=new XMLHttpRequest).open(D,c),s.setRequestHeader("Content-type","application/json"),s.send(JSON.stringify(o))))))},a=function(e,t){g||setTimeout(function(){!t&&f.core||i()},500),d=!1},T=function(e){var n=x.createElement(I),e=(n.src=e,cfg[u]);return!e&&""!==e||"undefined"==n[u]||(n[u]=e),n.onload=a,n.onerror=i,n.onreadystatechange=function(e,t){"loaded"!==n.readyState&&"complete"!==n.readyState||a(0,t)},cfg.ld&&cfg.ld<0?x.getElementsByTagName("head")[0].appendChild(n):setTimeout(function(){x.getElementsByTagName(I)[0].parentNode.appendChild(n)},cfg.ld||0),n};T(k)}try{f.cookie=x.cookie}catch(p){}function t(e){for(;e.length;)!function(t){f[t]=function(){var e=arguments;d||f.queue.push(function(){f[t].apply(f,e)})}}(e.pop())}var r,s,n="track",o="TrackPage",c="TrackEvent",n=(t([n+"Event",n+"PageView",n+"Exception",n+"Trace",n+"DependencyData",n+"Metric",n+"PageViewPerformance","start"+o,"stop"+o,"start"+c,"stop"+c,"addTelemetryInitializer","setAuthenticatedUserContext","clearAuthenticatedUserContext","flush"]),f.SeverityLevel={Verbose:0,Information:1,Warning:2,Error:3,Critical:4},(l.extensionConfig||{}).ApplicationInsightsAnalytics||{});return!0!==l[E]&&!0!==n[E]&&(t(["_"+(r="onerror")]),s=C[r],C[r]=function(e,t,n,i,a){var o=s&&s(e,t,n,i,a);return!0!==o&&f["_"+r]({message:e,url:t,lineNumber:n,columnNumber:i,error:a,evt:C.event}),o},l.autoExceptionInstrumented=!0),f}(cfg.cfg),(C[n]=i).queue&&0===i.queue.length?(i.queue.push(e),i.trackPageView({})):e();})({
src: "https://js.monitor.azure.com/scripts/b/ai.3.gbl.min.js",
crossOrigin: "anonymous",
onInit: function (sdk) {
  sdk.addTelemetryInitializer(function (envelope) {
    envelope.data = envelope.data || {};
    envelope.data.someField = 'This item passed through my telemetry initializer';
  });
}, // Once the application insights instance has loaded and initialized this method will be called
cfg: { // Application Insights Configuration
    connectionString: "YOUR_CONNECTION_STRING"
}});
</script>

import { ApplicationInsights } from '@microsoft/applicationinsights-web'

const appInsights = new ApplicationInsights({ config: {
  connectionString: 'YOUR_CONNECTION_STRING'
  /* ...Other Configuration Options... */
} });
appInsights.loadAppInsights();
// To insert a telemetry initializer, uncomment the following code.
/** var telemetryInitializer = (envelope) => {   envelope.data = envelope.data || {}; envelope.data.someField = 'This item passed through my telemetry initializer'; 
};
appInsights.addTelemetryInitializer(telemetryInitializer); **/ 
appInsights.trackPageView();

Zie Application Insights Export Data Model voor een samenvatting van de niet-aangepaste eigenschappen die beschikbaar zijn voor het telemetrie-item.

U kunt zoveel initialisaties toevoegen als u wilt. Ze worden aangeroepen in de volgorde waarin ze worden toegevoegd.

OpenCensus Python-telemetrieprocessors

Telemetrieprocessors in OpenCensus Python zijn gewoon callbackfuncties die worden aangeroepen om telemetrie te verwerken voordat ze worden geëxporteerd. De callback-functie moet een gegevenstype envelop accepteren als parameter. Als u wilt filteren dat telemetrie wordt geëxporteerd, moet u ervoor zorgen dat de callback-functie retourneert False. U kunt het schema voor Azure Monitor-gegevenstypen zien in de enveloppen op GitHub.

Notitie

U kunt dit wijzigen cloud_RoleName door het ai.cloud.role kenmerk in het tags veld te wijzigen.

def callback_function(envelope):
    envelope.tags['ai.cloud.role'] = 'new_role_name'

# Example for log exporter
import logging

from opencensus.ext.azure.log_exporter import AzureLogHandler

logger = logging.getLogger(__name__)

# Callback function to append '_hello' to each log message telemetry
def callback_function(envelope):
    envelope.data.baseData.message += '_hello'
    return True

handler = AzureLogHandler(connection_string='InstrumentationKey=<your-instrumentation_key-here>')
handler.add_telemetry_processor(callback_function)
logger.addHandler(handler)
logger.warning('Hello, World!')

# Example for trace exporter
import requests

from opencensus.ext.azure.trace_exporter import AzureExporter
from opencensus.trace import config_integration
from opencensus.trace.samplers import ProbabilitySampler
from opencensus.trace.tracer import Tracer

config_integration.trace_integrations(['requests'])

# Callback function to add os_type: linux to span properties
def callback_function(envelope):
    envelope.data.baseData.properties['os_type'] = 'linux'
    return True

exporter = AzureExporter(
    connection_string='InstrumentationKey=<your-instrumentation-key-here>'
)
exporter.add_telemetry_processor(callback_function)
tracer = Tracer(exporter=exporter, sampler=ProbabilitySampler(1.0))
with tracer.span(name='parent'):
response = requests.get(url='https://www.wikipedia.org/wiki/Rabbit')

# Example for metrics exporter
import time

from opencensus.ext.azure import metrics_exporter
from opencensus.stats import aggregation as aggregation_module
from opencensus.stats import measure as measure_module
from opencensus.stats import stats as stats_module
from opencensus.stats import view as view_module
from opencensus.tags import tag_map as tag_map_module

stats = stats_module.stats
view_manager = stats.view_manager
stats_recorder = stats.stats_recorder

CARROTS_MEASURE = measure_module.MeasureInt("carrots",
                                            "number of carrots",
                                            "carrots")
CARROTS_VIEW = view_module.View("carrots_view",
                                "number of carrots",
                                [],
                                CARROTS_MEASURE,
                                aggregation_module.CountAggregation())

# Callback function to only export the metric if value is greater than 0
def callback_function(envelope):
    return envelope.data.baseData.metrics[0].value > 0

def main():
    # Enable metrics
    # Set the interval in seconds in which you want to send metrics
    exporter = metrics_exporter.new_metrics_exporter(connection_string='InstrumentationKey=<your-instrumentation-key-here>')
    exporter.add_telemetry_processor(callback_function)
    view_manager.register_exporter(exporter)

    view_manager.register_view(CARROTS_VIEW)
    mmap = stats_recorder.new_measurement_map()
    tmap = tag_map_module.TagMap()

    mmap.measure_int_put(CARROTS_MEASURE, 1000)
    mmap.record(tmap)
    # Default export interval is every 15.0s
    # Your application should run for at least this amount
    # of time so the exporter will meet this interval
    # Sleep can fulfill this
    time.sleep(60)

    print("Done recording metrics")

if __name__ == "__main__":
    main()

U kunt zoveel processors toevoegen als u wilt. Ze worden aangeroepen in de volgorde waarin ze worden toegevoegd. Als één processor een uitzondering genereert, heeft dit geen invloed op de volgende processors.

Voorbeeld van TelemetryInitializers

Een aangepaste eigenschap toevoegen

Met de volgende voorbeeld-initialisatiefunctie wordt een aangepaste eigenschap toegevoegd aan elke bijgehouden telemetrie.

public void Initialize(ITelemetry item)
{
  var itemProperties = item as ISupportProperties;
  if(itemProperties != null && !itemProperties.Properties.ContainsKey("customProp"))
    {
        itemProperties.Properties["customProp"] = "customValue";
    }
}

Een cloudrolnaam toevoegen

Met de volgende voorbeeld-initialisatiefunctie wordt de naam van de cloudrol ingesteld op elke bijgehouden telemetrie.

public void Initialize(ITelemetry telemetry)
{
    if (string.IsNullOrEmpty(telemetry.Context.Cloud.RoleName))
    {
        telemetry.Context.Cloud.RoleName = "MyCloudRoleName";
    }
}

Het IP-adres van de client beheren dat wordt gebruikt voor geolocatietoewijzingen

Met de volgende voorbeeld-initialisatiefunctie wordt het client-IP-adres ingesteld dat wordt gebruikt voor geolocatietoewijzing, in plaats van het IP-adres van de clientsocket, tijdens telemetrieopname.

public void Initialize(ITelemetry telemetry)
{
    var request = telemetry as RequestTelemetry;
    if (request == null) return true;
    request.Context.Location.Ip = "{client ip address}"; // Could utilize System.Web.HttpContext.Current.Request.UserHostAddress;   
    return true;
}

ITelemetryProcessor en ITelemetryInitializer

Wat is het verschil tussen telemetrieprocessors en initialisatiefuncties voor telemetrie?

Er zijn enkele overlappingen in wat u ermee kunt doen. Beide kunnen worden gebruikt om eigenschappen van telemetrie toe te voegen of te wijzigen, hoewel we u aanraden initialisatiefuncties voor dat doel te gebruiken.
Telemetrie-initialisatiefuncties worden altijd uitgevoerd vóór telemetrieprocessors.
Telemetrie-initialisatiefuncties kunnen meerdere keren worden aangeroepen. Standaard stellen ze geen eigenschap in die al is ingesteld.
Met telemetrieprocessors kunt u een telemetrie-item volledig vervangen of verwijderen.
Alle geregistreerde telemetrie-initialisatiefuncties worden aangeroepen voor elk telemetrie-item. Voor telemetrieprocessors garandeert SDK dat de eerste telemetrieprocessor wordt aangeroepen. Of de rest van de processors wel of niet worden aangeroepen door de voorgaande telemetrieprocessors.
Gebruik telemetrie-initialisatiefuncties om telemetrie te verrijken met meer eigenschappen of om een bestaande te overschrijven. Gebruik een telemetrieprocessor om telemetrie uit te filteren.

Notitie

JavaScript heeft alleen telemetrie-initialisatiefuncties die gebeurtenissen kunnen filteren met behulp van ITelemetryInitializer

Problemen met ApplicationInsights.config oplossen

Controleer of de volledig gekwalificeerde typenaam en assemblynaam juist zijn.
Controleer of het bestand applicationinsights.config zich in de uitvoermap bevindt en recente wijzigingen bevat.

Telemetrie filteren en voorverwerken in de Application Insights-SDK

Filteren

Een telemetrieprocessor maken

C#

Voorbeeldfilters

Synthetische aanvragen

Mislukte verificatie

Snelle externe afhankelijkheidsaanroepen filteren

Problemen als gevolg van diagnoseafhankelijkheid

Java

JavaScript-webtoepassingen

Eigenschappen toevoegen/wijzigen: ITelemetryInitializer

Initialisatiefuncties voor JavaScript-telemetrie

OpenCensus Python-telemetrieprocessors

Voorbeeld van TelemetryInitializers

Een aangepaste eigenschap toevoegen

Een cloudrolnaam toevoegen

Het IP-adres van de client beheren dat wordt gebruikt voor geolocatietoewijzingen

ITelemetryProcessor en ITelemetryInitializer

Problemen met ApplicationInsights.config oplossen

Naslaginformatie over azure Monitor-telemetriegegevenstypen

Naslagdocumentatie

SDK-code

Volgende stappen

Aanvullende resources