Фильтрация и предварительная обработка данных телеметрии в пакете SDK для Application Insights

Статья
11/05/2024

Вы можете написать код для фильтрации, изменения или обогащения телеметрии перед отправкой из пакета SDK. Будут обрабатываться данные, отправляемые из модулей стандартной телеметрии, таких как коллекция запросов HTTP и коллекция зависимостей.

Используя фильтрацию, можно изменить или отменить телеметрию перед ее отправкой из пакета SDK. Для этого реализуйте ITelemetryProcessor. Например, можно уменьшить объем данных телеметрии, исключив запросы от роботов. В отличие от выборки, у вас есть полный контроль над отправкой или отменой, но он влияет на любые метрики на основе агрегированных журналов. В зависимости от способа отмены элементов вы также можете потерять возможность перемещаться между связанными элементами.
Добавление или изменение свойств в любые данные телеметрии, отправляемые из приложения, путем реализации ITelemetryInitializer. Например, можно добавить вычисляемые значения или номера версий, по которым будут отфильтрованы данные на портале.
Выборка сокращает объем данных телеметрии, не искажая статистические данные. Благодаря выборке связанные точки данных хранятся вместе, что облегчает навигацию между ними во время диагностики проблемы. На портале общее количество умножается, чтобы компенсировать выборку.

Примечание.

API пакета SDK используется для отправки пользовательских событий и показателей.

Необходимые компоненты

Установите соответствующий пакет SDK для приложения: ASP.NET, ASP.NET Core, Non-HTTP/Worker для .NET/.NET Core или JavaScript.

Фильтрация

Такой подход позволяет непосредственно контролировать включение элементов в поток данных телеметрии и исключение из него. Фильтрацию можно использовать для удаления элементов телеметрии перед отправкой в Application Insights. Фильтрацию можно использовать совместно с выборкой или по отдельности.

Для фильтрации данных телеметрии нужно создать обработчик данных телеметрии и зарегистрировать его с помощью TelemetryConfiguration. Все данные телеметрии проходят через обработчик. Вы можете удалить их из потока или передать следующему обработчику в цепочке. Сюда входят данные телеметрии из стандартных модулей, таких как сборщик HTTP-запросов и сборщик зависимостей, а также данные телеметрии, полученные вами самостоятельно. Например, можно отфильтровать данные телеметрии о запросах из программ-роботов или успешных вызовах зависимостей.

Предупреждение

Фильтрация данных телеметрии, отправленных из пакета SDK с помощью обработчиков, может исказить отображаемую на портале статистику и затруднить отслеживание связанных элементов.

Вместо этого попробуйте использовать выборку.

Приложения .NET

Реализуйте расширение ITelemetryProcessor.

Обработчики данных телеметрии создают цепь обработки. При создании экземпляра обработчика данных телеметрии предоставляется ссылка на следующий обработчик в цепочке. Когда точка данных телеметрии передается в метод Process, он выполняет свою работу и затем вызывает (или не вызывает) следующий обработчик данных телеметрии в цепочке.

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
- служба ASP.NET Core/Worker
В файл ApplicationInsights.config вставьте следующий фрагмент кода:
```
<TelemetryProcessors>
  <Add Type="WebApplication9.SuccessfulDependencyFilter, WebApplication9">
    
    <MyParamFromConfigFile>2-beta</MyParamFromConfigFile>
  </Add>
</TelemetryProcessors>
```
Можно передавать строковые значения из файла конфигурации, указав открытые именованные свойства в классе.

Предупреждение

Будьте внимательны и задайте имя типа и имена свойств в файле конфигурации, совпадающие с именами классов и свойств в коде. Если файл конфигурации ссылается на несуществующий тип или свойство, пакет SDK может не отправить данные телеметрии без уведомления.

Другой способ — инициализировать фильтр в коде. Вставьте обработчик в цепочку в соответствующем классе инициализации, например AppStart в Global.asax.cs:
```
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();
```
Клиенты телеметрии, созданные после этого момента, используют процессоры.
Примечание.

Добавление обработчика с помощью ApplicationInsights.config или TelemetryConfiguration.Active недопустимо для приложений ASP.NET Core или при использовании пакета SDK Microsoft.ApplicationInsights.WorkerService.

Для приложений, написанных с помощью ASP.NET Core или WorkerService, добавление нового обработчика данных телеметрии осуществляется с помощью метода расширения AddApplicationInsightsTelemetryProcessor в IServiceCollection, как показано ниже. Этот метод вызывается в методе ConfigureServices класса Startup.cs.
```
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);
}

Неполадки диагностики зависимостей

этом блоге описан проект, в котором диагностика неполадок с зависимостями реализована в виде автоматического опрашивания зависимостей.

Приложения Java

Дополнительные сведения об обработчиках данных телеметрии и их реализации в Java см. в документации по обработчикам телеметрии Java.

Веб-приложения JavaScript

Данные телеметрии можно фильтровать из веб-приложений 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(), вызываемые стандартными модулями телеметрии. Обычно эти модули не задают свойство, которое уже задал инициализатор. Инициализаторы телеметрии вызываются перед вызовом процессоров телеметрии, поэтому любые обогащения, выполненные инициализаторами, видны процессорам.

Приложения .NET

Определение инициализатора

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
- служба ASP.NET Core/Worker
В ApplicationInsights.config.:
```
<ApplicationInsights>
  <TelemetryInitializers>
    
    <Add Type="MvcWebRole.Telemetry.MyTelemetryInitializer, MvcWebRole"/>
    ...
  </TelemetryInitializers>
</ApplicationInsights>
```
Другой способ — создать экземпляр инициализатора в коде, например в Global.aspx.cs.
```
protected void Application_Start()
{
    // ...
    TelemetryConfiguration.Active.TelemetryInitializers.Add(new MyTelemetryInitializer());
}
```
Дополнительную информацию см. здесь.
Примечание.

Добавление инициализатора с помощью ApplicationInsights.config или TelemetryConfiguration.Active недопустимо для приложений ASP.NET Core или при использовании пакета SDK Microsoft.ApplicationInsights.WorkerService.

Для приложений, написанных с помощью ASP.NET Core или WorkerService, добавление нового инициализатора осуществляется с помощью контейнера внедрения зависимостей, как показано ниже. Выполните этот шаг в методе Startup.ConfigureServices.
```
using Microsoft.ApplicationInsights.Extensibility;
using CustomInitializer.Telemetry;
public void ConfigureServices(IServiceCollection services)
{
    services.AddSingleton<ITelemetryInitializer, MyTelemetryInitializer>();
}
```

Инициализаторы телеметрии JavaScript

При необходимости вставьте инициализатор телеметрии JavaScript. Дополнительные сведения о инициализаторах телеметрии для пакета SDK JavaScript Application Insights см. в разделе "Инициализаторы телеметрии".

Скрипт загрузчика пакета SDK для JavaScript (Web)
Пакет npm

Вставьте инициализатор телеметрии, добавив функцию обратного вызова onInit в конфигурацию скрипта загрузчика пакета SDK JavaScript (Web):

<script type="text/javascript">
!(function (cfg){function e(){cfg.onInit&&cfg.onInit(n)}var x,w,D,t,E,n,C=window,O=document,b=C.location,q="script",I="ingestionendpoint",L="disableExceptionTracking",j="ai.device.";"instrumentationKey"[x="toLowerCase"](),w="crossOrigin",D="POST",t="appInsightsSDK",E=cfg.name||"appInsights",(cfg.name||C[t])&&(C[t]=E),n=C[E]||function(g){var f=!1,m=!1,h={initialize:!0,queue:[],sv:"8",version:2,config:g};function v(e,t){var n={},i="Browser";function a(e){e=""+e;return 1===e.length?"0"+e:e}return n[j+"id"]=i[x](),n[j+"type"]=i,n["ai.operation.name"]=b&&b.pathname||"_unknown_",n["ai.internal.sdkVersion"]="javascript:snippet_"+(h.sv||h.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:undefined,seq:"1",aiDataContract:undefined}}var n,i,t,a,y=-1,T=0,S=["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"],o=g.url||cfg.src,r=function(){return s(o,null)};function s(d,t){if((n=navigator)&&(~(n=(n.userAgent||"").toLowerCase()).indexOf("msie")||~n.indexOf("trident/"))&&~d.indexOf("ai.3")&&(d=d.replace(/(\/)(ai\.3\.)([^\d]*)$/,function(e,t,n){return t+"ai.2"+n})),!1!==cfg.cr)for(var e=0;e<S.length;e++)if(0<d.indexOf(S[e])){y=e;break}var n,i=function(e){var a,t,n,i,o,r,s,c,u,l;h.queue=[],m||(0<=y&&T+1<S.length?(a=(y+T+1)%S.length,p(d.replace(/^(.*\/\/)([\w\.]*)(\/.*)$/,function(e,t,n,i){return t+S[a]+i})),T+=1):(f=m=!0,s=d,!0!==cfg.dle&&(c=(t=function(){var e,t={},n=g.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][x]()]=o[1])}return t[I]||(e=(n=t.endpointsuffix)?t.location:null,t[I]="https://"+(e?e+".":"")+"dc."+(n||"services.visualstudio.com")),t}()).instrumentationkey||g.instrumentationKey||"",t=(t=(t=t[I])&&"/"===t.slice(-1)?t.slice(0,-1):t)?t+"/v2/track":g.endpointUrl,t=g.userOverrideEndpointUrl||t,(n=[]).push((i="SDK LOAD Failure: Failed to load Application Insights SDK script (See stack for details)",o=s,u=t,(l=(r=v(c,"Exception")).data).baseType="ExceptionData",l.baseData.exceptions=[{typeName:"SDKLoadFailed",message:i.replace(/\./g,"-"),hasFullStack:!1,stack:i+"\nSnippet failed to load ["+o+"] -- Telemetry is disabled\nHelp Link: https://go.microsoft.com/fwlink/?linkid=2128109\nHost: "+(b&&b.pathname||"_unknown_")+"\nEndpoint: "+u,parsedStack:[]}],r)),n.push((l=s,i=t,(u=(o=v(c,"Message")).data).baseType="MessageData",(r=u.baseData).message='AI (Internal): 99 message:"'+("SDK LOAD Failure: Failed to load Application Insights SDK script (See stack for details) ("+l+")").replace(/\"/g,"")+'"',r.properties={endpoint:i},o)),s=n,c=t,JSON&&((u=C.fetch)&&!cfg.useXhr?u(c,{method:D,body:JSON.stringify(s),mode:"cors"}):XMLHttpRequest&&((l=new XMLHttpRequest).open(D,c),l.setRequestHeader("Content-type","application/json"),l.send(JSON.stringify(s)))))))},a=function(e,t){m||setTimeout(function(){!t&&h.core||i()},500),f=!1},p=function(e){var n=O.createElement(q),e=(n.src=e,t&&(n.integrity=t),n.setAttribute("data-ai-name",E),cfg[w]);return!e&&""!==e||"undefined"==n[w]||(n[w]=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?O.getElementsByTagName("head")[0].appendChild(n):setTimeout(function(){O.getElementsByTagName(q)[0].parentNode.appendChild(n)},cfg.ld||0),n};p(d)}cfg.sri&&(n=o.match(/^((http[s]?:\/\/.*\/)\w+(\.\d+){1,5})\.(([\w]+\.){0,2}js)$/))&&6===n.length?(d="".concat(n[1],".integrity.json"),i="@".concat(n[4]),l=window.fetch,t=function(e){if(!e.ext||!e.ext[i]||!e.ext[i].file)throw Error("Error Loading JSON response");var t=e.ext[i].integrity||null;s(o=n[2]+e.ext[i].file,t)},l&&!cfg.useXhr?l(d,{method:"GET",mode:"cors"}).then(function(e){return e.json()["catch"](function(){return{}})}).then(t)["catch"](r):XMLHttpRequest&&((a=new XMLHttpRequest).open("GET",d),a.onreadystatechange=function(){if(a.readyState===XMLHttpRequest.DONE)if(200===a.status)try{t(JSON.parse(a.responseText))}catch(e){r()}else r()},a.send())):o&&r();try{h.cookie=O.cookie}catch(k){}function e(e){for(;e.length;)!function(t){h[t]=function(){var e=arguments;f||h.queue.push(function(){h[t].apply(h,e)})}}(e.pop())}var c,u,l="track",d="TrackPage",p="TrackEvent",l=(e([l+"Event",l+"PageView",l+"Exception",l+"Trace",l+"DependencyData",l+"Metric",l+"PageViewPerformance","start"+d,"stop"+d,"start"+p,"stop"+p,"addTelemetryInitializer","setAuthenticatedUserContext","clearAuthenticatedUserContext","flush"]),h.SeverityLevel={Verbose:0,Information:1,Warning:2,Error:3,Critical:4},(g.extensionConfig||{}).ApplicationInsightsAnalytics||{});return!0!==g[L]&&!0!==l[L]&&(e(["_"+(c="onerror")]),u=C[c],C[c]=function(e,t,n,i,a){var o=u&&u(e,t,n,i,a);return!0!==o&&h["_"+c]({message:e,url:t,lineNumber:n,columnNumber:i,error:a,evt:C.event}),o},g.autoExceptionInstrumented=!0),h}(cfg.cfg),(C[E]=n).queue&&0===n.queue.length?(n.queue.push(e),n.trackPageView({})):e();})({
src: "https://js.monitor.azure.com/scripts/b/ai.3.gbl.min.js",
crossOrigin: "anonymous", // When supplied this will add the provided value as the cross origin attribute on the script tag
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
// sri: false, // Custom optional value to specify whether fetching the snippet from integrity file and do integrity check
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();

Краткое описание ненастраиваемых свойств, доступных в коллекции telemetryItem, см. в разделе Экспорт модели данных Application Insights.

Вы можете добавить любое количество инициализаторов по своему усмотрению. Они применяются в порядке добавления.

Обработчики телеметрии OpenCensus Python

Обработчики данных телеметрии в OpenCensus Python — это просто функции обратного вызова, которые вызываются для обработки данных телеметрии перед их экспортом. Функция обратного вызова должна принимать тип данных конверт в качестве параметра. Чтобы исключить данные телеметрии из экспорта, убедитесь, что функция обратного вызова возвращает False. Схема типов данных Azure Monitor в конвертах представлена на сайте GitHub.

Примечание.

Можно изменить cloud_RoleName, изменив атрибут ai.cloud.role в поле tags.

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

Вы можете добавить любое количество обработчиков по своему усмотрению. Они применяются в порядке добавления. Если один из обработчиков порождает исключение, оно не влияет на следующие обработчики.

Примеры инициализаторов TelemetryInitializer

Добавление пользовательского свойства

Следующий пример инициализатора добавляет пользовательское свойство в каждый отслеживаемый элемент телеметрии.

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 находится в выходном каталоге и содержит все последние изменения.

Поделиться через

Фильтрация и предварительная обработка данных телеметрии в пакете SDK для Application Insights

Необходимые компоненты

Фильтрация

Приложения .NET

Примеры фильтров

Искусственные запросы

Сбой проверки подлинности

Фильтрация быстрых удаленных вызовов зависимостей

Неполадки диагностики зависимостей

Приложения Java

Веб-приложения JavaScript

Добавление или изменение свойств: ITelemetryInitializer

Приложения .NET

Инициализаторы телеметрии JavaScript

Обработчики телеметрии OpenCensus Python

Примеры инициализаторов TelemetryInitializer

Добавление пользовательского свойства

Добавление имени облачной роли

Управление IP-адресом клиента, используемым для сопоставления геолокаций

ITelemetryProcessor и ITelemetryInitializer

Устранение неполадок с файлом ApplicationInsights.config

Справочник по типам данных телеметрии Azure Monitor

Справочная документация

Код пакета SDK

Следующие шаги

Обратная связь

Дополнительные ресурсы