OTel metrics source
출처: 문서
본문
OTel 메트릭스 소스
otel_metrics_source는 메트릭 데이터를 수집하는 OpenTelemetry Collector 소스예요. 다음 표는 otel_metrics_source 소스를 구성할 때 사용할 수 있는 옵션을 설명해요.
구성
otel_metrics_source 소스는 다음 옵션으로 구성할 수 있어요.
| 옵션 | 필수 | 타입 | 설명 |
|---|---|---|---|
port |
아니요 | Integer | OpenTelemetry 메트릭스 소스가 실행되는 포트예요. 기본값은 21891이에요. |
request_timeout |
아니요 | Integer | 요청 제한 시간(밀리초)이에요. 기본값은 10000이에요. |
health_check_service |
아니요 | Boolean | grpc.health.v1/Health/Check 아래에 gRPC 상태 확인 서비스를 활성화해요. 기본값은 false예요. |
proto_reflection_service |
아니요 | Boolean | Protobuf 서비스를 위한 리플렉션 서비스를 활성화해요(gRPC 리플렉션 및 gRPC 서버 리플렉션 튜토리얼 문서 참조). 기본값은 false예요. |
unframed_requests |
아니요 | Boolean | gRPC 와이어 프로토콜을 사용하여 프레이밍되지 않은 요청을 활성화해요. |
thread_count |
아니요 | Integer | ScheduledThreadPool에 유지할 스레드 수예요. 기본값은 200이에요. |
max_connection_count |
아니요 | Integer | 허용되는 최대 열린 연결 수예요. 기본값은 500이에요. |
output_format |
String | 생성된 이벤트의 출력 형식을 지정해요. 유효한 값은 otel 또는 opensearch예요. 기본값은 opensearch예요. |
|
max_request_length |
아니요 | ByteCount | 단일 gRPC 또는 HTTP 요청의 페이로드에 허용되는 최대 바이트 수예요. 기본값은 10mb예요. |
ssl |
아니요 | Boolean | TLS/SSL을 통해 OpenTelemetry 소스 포트에 대한 연결을 활성화해요. 기본값은 true예요. |
sslKeyCertChainFile |
조건부 | String | 보안 인증서의 파일 시스템 경로 또는 Amazon Simple Storage Service(Amazon S3) 경로예요(예: "config/demo-data-prepper.crt" 또는 "s3://my-secrets-bucket/demo-data-prepper.crt"). ssl이 true로 설정된 경우 필수예요. |
sslKeyFile |
조건부 | String | 보안 키의 파일 시스템 경로 또는 Amazon S3 경로예요(예: "config/demo-data-prepper.key" 또는 "s3://my-secrets-bucket/demo-data-prepper.key"). ssl이 true로 설정된 경우 필수예요. |
useAcmCertForSSL |
아니요 | Boolean | AWS Certificate Manager(ACM)의 인증서와 개인 키를 사용하여 TLS/SSL을 활성화할지 여부예요. 기본값은 false예요. |
acmCertificateArn |
조건부 | String | ACM 인증서 ARN을 나타내요. ACM 인증서는 S3 또는 로컬 파일 시스템 인증서보다 우선해요. useAcmCertForSSL이 true로 설정된 경우 필수예요. |
awsRegion |
조건부 | String | ACM 또는 Amazon S3에서 사용하는 AWS 리전을 나타내요. useAcmCertForSSL이 true로 설정되거나 sslKeyCertChainFile 및 sslKeyFile이 Amazon S3 경로인 경우 필수예요. |
authentication |
아니요 | Object | 인증 구성이에요. 기본적으로 파이프라인에 대해 인증되지 않은 서버가 생성돼요. HTTPS에 플러그형 인증을 사용해요. 기본 인증을 사용하려면 username과 password로 http_basic 플러그인을 정의해요. 사용자 지정 인증을 제공하려면 GrpcAuthenticationProvider를 구현하는 플러그인을 사용하거나 생성해요. |
사용법
otel-metrics 소스를 사용하려면 otel_metrics_source를 소스로 하여 다음 pipeline.yaml 파일을 생성해요.
source:
- otel_metrics_source:
{% include copy.html %}
출력에 OpenTelemetry 형식을 사용하려면 다음 예제와 같이 output_format을 otel로 설정해요.
source:
- otel_metrics_source:
output_format: otel
{% include copy.html %}
메트릭
otel_metrics_source 소스에는 다음 메트릭이 포함돼요.
카운터
requestTimeouts: 시간 초과된 요청의 총 수를 측정해요.requestsReceived: OpenTelemetry 메트릭스 소스가 수신한 요청의 총 수를 측정해요.