Application Insights SDK에서 원격 분석 필터링 및 전처리

아티클
02/13/2024

SDK에서 전송되기 전에 원격 분석을 필터링, 수정 또는 보강하는 코드를 작성할 수 있습니다. 처리는 HTTP 요청 컬렉션 및 종속성 컬렉션과 같은 표준 원격 분석 모듈에서 전송된 데이터를 포함합니다.

ITelemetryProcessor를 구현하여 원격 분석이 SDK에서 전송되기 전에 필터링을 통해 원격 분석을 수정 또는 삭제할 수 있습니다. 예를 들어 로봇의 요청을 제외하여 원격 분석의 양을 줄일 수 있습니다. 샘플링과 달리 전송 또는 삭제 내용을 완전히 제어할 수 있지만 집계된 로그를 기반으로 하는 모든 메트릭에 영향을 미칩니다. 항목 삭제 방법에 따라 관련된 항목 사이를 이동하는 기능이 손실될 수도 있습니다.
ITelemetryInitializer를 구현하여 앱에서 전송된 원격 분석에 속성을 추가하거나 수정합니다. 예를 들어 계산된 값을 추가하거나 포털에서 데이터를 필터링하는 데 사용할 버전 번호를 추가할 수 있습니다.
샘플링 통계를 왜곡하지 않고 원격 분석의 양을 줄입니다. 관련 데이터 요소를 함께 유지하여 문제를 진단할 때 데이터 요소 간을 탐색할 수 있습니다. 포털에서는 샘플링을 보완하기 위해 총 개수를 곱합니다.

참고 항목

SDK API 사용자 지정 이벤트 및 메트릭을 보내는 데 사용됩니다.

시작하기 전에:

ASP.NET, ASP.NET Core, 비 HTTP/.NET 및 .NET Core용 Worker, JavaScript 등 애플리케이션에 적합한 SDK를 설치합니다.

필터링

이 기술을 사용하면 원격 분석 스트림에 포함된 것과 제외된 것을 직접적으로 제어할 수 있습니다. 필터링을 사용하여 원격 분석 항목을 Application Insights에 전송되지 않도록 끊을 수 있습니다. 필터링을 샘플링과 함께 사용하거나 별도로 사용할 수 있습니다.

원격 분석을 필터링하려면 원격 분석 프로세서를 작성하고 TelemetryConfiguration을 사용하여 등록합니다. 모든 원격 분석은 프로세서를 통과합니다. 이를 스트림에서 끊거나 체인의 다음 프로세서에 제공할 수 있습니다. HTTP 요청 수집기, 종속성 수집기와 같은 표준 모듈의 원격 분석뿐만 아니라 직접 추적한 원격 분석까지 포함됩니다. 예를 들어 로봇 또는 성공적인 종속성 호출의 요청에 대한 원격 분석을 필터링할 수 있습니다.

Warning

SDK에서 보낸 원격 분석을 프로세서를 사용하여 필터링하는 작업은 포털에 표시되는 통계를 왜곡하고 관련 항목을 추적하기 어렵게 할 수 있습니다.

대신 샘플링사용을 고려하세요.

원격 분석 프로세서 만들기

C#

필터 그룹을 만들려면 ITelemetryProcessor를 시행하세요.

원격 분석 프로세서는 일련의 프로세싱을 구성합니다. 원격 분석 프로세서를 인스턴스화하면 체인의 다음 프로세서에 대한 참조가 제공됩니다. 원격 분석 데이터 요소가 전달되면 프로세스 메서드는 작업을 수행하고 체인의 다음 원격 분석 프로세서를 호출하거나 호출하지 않습니다.

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

프로세서를 추가합니다.

ASP.NET 앱

ApplicationInsights.config에 다음 코드 조각을 삽입합니다.

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

클래스에서 명명된 공용 속성을 제공하여 .config 파일의 문자열 값을 전달할 수 있습니다.

Warning

.config 파일의 형식 이름 및 모든 속성 이름이 코드의 클래스 및 속성 이름과 일치하는지 주의하여 확인해야 합니다. .config 파일에서 존재하지 않는 형식 또는 속성을 참조하는 경우 SDK가 자동으로 원격 분석을 전송하는 데 실패할 수 있습니다.

또는 코드에서 필터를 초기화할 수 있습니다. Global.asax.cs의 AppStart와 같은 적합한 초기화 클래스에서 체인에 프로세서를 삽입합니다.

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

이 시점 이후에 생성된 원격 분석 클라이언트는 나의 프로세서를 사용합니다.

ASP.NET Core/Worker 서비스 앱

참고 항목

ApplicationInsights.config 또는 TelemetryConfiguration.Active를 사용하여 프로세서를 추가하는 것은 ASP.NET Core 애플리케이션 또는 Microsoft.ApplicationInsights.WorkerService SDK를 사용하는 경우에는 유효하지 않습니다.

ASP.NET Core 또는 WorkerService를 사용하여 작성한 앱의 경우, 표시된 것처럼 IServiceCollection에서 AddApplicationInsightsTelemetryProcessor 확장 메서드를 사용하여 새로운 원격 분석 프로세서를 추가합니다. 이 메서드는 Startup.cs 클래스의 ConfigureServices 메서드에서 호출됩니다.

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

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

ASP.NET Core에서 매개 변수가 필요한 원격 분석 프로세서를 등록하려면 ITelemetryProcessorFactory를 구현하는 사용자 지정 클래스를 만듭니다. Create 메서드에서 원하는 매개 변수로 생성자를 호출한 다음 AddSingleton<ITelemetryProcessorFactory, MyTelemetryProcessorFactory>()를 사용합니다.

예제 필터

가상 요청

보트 및 웹 테스트를 필터링합니다. 메트릭 탐색기가 가상 소스를 필터링하는 옵션을 제공하지만 이 옵션은 SDK 자체에서 필터링하여 트래픽과 수집 크기를 감소시킵니다.

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

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

실패한 인증

"401" 응답을 사용하여 요청을 필터링합니다.

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

빠른 원격 종속성 호출을 필터링합니다.

느린 호출만 진단하려는 경우 빠른 호출을 필터링합니다.

참고 항목

이 필터링은 여러분이 포털에서 참조하는 통계를 왜곡시킵니다.

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

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

종속성 문제 진단

이 블로그 에서는 종속성으로 정규 ping을 자동으로 전송하여 종속성 문제를 진단하는 프로젝트에 대해 설명합니다.

Java

Java에서 원격 분석 프로세서 및 해당 구현에 대해 자세히 알아보려면 Java 원격 분석 프로세서 설명서를 참조하세요.

JavaScript 웹 애플리케이션

ITelemetryInitializer를 사용하여 필터링

원격 분석 이니셜라이저 콜백 함수를 만듭니다. 콜백 함수는 처리 중인 이벤트인 ITelemetryItem을 매개 변수로 사용합니다. 이 콜백에서 false를 반환하면 원격 분석 항목이 필터링됩니다.
```
var filteringFunction = (envelope) => {
  if (envelope.data.someField === 'tobefilteredout') {
      return false;
  }

  return true;
};
```
원격 분석 이니셜라이저 콜백을 추가합니다.
```
appInsights.addTelemetryInitializer(filteringFunction);
```

속성 추가/수정: ITelemetryInitializer

원격 분석 이니셜라이저를 사용하여 추가 정보로 원격 분석을 보강하거나 표준 원격 분석 모듈에 의해 설정된 원격 분석 속성을 재정의할 수 있습니다.

예를 들어, 웹 패키지에 대한 Application Insights는 HTTP 요청에 대한 원격 분석을 수집합니다. 기본적으로 응답 코드가 400 이상인 모든 요청을 실패한 것으로 플래그 지정합니다. 그러나 400을 성공으로 처리하고 싶다면 성공 속성을 설정하는 원격 분석 이니셜라이저를 제공할 수 있습니다.

원격 분석 이니셜라이저를 제공하면 Track*() 메서드가 호출될 때마다 호출됩니다. 이 이니셜라이즈에는 표준 원격 분석 모듈에 의해 호출되는 Track() 메서드가 포함됩니다. 규칙에 따라 해당 모듈은 이니셜라이저가 이미 설정한 속성은 설정하지 않습니다. 원격 분석 이니셜라이저는 원격 분석 프로세서가 호출되기 이전에 호출됩니다. 따라서 이니셜라이저가 수행하는 모든 강화는 프로세서에 표시됩니다.

이니셜라이저 정의

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 앱: 이니셜라이저 로드

ApplicationInsights.config에서:

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

또는, 코드에서 이니셜라이저를 인스턴스화할 수 있습니다(예: Global.aspx.cs).

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

이 샘플에 대해 자세히 알아봅니다.

ASP.NET Core/Worker 서비스 앱: 이니셜라이저 로드

참고 항목

ApplicationInsights.config 또는 TelemetryConfiguration.Active를 사용하여 이니셜라이저를 추가하는 것은 ASP.NET Core 애플리케이션 또는 Microsoft.ApplicationInsights.WorkerService SDK를 사용하는 경우에는 유효하지 않습니다.

ASP.NET Core 또는 WorkerService를 사용하여 작성한 앱의 경우, 표시된 것처럼 종속성 수집 컨테이너에 추가함으로써 새로운 원격 분석 이니셜라이저를 추가합니다. Startup.ConfigureServices 메서드에서 이 단계를 수행합니다.

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

JavaScript 원격 분석 이니셜라이저

필요한 경우 JavaScript 원격 분석 초기화 프로그램을 삽입합니다. Application Insights JavaScript SDK의 원격 분석 초기화 프로그램에 대한 자세한 내용은 원격 분석 초기화 프로그램을 참조하세요.

JavaScript(웹) SDK 로더 스크립트
npm 패키지

JavaScript(웹) SDK 로더 스크립트 구성에 onInit 콜백 함수를 추가하여 원격 분석 초기화를 삽입합니다.

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

원격 분석 항목에서 사용할 수 있는 사용자 지정이 아닌 속성의 요약은 Application Insights 데이터 모델 내보내기를 참조하세요.

이니셜라이저를 원하는 수만큼 추가할 수 있습니다. 추가된 순서대로 호출됩니다.

OpenCensus Python 원격 분석 프로세서

OpenCensus Python의 원격 분석 프로세서는 내보내기 전에 단순히 원격 분석을 처리하기 위해 호출되는 콜백 함수입니다. 콜백 함수는 봉투 데이터 형식을 매개 변수로 허용해야 합니다. 원격 분석을 내보내지 않도록 필터링하려면 콜백 함수가 False를 반환하는지 확인합니다. GitHub의 봉투에서 Azure Monitor 데이터 형식에 대한 스키마를 볼 수 있습니다.

참고 항목

tags 필드의 ai.cloud.role 특성을 변경하여 cloud_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()

원하는 만큼 프로세서를 추가할 수 있습니다. 추가된 순서대로 호출됩니다. 한 프로세서가 예외를 throw해도 다음 프로세서에 영향을 주지 않습니다.

TelemetryInitializers 예제

사용자 지정 속성 추가

다음 샘플 이니셜라이저는 추적된 모든 원격 분석에 사용자 지정 속성을 추가합니다.

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

클라우드 역할 이름 추가

다음 샘플 이니셜라이저는 추적된 모든 원격 분석에 클라우드 역할 이름을 설정합니다.

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

지리적 매핑에 사용되는 클라이언트 IP 주소 제어

다음 샘플 이니셜라이저는 원격 분석 수집 중에 클라이언트 소켓 IP 주소 대신 지리적 위치 매핑에 사용할 클라이언트 IP를 설정합니다.

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

원격 분석 프로세서 및 원격 분석 이니셜라이저 간의 차이는 무엇인가요?

두 가지로 수행할 수 있는 작업에는 약간의 중복이 있습니다. 두 가지 모두 원격 분석의 속성을 추가하거나 수정하는 데 사용할 수 있지만, 해당 목적이라면 이니셜라이저 사용을 권장합니다.
원격 분석 이니셜라이저는 원격 분석 프로세서보다 항상 먼저 실행됩니다.
원격 분석 이니셜라이저는 두 번 이상 호출될 수 있습니다. 규칙에 따라 이미 설정된 속성은 설정하지 않습니다.
원격 분석 프로세서를 사용하면 원격 분석 항목을 완전히 바꾸거나 버릴 수 있습니다.
등록된 모든 원격 분석 이니셜라이저는 모든 원격 분석 항목에 대해 호출됩니다. 원격 분석 프로세서의 경우 SDK가 첫 번째 원격 분석 프로세서 호출을 보장합니다. 나머지 프로세서가 호출되는지 여부는 이전 원격 분석 프로세서에 의해 결정됩니다.
추가 속성으로 원격 분석을 보강하거나 기존 속성을 재정의하려면 원격 분석 이니셜라이저를 사용합니다. 원격 분석을 필터링하려면 원격 분석 프로세서를 사용합니다.

참고 항목

JavaScript에는 ITelemetryInitializer를 사용하여 이벤트를 필터링할 수 있는 원격 분석 이니셜라이저만 있습니다.

ApplicationInsights.config 문제 해결

정규화된 형식 이름 및 어셈블리 이름이 올바른지 확인합니다.
applicationinsights.config 파일이 출력 디렉터리에 있고 최근 변경 내용을 포함하는지 확인합니다.

Application Insights SDK에서 원격 분석 필터링 및 전처리

필터링

원격 분석 프로세서 만들기

C#

예제 필터

가상 요청

실패한 인증

빠른 원격 종속성 호출을 필터링합니다.

종속성 문제 진단

Java

JavaScript 웹 애플리케이션

속성 추가/수정: ITelemetryInitializer

JavaScript 원격 분석 이니셜라이저

OpenCensus Python 원격 분석 프로세서

TelemetryInitializers 예제

사용자 지정 속성 추가

클라우드 역할 이름 추가

지리적 매핑에 사용되는 클라이언트 IP 주소 제어

ITelemetryProcessor 및 ITelemetryInitializer

ApplicationInsights.config 문제 해결

Azure Monitor 원격 분석 데이터 형식 참조

참조 문서

SDK 코드

다음 단계

추가 리소스