메트릭 수집기

메트릭 수집기은(는) 무엇을 하나요?

애플리케이션, 데이터베이스, 캐시 및 인프라의 성능 메트릭을 Prometheus, StatsD 또는 CloudWatch로 통합하고 중앙 집중화하여 일관된 명명 규칙을 적용합니다.

개요

이 기술은 Claude가 다양한 시스템의 메트릭을 통합된 뷰로 집계하여 성능 모니터링을 간소화할 수 있도록 지원합니다. 성능 데이터 수집, 중앙 집중화 및 분석 과정을 단순화하여 향상된 인사이트와 더 빠른 문제 해결을 가능하게 합니다.

작동 방식

1. 메트릭 분류 체계 설계: Claude는 모든 시스템에서 일관되고 명확한 메트릭 명명 규칙을 정의하는 데 도움을 줍니다.
2. 집계 도구 선택: Claude는 사용자 환경 및 요구 사항에 따라 적절한 메트릭 집계 도구(예: Prometheus, StatsD, CloudWatch)를 선택하도록 지원합니다.
3. 구성 및 통합: Claude는 선택한 집계 도구의 구성 및 다양한 데이터 소스와의 통합을 안내합니다.
4. 대시보드 및 알림 설정: Claude는 메트릭 시각화를 위한 대시보드 설정 및 중요한 성능 지표에 대한 알림 정의를 지원합니다.

이 기술을 사용해야 하는 경우

이 기술은 다음과 같은 경우에 활성화됩니다:

• 여러 애플리케이션 및 시스템의 성능 메트릭을 중앙 집중화해야 할 때
• 일관된 메트릭 명명 규칙을 설계해야 할 때
• 필요에 맞는 적절한 메트릭 집계 도구를 선택해야 할 때
• 성능 모니터링을 위한 대시보드 및 알림을 설정해야 할 때

예제

예제 1: 애플리케이션 및 시스템 메트릭 중앙 집중화

사용자 요청: "애플리케이션 및 시스템 메트릭을 Prometheus로 집계하세요."

기술이 수행하는 작업:

1. 애플리케이션 메트릭(예: 요청 지연 시간, 오류율) 및 시스템 메트릭(예: CPU 사용률, 메모리 사용률)을 정의하도록 안내합니다.
2. Prometheus가 애플리케이션 및 시스템 엔드포인트에서 메트릭을 스크랩하도록 구성하는 것을 지원합니다.

예제 2: 데이터베이스 성능 알림 설정

사용자 요청: "데이터베이스 메트릭을 중앙 집중화하고 느린 쿼리에 대한 알림을 설정하세요."

기술이 수행하는 작업:

1. 데이터베이스 성능 메트릭(예: 쿼리 실행 시간, 연결 풀 사용량)을 정의하도록 지원합니다.
2. 집계 도구가 데이터베이스에서 이러한 메트릭을 수집하도록 구성하는 방법을 안내합니다.
3. 쿼리 실행 시간이 정의된 임계값을 초과할 때 사용자에게 알리도록 집계 도구에 알림을 설정하는 것을 지원합니다.

모범 사례

• 명명 규칙: 모든 메트릭에 대해 일관되고 잘 정의된 명명 규칙을 사용하여 명확성과 분석 용이성을 보장합니다.
• 세분성: 세부 정보와 저장 요구 사항의 균형을 맞추기 위해 적절한 메트릭 세분성 수준을 선택합니다.
• 보존 정책: 저장 공간을 관리하고 기록 분석에 데이터를 사용할 수 있도록 메트릭 보존 정책을 정의합니다.

통합

이 기술은 인프라를 관리하고, 애플리케이션을 배포하며, 시스템 상태를 모니터링하는 다른 플러그인과 통합됩니다. 예를 들어, 새 애플리케이션 배포 후 메트릭 수집을 자동으로 구성하기 위해 배포 플러그인과 함께 사용할 수 있습니다.

전제 조건

• 메트릭 수집 도구(Prometheus, StatsD, CloudWatch)에 대한 액세스
• 메트릭 소스에 대한 네트워크 연결
• ${CLAUDE_SKILL_DIR}/metrics/에 메트릭 저장소 구성
• 메트릭 분류 체계에 대한 이해

지침

1. 일관된 메트릭 명명 규칙 설계
2. 환경에 적합한 집계 도구 선택
3. 모든 소스에서 메트릭 수집 구성
4. 중앙 집중식 저장소 및 보존 정책 설정
5. 시각화를 위한 대시보드 생성
6. 중요한 메트릭에 대한 알림 정의

출력

• 메트릭 집계 구성 파일
• 통합 명명 규칙 문서
• 주요 메트릭에 대한 대시보드 정의
• 성능 임계값에 대한 알림 규칙
• 메트릭 소스 통합 가이드

오류 처리

메트릭 집계가 실패한 경우:

• 소스에 대한 네트워크 연결 확인
• 인증 자격 증명 확인
• 메트릭 형식 호환성 검증
• 저장소 용량 및 보존 정책 검토
• 집계 도구 구성 확인

리소스

• Prometheus 집계 문서
• StatsD 프로토콜 사양
• CloudWatch 메트릭 API 참조
• 메트릭 명명 모범 사례