다음을 통해 공유

JavaScript용 Azure Monitor OpenTelemetry Exporter 클라이언트 라이브러리 - 버전 1.0.0-beta.36

npm 버전

시작하기

이 내보내기 패키지는 애플리케이션이 이미 OpenTelemetry SDK를 사용하여 계측되었다고 가정합니다. OpenTelemetry 데이터를 내보낼 준비가 되면 이 내보내기를 애플리케이션에 추가할 수 있습니다.

패키지 설치

npm install @azure/monitor-opentelemetry-exporter

현재 지원되는 환경

자세한 내용은 지원 정책 참조하세요.

경고: 이 SDK는 Node.js 환경에서만 작동합니다. 브라우저 환경용 Application Insights JavaScript SDK 를 사용합니다.

필수 조건

분산 추적

기존 OpenTelemetry Tracer Provider(NodeTracerProvider / BasicTracerProvider)에 내보내기 프로그램 추가

import { AzureMonitorTraceExporter } from "@azure/monitor-opentelemetry-exporter";
import { NodeTracerProvider, BatchSpanProcessor } from "@opentelemetry/sdk-trace-node";
import { resourceFromAttributes } from "@opentelemetry/resources";
import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";

// Create an exporter instance
const exporter = new AzureMonitorTraceExporter({
  connectionString: "<connection string>",
});

// Create and configure the Node Tracer provider
const tracerProvider = new NodeTracerProvider({
  resource: resourceFromAttributes({
    [ATTR_SERVICE_NAME]: "basic-service",
  }),
  spanProcessors: [
    new BatchSpanProcessor(exporter, {
      exportTimeoutMillis: 15000,
      maxQueueSize: 1000,
    }),
  ],
});

// Register Tracer Provider as global
tracerProvider.register();

지표

기존 OpenTelemetry Meter Provider()에 내보내기를 추가합니다.MeterProvider

import { AzureMonitorMetricExporter } from "@azure/monitor-opentelemetry-exporter";
import { PeriodicExportingMetricReader, MeterProvider } from "@opentelemetry/sdk-metrics";
import { metrics } from "@opentelemetry/api";

// Add the exporter into the MetricReader and register it with the MeterProvider
const exporter = new AzureMonitorMetricExporter({
  connectionString: "<connection string>",
});

const metricReaderOptions = {
  exporter: exporter,
};
const metricReader = new PeriodicExportingMetricReader(metricReaderOptions);
const meterProvider = new MeterProvider({
  readers: [metricReader],
});

// Register Meter Provider as global
metrics.setGlobalMeterProvider(meterProvider);

로그

기존 OpenTelemetry 로거 공급자()에 로그 내보내기를 추가합니다.LoggerProvider

import { AzureMonitorLogExporter } from "@azure/monitor-opentelemetry-exporter";
import { BatchLogRecordProcessor, LoggerProvider } from "@opentelemetry/sdk-logs";
import { logs } from "@opentelemetry/api-logs";

// Add the Log exporter into the logRecordProcessor and register it with the LoggerProvider
const exporter = new AzureMonitorLogExporter({
  connectionString: "<connection string>",
});

const logRecordProcessor = new BatchLogRecordProcessor(exporter);
const loggerProvider = new LoggerProvider();
loggerProvider.addLogRecordProcessor(logRecordProcessor);

// Register logger Provider as global
logs.setGlobalLoggerProvider(loggerProvider);

샘플링

샘플링을 사용하도록 설정하여 수신하는 원격 분석 레코드의 양을 제한할 수 있습니다. Application Insights에서 올바른 샘플링을 사용하도록 설정하려면 아래와 같이 사용합니다 ApplicationInsightsSampler .

import { ApplicationInsightsSampler } from "@azure/monitor-opentelemetry-exporter";
import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
import { resourceFromAttributes } from "@opentelemetry/resources";
import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";

// Sampler expects a sample rate of between 0 and 1 inclusive
// A rate of 0.75 means approximately 75 % of your traces will be sent
const aiSampler = new ApplicationInsightsSampler(0.75);
const provider = new NodeTracerProvider({
  sampler: aiSampler,
  resource: resourceFromAttributes({
    [ATTR_SERVICE_NAME]: "basic-service",
  }),
});

provider.register();

예시

몇 가지 챔피언 시나리오의 전체 샘플은 폴더를 참조하십시오 samples/ .

주요 개념

OpenTelemetry 프로젝트에 대한 자세한 내용은 OpenTelemetry 사양을 검토하세요.

문제 해결

디버그 로깅 활성화

공급자의 로깅 수준을 변경하여 디버그 로깅을 사용하도록 설정할 수 있습니다.

import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
import { diag, DiagConsoleLogger, DiagLogLevel } from "@opentelemetry/api";

const provider = new NodeTracerProvider();
diag.setLogger(new DiagConsoleLogger(), DiagLogLevel.ALL);
provider.register();

로깅 (로그 기록)

Azure 로깅을 사용하도록 설정하면 오류에 대한 유용한 정보를 찾는 데도 도움이 될 수 있습니다. HTTP 요청 및 응답 로그를 보려면 AZURE_LOG_LEVEL 환경 변수를 info설정합니다. 또는 setLogLevel@azure/logger 호출하여 런타임에 로깅을 사용하도록 설정할 수 있습니다.

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

로그를 사용하도록 설정하는 방법에 대한 자세한 지침은 @azure/로거 패키지 문서확인할 수 있습니다.

다음 단계

이 내보내기는 OpenTelemetry JS와 함께 사용하도록 만들어졌습니다.

플러그인 레지스트리

사용 중인 라이브러리에 대한 플러그인이 이미 만들어졌는지 확인하려면 OpenTelemetry Registry를 확인하십시오.

레지스트리에서 라이브러리를 사용할 수 없는 경우 에서 opentelemetry-js-contrib새 플러그인 요청을 제안해 주십시오.

기여하기

이 라이브러리에 기여하려면 기여 가이드 읽어 코드를 빌드하고 테스트하는 방법에 대해 자세히 알아보세요.

  • Last updated on