OpenTelemetry 메트릭 목적지

이 제품은 선택한 Datadog 사이트에서 지원되지 않습니다. ().

개요

Observability Pipelines의 OpenTelemetry 대상을 사용하여 액세스 권한을 요청하려면 계정 관리자에게 문의하세요. HTTP/S를 통해 OpenTelemetry(OTel) Collector 또는 다른 OpenTelemetry Protocol(OTLP) 호환 엔드포인트로 메트릭을 전송합니다.

목적지 설정

시크릿 관리: HTTP/S 클라이언트 URI에 대한 식별자와 해당하는 경우 TLS 키 암호만 입력하세요. 실제 값은 입력하지 마세요.

파이프라인을 설정할 때 OpenTelemetry 목적지를 구성하세요. 파이프라인은 UI에서 설정할 수 있으며, API 또는 Terraform을 사용하여 설정할 수 있습니다. 이 섹션에서는 UI를 기준으로 단계를 설명합니다.

파이프라인 UI에서 OpenTelemetry 목적지를 선택한 후 HTTP/S 클라이언트 URI에 대한 식별자를 입력하세요. 식별자가 참조하는 HTTP/S URI 엔드포인트의 예: http://localhost:4319/v1/metrics. 식별자 필드를 비워 두면 기본값이 사용됩니다.

참고:

  • Worker는 카운터, 게이지, 히스토그램 메트릭만 OpenTelemetry로 보낼 수 있습니다. OpenTelemetry는 다른 메트릭 유형을 지원하지 않으므로 Worker는 해당 메트릭을 삭제합니다. 자세한 내용은 지원되지 않는 메트릭 필터링을 참조하세요.
  • Worker는 메트릭의 순서를 재정렬하지 않으며 일부 OTLP 수신기는 순서가 맞지 않는 샘플을 거부하므로, Datadog에서는 OTLP 수신기가 순서가 맞지 않는 샘플을 허용하도록 설정할 것을 권장합니다. 자세한 내용은 순서가 맞지 않는 샘플 허용을 참조하세요.
  • 보안 식별자를 입력한 후 환경 변수 사용을 선택하면, 환경 변수는 입력한 식별자 앞에 DD_OP_가 추가된 형태가 됩니다. 예를 들어 암호 식별자로 PASSWORD_1을 입력한 경우 해당 암호의 환경 변수는 DD_OP_PASSWORD_1입니다.

선택적 설정

TLS 활성화

Toggle the switch to Enable TLS.

  • If you are using Secrets Management, enter the identifier for the key pass. See Secret defaults for the default used if the field is left blank.
  • Enter the following certificate and key files:
    • Server Certificate Path: The path to the certificate file that has been signed by your Certificate Authority (CA) root file in DER, PEM, or CRT (X.509).
    • (Optional) CA Certificate Path: The path to the certificate file that is your Certificate Authority (CA) root file in DER, PEM, or CRT (X.509).
    • (Optional) Private Key Path: The path to the .key private key file that belongs to your Server Certificate Path in DER, PEM, or CRT (PKCS #8) format.
    • Notes:
      • The configuration data directory /var/lib/observability-pipelines-worker/config/ is automatically appended to the file paths. See Advanced Worker Configurations for more information.
      • The file must be readable by the observability-pipelines-worker group and user.

버퍼링

Toggle the switch to enable Buffering Options. Enable a configurable buffer on your destination to ensure intermittent latency or an outage at the destination doesn’t create immediate backpressure, and allow events to continue to be ingested from your source. Disk buffers can also increase pipeline durability by writing data to disk, ensuring buffered data persists through a Worker restart. See Destination buffers for more information.

  • If left unconfigured, your destination uses a memory buffer with a capacity of 500 events.
  • To configure a buffer on your destination:
    1. Select the buffer type you want to set (Memory or Disk).
    2. Enter the buffer size and select the unit.
      1. Maximum memory buffer size is 128 GB.
      2. Maximum disk buffer size is 5 TB.
        • Note: For Worker versions 2.20.x and older, the maximum disk buffer size is 500 GB.
    3. In the Behavior on full buffer dropdown menu, select whether you want to block events or drop new events when the buffer is full.

지원되지 않는 메트릭 필터링

Worker는 카운터, 게이지, 히스토그램 메트릭만 OpenTelemetry로 보낼 수 있습니다. 다음 Datadog 메트릭은 OTLP 형식으로 변환할 수 없으므로 지원되지 않습니다.

  • StatsD 유형 메트릭
  • 분포 메트릭
  • 스케치 메트릭

이러한 메트릭 중 하나가 인코딩되어 OpenTelemetry로 전송될 배치에 포함된 경우, Worker는 지원되지 않는 메트릭을 삭제하고 오류를 기록하며 component_error_total 메트릭을 업데이트합니다. Datadog에서는 필터 프로세서를 사용하여 지원되지 않는 메트릭 유형을 필터링할 것을 권장합니다.

순서가 맞지 않는 샘플 허용

Worker는 메트릭 순서를 재조정하지 않기 때문에 특정 시리즈에 대해 항상 올바른 순서로 메트릭을 전송하지는 않습니다. 예를 들어, 첫 번째 메트릭 배치에 타임스탬프가 10:03, 10:04, 10:05인 메트릭이 포함되어 있고 두 번째 배치에 타임스탬프가 10:01, 10:02, 10:06인 메트릭이 포함되어 있는 경우, Worker는 해당 메트릭을 전송하기 전에 순서를 재조정하지 않습니다.

Prometheus OTLP 수신기와 같이 일부 OTLP 수신기는 순서가 맞지 않는 샘플을 거부하므로, 두 번째 메트릭 배치가 수신기에 의해 거부됩니다. 결과적으로 Worker는 잘못된 요청(400) 오류를 기록하고, OTLP 수신기가 배치 내의 일부 유효한 메트릭을 수락했더라도 거부된 전체 배치가 삭제됩니다.

Datadog에서는 순서가 맞지 않는 샘플이 삭제되는 것을 방지할 수 있도록 OTLP 수신기가 순서가 맞지 않는 샘플을 허용하도록 설정할 것을 권장합니다.

시크릿 기본값

These are the defaults used for secret identifiers and environment variables.

    • HTTP/S 클라이언트 URI 엔드포인트 식별자
      • Worker가 OpenTelemetry 데이터를 전송하는 HTTP/S URI 엔드포인트를 참조합니다. 식별자가 참조하는 HTTP/S URI 엔드포인트의 예: http://localhost:4319/v1/metrics.
      • 기본 식별자는 DESTINATION_OTEL_HTTP_CLIENT_URI입니다.
    • HTTP/S 클라이언트 TLS 암호 식별자(TLS가 활성화된 경우):
      • 기본 식별자는 DESTINATION_OTEL_HTTP_CLIENT_KEY_PASS입니다.
    • HTTP/S client URI endpoint, such as http://localhost:4319/v1/metrics:
      • The HTTP/S URI endpoint to which the Worker sends OpenTelemetry data.
      • The default environment variable is DD_OP_DESTINATION_OTEL_HTTP_CLIENT_URI.
    • HTTP/S Client TLS passphrase (when enabled):
      • The default environment variable is DD_OP_DESTINATION_OTEL_HTTP_CLIENT_KEY_PASS.

    메트릭

    모든 목적지에서 내보내는 구성 요소 메트릭 및 목적지 버퍼 메트릭에 대해서는 Pipelines 사용량 메트릭 문서를 참조하세요. OpenTelemetry 목적지 메트릭을 필터링하거나 그룹화하려면 태그 component_type:opentelemetry를 사용하세요.

    목적지가 작동하는 방식

    이벤트 배치

    이벤트 배치는 다음 조건 중 하나가 발생하면 플러시됩니다. 자세한 내용은 이벤트 배치를 참조하세요.

    최대 이벤트최대 크기(MB)타임아웃(초)
    N/A101