Application Insights SDK'sında telemetri verilerini filtreleme ve ön işlemeden geçirme

Makale
11/15/2023

SDK'dan gönderilmeden önce telemetrinizi filtrelemek, değiştirmek veya zenginleştirmek için kod yazabilirsiniz. İşleme, HTTP isteği koleksiyonu ve bağımlılık koleksiyonu gibi standart telemetri modüllerinden gönderilen verileri içerir.

Filtreleme, uygulayarak ITelemetryProcessorSDK'dan gönderilmeden önce telemetriyi değiştirebilir veya atabilir. Örneğin, robotlardan gelen istekleri dışlayarak telemetri hacmini azaltabilirsiniz. Örneklemeden farklı olarak, nelerin gönderileceğini veya atılacağını tam olarak denetlersiniz, ancak toplanan günlükleri temel alan tüm ölçümleri etkiler. Öğeleri nasıl attığınıza bağlı olarak, ilgili öğeler arasında gezinme özelliğini de kaybedebilirsiniz.
uygulamanızdan gönderilen herhangi bir telemetriye bir uygulayarak ITelemetryInitializerözellikleri ekleyin veya değiştirin. Örneğin, portaldaki verileri filtrelemek için hesaplanan değerler veya sürüm numaraları ekleyebilirsiniz.
Örnekleme , istatistiklerinizi etkilemeden telemetri hacmini azaltır. Bir sorunu tanıladığınızda aralarında gezinebilmeniz için ilgili veri noktalarını bir arada tutar. Portalda, örneklemeyi telafi etmek için toplam sayılar çarpılır.

Dekont

SDK API'si özel olayları ve ölçümleri göndermek için kullanılır.

Başlamadan önce:

Uygulamanız için uygun SDK'yı yükleyin: ASP.NET, ASP.NET Core, .NET/.NET Core için HTTP/Worker Olmayan veya JavaScript.

Filtreleme

Bu teknik, telemetri akışına dahil edilen veya telemetri akışından dışlananlar üzerinde doğrudan denetim sağlar. Filtreleme, telemetri öğelerinin Uygulama Analizler gönderilmesini bırakmak için kullanılabilir. Filtrelemeyi örneklemeyle veya ayrı ayrı kullanabilirsiniz.

Telemetriyi filtrelemek için bir telemetri işlemcisi yazar ve ile TelemetryConfigurationkaydedersiniz. Tüm telemetri işlemcinizden geçer. Akışı akıştan bırakmayı veya zincirdeki bir sonraki işlemciye vermeyi seçebilirsiniz. HTTP isteği toplayıcısı ve bağımlılık toplayıcısı gibi standart modüllerden alınan telemetri ve kendiniz takip ettiğiniz telemetri dahildir. Örneğin, robotlardan gelen istekler veya başarılı bağımlılık çağrıları hakkındaki telemetri verilerini filtreleyebilirsiniz.

Uyarı

SDK'dan gönderilen telemetri verilerini işlemciler kullanarak filtrelemek, portalda gördüğünüz istatistikleri çarpıtabilir ve ilgili öğeleri izlemeyi zorlaştırabilir.

Bunun yerine örnekleme kullanmayı göz önünde bulundurun.

Telemetri işlemcisi oluşturma

C#

Filtre oluşturmak için uygulayın ITelemetryProcessor.

Telemetri işlemcileri bir işleme zinciri oluşturur. Bir telemetri işlemcisi örneği oluştururken, zincirdeki bir sonraki işlemciye başvuru alırsınız. Bir telemetri veri noktası işlem yöntemine geçirildiğinde, işini yapar ve ardından zincirdeki sonraki telemetri işlemcisini çağırır (veya çağırmaz).

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;
    }
}

İşlemcinizi ekleyin.

uygulamaları ASP.NET

Bu kod parçacığını Application Analizler.config içine ekleyin:

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

Sınıfınızda genel adlandırılmış özellikler sağlayarak .config dosyasından dize değerlerini geçirebilirsiniz.

Uyarı

Tür adını ve .config dosyasındaki tüm özellik adlarını koddaki sınıf ve özellik adlarına eşleştirmeye dikkat edin. .config dosyası var olmayan bir türe veya özelliğe başvurursa, SDK sessizce herhangi bir telemetri gönderemeyebilir.

Alternatif olarak, filtreyi kodda başlatabilirsiniz. Uygun bir başlatma sınıfında, örneğin, içinde Global.asax.csAppStart, işlemcinizi zincire ekleyin:

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();

Bu noktadan sonra oluşturulan telemetri istemcileri işlemcilerinizi kullanır.

ASP.NET Core/Worker hizmet uygulamaları

Dekont

kullanarak ApplicationInsights.config işlemci ekleme veya TelemetryConfiguration.Active ASP.NET Core uygulamaları için geçerli değildir veya Microsoft.Application Analizler kullanıyorsanız. WorkerService SDK'sı.

ASP.NET Core veya WorkerService kullanılarak yazılan uygulamalar için, yeni bir telemetri işlemcisi ekleme işlemi, gösterildiği gibi üzerinde IServiceCollectionuzantı yöntemi kullanılarak AddApplicationInsightsTelemetryProcessor gerçekleştirilir. Bu yöntem, sınıfınızın Startup.cs yönteminde ConfigureServices çağrılır.

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

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

parametreleri gereken telemetri işlemcilerini ASP.NET Core'a kaydetmek için ITelemetryProcessorFactory uygulayan özel bir sınıf oluşturun. Create yönteminde istenen parametrelerle oluşturucuyu çağırın ve ardından AddSingleton<ITelemetryProcessorFactory, MyTelemetryProcessorFactory>() kullanın.

Örnek filtreler

Yapay istekler

Botları ve web testlerini filtreleyin. Ölçüm Gezgini yapay kaynakları filtreleme seçeneği sunar ancak bu seçenek trafiği ve alma boyutunu SDK'nın kendisinde filtreleyerek azaltır.

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

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

Kimlik doğrulaması başarısız oldu

İstekleri "401" yanıtıyla filtreleyin.

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);
}

Hızlı uzak bağımlılık çağrılarını filtreleme

Yalnızca yavaş çağrıları tanılamak istiyorsanız, hızlı olanları filtreleyin.

Dekont

Bu filtreleme, portalda gördüğünüz istatistikleri çarpıtır.

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

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

Bağımlılık sorunlarını tanılama

Bu blogda , bağımlılıklara otomatik olarak düzenli ping göndererek bağımlılık sorunlarını tanılamaya yönelik bir proje açıklanır.

Java

Telemetri işlemcileri ve Bunların Java'daki uygulamaları hakkında daha fazla bilgi edinmek için Java telemetri işlemcileri belgelerine bakın.

JavaScript web uygulamaları

ITelemetryInitializer kullanarak filtreleme

Telemetri başlatıcı geri çağırma işlevi oluşturun. Geri çağırma işlevi, işlenen olay olan bir parametre olarak alır ITelemetryItem . Bu geri aramadan geri dönülerek false telemetri öğesinin filtreleneceği sonucuna varılır.
```
var filteringFunction = (envelope) => {
  if (envelope.data.someField === 'tobefilteredout') {
      return false;
  }

  return true;
};
```

Telemetri başlatıcı geri aramanızı ekleyin:

appInsights.addTelemetryInitializer(filteringFunction);

Özellikleri ekleme/değiştirme: ITelemetryInitializer

Telemetriyi ek bilgilerle zenginleştirmek veya standart telemetri modülleri tarafından ayarlanan telemetri özelliklerini geçersiz kılmak için telemetri başlatıcılarını kullanın.

Örneğin, web paketi için Uygulama Analizler HTTP istekleri hakkında telemetri toplar. Varsayılan olarak, yanıt kodu >=400 olan başarısız istek olarak işaretlenir. Ancak 400'e başarılı olarak davranmayı istiyorsanız, başarı özelliğini ayarlayan bir telemetri başlatıcısı sağlayabilirsiniz.

Telemetri başlatıcı sağlarsanız, Track*() yöntemlerinden herhangi biri çağrıldığında çağrılır. Bu başlatıcı, standart telemetri modülleri tarafından çağrılan yöntemleri içerir Track() . Kural gereği, bu modüller zaten bir başlatıcı tarafından ayarlanmış olan herhangi bir özelliği ayarlamaz. Telemetri başlatıcıları, telemetri işlemcileri çağrılmadan önce çağrılır. Bu nedenle başlatıcılar tarafından yapılan tüm zenginleştirmeler işlemciler tarafından görülebilir.

Başlatıcınızı tanımlama

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 uygulamaları: Başlatıcınızı yükleme

Application Analizler.config içinde:

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

Alternatif olarak, başlatıcının örneğin Global.aspx.cs dosyasında kodda örneği oluşturabilirsiniz:

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

Bu örneğe daha fazla bakın.

ASP.NET Core/Worker hizmeti uygulamaları: Başlatıcınızı yükleme

Dekont

kullanarak ApplicationInsights.config başlatıcı ekleme veya TelemetryConfiguration.Active ASP.NET Core uygulamaları için geçerli değildir veya Microsoft.Application Analizler kullanıyorsanız. WorkerService SDK'sı.

ASP.NET Core veya WorkerService kullanılarak yazılan uygulamalar için, yeni bir telemetri başlatıcısı eklendiğinde, gösterildiği gibi Bağımlılık Ekleme kapsayıcısına eklenir. yönteminde bu adımı gerçekleştirin Startup.ConfigureServices .

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

JavaScript telemetri başlatıcıları

Gerekirse bir JavaScript telemetri başlatıcısı ekleyin. Application Analizler JavaScript SDK'sının telemetri başlatıcıları hakkında daha fazla bilgi için bkz. Telemetri başlatıcıları.

JavaScript (Web) SDK Yükleyici Betiği
npm paketi

JavaScript (Web) SDK Yükleyici Betiği yapılandırmasına onInit geri çağırma işlevini ekleyerek telemetri başlatıcısı ekleyin:

<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();

Telemetri öğesinde kullanılabilen özel olmayan özelliklerin özeti için bkz. Uygulama Analizler Veri Modelini Dışarı Aktarma.

İstediğiniz kadar başlatıcı ekleyebilirsiniz. Bunlar, eklendikleri sırayla çağrılır.

OpenCensus Python telemetri işlemcileri

OpenCensus Python'daki telemetri işlemcileri, dışarı aktarilmeden önce telemetriyi işlemek için çağrılan geri çağırma işlevleridir. Geri çağırma işlevinin parametresi olarak bir zarf veri türünü kabul etmesi gerekir. Telemetri verilerinin dışarı aktarılmasını filtrelemek için geri çağırma işlevinin döndürdüğünden Falseemin olun. Azure İzleyici veri türlerinin şemasını GitHub'daki zarflarda görebilirsiniz.

Dekont

Alandaki özniteliğini tags değiştirerek ai.cloud.role değiştirebilirsinizcloud_RoleName.

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()

İstediğiniz kadar işlemci ekleyebilirsiniz. Bunlar, eklendikleri sırayla çağrılır. Bir işlemci özel durum oluşturursa, aşağıdaki işlemcileri etkilemez.

Örnek TelemetriInitializers

Özel özellik ekleme

Aşağıdaki örnek başlatıcı izlenen her telemetriye özel bir özellik ekler.

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

Bulut rolü adı ekleme

Aşağıdaki örnek başlatıcı, bulut rolü adını izlenen her telemetriye ayarlar.

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

Coğrafi konum eşlemeleri için kullanılan istemci IP adresini denetleme

Aşağıdaki örnek başlatıcı, telemetri alımı sırasında istemci yuva IP adresi yerine coğrafi konum eşlemesi için kullanılacak istemci IP'sini ayarlar.

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 ve ITelemetryInitializer

Telemetri işlemcileri ile telemetri başlatıcıları arasındaki fark nedir?

Bunlarla yapabileceklerinizde bazı çakışmalar vardır. Her ikisi de telemetri özelliklerini eklemek veya değiştirmek için kullanılabilir, ancak bu amaçla başlatıcıları kullanmanızı öneririz.
Telemetri başlatıcıları her zaman telemetri işlemcilerinden önce çalışır.
Telemetri başlatıcıları birden çok kez çağrılabilir. Kurala göre, önceden ayarlanmış herhangi bir özelliği ayarlamaz.
Telemetri işlemcileri, bir telemetri öğesini tamamen değiştirmenize veya atmanıza olanak sağlar.
Tüm kayıtlı telemetri başlatıcıları her telemetri öğesi için çağrılır. Telemetri işlemcileri için SDK, ilk telemetri işlemcisini çağırmayı garanti eder. Geri kalan işlemcilerin çağrılıp çağrılmayacağı, önceki telemetri işlemcileri tarafından belirlenir.
Telemetriyi daha fazla özellik ile zenginleştirmek veya var olan bir telemetriyi geçersiz kılmak için telemetri başlatıcılarını kullanın. Telemetriyi filtrelemek için telemetri işlemcisi kullanın.

Dekont

JavaScript'te yalnızca ITelemetryInitializer kullanarak olayları filtreleyen telemetri başlatıcıları vardır

Application Analizler.config sorunlarını giderme

Tam tür adının ve derleme adının doğru olduğunu onaylayın.
applicationinsights.config dosyasının çıkış dizininizde olduğunu ve son değişiklikleri içerdiğini onaylayın.

Application Insights SDK'sında telemetri verilerini filtreleme ve ön işlemeden geçirme

Filtreleme

Telemetri işlemcisi oluşturma

C#

Örnek filtreler

Yapay istekler

Kimlik doğrulaması başarısız oldu

Hızlı uzak bağımlılık çağrılarını filtreleme

Bağımlılık sorunlarını tanılama

Java

JavaScript web uygulamaları

Özellikleri ekleme/değiştirme: ITelemetryInitializer

JavaScript telemetri başlatıcıları

OpenCensus Python telemetri işlemcileri

Örnek TelemetriInitializers

Özel özellik ekleme

Bulut rolü adı ekleme

Coğrafi konum eşlemeleri için kullanılan istemci IP adresini denetleme

ITelemetryProcessor ve ITelemetryInitializer

Application Analizler.config sorunlarını giderme

Azure İzleyici Telemetri Veri Türleri Başvurusu

Başvuru belgeleri

SDK kodu

Sonraki adımlar

Ek kaynaklar