Использование OpenTelemetry с Функции Azure

В этой статье показано, как настроить приложение-функцию для экспорта данных журнала и трассировки в формате OpenTelemetry. Функции Azure генерирует данные телеметрии для выполнения функций как из процесса узла Функций, так и процесса конкретной рабочей роли, в которой выполняется код функции. По умолчанию эти данные телеметрии отправляются в Application Insights с помощью пакета SDK Application Insights. Однако вы можете экспортировать эти данные с помощью семантики OpenTelemetry. Хотя вы по-прежнему можете использовать формат OpenTelemetry для отправки данных в Application Insights, теперь можно экспортировать те же данные в любую другую конечную точку, совместимую с OpenTelemetry.

Эти преимущества можно получить, включив OpenTelemetry в приложении-функции:

• Сопоставляет данные между трассировками и журналами, создаваемыми как на узле, так и в коде приложения.
• Обеспечивает согласованное создание экспортируемых данных телеметрии на основе стандартов.
• Интегрируется с другими поставщиками, которые могут использовать данные, совместимые с OpenTelemetry.

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

• Ознакомьтесь с руководством по OpenTelemetry, которое поможет вам быстро приступить к работе с OpenTelemetry и Функциями Azure. В этой статье используется интерфейс командной строки разработчика Azure (azd) для создания и развертывания приложения-функции, использующего интеграцию OpenTelemetry для распределенной трассировки.

• Так как эта статья ориентирована на выбранный язык разработки, не забудьте выбрать правильный язык в верхней части статьи.

• В настоящее время OpenTelemetry не поддерживается для приложений внутрипроцессного процесса C#.

• OpenTelemetry включен на уровне приложения-функции как в конфигурации узла (host.json), так и в проекте кода. Функции также предоставляют оптимизированный клиентом интерфейс для экспорта данных OpenTelemetry из кода функции, выполняющегося в рабочем процессе для конкретного языка.

Включение OpenTelemetry в узле функций

Если вы включите вывод данных OpenTelemetry в файле host.json приложения-функции, ваш хост экспортирует выходные данные OpenTelemetry независимо от используемого приложением языкового стека.

Чтобы включить выходные данные OpenTelemetry из узла Функций, обновите файл host.json в проекте кода, чтобы добавить элемент в корневую "telemetryMode": "OpenTelemetry" коллекцию. С включенной функцией OpenTelemetry файл host.json может выглядеть следующим образом:

{
    "version": "2.0",
    "telemetryMode": "OpenTelemetry",
    ...
}

Настройка параметров приложения

При включении OpenTelemetry в host.json файле переменные среды приложения определяют конечные точки для отправки данных на основе параметров приложения, поддерживаемых OpenTelemetry.

Создайте определенные параметры приложения в приложении-функции на основе назначения выходных данных OpenTelemetry. При предоставлении параметров подключения как для Application Insights, так и для экспортера протокола OpenTelemetry (OTLP) данные OpenTelemetry отправляются в обе конечные точки.

Аналитика приложений

APPLICATIONINSIGHTS_CONNECTION_STRING: строка подключения для рабочей области Application Insights. Если этот параметр существует, данные OpenTelemetry отправляются в эту рабочую область. Используйте тот же параметр для подключения к Application Insights без включения OpenTelemetry. Если у приложения еще нет этого параметра, может потребоваться включить интеграцию Application Insights.

JAVA_APPLICATIONINSIGHTS_ENABLE_TELEMETRY: установите значение true , чтобы узел функций позволял рабочему процессу Java передавать журналы OpenTelemetry напрямую, что предотвращает дублирование записей на уровне узла.

PYTHON_APPLICATIONINSIGHTS_ENABLE_TELEMETRY: установите значение true , чтобы узел функций позволял рабочему процессу Python передавать журналы OpenTelemetry напрямую, что предотвращает дублирование записей на уровне узла.

Экспортер OTLP

Функции Azure поддерживают экспорт данных OpenTelemetry в любую конечную точку, совместимую с OTLP. Определенные переменные среды, необходимые для настройки, зависят от выбранного поставщика наблюдаемости (например, Datadog, New Relic, Grafana или других).

Большинство поставщиков требует:

OTEL_EXPORTER_OTLP_ENDPOINT: URL-адрес конечной точки OTLP, предоставленный поставщиком наблюдаемости.

Для многих поставщиков также требуется следующее:

OTEL_EXPORTER_OTLP_HEADERS: заголовки для учетных данных проверки подлинности, таких как ключи API.

PYTHON_ENABLE_OPENTELEMETRY: установите значение true , чтобы узел функций позволял рабочему процессу Python передавать журналы OpenTelemetry напрямую, что предотвращает дублирование записей на уровне узла.

Функции Azure поддерживают любые переменные среды, определенные в документации по конфигурации пакета SDK OpenTelemetry. Однако определенные переменные и значения, необходимые поставщику, зависят от поставщика. Ознакомьтесь с документацией вашего поставщика услуг наблюдаемости:

• Необходимые URL-адреса конечной точки и методы проверки подлинности
• Рекомендуемые параметры конфигурации
• Переменные среды для конкретного поставщика
• Любые дополнительные действия по настройке

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

Удалите этот параметр, если вы также не хотите, чтобы выходные APPLICATIONINSIGHTS_CONNECTION_STRING данные OpenTelemetry от узла были отправлены в Application Insights.

Включение OpenTelemetry в приложении

После настройки узла Функций для использования OpenTelemetry обновите код приложения до вывода данных OpenTelemetry. Если включить OpenTelemetry как в хосте, так и в коде приложения, вы получите лучшую корреляцию между трейсами и журналами, которые процесс хоста функций и процесс рабочего языка программирования выдают.

Настройка вашего приложения для использования OpenTelemetry зависит от целевой конечной точки OpenTelemetry.

В примерах этой статьи предполагается, что ваше приложение использует IHostApplicationBuilder, которое доступно, начиная с версии 2.x и более поздних версий Microsoft.Azure.Functions.Worker. Дополнительные сведения см. в руководстве по изолированной рабочей модели C# версии 2.x .

1. Выполните следующие команды, чтобы установить необходимые сборки в приложении:

   Аналитика приложений

   dotnet add package Microsoft.Azure.Functions.Worker.OpenTelemetry
   dotnet add package OpenTelemetry.Extensions.Hosting 
   dotnet add package Azure.Monitor.OpenTelemetry.Exporter  
   

   Экспортер OTLP

   dotnet add package Microsoft.Azure.Functions.Worker.OpenTelemetry
   dotnet add package OpenTelemetry.Extensions.Hosting 
   dotnet add package OpenTelemetry.Exporter.OpenTelemetryProtocol   
   

2. Добавьте в файл проекта Program.cs следующее using :

   Аналитика приложений

   using Azure.Monitor.OpenTelemetry.Exporter; 
   

   Экспортер OTLP

   using OpenTelemetry; 
   

3. Настройте OpenTelemetry в зависимости от того, какой запуск проекта используется: IHostBuilder или IHostApplicationBuilder. Последний был представлен в версии 2.x расширения изолированной рабочей модели .NET.

   IHostApplicationBuilder

   В program.cs добавьте эту строку кода после ConfigureFunctionsWebApplication:

   builder.Services.AddOpenTelemetry()
       .UseFunctionsWorkerDefaults()
       .UseAzureMonitorExporter();
   

   IHostBuilder

   В program.cs добавьте этот ConfigureServices вызов в HostBuilder конвейер:

   .ConfigureServices(s =>
   {
       s.AddOpenTelemetry()
       .UseFunctionsWorkerDefaults()
       .UseAzureMonitorExporter();
   })
   

   IHostApplicationBuilder

   В program.cs добавьте эту строку кода после ConfigureFunctionsWebApplication:

   builder.Services.AddOpenTelemetry()
       .UseFunctionsWorkerDefaults()
       .UseOtlpExporter();
   

   IHostBuilder

   В program.cs добавьте этот ConfigureServices вызов в HostBuilder конвейер:

   .ConfigureServices(s =>
   {
       s.AddOpenTelemetry()
       .UseFunctionsWorkerDefaults()
       .UseOtlpExporter();
   })
   

   Вы можете экспортировать данные на оба конечных пункта OpenTelemetry из одного приложения.

1. Добавьте необходимые библиотеки в приложение. Способ добавления библиотек зависит от того, развертываете ли вы с помощью Maven или Kotlin и хотите также отправлять данные в Application Insights.

   Maven

   <dependency>
     <groupId>com.microsoft.azure.functions</groupId>
     <artifactId>azure-functions-java-opentelemetry</artifactId>
     <version>1.0.0</version>
   </dependency>
   <dependency>
     <groupId>com.azure</groupId>
     <artifactId>azure-monitor-opentelemetry-autoconfigure</artifactId>
     <version>1.2.0</version>
   </dependency>
   

   Kotlin

   implementation("com.microsoft.azure.functions:azure-functions-java-opentelemetry:1.0.0")
   implementation("com.azure:azure-monitor-opentelemetry-autoconfigure:1.2.0")
   

   Maven

   <dependency>
     <groupId>com.microsoft.azure.functions</groupId>
     <artifactId>azure-functions-java-opentelemetry</artifactId>
     <version>1.0.0</version>
   </dependency>
   

   Kotlin

   implementation("com.microsoft.azure.functions:azure-functions-java-opentelemetry:1.0.0")
   

2. (Необязательно) Добавьте этот код для создания пользовательских диапазонов:

   import com.microsoft.azure.functions.opentelemetry.FunctionsOpenTelemetry;
   import io.opentelemetry.api.trace.Span;
   import io.opentelemetry.api.trace.SpanKind;
   import io.opentelemetry.context.Scope;
   
   Span span = FunctionsOpenTelemetry.startSpan(
           "com.contoso.PaymentFunction",  // tracer name
           "validateCharge",               // span name
           null,                           // parent = current context
           SpanKind.INTERNAL);
   
   try (Scope ignored = span.makeCurrent()) {
       // business logic here
   } finally {
       span.end();
   }
   

1. Установите эти пакеты npm в проекте:

   Аналитика приложений

   npm install @opentelemetry/api 
   npm install @opentelemetry/auto-instrumentations-node 
   npm install @azure/monitor-opentelemetry-exporter 
   npm install @azure/functions-opentelemetry-instrumentation
   

   Экспортер OTLP

   npm install @opentelemetry/api 
   npm install @opentelemetry/auto-instrumentations-node 
   npm install @opentelemetry/exporter-logs-otlp-http 
   npm install @azure/functions-opentelemetry-instrumentation
   

2. Создайте файл кода в проекте, скопируйте и вставьте следующий код в этот новый файл и сохраните его следующим образом src/index.js:

   Аналитика приложений

   const { AzureFunctionsInstrumentation } = require('@azure/functions-opentelemetry-instrumentation');
   const { AzureMonitorLogExporter, AzureMonitorTraceExporter } = require('@azure/monitor-opentelemetry-exporter');
   const { getNodeAutoInstrumentations, getResourceDetectors } = require('@opentelemetry/auto-instrumentations-node');
   const { registerInstrumentations } = require('@opentelemetry/instrumentation');
   const { detectResourcesSync } = require('@opentelemetry/resources');
   const { LoggerProvider, SimpleLogRecordProcessor } = require('@opentelemetry/sdk-logs');
   const { NodeTracerProvider, SimpleSpanProcessor } = require('@opentelemetry/sdk-trace-node');
   
   const resource = detectResourcesSync({ detectors: getResourceDetectors() });
   
   const tracerProvider = new NodeTracerProvider({ resource });
   tracerProvider.addSpanProcessor(new SimpleSpanProcessor(new AzureMonitorTraceExporter()));
   tracerProvider.register();
   
   const loggerProvider = new LoggerProvider({ resource });
   loggerProvider.addLogRecordProcessor(new SimpleLogRecordProcessor(new AzureMonitorLogExporter()));
   
   registerInstrumentations({
       tracerProvider,
       loggerProvider,
       instrumentations: [getNodeAutoInstrumentations(), new AzureFunctionsInstrumentation()],
   });
   

   Экспортер OTLP

   const { AzureFunctionsInstrumentation } = require('@azure/functions-opentelemetry-instrumentation');
   const { getNodeAutoInstrumentations, getResourceDetectors } = require('@opentelemetry/auto-instrumentations-node');
   const { OTLPLogExporter } = require('@opentelemetry/exporter-logs-otlp-http');
   const { OTLPTraceExporter } = require('@opentelemetry/exporter-trace-otlp-http');
   const { registerInstrumentations } = require('@opentelemetry/instrumentation');
   const { detectResourcesSync } = require('@opentelemetry/resources');
   const { LoggerProvider, SimpleLogRecordProcessor } = require('@opentelemetry/sdk-logs');
   const { NodeTracerProvider, SimpleSpanProcessor } = require('@opentelemetry/sdk-trace-node');
   
   const resource = detectResourcesSync({ detectors: getResourceDetectors() });
   
   const tracerProvider = new NodeTracerProvider({ resource });
   tracerProvider.addSpanProcessor(new SimpleSpanProcessor(new OTLPTraceExporter()));
   tracerProvider.register();
   
   const loggerProvider = new LoggerProvider({ resource });
   loggerProvider.addLogRecordProcessor(new SimpleLogRecordProcessor(new OTLPLogExporter()));
   
   registerInstrumentations({
       tracerProvider,
       loggerProvider,
       instrumentations: [getNodeAutoInstrumentations(), new AzureFunctionsInstrumentation()],
   });
   

3. Обновите поле main в файле package.json, чтобы включить новый файл src/index.js. Рассмотрим пример.

   "main": "src/{index.js,functions/*.js}"
   

2. Создайте файл кода в проекте, скопируйте и вставьте следующий код в этот новый файл и сохраните его следующим образом src/index.ts:

   Аналитика приложений

   import { AzureFunctionsInstrumentation } from '@azure/functions-opentelemetry-instrumentation';
   import { AzureMonitorLogExporter, AzureMonitorTraceExporter } from '@azure/monitor-opentelemetry-exporter';
   import { getNodeAutoInstrumentations, getResourceDetectors } from '@opentelemetry/auto-instrumentations-node';
   import { registerInstrumentations } from '@opentelemetry/instrumentation';
   import { detectResourcesSync } from '@opentelemetry/resources';
   import { LoggerProvider, SimpleLogRecordProcessor } from '@opentelemetry/sdk-logs';
   import { NodeTracerProvider, SimpleSpanProcessor } from '@opentelemetry/sdk-trace-node';
   
   const resource = detectResourcesSync({ detectors: getResourceDetectors() });
   
   const tracerProvider = new NodeTracerProvider({ resource });
   tracerProvider.addSpanProcessor(new SimpleSpanProcessor(new AzureMonitorTraceExporter()));
   tracerProvider.register();
   
   const loggerProvider = new LoggerProvider({ resource });
   loggerProvider.addLogRecordProcessor(new SimpleLogRecordProcessor(new AzureMonitorLogExporter()));
   
   registerInstrumentations({
       tracerProvider,
       loggerProvider,
       instrumentations: [getNodeAutoInstrumentations(), new AzureFunctionsInstrumentation()],
   });
   

   Экспортер OTLP

   import { AzureFunctionsInstrumentation } from '@azure/functions-opentelemetry-instrumentation';
   import { getNodeAutoInstrumentations, getResourceDetectors } from '@opentelemetry/auto-instrumentations-node';
   import { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';
   import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
   import { registerInstrumentations } from '@opentelemetry/instrumentation';
   import { detectResourcesSync } from '@opentelemetry/resources';
   import { LoggerProvider, SimpleLogRecordProcessor } from '@opentelemetry/sdk-logs';
   import { NodeTracerProvider, SimpleSpanProcessor } from '@opentelemetry/sdk-trace-node';
   
   const resource = detectResourcesSync({ detectors: getResourceDetectors() });
   
   const tracerProvider = new NodeTracerProvider({ resource });
   tracerProvider.addSpanProcessor(new SimpleSpanProcessor(new OTLPTraceExporter()));
   tracerProvider.register();
   
   const loggerProvider = new LoggerProvider({ resource });
   loggerProvider.addLogRecordProcessor(new SimpleLogRecordProcessor(new OTLPLogExporter()));
   
   registerInstrumentations({
       tracerProvider,
       loggerProvider,
       instrumentations: [getNodeAutoInstrumentations(), new AzureFunctionsInstrumentation()],
   });
   

3. main Обновите поле в файле package.json, чтобы включить выходные данные этого нового src/index.ts файла, которые могут выглядеть следующим образом:

   "main": "dist/src/{index.js,functions/*.js}"
   

Внимание

Выходные данные OpenTelemetry в Application Insights из рабочей роли языка в настоящее время не поддерживаются для приложений PowerShell. Вместо этого можно использовать конечную точку экспортера OTLP. При настройке узла для выходных данных OpenTelemetry в Application Insights журналы, созданные рабочим процессом PowerShell, по-прежнему перенаправляются, но распределенная трассировка в настоящее время не поддерживается.

Эти инструкции применяются только для экспортера OTLP:

1. Добавьте параметр приложения с именем OTEL_FUNCTIONS_WORKER_ENABLED со значением True.

2. Создайте папку Modules уровня приложения в корне приложения и выполните следующую команду:

   Save-Module -Name AzureFunctions.PowerShell.OpenTelemetry.SDK
   

   Эта команда устанавливает необходимый AzureFunctions.PowerShell.OpenTelemetry.SDK модуль непосредственно в приложении. requirements.psd1 Невозможно использовать файл для автоматической установки этой зависимости, так как управляемые зависимости в настоящее время не поддерживаются в предварительной версии плана потребления Flex.

3. Добавьте этот код в файл profile.ps1:

   Import-Module AzureFunctions.PowerShell.OpenTelemetry.SDK -Force -ErrorAction Stop 
   Initialize-FunctionsOpenTelemetry 
   

1. Убедитесь, что эти библиотеки присутствуют в файле requirements.txt, путем снятия комментариев или добавления их вручную.

   Аналитика приложений

   azure-monitor-opentelemetry
   

   Экспортер OTLP

   opentelemetry-api
   opentelemetry-sdk
   opentelemetry-exporter-otlp
   opentelemetry-instrumentation-logging
   

2. Добавьте этот код в function_app.py файл основной точки входа:

   Аналитика приложений

   Если вы уже добавили PYTHON_APPLICATIONINSIGHTS_ENABLE_TELEMETRY=true в параметры приложения, этот шаг можно пропустить. Чтобы вручную включить коллекцию Application Insights без автоматического инструментирования, добавьте этот код в приложение:

   from azure.monitor.opentelemetry import configure_azure_monitor 
   configure_azure_monitor() 
   

   Экспортер OTLP

   Необходимо вручную настроить экспорт трассировок, метрик и журналов с помощью OpenTelemetry. Дополнительные сведения см. в разделе Инструментирование для Python.

   В этом примере показана простая реализация для экспорта журналов:

   logging.basicConfig(level=logging.DEBUG)
   
   from opentelemetry import _logs
   from opentelemetry.sdk._logs import LoggerProvider, LoggingHandler
   from opentelemetry.sdk._logs.export import BatchLogRecordProcessor
   from opentelemetry.exporter.otlp.proto.http._log_exporter import OTLPLogExporter
   
   # Initialize logging and an exporter that can send data to an OTLP endpoint by attaching OTLP handler to root logger
   # SELECT * FROM Log WHERE instrumentation.provider='opentelemetry'
   _logs.set_logger_provider(
       LoggerProvider(resource=Resource.create(OTEL_RESOURCE_ATTRIBUTES))
   )
   logging.getLogger().addHandler(
       LoggingHandler(
           logger_provider=_logs.get_logger_provider().add_log_record_processor(
               BatchLogRecordProcessor(OTLPLogExporter())
           )
       )
   )
   
   

   Чтобы узнать, как использовать компоненты OpenTelemetry для сбора журналов, ознакомьтесь с пакетом SDK для ведения журнала OpenTelemetry.

3. Ознакомьтесь с документацией по использованию дистрибутива Azure Monitor , чтобы узнать, как настроить пакет SDK.

Рекомендации по OpenTelemetry

При экспорте данных с помощью OpenTelemetry следует учитывать эти рекомендации.

• Портал Azure поддерживает Recent function invocation трассировки, только если данные телеметрии отправляются в Azure Monitor.

• При настройке узла для использования OpenTelemetry портал Azure не поддерживает потоковую передачу журналов.

• Если задано значение telemetryModeOpenTelemetry, конфигурация в logging.applicationInsights разделе host.json не применяется.

• Пользовательские диапазоны автоматически включают все атрибуты ресурсов и используют экспортеры, настроенные в приложении.

• Когда приложение выполняется за пределами Azure, включая локальную разработку, детектор ресурсов задает service.name атрибут java-function-app по умолчанию.

• Используйте эти флаги виртуальной машины Java (JVM) для отключения телеметрии при локальной работе в модульных тестах.

  • -Dotel.traces.exporter=none
  • -Dotel.metrics.exporter=none
  • -Dotel.logs.exporter=none

• Вам не нужно вручную регистрировать промежуточное ПО; Java Worker автоматически обнаруживает OpenTelemetryInvocationMiddleware.

Устранение неполадок

При экспорте данных с помощью OpenTelemetry следует учитывать эти распространенные проблемы и решения.

Фильтрация журналов

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

Процесс узла — это среда выполнения Функций Azure, которая управляет триггерами, масштабированием и выдает данные телеметрии уровня системы, такие как журналы инициализации, трассировки запросов и сведения о работоспособности среды выполнения.

Рабочий процесс зависит от языка, выполняет код вашей функции и независимо создает журналы приложений и телеметрию.

Внимание

Фильтры, определенные в host.json применяются только к журналам, созданным процессом узла. Для фильтрации журналов из рабочего процесса необходимо использовать параметры OpenTelemetry, относящиеся к языку.

Пример. Фильтрация журналов узлов для всех поставщиков в host.json

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

{
  "version": "2.0",
  "telemetryMode": "OpenTelemetry",
  "logging": {
    "logLevel": {
      "default": "Warning"
    }
  }
}

Пример. Фильтрация журналов только для поставщика средства ведения журнала OpenTelemetry

Используйте этот подход, чтобы нацелиться только на поставщика логгера OpenTelemetry, оставляя других поставщиков, таких как консольное или файловое логирование, нетронутыми.

{
  "version": "2.0",
  "telemetryMode": "OpenTelemetry",
  "logging": {
    "OpenTelemetry": {
      "logLevel": {
        "default": "Warning"
      }
    }
  }
}

Логирование консоли

Хост функций автоматически захватывает все записи в stdout или stderr и пересылает их в конвейер телеметрии. Если вы также используете ConsoleExporter или записываете данные непосредственно в консоль в коде, в данных телеметрии могут возникать дублирующиеся записи.

Замечание

Чтобы избежать дублирования записей телеметрии, не добавляйте ConsoleExporter и не записывайте в консоль в производственном коде.

Аутентификация Microsoft Entra

При использовании проверки подлинности Microsoft Entra совместно с OpenTelemetry необходимо настроить её отдельно для процесса хоста и рабочего процесса.

Сведения о настройке проверки подлинности для хост-процесса см. в статье "Требовать проверку подлинности Microsoft Entra".

Сведения о настройке проверки подлинности для рабочего процесса см. в разделе "Включение проверки подлинности Microsoft Entra".

Поддержка атрибутов ресурсов

Поддержка атрибутов ресурсов в Azure Monitor в настоящее время доступна в предварительной версии. Чтобы включить эту функцию, задайте для переменной OTEL_DOTNET_AZURE_MONITOR_ENABLE_RESOURCE_METRICS среды значение true. Этот параметр возвращает атрибуты ресурсов в настраиваемую таблицу метрик.

Повторяющаяся телеметрия запроса

Процесс узла автоматически выдает данные телеметрии запроса. Если рабочий процесс также инструментирован с помощью библиотек отслеживания запросов (например, AspNetCoreInstrumentation в .NET), один и тот же запрос сообщается дважды.

Замечание

Так как дистрибутив Azure Monitor обычно включает AspNetCoreInstrumentation в .NET и аналогичное инструментирование на других языках, избегайте использования дистрибутива Azure Monitor в рабочем процессе, чтобы предотвратить дублирование данных телеметрии.

Области ведения журнала не включены

По умолчанию рабочий процесс не включает области в журналы. Чтобы включить права доступа, необходимо явно задать этот параметр в рабочем процессе. В следующем примере показано, как включить области в изолированной среде .NET:

builder.Logging.AddOpenTelemetry(b => b.IncludeScopes = true);

Отсутствующие данные телеметрии запроса

Триггеры, такие как HTTP, служебная шина и Центры событий, зависят от распространения контекста для распределенной трассировки. При выборке на основе родителей в качестве поведения по умолчанию данные телеметрии запросов не создаются, когда входящий запрос или сообщение не подвергается выборке.

Повторяющийся идентификатор операции

В Azure Functions OperationId используется для корреляции телеметрии и непосредственно берет значение traceparent из входящего запроса или сообщения. Если несколько вызовов используют одно и то же traceparent значение повторно, все они получают одинаковые OperationId.

Настройка OpenTelemetry с переменными среды

Поведение OpenTelemetry можно настроить с помощью стандартных переменных среды. Эти переменные обеспечивают согласованный способ управления поведением на разных языках и средах выполнения. Вы можете настроить стратегии выборки, параметры экспортера и атрибуты ресурсов. Дополнительные сведения о поддерживаемых переменных среды см. в документации по OpenTelemetry.

Использование диагностики для устранения неполадок мониторинга

Диагностика функций Azure на портале Azure — это полезный ресурс для обнаружения и диагностики потенциальных проблем, связанных с мониторингом.

Чтобы получить доступ к диагностике в приложении, выполните приведенные далее действия.

1. На портале Azure перейдите к ресурсу приложения-функции.

2. На левой панели выберите "Диагностика и устранение проблем" и найдите приложение-функцию, отсутствующее в приложении телеметрии Application Insights или рабочем процессе OpenTelemetry .

3. Выберите этот рабочий процесс, выберите метод приема и нажмите кнопку "Далее".

4. Ознакомьтесь с инструкциями и рекомендациями, предоставленными средством устранения неполадок.

Дальнейшие шаги

Дополнительные сведения о OpenTelemetry и мониторинге Функций Azure:

• Мониторинг функций Azure с помощью распределенной трассировки OpenTelemetry
• Мониторинг функций Azure