Azure Functions와 함께 OpenTelemetry 사용

현재 Java 앱에 대한 클라이언트 최적화 OpenTelemetry 지원은 없습니다.

OpenTelemetry는 현재 C# In Process 앱에 지원되지 않습니다.

1. 앱에 필요한 어셈블리를 설치하려면 다음 명령을 실행합니다.

   • Application Insights
   • OTLP 내보내기 도구

   dotnet add package Microsoft.Azure.Functions.Worker.OpenTelemetry --version 1.0.0-preview1 
   dotnet add package OpenTelemetry.Extensions.Hosting 
   dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore  
   

2. Program.cs 프로젝트 파일에 다음 using 문을 추가합니다.

   • Application Insights
   • OTLP 내보내기 도구

   using Azure.Monitor.OpenTelemetry.AspNetCore; 
   

3. ConfigureServices 대리자에서 다음 서비스 구성을 추가합니다.

   • Application Insights
   • OTLP 내보내기 도구

   services.AddOpenTelemetry()
   .UseFunctionsWorkerDefaults()
   .UseAzureMonitor();
   

   두 OpenTelemetry 엔드포인트 모두로 내보내려면 UseAzureMonitor 및 UseOtlpExporter를 모두 호출합니다.

OpenTelemetry에서는 아직 Java 작업자 최적화를 사용할 수 없으므로 Java 코드에서 구성할 항목이 없습니다.

1. 프로젝트에 다음 npm 패키지를 설치합니다.

   • Application Insights
   • OTLP 내보내기 도구

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

1. 프로젝트에서 코드 파일을 만들고 다음 코드를 이 새 파일에 복사하여 붙여넣은 후 파일을 src/index.js로 저장합니다.

   • Application Insights
   • OTLP 내보내기 도구

   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()],
   });
   

2. package.json 파일의 main 필드를 업데이트하여 다음과 같은 새로운 src/index.js 파일을 포함합니다.

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

1. 프로젝트에서 코드 파일을 만들고 다음 코드를 이 새 파일에 복사하여 붙여넣은 후 파일을 src/index.ts로 저장합니다.

   • Application Insights
   • OTLP 내보내기 도구

   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()],
   });
   

2. 이 새 src/index.ts 파일의 출력을 포함하도록 package.json 파일의 main 필드를 업데이트합니다. 이는 다음과 같습니다.

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

이 지침은 OTLP 내보내기 도구에만 적용됩니다.

1. 값이 True인 OTEL_FUNCTIONS_WORKER_ENABLED라는 애플리케이션 설정을 추가합니다.

2. 앱 루트에 앱 수준 Modules 폴더를 만들고 다음 명령을 실행합니다.

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

   그러면 필요한 AzureFunctions.PowerShell.OpenTelemetry.SDK 모듈이 앱에 직접 설치됩니다. 관리 종속성은 현재 Flex 사용량 플랜 미리 보기에서 지원되지 않으므로 requirements.psd1 파일을 사용하여 이 종속성을 자동으로 설치할 수 없습니다.

3. profile.ps1 파일에 다음 코드를 추가합니다.

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

1. requirements.txt 파일에 다음 항목을 추가합니다.

   • Application Insights
   • OTLP 내보내기 도구

   azure.monitor.opentelemetry
   

2. function_app.py 기본 진입점 파일에 다음 코드를 추가합니다.

   • Application Insights
   • OTLP 내보내기 도구

   from azure.monitor.opentelemetry import configure_azure_monitor 
   configure_azure_monitor()