Azure Functions와 함께 OpenTelemetry 사용

Important

Azure Functions에 대한 OpenTelemetry 지원은 현재 미리 보기로 제공됩니다.

이 문서에서는 로그 및 추적 데이터를 OpenTelemetry 형식으로 내보내도록 함수 앱을 구성하는 방법을 보여 줍니다. Azure Functions는 Functions 호스트 프로세스와 Functions 코드가 실행되는 언어별 작업자 프로세스 모두에서 Functions 실행에 대한 원격 분석 데이터를 생성합니다. 기본적으로 이 원격 분석 데이터는 Application Insights SDK를 사용하여 Application Insights로 전송됩니다. 그러나 OpenTelemetry 의미 체계를 사용하여 이 데이터를 내보내도록 선택할 수 있습니다. 여전히 OpenTelemetry 형식을 사용하여 데이터를 Application Insights로 보낼 수 있지만 이제 동일한 데이터를 다른 OpenTelemetry 호환 엔드포인트로 내보낼 수도 있습니다.

팁

이 문서는 사용자가 선택한 개발 언어를 대상으로 하므로 문서 상단에서 올바른 언어를 선택해야 합니다.

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

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

함수 앱에서 OpenTelemetry를 사용하도록 설정하면 다음과 같은 이점을 가져올 수 있습니다.

• 호스트와 애플리케이션 코드 모두에서 생성되는 추적 및 로그 간의 상관 관계입니다.
• 내보낼 수 있는 원격 분석 데이터를 일관되게 표준 기반으로 생성합니다.
• OpenTelemetry 규격 데이터를 사용할 수 있는 다른 공급자와 통합됩니다.

OpenTelemetry는 호스트 구성(host.json)과 코드 프로젝트 모두에서 함수 앱 수준에서 사용하도록 설정됩니다. 또한 Functions는 언어별 작업자 프로세스에서 실행되는 Functions 코드에서 OpenTelemetry 데이터를 내보내기 위한 클라이언트 최적화 환경을 제공합니다.

1. Functions 호스트에서 OpenTelemetry 사용

함수 앱의 host.json 파일에서 OpenTelemetry 출력을 사용하도록 설정하면 호스트는 앱에서 사용하는 언어 스택에 관계없이 OpenTelemetry 출력을 내보냅니다.

Functions 호스트에서 OpenTelemetry 출력을 사용하도록 설정하려면 코드 프로젝트에서 host.json 파일을 업데이트하여 루트 컬렉션에 "telemetryMode": "openTelemetry" 요소를 추가합니다. OpenTelemetry가 사용하도록 설정되면 host.json 파일은 다음과 같을 수 있습니다.

{
    "version": "2.0",
    "logging": {
        "applicationInsights": {
            "samplingSettings": {
                "isEnabled": true,
                "excludedTypes": "Request"
            },
            "enableLiveMetricsFilters": true
        }
    },
    "telemetryMode": "openTelemetry"
}

2. 애플리케이션 설정 구성

host.json 파일에서 OpenTelemetry가 사용하도록 설정되면 데이터가 전송되는 엔드포인트는 앱의 환경 변수에서 사용할 수 있는 OpenTelemetry 지원 애플리케이션 설정에 따라 결정됩니다.

OpenTelemetry 출력 대상을 기반으로 함수 앱에서 특정 애플리케이션 설정을 만듭니다. Application Insights와 OTLP(OpenTelemetry 프로토콜) 내보내기 도구 모두에 대한 연결 설정이 제공되면 OpenTelemetry 데이터가 두 엔드포인트 모두로 전송됩니다.

Application Insights

APPLICATIONINSIGHTS_CONNECTION_STRING: Application Insights 작업 영역에 대한 연결 문자열입니다. 이 설정이 있으면 OpenTelemetry 데이터가 해당 작업 영역으로 전송됩니다. 이 설정은 OpenTelemetry를 사용하지 않고 Application Insights에 연결하는 데 사용되는 설정과 동일합니다. 앱에 아직 이 설정이 없으면 Application Insights 통합을 사용하도록 설정해야 할 수도 있습니다.

OTLP 내보내기 도구

OTEL_EXPORTER_OTLP_ENDPOINT: OTLP 내보내기 도구 엔드포인트 URL입니다.

OTEL_EXPORTER_OTLP_HEADERS: (선택 사항) 모든 발신 데이터에 적용할 헤더 목록입니다. 이는 많은 엔드포인트에서 API 키를 전달하는 데 사용됩니다.

엔드포인트에서 다른 환경 변수를 설정해야 하는 경우 이를 애플리케이션 설정에도 추가해야 합니다. 자세한 내용은 OTLP 내보내기 도구 구성 설명서를 참조하세요.

호스트의 OpenTelemetry 출력을 Application Insights로 전송하려는 경우가 아니면 APPLICATIONINSIGHTS_CONNECTION_STRING 설정을 제거해야 합니다.

3. 앱에서 OpenTelemetry 사용

OpenTelemetry를 사용하도록 구성된 Functions 호스트를 사용하면 OpenTelemetry 데이터를 출력하도록 애플리케이션 코드도 업데이트해야 합니다. 호스트와 애플리케이션 코드 모두에서 OpenTelemetry를 사용하도록 설정하면 Functions 호스트 프로세스와 언어 작업자 프로세스에서 내보낸 추적과 로그 간의 상관 관계가 향상됩니다.

OpenTelemetry를 사용하기 위해 애플리케이션을 계측하는 방법은 대상 OpenTelemetry 엔드포인트에 따라 다릅니다.

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

   Application Insights

   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  
   

   OTLP 내보내기 도구

   dotnet add package Microsoft.Azure.Functions.Worker.OpenTelemetry --version 1.0.0-preview1 
   dotnet add package OpenTelemetry.Extensions.Hosting 
   dotnet add package OpenTelemetry.Exporter.OpenTelemetryProtocol   
   

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

   Application Insights

   using Azure.Monitor.OpenTelemetry.AspNetCore; 
   

   OTLP 내보내기 도구

   using OpenTelemetry; 
   

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

   Application Insights

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

   OTLP 내보내기 도구

   services.AddOpenTelemetry()
   .UseFunctionsWorkerDefaults()
   .UseOtlpExporter();
   

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

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

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

   Application Insights

   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
   

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

   Application Insights

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

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

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

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

   Application Insights

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

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

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

Important

언어 작업자에서 Application Insights로의 OpenTelemetry 출력은 현재 PowerShell 앱에서 지원되지 않습니다. 대신 OTLP 내보내기 도구 엔드포인트를 사용할 수도 있습니다. 호스트가 Application Insights에 대한 OpenTelemetry 출력을 위해 구성된 경우 PowerShell 작업자 프로세스에서 생성된 로그는 계속 전달되지만 현재 분산 추적은 지원되지 않습니다.

이 지침은 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

   azure.monitor.opentelemetry
   

   OTLP 내보내기 도구

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

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

   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 구성 요소를 사용하여 로그를 수집하는 방법을 알아보려면 OpenTelemetry Logging SDK를 검토합니다.

OpenTelemetry에 대한 고려 사항

OpenTelemetry를 사용하여 데이터를 내보낼 때 현재 고려 사항을 염두에 둡니다.

• 호스트가 OpenTelemetry를 사용하도록 구성된 경우 로그 및 추적만 내보냅니다. 호스트 메트릭은 현재 내보내지지 않습니다.

• 현재 호스트에서 OpenTelemetry를 사용하도록 설정한 경우 Core Tools를 사용하여 앱 프로젝트를 로컬로 실행할 수 없습니다. 현재 OpenTelemetry 관련 업데이트의 유효성을 검사하려면 코드를 Azure에 배포해야 합니다.

• 현재 OpenTelemetry 출력에서는 HTTP 트리거와 Azure SDK 기반 트리거만 지원됩니다.

관련 콘텐츠

Azure Functions 모니터링Flex 사용량 플랜