Настройка Azure Monitor OpenTelemetry

Используйте один из следующих трех способов настройки строка подключения:

• Добавьте UseAzureMonitor() в program.cs файл:

  var builder = WebApplication.CreateBuilder(args);
  
  // Add the OpenTelemetry telemetry service to the application.
  // This service will collect and send telemetry data to Azure Monitor.
  builder.Services.AddOpenTelemetry().UseAzureMonitor(options => {
      options.ConnectionString = "<Your Connection String>";
  });
  
  var app = builder.Build();
  
  app.Run();
  

• Задайте переменную среды.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your Connection String>
  

• Добавьте следующий раздел в appsettings.json файл конфигурации.

  {
    "AzureMonitor": {
        "ConnectionString": "<Your Connection String>"
    }
  }
  

Используйте один из следующих двух способов настройки строка подключения:

• Добавьте экспортер Azure Monitor к каждому сигналу OpenTelemetry в запуске приложения.

  // Create a new OpenTelemetry tracer provider.
  // It is important to keep the TracerProvider instance active throughout the process lifetime.
  var tracerProvider = Sdk.CreateTracerProviderBuilder()
      .AddAzureMonitorTraceExporter(options =>
      {
          options.ConnectionString = "<Your Connection String>";
      })
      .Build();
  
  // Create a new OpenTelemetry meter provider.
  // It is important to keep the MetricsProvider instance active throughout the process lifetime.
  var metricsProvider = Sdk.CreateMeterProviderBuilder()
      .AddAzureMonitorMetricExporter(options =>
      {
          options.ConnectionString = "<Your Connection String>";
      })
      .Build();
  
  // Create a new logger factory.
  // It is important to keep the LoggerFactory instance active throughout the process lifetime.
  var loggerFactory = LoggerFactory.Create(builder =>
  {
      builder.AddOpenTelemetry(logging =>
      {
          logging.AddAzureMonitorLogExporter(options =>
          {
              options.ConnectionString = "<Your Connection String>";
          });
      });
  });
  

• Задайте переменную среды.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your Connection String>
  

Сведения о настройке строки подключения см. в разделе "Строка подключения".

Используйте один из следующих двух способов настройки строка подключения:

• Задайте переменную среды.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your Connection String>
  

• Задайте свойство.

  applicationinsights.connection.string=<Your Connection String>
  

Используйте один из следующих двух способов настройки строка подключения:

• Задайте переменную среды.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your Connection String>
  

• Используйте объект конфигурации.

  // Import the useAzureMonitor function and the AzureMonitorOpenTelemetryOptions class from the @azure/monitor-opentelemetry package.
  const { useAzureMonitor, AzureMonitorOpenTelemetryOptions } = require("@azure/monitor-opentelemetry");
  
  // Create a new AzureMonitorOpenTelemetryOptions object.
  const options: AzureMonitorOpenTelemetryOptions = {
    azureMonitorExporterOptions: {
      connectionString: "<your connection string>"
    }
  };
  
  // Enable Azure Monitor integration using the useAzureMonitor function and the AzureMonitorOpenTelemetryOptions object.
  useAzureMonitor(options);
  

Используйте один из следующих двух способов настройки строка подключения:

• Задайте переменную среды.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your Connection String>
  

• Использовать функцию configure_azure_monitor.

# Import the `configure_azure_monitor()` function from the `azure.monitor.opentelemetry` package.
from azure.monitor.opentelemetry import configure_azure_monitor

# Configure OpenTelemetry to use Azure Monitor with the specified connection string.
# Replace `<your-connection-string>` with the connection string of your Azure Monitor Application Insights resource.
configure_azure_monitor(
    connection_string="<your-connection-string>",
)

Задайте имя и экземпляр облачной роли с помощью атрибутов Resource. Имя облачной роли использует атрибуты service.namespace и service.name, хотя и возвращается к service.name, если service.namespace не задано. Экземпляр облачной роли использует значение атрибута service.instance.id. Сведения о стандартных атрибутах ресурсов см. в разделе "Семантические соглашения OpenTelemetry".

// Setting role name and role instance

// Create a dictionary of resource attributes.
var resourceAttributes = new Dictionary<string, object> {
    { "service.name", "my-service" },
    { "service.namespace", "my-namespace" },
    { "service.instance.id", "my-instance" }};

// Create a new ASP.NET Core web application builder.
var builder = WebApplication.CreateBuilder(args);

// Add the OpenTelemetry telemetry service to the application.
// This service will collect and send telemetry data to Azure Monitor.
builder.Services.AddOpenTelemetry()
    .UseAzureMonitor()
    // Configure the ResourceBuilder to add the custom resource attributes to all signals.
    // Custom resource attributes should be added AFTER AzureMonitor to override the default ResourceDetectors.
    .ConfigureResource(resourceBuilder => resourceBuilder.AddAttributes(_testResourceAttributes));

// Build the ASP.NET Core web application.
var app = builder.Build();

// Start the ASP.NET Core web application.
app.Run();

Задайте имя и экземпляр облачной роли с помощью атрибутов Resource. Имя облачной роли использует атрибуты service.namespace и service.name, хотя и возвращается к service.name, если service.namespace не задано. Экземпляр облачной роли использует значение атрибута service.instance.id. Сведения о стандартных атрибутах ресурсов см. в разделе "Семантические соглашения OpenTelemetry".

// Setting role name and role instance

// Create a dictionary of resource attributes.
var resourceAttributes = new Dictionary<string, object> {
    { "service.name", "my-service" },
    { "service.namespace", "my-namespace" },
    { "service.instance.id", "my-instance" }};

// Create a resource builder.
var resourceBuilder = ResourceBuilder.CreateDefault().AddAttributes(resourceAttributes);

// Create a new OpenTelemetry tracer provider and set the resource builder.
// It is important to keep the TracerProvider instance active throughout the process lifetime.
var tracerProvider = Sdk.CreateTracerProviderBuilder()
    // Set ResourceBuilder on the TracerProvider.
    .SetResourceBuilder(resourceBuilder)
    .AddAzureMonitorTraceExporter()
    .Build();

// Create a new OpenTelemetry meter provider and set the resource builder.
// It is important to keep the MetricsProvider instance active throughout the process lifetime.
var metricsProvider = Sdk.CreateMeterProviderBuilder()
    // Set ResourceBuilder on the MeterProvider.
    .SetResourceBuilder(resourceBuilder)
    .AddAzureMonitorMetricExporter()
    .Build();

// Create a new logger factory and add the OpenTelemetry logger provider with the resource builder.
// It is important to keep the LoggerFactory instance active throughout the process lifetime.
var loggerFactory = LoggerFactory.Create(builder =>
{
    builder.AddOpenTelemetry(logging =>
    {
        // Set ResourceBuilder on the Logging config.
        logging.SetResourceBuilder(resourceBuilder);
        logging.AddAzureMonitorLogExporter();
    });
});

Чтобы задать имя облачной роли, см. имя облачной роли.

Сведения о настройке экземпляра облачной роли см. в разделе "Экземпляр облачной роли".

Чтобы задать имя облачной роли, выполните следующие действия.

• Использование собственных приложений образов spring.application.name Spring Boot
• Использование собственных приложений образов quarkus.application.name Quarkus

Задайте имя и экземпляр облачной роли с помощью атрибутов Resource. Имя облачной роли использует атрибуты service.namespace и service.name, хотя и возвращается к service.name, если service.namespace не задано. Экземпляр облачной роли использует значение атрибута service.instance.id. Сведения о стандартных атрибутах ресурсов см. в разделе "Семантические соглашения OpenTelemetry".

// Import the useAzureMonitor function, the AzureMonitorOpenTelemetryOptions class, the Resource class, and the SemanticResourceAttributes class from the @azure/monitor-opentelemetry, @opentelemetry/resources, and @opentelemetry/semantic-conventions packages, respectively.
const { useAzureMonitor, AzureMonitorOpenTelemetryOptions } = require("@azure/monitor-opentelemetry");
const { Resource } = require("@opentelemetry/resources");
const { SemanticResourceAttributes } = require("@opentelemetry/semantic-conventions");

// Create a new Resource object with the following custom resource attributes:
//
// * service_name: my-service
// * service_namespace: my-namespace
// * service_instance_id: my-instance
const customResource = new Resource({
  [SemanticResourceAttributes.SERVICE_NAME]: "my-service",
  [SemanticResourceAttributes.SERVICE_NAMESPACE]: "my-namespace",
  [SemanticResourceAttributes.SERVICE_INSTANCE_ID]: "my-instance",
});

// Create a new AzureMonitorOpenTelemetryOptions object and set the resource property to the customResource object.
const options: AzureMonitorOpenTelemetryOptions = {
  resource: customResource
};

// Enable Azure Monitor integration using the useAzureMonitor function and the AzureMonitorOpenTelemetryOptions object.
useAzureMonitor(options);

Задайте имя и экземпляр облачной роли с помощью атрибутов Resource. Имя облачной роли использует атрибуты service.namespace и service.name, хотя и возвращается к service.name, если service.namespace не задано. Экземпляр облачной роли использует значение атрибута service.instance.id. Сведения о стандартных атрибутах ресурсов см. в разделе "Семантические соглашения OpenTelemetry".

Задайте атрибуты ресурса с помощью OTEL_RESOURCE_ATTRIBUTES переменных среды и /или OTEL_SERVICE_NAME среды. OTEL_RESOURCE_ATTRIBUTES принимает ряд пар "ключ-значение", разделенных запятыми. Например, чтобы задать имя my-namespace.my-helloworld-service облачной роли и задать для my-instanceэкземпляра облачной роли значение, можно задать OTEL_RESOURCE_ATTRIBUTES и OTEL_SERVICE_NAME так:

export OTEL_RESOURCE_ATTRIBUTES="service.namespace=my-namespace,service.instance.id=my-instance"
export OTEL_SERVICE_NAME="my-helloworld-service"

Если атрибут resource не задан, можно также задать имя облачной service.namespace роли только с переменной среды OTEL_SERVICE_NAME или атрибутом service.name Resource. Например, чтобы задать имя my-helloworld-service облачной роли и задать для my-instanceэкземпляра облачной роли значение, можно задать OTEL_RESOURCE_ATTRIBUTES и OTEL_SERVICE_NAME так:

export OTEL_RESOURCE_ATTRIBUTES="service.instance.id=my-instance"
export OTEL_SERVICE_NAME="my-helloworld-service"

Выборщик ожидает частоту выборки от 0 до 1 включительно. Скорость 0,1 означает, что отправляется примерно 10% ваших трассировок.

// Create a new ASP.NET Core web application builder.
var builder = WebApplication.CreateBuilder(args);

// Add the OpenTelemetry telemetry service to the application.
// This service will collect and send telemetry data to Azure Monitor.
builder.Services.AddOpenTelemetry().UseAzureMonitor(options =>
{
    // Set the sampling ratio to 10%. This means that 10% of all traces will be sampled and sent to Azure Monitor.
    options.SamplingRatio = 0.1F;
});

// Build the ASP.NET Core web application.
var app = builder.Build();

// Start the ASP.NET Core web application.
app.Run();

Выборщик ожидает частоту выборки от 0 до 1 включительно. Скорость 0,1 означает, что отправляется примерно 10% ваших трассировок.

// Create a new OpenTelemetry tracer provider.
// It is important to keep the TracerProvider instance active throughout the process lifetime.
var tracerProvider = Sdk.CreateTracerProviderBuilder()
    .AddAzureMonitorTraceExporter(options =>
    {   
        // Set the sampling ratio to 10%. This means that 10% of all traces will be sampled and sent to Azure Monitor.
        options.SamplingRatio = 0.1F;
    })
    .Build();

Начиная с версии 3.4.0 доступна ограниченная скорость выборки и теперь используется по умолчанию. Дополнительные сведения о выборке см. в статье "Выборка Java".

Для нативных приложений Spring Boot применяются параметры выборки Java SDK OpenTelemetry.

Для нативных приложений Quarkus ознакомьтесь с документацией по Quarkus OpenTelemetry.

Выборщик ожидает частоту выборки от 0 до 1 включительно. Скорость 0,1 означает, что отправляется примерно 10% ваших трассировок.

// Import the useAzureMonitor function and the AzureMonitorOpenTelemetryOptions class from the @azure/monitor-opentelemetry package.
const { useAzureMonitor, AzureMonitorOpenTelemetryOptions } = require("@azure/monitor-opentelemetry");

// Create a new AzureMonitorOpenTelemetryOptions object and set the samplingRatio property to 0.1.
const options: AzureMonitorOpenTelemetryOptions = {
  samplingRatio: 0.1
};

// Enable Azure Monitor integration using the useAzureMonitor function and the AzureMonitorOpenTelemetryOptions object.
useAzureMonitor(options);

Функция configure_azure_monitor() автоматически использует ApplicationInsightsSampler для совместимости с пакетами SDK Application Insights и примерами данных телеметрии. Переменная OTEL_TRACES_SAMPLER_ARG среды может использоваться для указания частоты выборки с допустимым диапазоном от 0 до 1, где 0 — 0% и 1 — 100 %. Например, значение 0,1 означает, что 10 % трассировки отправляются.

export OTEL_TRACES_SAMPLER_ARG=0.1

По умолчанию эта функция включена.

Пользователи могут отключить динамические метрики при настройке дистрибутива.

builder.Services.AddOpenTelemetry().UseAzureMonitor(options => {
	// Disable the Live Metrics feature.
    options.EnableLiveMetrics = false;
});

Эта функция недоступна в azure Monitor .NET Exporter.

По умолчанию включен интерфейс динамических метрик.

Дополнительные сведения о конфигурации Java см. в разделе "Параметры конфигурации: Azure Monitor Application Insights для Java".

Динамические метрики недоступны сегодня для собственных приложений GraalVM.

Пользователи могут включить или отключить динамические метрики при настройке дистрибутива enableLiveMetrics с помощью свойства.

const options: AzureMonitorOpenTelemetryOptions = {
    azureMonitorExporterOptions: {
        connectionString:
            process.env["APPLICATIONINSIGHTS_CONNECTION_STRING"] || "<your connection string>",
    },
    enableLiveMetrics: false
};

useAzureMonitor(options);

Вы можете включить динамические метрики с помощью дистрибутива OpenTelemetry в Azure Monitor для Python следующим образом:

...
configure_azure_monitor(
	enable_live_metrics=True
)
...

Дополнительные сведения о настройке аутентификации Entra ID см. в статье Microsoft Entra Authentication for Application Insights

Дополнительные сведения о настройке аутентификации Entra ID см. в статье Microsoft Entra Authentication for Application Insights

Дополнительные сведения о настройке аутентификации Entra ID см. в статье Microsoft Entra Authentication for Application Insights

Проверка подлинности идентификатора Microsoft Entra недоступна для приложений GraalVM Native.

Дополнительные сведения о настройке аутентификации Entra ID см. в статье Microsoft Entra Authentication for Application Insights

Дополнительные сведения о настройке аутентификации Entra ID см. в статье Microsoft Entra Authentication for Application Insights

Пакет дистрибутива включает AzureMonitorExporter, который по умолчанию использует одно из следующих расположений для автономного хранилища (указано в порядке приоритета):

• Виндоус
  • %LOCALAPPDATA%\Microsoft\AzureMonitor
  • %TEMP%\Microsoft\AzureMonitor
• Не в Windows
  • %TMPDIR%/Microsoft/AzureMonitor
  • /var/tmp/Microsoft/AzureMonitor
  • /tmp/Microsoft/AzureMonitor

Чтобы переопределить каталог по умолчанию, необходимо задать.AzureMonitorOptions.StorageDirectory

// Create a new ASP.NET Core web application builder.
var builder = WebApplication.CreateBuilder(args);

// Add the OpenTelemetry telemetry service to the application.
// This service will collect and send telemetry data to Azure Monitor.
builder.Services.AddOpenTelemetry().UseAzureMonitor(options =>
{
    // Set the Azure Monitor storage directory to "C:\\SomeDirectory".
    // This is the directory where the OpenTelemetry SDK will store any telemetry data that cannot be sent to Azure Monitor immediately.
    options.StorageDirectory = "C:\\SomeDirectory";
});

// Build the ASP.NET Core web application.
var app = builder.Build();

// Start the ASP.NET Core web application.
app.Run();

Чтобы отключить эту функцию, следует задать.AzureMonitorOptions.DisableOfflineStorage = true

По умолчанию AzureMonitorExporter использует одно из следующих расположений для автономного хранилища (указано в порядке приоритета):

• Виндоус
  • %LOCALAPPDATA%\Microsoft\AzureMonitor
  • %TEMP%\Microsoft\AzureMonitor
• Не в Windows
  • %TMPDIR%/Microsoft/AzureMonitor
  • /var/tmp/Microsoft/AzureMonitor
  • /tmp/Microsoft/AzureMonitor

Чтобы переопределить каталог по умолчанию, необходимо задать.AzureMonitorExporterOptions.StorageDirectory

// Create a new OpenTelemetry tracer provider and set the storage directory.
// It is important to keep the TracerProvider instance active throughout the process lifetime.
var tracerProvider = Sdk.CreateTracerProviderBuilder()
    .AddAzureMonitorTraceExporter(options =>
    {
        // Set the Azure Monitor storage directory to "C:\\SomeDirectory".
        // This is the directory where the OpenTelemetry SDK will store any trace data that cannot be sent to Azure Monitor immediately.
        options.StorageDirectory = "C:\\SomeDirectory";
        })
        .Build();

// Create a new OpenTelemetry meter provider and set the storage directory.
// It is important to keep the MetricsProvider instance active throughout the process lifetime.
var metricsProvider = Sdk.CreateMeterProviderBuilder()
    .AddAzureMonitorMetricExporter(options =>
    {
        // Set the Azure Monitor storage directory to "C:\\SomeDirectory".
        // This is the directory where the OpenTelemetry SDK will store any metric data that cannot be sent to Azure Monitor immediately.
        options.StorageDirectory = "C:\\SomeDirectory";
        })
        .Build();

// Create a new logger factory and add the OpenTelemetry logger provider with the storage directory.
// It is important to keep the LoggerFactory instance active throughout the process lifetime.
var loggerFactory = LoggerFactory.Create(builder =>
{
    builder.AddOpenTelemetry(logging =>
    {
        logging.AddAzureMonitorLogExporter(options =>
        {
            // Set the Azure Monitor storage directory to "C:\\SomeDirectory".
            // This is the directory where the OpenTelemetry SDK will store any log data that cannot be sent to Azure Monitor immediately.
            options.StorageDirectory = "C:\\SomeDirectory";
        });
    });
});

Чтобы отключить эту функцию, следует задать.AzureMonitorExporterOptions.DisableOfflineStorage = true

Если агент не может отправлять данные телеметрии в Azure Monitor, он хранит файлы телеметрии на диске. Файлы сохраняются в telemetry папке в каталоге, указанном системным свойством java.io.tmpdir . Каждое имя файла начинается с метки времени и заканчивается расширением .trn . Этот механизм автономного хранилища помогает обеспечить хранение данных телеметрии во время временных сбоев сети или сбоев приема.

Агент хранит до 50 МБ данных телеметрии по умолчанию и разрешает настройку ограничения хранилища. Попытки отправки хранимой телеметрии периодически выполняются. Файлы телеметрии старше 48 часов удаляются, а самые старые события удаляются при достижении ограничения хранилища.

Полный список доступных конфигураций см. в разделе "Параметры конфигурации".

Если агент не может отправлять данные телеметрии в Azure Monitor, он хранит файлы телеметрии на диске. Файлы сохраняются в telemetry папке в каталоге, указанном системным свойством java.io.tmpdir . Каждое имя файла начинается с метки времени и заканчивается расширением .trn . Этот механизм автономного хранилища помогает обеспечить хранение данных телеметрии во время временных сбоев сети или сбоев приема.

Агент хранит до 50 МБ данных телеметрии по умолчанию. Попытки отправки хранимой телеметрии периодически выполняются. Файлы телеметрии старше 48 часов удаляются, а самые старые события удаляются при достижении ограничения хранилища.

По умолчанию AzureMonitorExporter использует одно из следующих расположений для автономного хранилища.

• Виндоус
  • %TEMP%\Microsoft\AzureMonitor
• Не в Windows
  • %TMPDIR%/Microsoft/AzureMonitor
  • /var/tmp/Microsoft/AzureMonitor

Чтобы переопределить каталог по умолчанию, необходимо задать.storageDirectory

Например:

// Import the useAzureMonitor function and the AzureMonitorOpenTelemetryOptions class from the @azure/monitor-opentelemetry package.
const { useAzureMonitor, AzureMonitorOpenTelemetryOptions } = require("@azure/monitor-opentelemetry");

// Create a new AzureMonitorOpenTelemetryOptions object and set the azureMonitorExporterOptions property to an object with the following properties:
//
// * connectionString: The connection string for your Azure Monitor Application Insights resource.
// * storageDirectory: The directory where the Azure Monitor OpenTelemetry exporter will store telemetry data when it is offline.
// * disableOfflineStorage: A boolean value that specifies whether to disable offline storage.
const options: AzureMonitorOpenTelemetryOptions = {
  azureMonitorExporterOptions: {
    connectionString: "<Your Connection String>",
    storageDirectory: "C:\\SomeDirectory",
    disableOfflineStorage: false
  }
};

// Enable Azure Monitor integration using the useAzureMonitor function and the AzureMonitorOpenTelemetryOptions object.
useAzureMonitor(options);

Чтобы отключить эту функцию, следует задать.disableOfflineStorage = true

По умолчанию экспортеры Azure Monitor используют следующий путь:

<tempfile.gettempdir()>/Microsoft/AzureMonitor/opentelemetry-python-<your-instrumentation-key>

Чтобы переопределить каталог по умолчанию, необходимо задать storage_directory нужный каталог.

Например:

...
# Configure OpenTelemetry to use Azure Monitor with the specified connection string and storage directory.
# Replace `your-connection-string` with the connection string to your Azure Monitor Application Insights resource.
# Replace `C:\\SomeDirectory` with the directory where you want to store the telemetry data before it is sent to Azure Monitor.
configure_azure_monitor(
    connection_string="your-connection-string",
    storage_directory="C:\\SomeDirectory",
)
...

Чтобы отключить эту функцию, необходимо задать значение disable_offline_storageTrue. По умолчанию — False.

Например:

...
# Configure OpenTelemetry to use Azure Monitor with the specified connection string and disable offline storage.
# Replace `your-connection-string` with the connection string to your Azure Monitor Application Insights resource.
configure_azure_monitor(
    connection_string="your-connection-string",
    disable_offline_storage=True,
)
...

1. Установите пакет OpenTelemetry.Exporter.OpenTelemetryProtocol в проекте.

   dotnet add package OpenTelemetry.Exporter.OpenTelemetryProtocol
   

2. Добавьте приведенный ниже фрагмент кода. В этом примере предполагается, что у вас есть сборщик OpenTelemetry с работающим приемником OTLP. Дополнительные сведения см. в примере на сайте GitHub.

   // Create a new ASP.NET Core web application builder.
   var builder = WebApplication.CreateBuilder(args);
   
   // Add the OpenTelemetry telemetry service to the application.
   // This service will collect and send telemetry data to Azure Monitor.
   builder.Services.AddOpenTelemetry().UseAzureMonitor();
   
   // Add the OpenTelemetry OTLP exporter to the application.
   // This exporter will send telemetry data to an OTLP receiver, such as Prometheus
   builder.Services.AddOpenTelemetry().WithTracing(builder => builder.AddOtlpExporter());
   builder.Services.AddOpenTelemetry().WithMetrics(builder => builder.AddOtlpExporter());
   
   // Build the ASP.NET Core web application.
   var app = builder.Build();
   
   // Start the ASP.NET Core web application.
   app.Run();
   

1. Установите пакет OpenTelemetry.Exporter.OpenTelemetryProtocol в проекте.

   dotnet add package OpenTelemetry.Exporter.OpenTelemetryProtocol
   

2. Добавьте приведенный ниже фрагмент кода. В этом примере предполагается, что у вас есть сборщик OpenTelemetry с работающим приемником OTLP. Дополнительные сведения см. в примере на сайте GitHub.

   // Create a new OpenTelemetry tracer provider and add the Azure Monitor trace exporter and the OTLP trace exporter.
   // It is important to keep the TracerProvider instance active throughout the process lifetime.
   var tracerProvider = Sdk.CreateTracerProviderBuilder()
       .AddAzureMonitorTraceExporter()
       .AddOtlpExporter()
       .Build();
   
   // Create a new OpenTelemetry meter provider and add the Azure Monitor metric exporter and the OTLP metric exporter.
   // It is important to keep the MetricsProvider instance active throughout the process lifetime.
   var metricsProvider = Sdk.CreateMeterProviderBuilder()
       .AddAzureMonitorMetricExporter()
       .AddOtlpExporter()
       .Build();
   

Дополнительные сведения о Java см. в дополнительной документации по Java.

Вы не можете включить экспортер OpenTelemetry Protocol (OTLP) вместе с экспортером Azure Monitor для отправки данных телеметрии в два расположения.

1. Установите экспортер трассировки сборщика OpenTelemetry и другие пакеты OpenTelemetry в проекте.

       npm install @opentelemetry/api
       npm install @opentelemetry/exporter-trace-otlp-http
       npm install @opentelemetry/sdk-trace-base
       npm install @opentelemetry/sdk-trace-node
   

2. Добавьте приведенный ниже фрагмент кода. В этом примере предполагается, что у вас есть сборщик OpenTelemetry с работающим приемником OTLP. Дополнительные сведения см. в примере на сайте GitHub.

   // Import the useAzureMonitor function, the AzureMonitorOpenTelemetryOptions class, the trace module, the ProxyTracerProvider class, the BatchSpanProcessor class, the NodeTracerProvider class, and the OTLPTraceExporter class from the @azure/monitor-opentelemetry, @opentelemetry/api, @opentelemetry/sdk-trace-base, @opentelemetry/sdk-trace-node, and @opentelemetry/exporter-trace-otlp-http packages, respectively.
   const { useAzureMonitor, AzureMonitorOpenTelemetryOptions } = require("@azure/monitor-opentelemetry");
   const { BatchSpanProcessor } = require('@opentelemetry/sdk-trace-base');
   const { OTLPTraceExporter } = require('@opentelemetry/exporter-trace-otlp-http');
   
   // Create a new OTLPTraceExporter object.
   const otlpExporter = new OTLPTraceExporter();
   
   // Enable Azure Monitor integration.
   const options: AzureMonitorOpenTelemetryOptions = {
       // Add the SpanEnrichingProcessor
       spanProcessors: [new BatchSpanProcessor(otlpExporter)] 
   }
   useAzureMonitor(options);
   

1. Установите пакет opentelemetry-exporter-otlp .

2. Добавьте приведенный ниже фрагмент кода. В этом примере предполагается, что у вас есть сборщик OpenTelemetry с работающим приемником OTLP. Дополнительные сведения см. в этой статье README.

   # Import the `configure_azure_monitor()`, `trace`, `OTLPSpanExporter`, and `BatchSpanProcessor` classes from the appropriate packages.    
   from azure.monitor.opentelemetry import configure_azure_monitor
   from opentelemetry import trace
   from opentelemetry.exporter.otlp.proto.grpc.trace_exporter import OTLPSpanExporter
   from opentelemetry.sdk.trace.export import BatchSpanProcessor
   
   # Configure OpenTelemetry to use Azure Monitor with the specified connection string.
   # Replace `<your-connection-string>` with the connection string to your Azure Monitor Application Insights resource.
   configure_azure_monitor(
       connection_string="<your-connection-string>",
   )
   
   # Get the tracer for the current module.
   tracer = trace.get_tracer(__name__) 
   
   # Create an OTLP span exporter that sends spans to the specified endpoint.
   # Replace `http://localhost:4317` with the endpoint of your OTLP collector.
   otlp_exporter = OTLPSpanExporter(endpoint="http://localhost:4317")
   
   # Create a batch span processor that uses the OTLP span exporter.
   span_processor = BatchSpanProcessor(otlp_exporter)
   
   # Add the batch span processor to the tracer provider.
   trace.get_tracer_provider().add_span_processor(span_processor)
   
   # Start a new span with the name "test".
   with tracer.start_as_current_span("test"):
       print("Hello world!")
   

Дополнительные сведения о Java см. в дополнительной документации по Java.

Для собственных приложений Spring Boot доступны конфигурации пакета SDK для Java OpenTelemetry .

Для нативных приложений Quarkus ознакомьтесь с документацией по Quarkus OpenTelemetry.

Дополнительные сведения о конфигурации пакета SDK для OpenTelemetry см. в документации по OpenTelemetry.

Дополнительные сведения о конфигурации пакета SDK Для OpenTelemetry см. в документации по OpenTelemetry и использовании дистрибутива Azure Monitor.

При использовании пакета дистрибутива Azure.Monitor.OpenTelemetry.AspNetCore включены библиотеки ASP.NET Core и HttpClient Instrumentation. По умолчанию пакет дистрибутива задает redaction строки запроса.

Чтобы изменить это поведение, необходимо задать для переменной среды значение true или false.

• ASP.NET основное инструментирование. OTEL_DOTNET_EXPERIMENTAL_ASPNETCORE_DISABLE_URL_QUERY_REDACTION По умолчанию параметр "Редактация строки запроса" отключен. Чтобы включить, задайте для этой переменной среды значение false.
• Инструментирование клиента Http. OTEL_DOTNET_EXPERIMENTAL_HTTPCLIENT_DISABLE_URL_QUERY_REDACTION По умолчанию параметр "Редактация строки запроса" отключен. Чтобы включить, задайте для этой переменной среды значение false.

При использовании Azure.Monitor.OpenTelemetry.Exporter необходимо вручную включить библиотеки ASP.NET Core или HttpClient Instrumentation в конфигурацию OpenTelemetry. Эти библиотеки инструментирования включают Redaction QueryString по умолчанию.

Чтобы изменить это поведение, необходимо задать для переменной среды значение true или false.

• ASP.NET основное инструментирование. OTEL_DOTNET_EXPERIMENTAL_ASPNETCORE_DISABLE_URL_QUERY_REDACTION По умолчанию включена редактация строки запроса. Чтобы отключить эту переменную среды, задайте для trueнее значение .
• Инструментирование клиента Http: OTEL_DOTNET_EXPERIMENTAL_HTTPCLIENT_DISABLE_URL_QUERY_REDACTION по умолчанию включена редактация строки запроса. Чтобы отключить эту переменную среды, задайте для trueнее значение .

Добавьте следующее applicationinsights.json в файл конфигурации:

{
  "preview": {
    "processors": [
      {
        "type": "attribute",
        "actions": [
          {
            "key": "url.query",
            "pattern": "^.*$",
            "replace": "REDACTED",
            "action": "mask"
          }
        ]
      },
      {
        "type": "attribute",
        "actions": [
          {
            "key": "url.full",
            "pattern": "[?].*$",
            "replace": "?REDACTED",
            "action": "mask"
          }
        ]
      }
    ]
  }
}

Мы активно работаем в сообществе OpenTelemetry для поддержки редакта.

При использовании пакета дистрибутива OpenTelemetry в Azure Monitor строки запроса можно редактировать путем создания и применения процессора областей в конфигурацию дистрибутива.

import { useAzureMonitor, AzureMonitorOpenTelemetryOptions } from "@azure/monitor-opentelemetry";
import { Context } from "@opentelemetry/api";
import { ReadableSpan, Span, SpanProcessor } from "@opentelemetry/sdk-trace-base";
import { SEMATTRS_HTTP_ROUTE, SEMATTRS_HTTP_TARGET, SEMATTRS_HTTP_URL } from "@opentelemetry/semantic-conventions";

class RedactQueryStringProcessor implements SpanProcessor {
  forceFlush(): Promise<void> {
	return Promise.resolve();
  }
  onStart(span: Span, parentContext: Context): void {
    return;
  }
  shutdown(): Promise<void> {
	return Promise.resolve();
  }
  onEnd(span: ReadableSpan) {
    const httpRouteIndex: number = String(span.attributes[SEMATTRS_HTTP_ROUTE]).indexOf('?');
    const httpUrlIndex: number = String(span.attributes[SEMATTRS_HTTP_URL]).indexOf('?');
    const httpTargetIndex: number = String(span.attributes[SEMATTRS_HTTP_TARGET]).indexOf('?');
    if (httpRouteIndex !== -1) {
      span.attributes[SEMATTRS_HTTP_ROUTE] = String(span.attributes[SEMATTRS_HTTP_ROUTE]).substring(0, httpRouteIndex);
    }
    if (httpUrlIndex !== -1) {
      span.attributes[SEMATTRS_HTTP_URL] = String(span.attributes[SEMATTRS_HTTP_URL]).substring(0, httpUrlIndex);
    }
    if (httpTargetIndex !== -1) {
      span.attributes[SEMATTRS_HTTP_TARGET] = String(span.attributes[SEMATTRS_HTTP_TARGET]).substring(0, httpTargetIndex);
    }
  }
}

const options: AzureMonitorOpenTelemetryOptions = {
  azureMonitorExporterOptions: {
      connectionString: <YOUR_CONNECTION_STRING>,
  },
  spanProcessors: [new RedactQueryStringProcessor()]
};

useAzureMonitor(options);

Мы активно работаем в сообществе OpenTelemetry для поддержки редакта.