기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 파이프라인 지표 모니터링
<a name="monitoring-pipeline-metrics"></a>

원시 데이터를 수집하여 읽기 가능하며 실시간에 가까운 지표로 처리하는 Amazon CloudWatch를 통해 를 Amazon OpenSearch Ingestion 모니터링할 수 있습니다. 이러한 통계는 15개월간 보관되므로 기록 정보에 액세스하고 웹 애플리케이션 또는 서비스가 어떻게 실행되고 있는지 전체적으로 더 잘 파악할 수 있습니다. 특정 임곗값을 주시하다가 해당 임곗값이 충족될 때 알림을 전송하거나 조치를 취하도록 경보를 설정할 수도 있습니다. 자세한 내용은 [Amazon CloudWatch 사용 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)를 참조하세요.

OpenSearch Ingestion 콘솔에는 CloudWatch의 원시 데이터를 기초로 하는 일련의 차트가 각 파이프라인의 **성능** 탭에 표시됩니다.

OpenSearch Ingestion은 대부분의 [지원되는 플러그인](pipeline-config-reference.md#ingestion-plugins)의 지표를 보고합니다. 특정 플러그인에 아래의 자체 표가 없다면 플러그인별 지표를 보고하지 않는다는 뜻입니다. 이러한 지표는 `AWS/OSIS` 네임스페이스에 게시됩니다.

**Topics**
+ [공통 지표](#common-metrics)
+ [버퍼 지표](#buffer-metrics)
+ [서명 V4 지표](#sigv4-metrics)
+ [경계가 있는 차단 버퍼 지표](#blockingbuffer-metrics)
+ [Otel 추적 소스 지표](#oteltrace-metrics)
+ [Otel 지표 소스 지표](#otelmetrics-metrics)
+ [Http 지표](#http-metrics)
+ [S3 ta 지표](#s3-metrics)
+ [집계 지표](#aggregate-metrics)
+ [날짜 지표](#date-metrics)
+ [Lambda 지표](#lambda-metrics)
+ [Grok 지표](#grok-metrics)
+ [Otel 추적 원시 지표](#oteltrace-raw-metrics)
+ [Otel 추적 그룹 지표](#oteltracegroup-metrics)
+ [서비스 맵 스테이트풀 메트릭](#servicemapstateful-metrics)
+ [OpenSearch 지표](#opensearch-metrics)
+ [시스템 및 측정 지표](#systemmetering-metrics)

## 공통 지표
<a name="common-metrics"></a>

다음 지표는 모든 프로세서와 싱크에 공통입니다.

각 지표 앞에는 <{{sub\_pipeline\_name}}><{{plugin}}><{{metric\_name}}> 형식으로 하위 파이프라인 이름과 플러그인 이름이 접두사로 붙습니다. 예를 들어, `my-pipeline`이라는 하위 파이프라인의 `recordsIn.count` 지표 전체 이름과 [날짜](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/date/) 프로세서는 `my-pipeline.date.recordsIn.count`과 같습니다.


| 지표 접미사 | 설명 | 
| --- | --- | 
| recordsIn.count | 파이프라인 구성 요소로의 레코드 수신. 이 지표는 프로세서와 싱크에 적용됩니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| recordsOut.count | 파이프라인 구성 요소로의 레코드 송신. 이 지표는 프로세서와 소스에 적용됩니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| timeElapsed.count | 파이프라인 구성 요소 실행 중에 기록된 데이터 포인트 수입니다. 이 지표는 프로세서와 싱크에 적용됩니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| timeElapsed.sum | 파이프라인 구성 요소를 실행하는 동안 경과된 총 시간입니다. 이 지표는 프로세서와 싱크에 적용(밀리초)됩니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| timeElapsed.max | 파이프라인 구성 요소를 실행하는 동안 경과된 최대 시간입니다. 이 지표는 프로세서와 싱크에 적용(밀리초)됩니다.<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 

## 버퍼 지표
<a name="buffer-metrics"></a>

다음 지표는 OpenSearch Ingestion이 모든 파이프라인에 대해 자동으로 구성하는 기본 [경계가 있는 차단](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/buffers/bounded-blocking/) 버퍼에 적용됩니다.

각 지표 앞에는 <{{sub\_pipeline\_name}}><{{plugin}}><{{metric\_name}}> 형식으로 하위 파이프라인 이름과 버퍼 이름이 접두사로 붙습니다. 예를 들어, `my-pipeline`이라는 하위 파이프라인의 `recordsWritten.count` 지표 전체 이름이 `my-pipeline.BlockingBuffer.recordsWritten.count`(와)과 같습니다.


| 지표 접미사 | 설명 | 
| --- | --- | 
| recordsWritten.count | 버퍼에 기록된 레코드 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| recordsRead.count | 버퍼에서 읽은 레코드 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| recordsInFlight.value | 버퍼에서 읽은 미확인된 레코드 수입니다.<br />**관련 통계**: Average<br />**차원**: `PipelineName` | 
| recordsInBuffer.value | 현재 버퍼에 있는 레코드 수입니다.<br />**관련 통계**: Average<br />**차원**: `PipelineName` | 
| recordsProcessed.count | 버퍼에서 읽고 파이프라인에서 처리한 레코드 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| recordsWriteFailed.count | 파이프라인이 싱크에 기록하지 못한 레코드 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| writeTimeElapsed.count | 버퍼에 쓰는 동안 기록된 데이터 포인트 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| writeTimeElapsed.sum | 버퍼에 쓰는 동안 경과된 총 시간(밀리초)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| writeTimeElapsed.max | 버퍼에 쓰는 동안 경과된 최대 시간(밀리초)입니다.<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 
| writeTimeouts.count | 버퍼에 대한 쓰기 타임아웃 횟수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| readTimeElapsed.count | 버퍼에 쓰는 동안 기록된 데이터 포인트 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| readTimeElapsed.sum | 버퍼에서 읽는 동안 경과된 총 시간(밀리초)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| readTimeElapsed.max | 버퍼에서 읽는 동안 경과된 최대 시간(밀리초)입니다.<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 
| checkpointTimeElapsed.count | 체크포인트를 수행하는 동안 기록된 데이터 포인트 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| checkpointTimeElapsed.sum | 체크포인트를 수행하는 동안 경과된 총 시간(밀리초)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| checkpointTimeElapsed.max | 체크포인트를 수행하는 동안 경과된 최대 시간(밀리초)입니다.<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 

## 서명 V4 지표
<a name="sigv4-metrics"></a>

다음 지표는 파이프라인의 수집 엔드포인트에 적용되며 소스 플러그인(`http`, `otel_trace`, `otel_metrics`)과 연결됩니다. OpenSearch Ingestion에 대한 모든 요청은 [서명 버전 4](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html)로 서명되어야 합니다. 이러한 지표를 통해 파이프라인에 연결할 때 권한 부여 문제를 식별하거나 성공적으로 인증되고 있는지 확인할 수 있습니다.

각 지표 앞에는 하위 파이프라인 이름 및 `osis_sigv4_auth`(이)가 붙습니다. 예를 들어 `{{sub_pipeline_name}}.osis_sigv4_auth.httpAuthSuccess.count`입니다.


| 지표 접미사 | 설명 | 
| --- | --- | 
| httpAuthSuccess.count | 파이프라인에 대한 성공적인 서명 V4 요청 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| httpAuthFailure.count | 파이프라인에 대한 실패한 서명 V4 요청 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| httpAuthServerError.count | 서버 오류를 반환한 파이프라인에 대한 서명 V4 요청 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 

## 경계가 있는 차단 버퍼 지표
<a name="blockingbuffer-metrics"></a>

다음 지표는 [경계가 있는 차단 ](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/buffers/bounded-blocking/) 버퍼에 적용됩니다. 각 지표 앞에는 하위 파이프라인 이름 및 `BlockingBuffer`(이)가 붙습니다. 예를 들어 `{{sub_pipeline_name}}.BlockingBuffer.bufferUsage.value`입니다.


| 지표 접미사 | 설명 | 
| --- | --- | 
| bufferUsage.value | 버퍼에 있는 레코드 수를 기준으로 한 `buffer_size`의 사용률입니다. `buffer_size`는 버퍼에 기록된 최대 레코드 수와 확인되지 않은 기내 레코드를 나타냅니다.<br />**관련 통계**: Average<br />**차원**: `PipelineName` | 

## Otel 추적 소스 지표
<a name="oteltrace-metrics"></a>

다음 지표는 [oTel 추적 ](https://docs.opensearch.org/latest/data-prepper/pipelines/configuration/sources/otel-trace-source/) 소스에 적용됩니다. 각 지표 앞에는 하위 파이프라인 이름 및 `otel_trace_source`(이)가 붙습니다. 예를 들어 `{{sub_pipeline_name}}.otel_trace_source.requestTimeouts.count`입니다.


| 지표 접미사 | 설명 | 
| --- | --- | 
| requestTimeouts.count | 시간을 초과한 요청 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| requestsReceived.count | 플러그인에서 수신된 요청 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| successRequests.count | 메시지 브로커가 성공적으로 처리한 구독 요청 수.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| badRequests.count | 플러그인에서 처리한 잘못된 형식의 요청 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| requestsTooLarge.count | 콘텐츠의 스팬 수가 버퍼 용량보다 큰 요청의 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| internalServerError.count | 사용자 지정 예외 유형을 사용하여 플러그인에서 처리한 요청 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| requestProcessDuration.count | 플러그인의 요청을 처리하는 동안 기록된 데이터 포인트 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| requestProcessDuration.sum | 플러그인에서 처리한 요청의 총 지연 시간(밀리초)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| requestProcessDuration.max | 플러그인에서 처리한 요청의 최대 지연 시간(밀리초)입니다.<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 
| payloadSize.count | 수신 요청의 페이로드 크기 분포 수(바이트)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| payloadSize.sum | 수신 요청의 페이로드 크기 분포의 총 수(바이트)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| payloadSize.max | 수신 요청의 페이로드 크기 분포의 최대 수(바이트)입니다.<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 

## Otel 지표 소스 지표
<a name="otelmetrics-metrics"></a>

다음 지표는 [oTel 지표 ](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/otel-metrics-source/) 소스에 적용됩니다. 각 지표 앞에는 하위 파이프라인 이름 및 `otel_metrics_source`(이)가 붙습니다. 예를 들어 `{{sub_pipeline_name}}.otel_metrics_source.requestTimeouts.count`입니다.


| 지표 접미사 | 설명 | 
| --- | --- | 
| requestTimeouts.count | 시간 초과된 플러그인에 대한 총 요청 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| requestsReceived.count | 플러그인에서 수신된 요청 총 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| successRequests.count | 플러그인이 성공적으로 처리한 요청 수(응답 상태 코드 200개)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| requestProcessDuration.count | 플러그인에서 처리한 요청의 지연 시간 수(초)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| requestProcessDuration.sum | 플러그인에서 처리한 요청의 총 지연 시간(밀리초)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| requestProcessDuration.max | 플러그인에서 처리한 요청의 최대 지연 시간(밀리초)입니다.<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 
| payloadSize.count | 수신 요청의 페이로드 크기 분포 수(바이트)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| payloadSize.sum | 수신 요청의 페이로드 크기 분포의 총 수(바이트)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| payloadSize.max | 수신 요청의 페이로드 크기 분포의 최대 수(바이트)입니다.<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 

## Http 지표
<a name="http-metrics"></a>

다음 지표는 [HTTP](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/http-source/) 소스에 적용됩니다. 각 지표 앞에는 하위 파이프라인 이름 및 `http`(이)가 붙습니다. 예를 들어 `{{sub_pipeline_name}}.http.requestsReceived.count`입니다.


| 지표 접미사 | 설명 | 
| --- | --- | 
| requestsReceived.count | `/log/ingest` 엔드포인트에서 수신된 바이트 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| requestsRejected.count | 플러그인이 거부한 요청 수(응답 상태 코드 429개)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| successRequests.count | 플러그인이 성공적으로 처리한 요청 수(응답 상태 코드 200개)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| badRequests.count | 플러그인에서 처리한 콘텐츠 유형이나 형식이 잘못된 요청 수(응답 상태 코드 400개)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| requestTimeouts.count | HTTP 소스 서버에서 제한 시간이 초과된 요청 수(415 응답 상태 코드)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| requestsTooLarge.count | 콘텐츠의 이벤트 수가 버퍼 용량보다 큰 요청의 수(413 응답 상태 코드)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| internalServerError.count | 사용자 지정 예외 유형을 사용하여 플러그인에서 처리한 요청 수(500 응답 상태 코드)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| requestProcessDuration.count | 플러그인에서 처리한 요청의 지연 시간 수(초)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| requestProcessDuration.sum | 플러그인에서 처리한 요청의 총 지연 시간(밀리초)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| requestProcessDuration.max | 플러그인에서 처리한 요청의 최대 지연 시간(밀리초)입니다.<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 
| payloadSize.count | 수신 요청의 페이로드 크기 분포 수(바이트)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| payloadSize.sum | 수신 요청의 페이로드 크기 분포의 총 수(바이트)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| payloadSize.max | 수신 요청의 페이로드 크기 분포의 최대 수(바이트)입니다.<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 

## S3 ta 지표
<a name="s3-metrics"></a>

다음 지표는 [S3](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sources/s3/) 소스에 적용됩니다. 각 지표 앞에는 하위 파이프라인 이름 및 `s3`(이)가 붙습니다. 예를 들어 `{{sub_pipeline_name}}.s3.s3ObjectsFailed.count`입니다.


| 지표 접미사 | 설명 | 
| --- | --- | 
| s3ObjectsFailed.count | 플러그인이 읽지 못한 S3 객체의 총 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| s3ObjectsNotFound.count | S3에서 `Not Found` 오류가 발생하여 플러그인이 읽지 못한 S3 객체의 수입니다. 이러한 지표도 `s3ObjectsFailed` 지표에 포함됩니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| s3ObjectsAccessDenied.count | S3에서 `Access Denied` 또는 `Forbidden` 오류가 발생하여 플러그인이 읽지 못한 S3 객체의 수입니다. 이러한 지표도 `s3ObjectsFailed` 지표에 포함됩니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| s3ObjectReadTimeElapsed.count | 플러그인이 S3 객체에 대한 GET 요청을 수행하고, 객체를 구문 분석하고, 버퍼에 이벤트를 쓰는 데 걸리는 시간입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| s3ObjectReadTimeElapsed.sum | 플러그인이 S3 객체에 대한 GET 요청을 수행하고, 객체를 구문 분석하고, 버퍼에 이벤트를 쓰는 데 걸리는 시간입니다(밀리초).<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| s3ObjectReadTimeElapsed.max | 플러그인이 S3 객체에 대한 GET 요청을 수행하고, 객체를 구문 분석하고, 버퍼에 이벤트를 쓰는 데 걸리는 최대 시간입니다(밀리초).<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 
| s3ObjectSizeBytes.count | S3 객체 크기의 분포 수(바이트)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| s3ObjectSizeBytes.sum | S3 객체 크기의 분포 총 수(바이트)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| s3ObjectSizeBytes.max | S3 객체 크기의 최대 분포 수(바이트)입니다.<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 
| s3ObjectProcessedBytes.count | 플러그인에서 처리한 S3 객체의 배포 수(바이트)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| s3ObjectProcessedBytes.sum | 플러그인에서 처리한 S3 객체의 총 배포 수(바이트)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| s3ObjectProcessedBytes.max | 플러그인에서 처리한 S3 객체의 최대 배포 수(바이트)입니다.<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 
| s3ObjectsEvents.count | 플러그인이 수신한 S3 이벤트의 배포 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| s3ObjectsEvents.sum | 플러그인이 수신한 S3 이벤트의 총 배포입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| s3ObjectsEvents.max | 플러그인이 수신한 S3 이벤트의 최대 배포입니다.<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 
| sqsMessageDelay.count | S3가 객체 생성에 필요한 이벤트 시간을 기록하여 객체가 완전히 구문 분석된 시점까지 기록하는 동안 기록된 데이터 포인트 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| sqsMessageDelay.sum | S3가 객체 생성을 위한 이벤트 시간을 기록하는 시점부터 완전히 구문 분석된 시점까지의 총 시간(밀리초)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| sqsMessageDelay.max | S3가 객체 생성을 위한 이벤트 시간을 기록하는 시점부터 완전히 구문 분석된 시점까지의 최대 시간(밀리초)입니다.<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 
| s3ObjectsSucceeded.count | 플러그인이 성공적으로 읽은 S3 객체 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| sqsMessagesReceived.count | 플러그인이 대기열에서 수신한 Amazon SQS 메시지 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| sqsMessagesDeleted.count | 플러그인이 대기열에서 삭제한 Amazon SQS 메시지 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| sqsMessagesFailed.count | 플러그인이 구문 분석하지 못한 Amazon SQS 메시지 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 

## 집계 지표
<a name="aggregate-metrics"></a>

다음 지표는 [집계](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/aggregate/) 프로세서에 적용됩니다. 각 지표 앞에는 하위 파이프라인 이름 및 `aggregate`(이)가 붙습니다. 예를 들어 `{{sub_pipeline_name}}.aggregate.actionHandleEventsOut.count`입니다.


| 지표 접미사 | 설명 | 
| --- | --- | 
| actionHandleEventsOut.count | 구성된 작업에 대한 `handleEvent` 호출에서 반환된 이벤트 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| actionHandleEventsDropped.count | 구성된 작업에 대한 `handleEvent` 호출에서 반환된 이벤트 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| actionHandleEventsProcessingErrors.count | 오류가 발생한 구성된 작업에 대해 `handleEvent`로 걸려온 호출 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| actionConcludeGroupEventsOut.count | 구성된 작업에 대한 `concludeGroup` 호출에서 반환된 이벤트 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| actionConcludeGroupEventsDropped.count | 구성된 작업에 대한 `condludeGroup` 호출에서 반환되지 않은 이벤트 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| actionConcludeGroupEventsProcessingErrors.count | 오류가 발생한 구성된 작업에 대해 `concludeGroup`로 걸려온 호출 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| currentAggregateGroups.value | 현재 그룹 수입니다. 이 게이지는 그룹이 종료되면 감소하고 이벤트에서 새 그룹이 생성되기 시작하면 증가합니다.<br />**관련 통계**: Average<br />**차원**: `PipelineName` | 

## 날짜 지표
<a name="date-metrics"></a>

다음 지표는 [날짜](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/date/) 프로세서에 적용됩니다. 각 지표 앞에는 하위 파이프라인 이름 및 `date`(이)가 붙습니다. 예를 들어 `{{sub_pipeline_name}}.date.dateProcessingMatchSuccess.count`입니다.


| 지표 접미사 | 설명 | 
| --- | --- | 
| dateProcessingMatchSuccess.count | `match` 구성 옵션에 지정된 패턴 중 최소 하나 이상과 일치하는 레코드 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| dateProcessingMatchFailure.count | `match` 구성 옵션에 지정된 패턴 중 어떤 것과도 일치하지 않는 레코드 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 

## Lambda 지표
<a name="lambda-metrics"></a>

다음 지표는 [AWS Lambda](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/aws-lambda/) 프로세서에 적용됩니다. 각 지표 앞에는 하위 파이프라인 이름 및 `lambda`(이)가 붙습니다. 예를 들어 `{{sub_pipeline_name}}.lambda.recordsSuccessfullySentToLambda.count`입니다.


| 지표 접미사 | 설명 | 
| --- | --- | 
| recordsSuccessfullySentToLambda.count | Lambda 함수에서 성공적으로 처리된 레코드 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| recordsFailedToSendToLambda.count | Lambda 함수로 전송하지 못한 레코드 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| lambdaFunctionLatency.avg`lambdaFunctionLatency.max` | Lambda 함수 호출의 지연 시간입니다.<br />**관련 통계**: 평균 및 최대<br />**차원**: `PipelineName` | 
| numberOfRequestsSucceeded.count | 성공적인 Lambda 간접 호출 요청의 총 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| numberOfRequestsFailed.count | 실패한 Lambda 간접 호출 요청의 총 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| requestPayloadSize.avg | Lambda로 전송된 요청 페이로드의 크기입니다.<br />**관련 통계**: Average<br />**차원**: `PipelineName` | 
| responsePayloadSize.avg | Lambda에서 수신한 응답 페이로드의 크기입니다.<br />**관련 통계**: Average<br />**차원**: `PipelineName` | 

## Grok 지표
<a name="grok-metrics"></a>

다음 지표는 [Grok](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/processors/grok/) 프로세서에 적용됩니다. 각 지표 앞에는 하위 파이프라인 이름 및 `grok`(이)가 붙습니다. 예를 들어 `{{sub_pipeline_name}}.grok.grokProcessingMatch.count`입니다.


| 지표 접미사 | 설명 | 
| --- | --- | 
| grokProcessingMatch.count | `match` 구성 옵션에 최소 하나 이상의 패턴이 검색된 레코드 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| grokProcessingMismatch.count | `match` 구성 옵션에 지정된 패턴 중 어떤 것과도 일치하지 않는 레코드 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| grokProcessingErrors.count | 레코드 처리 오류 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| grokProcessingTimeouts.count | 매칭 중에 제한 시간이 초과된 레코드 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| grokProcessingTime.count | 개별 레코드가 `match` 구성 옵션의 패턴과 일치하는 동안 기록된 데이터 포인트 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| grokProcessingTime.sum | 각 개별 레코드가 `match` 구성 옵션의 패턴과 일치시키는 데 걸리는 총 시간(밀리초)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| grokProcessingTime.max | 각 개별 레코드가 `match` 구성 옵션의 패턴과 일치시키는 데 걸리는 최대 시간(밀리초)입니다.<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 

## Otel 추적 원시 지표
<a name="oteltrace-raw-metrics"></a>

다음 지표는 [OTel 추적 원시](https://docs.opensearch.org/latest/data-prepper/pipelines/configuration/processors/otel-traces/) 프로세서에 적용됩니다. 각 지표 앞에는 하위 파이프라인 이름 및 `otel_trace_raw`(이)가 붙습니다. 예를 들어 `{{sub_pipeline_name}}.otel_trace_raw.traceGroupCacheCount.value`입니다.


| 지표 접미사 | 설명 | 
| --- | --- | 
| traceGroupCacheCount.value | 추적 그룹 캐시의 추적 그룹 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| spanSetCount.value | 스팬 세트 컬렉션의 스팬 세트 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 

## Otel 추적 그룹 지표
<a name="oteltracegroup-metrics"></a>

다음 지표는 [OTel 추적 그룹](https://github.com/opensearch-project/data-prepper/tree/main/data-prepper-plugins/otel-trace-group-processor) 프로세서에 적용됩니다. 각 지표 앞에는 하위 파이프라인 이름 및 `otel_trace_group`(이)가 붙습니다. 예를 들어 `{{sub_pipeline_name}}.otel_trace_group.recordsInMissingTraceGroup.count`입니다.


| 지표 접미사 | 설명 | 
| --- | --- | 
| recordsInMissingTraceGroup.count | 추적 그룹 필드가 누락된 수신 레코드 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| recordsOutFixedTraceGroup.count | 추적 그룹 필드가 성공적으로 채워진 수신 레코드의 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| recordsOutMissingTraceGroup.count | 추적 그룹 필드가 누락된 송신 레코드 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 

## 서비스 맵 스테이트풀 메트릭
<a name="servicemapstateful-metrics"></a>

다음 지표는 [Service-Map 상태 저장](https://docs.opensearch.org/latest/data-prepper/common-use-cases/trace-analytics/) 프로세서에 적용됩니다. 각 지표 앞에는 하위 파이프라인 이름 및 `service-map-stateful`(이)가 붙습니다. 예를 들어 `{{sub_pipeline_name}}.service-map-stateful.spansDbSize.count`입니다.


| 지표 접미사 | 설명 | 
| --- | --- | 
| spansDbSize.value | 현재 및 이전 지속 기간에 대한 MapDB 내 스팬의 메모리 바이트 크기입니다.<br />**관련 통계**: Average<br />**차원**: `PipelineName` | 
| traceGroupDbSize.value | 현재 및 이전 지속 기간에 대한 MapDB 내 추적 그룹의 메모리 바이트 크기입니다.<br />**관련 통계**: Average<br />**차원**: `PipelineName` | 
| spansDbCount.value | 현재 및 이전 지속 기간에 대한 MapDB 내 스팬의 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| traceGroupDbCount.value | 현재 및 이전 지속 기간에 대한 MapDB의 추적 그룹 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| relationshipCount.value | 현재 및 이전 지속 기간 동안 저장된 관계 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 

## OpenSearch 지표
<a name="opensearch-metrics"></a>

다음 지표는 [OpenSearch](https://opensearch.org/docs/latest/data-prepper/pipelines/configuration/sinks/opensearch/) 싱크에 적용됩니다. 각 지표 앞에는 하위 파이프라인 이름 및 `opensearch`(이)가 붙습니다. 예를 들어 `{{sub_pipeline_name}}.opensearch.bulkRequestErrors.count`입니다.


| 지표 접미사 | 설명 | 
| --- | --- | 
| bulkRequestErrors.count | 대량 요청을 보내는 동안 발생한 총 오류 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| documentsSuccess.count | 대량 요청을 통해 OpenSearch Service에 성공적으로 전송된 문서 수(재시도 포함)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| documentsSuccessFirstAttempt.count | 첫 시도에 대량 요청을 통해 OpenSearch Service에 성공적으로 전송된 문서 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| documentErrors.count | 대량 요청으로 전송하지 못한 문서 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| bulkRequestFailed.count | 실패한 대량 요청 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| bulkRequestNumberOfRetries.count | 대량 복원 요청의 수.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| bulkBadRequestErrors.count | 대량 요청을 보내는 동안 발생한 `Bad Request` 오류 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| bulkRequestNotAllowedErrors.count | 대량 요청을 보내는 동안 발생한 `Request Not Allowed` 오류 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| bulkRequestInvalidInputErrors.count | 대량 요청을 보내는 동안 발생한 `Invalid Input` 오류 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| bulkRequestNotFoundErrors.count | 대량 요청을 보내는 동안 발생한 `Request Not Found` 오류 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| bulkRequestTimeoutErrors.count | 대량 요청을 보내는 동안 발생한 `Request Timeout` 오류 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| bulkRequestServerErrors.count | 대량 요청을 보내는 동안 발생한 `Server Error` 오류 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| bulkRequestSizeBytes.count | 대량 요청의 페이로드 크기 분포 수(바이트)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| bulkRequestSizeBytes.sum | 대량 요청의 페이로드 크기 분포 총 수(바이트)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| bulkRequestSizeBytes.max | 대량 요청의 페이로드 크기 분포 최대 수(바이트)입니다.<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 
| bulkRequestLatency.count | 재시도를 포함하여 요청이 플러그인으로 전송되는 동안 기록된 데이터 포인트 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| bulkRequestLatency.sum | 재시도를 포함하여 플러그인으로 전송된 요청의 총 지연 시간(밀리초)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| bulkRequestLatency.max | 재시도를 포함하여 플러그인으로 전송된 요청의 최대 지연 시간(밀리초)입니다.<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 
| s3.dlqS3RecordsSuccess.count | S3 DLQ(Dead Letter Queue)로 성공적으로 전송된 레코드 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| s3.dlqS3RecordsFailed.count | S3 DLQ(Dead Letter Queue)로 전송되지 못한 레코드 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| s3.dlqS3RequestSuccess.count | S3 DLQ(Dead Letter Queue)에 성공한 요청 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| s3.dlqS3RequestFailed.count | S3 DLQ(Dead Letter Queue)에 실패한 요청 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| s3.dlqS3RequestLatency.count | 재시도를 포함하여 요청이 S3 DLQ(Dead Letter Queue)로 전송되는 동안 기록된 데이터 포인트 수입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| s3.dlqS3RequestLatency.sum | 재시도를 포함하여 S3 DLQ(Dead Letter Queue)로 전송된 요청의 총 지연 시간(밀리초)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| s3.dlqS3RequestLatency.max | 재시도를 포함하여 S3 DLQ(Dead Letter Queue)로 전송된 요청의 최대 지연 시간(밀리초)입니다.<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 
| s3.dlqS3RequestSizeBytes.count | S3 DLQ(Dead Letter Queue)에 대한 요청의 페이로드 크기 분포 수(바이트)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| s3.dlqS3RequestSizeBytes.sum | S3 DLQ(Dead Letter Queue)에 대한 요청의 총 페이로드 크기의 총 분포(바이트)입니다.<br />**관련 통계**: 합계<br />**차원**: `PipelineName` | 
| s3.dlqS3RequestSizeBytes.max | S3 DLQ(Dead Letter Queue)에 대한 요청의 최대 페이로드 크기 분포(바이트)입니다.<br />**관련 통계**: 최대<br />**차원**: `PipelineName` | 

## 시스템 및 측정 지표
<a name="systemmetering-metrics"></a>

다음 지표는 전체 OpenSearch Ingestion 시스템에 적용됩니다. 이러한 지표 앞에는 아무 것도 붙지 않습니다.


| 지표 | 설명 | 
| --- | --- | 
| system.cpu.usage.value | 모든 데이터 노드의 사용 가능한 CPU 사용률입니다.<br />**관련 통계**: Average<br />**차원**: `PipelineName`, `area`, `id`  | 
| system.cpu.count.value | 모든 데이터 노드의 총 CPU 사용량입니다.<br />**관련 통계**: Average<br />**차원**: `PipelineName`, `area`, `id`  | 
| jvm.memory.max.value | 메모리 관리에 사용할 수 있는 최대 메모리 용량(바이트)입니다.<br />**관련 통계**: Average<br />**차원**: `PipelineName`, `area`, `id`  | 
| jvm.memory.used.value | 사용된 총 메모리 용량(바이트).<br />**관련 통계**: Average<br />**차원**: `PipelineName`, `area`, `id`signa | 
| jvm.memory.committed.value | Java 가상 머신(JVM)에서 사용하기 위해 커밋된 메모리의 용량(바이트)입니다.<br />**관련 통계**: Average<br />**차원**: `PipelineName`, `area`, `id`  | 
| computeUnits | 파이프라인에서 사용 중인 Ingestion OpenSearch Compute Units (Ingestion OCUs)의 수입니다.<br />**관련 통계**: Maximum, Sum, Average<br />**차원**: `PipelineName` |