메트릭 수집¶

Guance 메트릭 수집은 DataKit(데이터 수집기)을 기반으로 구현되며, 표준화된 파이프라인 모델을 따릅니다.

DataKit 배포¶

DataKit 설치¶

다음 두 가지 설치 방식을 지원합니다.

수집기 구성¶

DataKit 표준 설정을 통해 메트릭 수집을 구현하며, 핵심 프로세스는 네 단계로 구성됩니다.

구성 템플릿 생성: 대상 수집기 구성 디렉터리(예: /usr/local/datakit/conf.d/mysql/)로 이동하여 공식 제공 .conf.sample 템플릿 파일을 .conf 확장자의 활성 구성 파일로 복사합니다.
핵심 매개변수 편집: 구성 파일에서 기본 연결(예: MySQL의 host), 수집 정책(예: 간격 시간 interval), 비즈니스 태그를 정의합니다.
재시작 후 적용: datakit --restart를 실행하여 구성을 로드하고, 로그 키워드(예: mysql collector started) 및 datakit monitor 명령어로 상태를 확인합니다.
인프라스트럭처, 미들웨어, 커스텀 메트릭 등 다양한 시나리오로 확장합니다.

자세한 구성 단계는 수집기 구성을 참조하세요.

커스텀 메트릭 수집¶

DataKit을 통한 메트릭 데이터 수집 외에도 Prometheus 생태계, HTTP API 푸시, Graphite/StatsD 프로토콜 수신, Telegraf/Kafka 파이프라인 전송, SQL 쿼리 생성, Python 스크립트 확장 등 다차원적인 방식을 통해 인프라스트럭처, 미들웨어 및 비즈니스 계층의 커스텀 메트릭을 수집할 수 있습니다.

Prometheus데이터 파이프라인확장 수집기타

Prometheus exporter 메트릭 연동
Prometheus Remote Write 수집기로 메트릭 직접 푸시
Prometheus push gateway 수집기를 통해 메트릭 푸시

DataKit HTTP API를 통해 메트릭 데이터 쓰기
Kafkamq 수집기를 통해 Kafka에서 메트릭 데이터 수집
Telegraf에서 푸시된 데이터 수신

데이터베이스 수집기에서 커스텀 SQL(custom_queries)을 통해 메트릭 연동 (MySQL 예시)
커스텀 Python 스크립트를 통해 데이터 수집
Kubernetes에서 Prometheus exporter 메트릭 수집

Graphite 수집기를 통해 커스텀 메트릭 데이터 수신
Statsd에서 푸시된 메트릭 데이터 수신

태그 규칙¶

동적 태그 금지(예: user_id, ip), 정적 비즈니스 태그(env, project)만 사용합니다.
글로벌 태그(datakit.conf):

[global_tags]  
cluster = "k8s-01"  
region = "cn-east"

데이터 검증¶

콘솔: 경로: 메트릭 > 탐색기 > 메저먼트 이름(예: mysql) 입력 후 데이터 연속성 확인.
명령줄 디버깅: 자세한 내용은 수집기 구성 디버깅을 참조하세요.