View a markdown version of this page

스크레이퍼 구성 - Amazon CloudWatch
지원되는 구성 섹션구성의 예제한 사항문제 해결

스크레이퍼 구성

Amazon CloudWatch 관리형 Prometheus 수집기는 Prometheus 호환 YAML 구성을 사용하여 수집기가 지표를 스크레이핑하는 방법을 정의합니다. 스크레이퍼를 생성하거나 업데이트할 때 이 구성을 base64로 인코딩된 BLOB으로 제공합니다. 구성은 표준 Prometheus 스크레이프 구성 형식을 사용하며 관리형 수집기에 특정한 몇 가지 제한 사항이 있습니다.

GetDefaultScraperConfiguration을 사용하여 범용 스크레이퍼 구성을 검색하거나 직접 제공할 수 있습니다.

지원되는 구성 섹션

Prometheus 스크레이프 구성의 다음 최상위 섹션이 지원됩니다.

  • global - scrape_interval, scrape_timeout 및 external_labels를 포함한 글로발 설정입니다.

  • scrape_configs - 스크레이프 작업 목록으로, 각각 대상 및 스크레이프 방법을 정의합니다.

각 scrape_configs 항목 내에서 다음 필드가 지원됩니다.

  • job_name - 스크레이프 작업의 고유한 이름입니다.

  • metrics_path - 스크레이핑할 HTTP 경로(기본값은 /metrics)입니다.

  • scheme - 프로토콜 스키마(http 또는 https)입니다.

  • scrape_interval - 글로벌 스크레이프 간격의 작업별 재정의입니다.

  • scrape_timeout - 글로벌 스크레이프 제한 시간의 작업별 재정의입니다.

  • static_configs - 대상의 정적 목록입니다.

  • dns_sd_configs - DNS 기반 서비스 검색입니다.

  • relabel_configs - 스크레이핑 전에 적용되는 레이블 재지정 규칙입니다.

  • metric_relabel_configs - 스크레이핑 후에 적용되는 레이블 재지정 규칙입니다.

  • tls_config - HTTPS 대상에 대한 TLS 구성입니다.

구성의 예

다음 예제에서는 기본 스크레이프 구성을 보여줍니다.

global:
  scrape_interval: 60s
  scrape_timeout: 10s
  external_labels:
    environment: production

scrape_configs:
  - job_name: 'my-service'
    metrics_path: /metrics
    scheme: http
    static_configs:
      - targets:
          - '10.0.1.10:9090'
          - '10.0.1.11:9090'
        labels:
          team: platform
    relabel_configs:
      - source_labels: [__address__]
        target_label: instance
    metric_relabel_configs:
      - source_labels: [__name__]
        regex: 'go_.*'
        action: drop

제한 사항

  • 최소 scrape_interval은 30초입니다.

  • 관리형 수집기는 파일 기반 서비스 검색(file_sd_configs)을 지원하지 않습니다.

  • 관리형 수집기는 Consul, Eureka 또는 기타 외부 서비스 검색 메커니즘을 지원하지 않습니다.

  • 수집기는 CloudWatch로의 전송을 처리하기 때문에 원격 쓰기 및 원격 읽기 구성은 적용되지 않습니다.

  • 최대 구성 크기는 256KB입니다.

문제 해결

스크레이퍼가 예상대로 지표를 수집하지 않는 경우 다음을 확인합니다.

  • 스크레이퍼에 연결된 보안 그룹이 대상 포트로의 아웃바운드 트래픽을 허용하는지 확인합니다.

  • 스크레이퍼 구성에서 지정한 서브넷에서 대상에 도달 가능한지 확인합니다.

  • dns_sd_configs에 사용된 DNS 이름이 VPC 내에서 올바르게 확인되는지 확인합니다.

  • 대상이 유효한 Prometheus 표시 형식을 사용하여 구성된 metrics_path에서 응답하는지 확인합니다.

추가 문제 해결 지침은 Amazon Managed Service for Prometheus 사용 설명서의 Troubleshooting managed collectors를 참조하세요.