> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiderx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 모니터링: Prometheus Exporter 연동

<img src="https://mintcdn.com/aiderx/tjHtaiAN__Ai-ZM-/images/monitoring-metrics/a2_monitoring-min.png?fit=max&auto=format&n=tjHtaiAN__Ai-ZM-&q=85&s=d6d896f865be4dc9af2df9cdc1f3952c" alt="image" width="2536" height="852" data-path="images/monitoring-metrics/a2_monitoring-min.png" />

## A2 모니터링 기능 안내: Prometheus Exporter 연동

A2 플랫폼은 [Prometheus](https://prometheus.io) Exporter 기능을 통해 실시간 모니터링 지표를 제공합니다. Prometheus를 사용하면 대시보드나 알림 설정을 통해 주요 성능 지표를 손쉽게 조회하고 관리할 수 있으며, 이를 통해 플랫폼의 상태를 지속적으로 모니터링할 수 있습니다. A2의 Prometheus Exporter는 기본적으로 `29100` 포트에서 작동합니다.

### 네임스페이스별 모니터링 지표

A2에서 제공하는 모니터링 지표는 네임스페이스로 구분되며, 각 네임스페이스는 서로 다른 유형의 로그 및 상태 정보를 제공합니다.

#### 광고 및 서비스 이벤트 로그

광고 및 서비스 이벤트와 관련된 지표는 다음 두 네임스페이스를 통해 확인할 수 있습니다:

**ad\_log**: 광고 송출, 노출, 클릭, 전환과 같은 광고 활동 관련 데이터를 기록하는 네임스페이스입니다. 광고 캠페인의 성과를 모니터링할 때 유용한 지표입니다.

**event\_log**: 서비스 이벤트 로그를 기반으로 한 지표로, 사용자 활동(예: 페이지 뷰, 구매, 좋아요, 장바구니 담기) 데이터를 포함합니다. 서비스 이용자의 행동을 분석하는 데 활용할 수 있습니다.

#### 내부 모듈(ADM, DSP, Edge) 상태 모니터링

A2의 ADM, DSP, Edge와 같은 내부 모듈에 대한 상태와 성능 지표는 다음 네임스페이스를 통해 제공됩니다:

**a2\_stats**: Edge의 평균 응답 시간, 광고 송출량, 광고 요청량 등 A2 내부 모듈의 성능 데이터를 나타내는 네임스페이스입니다. 메트릭 이름은 `a2_stats_*` 형식으로 구성되며, 시스템의 성능과 효율성을 확인하는 데 유용합니다.

**a2\_error**: HTTP 오류, 내부 처리 오류 등 시스템 에러 정보를 제공하는 네임스페이스입니다. 발생하는 에러의 상태를 파악하고 문제 해결에 도움을 줄 수 있는 지표입니다.

### Prometheus 지표 활용하기

Prometheus를 통해 수집된 데이터는 실시간으로 조회가 가능하며, 쿼리를 통해 각 네임스페이스에 속하는 메트릭을 확인할 수 있습니다. 예를 들어 `a2_stats_edge:req_total`은 Edge 모듈의 총 요청 수를 나타내는 지표이며, `a2_error_edge:http_total`은 Edge 모듈에서 발생한 HTTP 오류의 총합을 보여줍니다.

***

A2의 모니터링 기능은 필요에 따라 선택적으로 사용할 수 있으며, 시스템 운영에 필요한 데이터를 유연하게 제공하므로 상황에 맞게 활용해 보세요.
