이 페이지에서는 구성 동기화에서 커스텀 OpenTelemetry 내보내기 도구로 측정항목을 전송하는 방법을 설명합니다.
구성 동기화는 OpenCensus를 사용해서 측정항목을 생성 및 기록하고 OpenTelemetry를 사용해서 해당 측정항목을 내보냅니다. 이 페이지에서는 커스텀 내보내기 도구에 대해 이러한 측정항목을 구성하는 방법을 설명합니다. 측정항목을 내보내는 다른 방법은 Cloud Monitoring으로 구성 동기화 모니터링 또는 Prometheus로 구성 동기화 모니터링을 참조하세요.
커스텀 OpenTelemetry 내보내기 구성
측정항목을 Prometheus 또는 Cloud Monitoring 이외의 모니터링 시스템으로 전송하려면 OpenTelemetry 구성을 수정할 수 있습니다. 지원되는 모니터링 시스템 목록은 OpenTelemetry Collector 내보내기 도구 및 OpenTelemetry Collector-Contrib 내보내기 도구를 참조하세요.
OpenTelemetry 모니터링 리소스는 별도의 config-management-monitoring 네임스페이스에서 관리됩니다. 구성 동기화에 사용하도록 커스텀 OpenTelemetry를 구성하려면 해당 config-management-monitoring 네임스페이스에서 otel-collector-custom 이름으로 ConfigMap을 만들어야 합니다.
ConfigMap은 otel-collector-config.yaml 키를 포함해야 하고, 값은 커스텀 OpenTelemetry Collector 구성의 파일 콘텐츠여야 합니다.
구성 옵션에 대한 상세 설명은 OpenTelemetry Collector 구성 문서를 참조하세요.
다음 ConfigMap은 커스텀 로깅 내보내기 도구를 사용한 ConfigMap 예시입니다.
# otel-collector-custom-cm.yaml
apiVersion: v1
kind: ConfigMap
metadata:
name: otel-collector-custom
namespace: config-management-monitoring
labels:
app: opentelemetry
component: otel-collector
data:
otel-collector-config.yaml: |
receivers:
opencensus:
exporters:
logging:
logLevel: debug
processors:
batch:
extensions:
health_check:
service:
extensions: [health_check]
pipelines:
metrics:
receivers: [opencensus]
processors: [batch]
exporters: [logging]
모든 커스텀 구성은 opencensus 수신기 및 metrics 파이프라인을 정의해야 합니다. 나머지 필드는 선택적이고 구성 가능하지만, 예시와 같이 batch 프로세서 및 상태 확인 확장 프로그램을 포함하는 것이 좋습니다.
ConfigMap을 만든 후 kubectl을 사용하여 리소스를 만듭니다.
kubectl apply -f otel-collector-custom-cm.yaml
OpenTelemetry Collector 배포는 이 ConfigMap을 선택하고 자동으로 재시작되어 커스텀 구성을 적용합니다.
제한사항
구성 동기화를 새 버전으로 업그레이드할 때 이전 버전에 대해 otel-collector-custom ConfigMap을 만든 경우 커스텀 설정이 새 버전의 구성 동기화와 호환되지 않을 수 있습니다. 예를 들어 측정항목 이름, 라벨, 속성은 구성 동기화 버전 간에 변경될 수 있습니다.
구성 동기화 측정항목이 변경되면 출시 노트에 발표됩니다. 이러한 변경을 위해서는 커스텀 otel-collector 구성을 업데이트해야 할 수 있습니다.
이러한 제한사항으로 인해 임시 해결 방법으로만 커스텀 측정항목 구성을 사용하는 것이 좋습니다. 커스텀 구성을 사용해야 하는 경우 지원 티켓을 제출하여 기능 또는 버그 수정으로 해결 방법을 요청하세요.