Custom OTLP 연결

Custom OTLP는 특정 애플리케이션이나 인프라를 새로 계측하는 카탈로그가 아닙니다. 이미 OpenTelemetry SDK, Agent 또는 Collector가 보내는 OTLP 데이터를 Monithub로 전달할 때 사용합니다.

수집되는 신호는 앞단 송신기가 실제로 보내는 데이터에 따라 달라집니다. 메트릭, 트레이스와 로그 중 하나만 보내고 있다면 해당 신호만 확인됩니다.

설정 생성

1. 커스텀 OTLP를 선택합니다.
2. OTLP 송신기 가까이에서 Collector를 실행할 환경을 선택합니다.
3. 목록에서 구분할 수집 대상 이름과 운영 환경을 입력하고 설정 생성을 누릅니다.

Collector 실행과 송신 주소 적용

Connect가 생성한 otelcol-monithub.yaml 전체를 저장하고 Collector를 실행한 뒤, 기존 송신기의 OTLP 주소를 해당 Collector로 변경합니다.

otelcol-contrib --config ./otelcol-monithub.yaml
export OTEL_EXPORTER_OTLP_ENDPOINT="http://127.0.0.1:4318"
export OTEL_EXPORTER_OTLP_PROTOCOL="http/protobuf"
# 기존 송신기 또는 애플리케이션을 다시 시작합니다.

위 주소는 OTLP HTTP 예시입니다. OTLP gRPC 송신기는 Connect가 생성한 4317 주소를 사용합니다. Docker 방식도 호스트에는 로컬 주소로만 포트를 공개하므로 다른 서버에 그대로 노출하지 마세요.

연결 후 확인

앞단 송신기에서 실제 메트릭, 트레이스 또는 로그를 보낸 뒤 데이터 수집 확인을 다시 누릅니다.

증상	확인할 내용
모든 신호가 없음	송신 endpoint, HTTP·gRPC 프로토콜, 4317·4318 포트와 송신기 재시작 여부를 확인합니다.
일부 신호만 없음	앞단 송신기가 해당 신호를 실제로 생성하고 내보내는지 확인합니다.
Collector가 시작되지 않음	Connect에서 생성한 YAML 전체를 저장했는지와 수신 포트 충돌 여부를 확인합니다.

상태의 의미와 재시도 방법은 연결 및 수집 확인에서 안내합니다.

• OpenTelemetry OTLP Receiver
• OpenTelemetry Collector 설정