메인 콘텐츠로 건너뛰기
Prometheus 호환 모니터링 백엔드를 연결하여 CloudThinker 에이전트가 PromQL 쿼리를 실행하고, 메트릭과 레이블을 검색하며, 스크레이프 타겟 상태를 검사하고, 활성 알림을 상관 분석할 수 있도록 합니다 — 모두 읽기 전용입니다.
커넥터는 표준 Prometheus HTTP API를 지원하는 모든 백엔드와 작동합니다: 자체 호스팅 Prometheus, Thanos, VictoriaMetrics, Grafana Cloud. 인증은 없음, Bearer Token, Basic Auth를 지원합니다.

​
지원 플랫폼

매니지드 Mimir 기반 엔드포인트(Grafana Cloud)에서는 /api/v1/targets, /rules, /alerts 경로가 노출되지 않아 404를 반환합니다. 이는 예상된 동작입니다 — 쿼리 API(즉시 쿼리, 범위 쿼리, 레이블, 메타데이터)는 정상적으로 작동합니다.

​
사전 요구 사항

  • CloudThinker에서 HTTPS로 접근 가능한 Prometheus 호환 엔드포인트 — 자체 호스팅 Prometheus, Thanos, VictoriaMetrics, 또는 Grafana Cloud.
  • 엔드포인트에 인증이 필요한 경우 자격 증명: bearer 토큰(Bearer Token 모드) 또는 사용자 이름과 비밀번호(Basic Auth 모드).
  • Grafana Cloud의 경우, 숫자 인스턴스 ID와 metrics:read 범위가 있는 액세스 정책 토큰.

​
인증 모드 선택

엔드포인트 노출 방식에 맞는 모드를 선택하세요:
Grafana Cloud의 경우, 사용자 이름은 숫자 인스턴스 ID이고 비밀번호는 metrics read 범위가 있는 액세스 정책 토큰입니다.

​
설정

1

Prometheus URL 확인

Prometheus HTTP API의 기본 URL을 확인합니다(예: https://prometheus.your-domain.com 또는 Grafana Cloud Prometheus 쿼리 엔드포인트). CloudThinker가 표준 /api/v1/... 경로를 자동으로 추가합니다.
2

자격 증명 준비 (필요한 경우)

  • 없음 — 준비할 것이 없습니다. 엔드포인트에 인증 없이 접근 가능합니다.
  • Bearer Token — 프록시 또는 게이트웨이가 기대하는 bearer 토큰을 준비합니다.
  • Basic Auth — 사용자 이름과 비밀번호를 준비합니다 (Grafana Cloud의 경우, 숫자 인스턴스 ID와 액세스 정책 토큰).
3

CloudThinker에 연결 추가

Connections → Prometheus로 이동하여 다음을 입력합니다:
  • PROMETHEUS_URL: 엔드포인트 (예: https://prometheus.your-domain.com)
  • PROMETHEUS_AUTH_TYPE: 없음, Bearer Token, 또는 Basic Auth 선택
선택에 따라 자격 증명 필드가 표시됩니다:
  • Bearer Token → PROMETHEUS_TOKEN
  • Basic Auth → PROMETHEUS_USERNAME 및 PROMETHEUS_PASSWORD
Connect를 클릭합니다. CloudThinker가 엔드포인트를 확인하고 Connected 상태를 표시합니다.

​
연결 세부 정보

​
필요 권한

Prometheus 커넥터는 읽기 전용입니다 — 에이전트가 쿼리하고 검사하지만 모니터링 백엔드에 쓰지 않습니다.
  • Grafana Cloud의 경우, metrics:read 범위만 있는 액세스 정책 토큰을 생성합니다.
  • 보호된 엔드포인트의 경우, 자격 증명이 쿼리, 레이블, 타겟, 규칙, 알림 API 경로에 접근할 수 있는지 확인합니다.
Grafana Cloud에서는 액세스 정책 토큰을 metrics:read 범위로만 지정하세요 — CloudThinker에 다른 범위는 필요하지 않습니다.

​
에이전트 기능

Prometheus 커넥터는 읽기 전용입니다 — 에이전트가 쿼리하고 검사하지만 모니터링 백엔드를 수정하지 않습니다.

​
연결 확인

​
예시 프롬프트

Prometheus는 레이블 값 조회 도구를 제공하지 않습니다 — 레이블 열거는 레이블 이름만 반환합니다. 에이전트가 정확한 PromQL 셀렉터를 구성할 수 있도록 관심 있는 메트릭과 레이블을 명시하세요.

​
문제 해결

  • PROMETHEUS_AUTH_TYPE이 엔드포인트가 기대하는 것과 일치하는지 확인합니다.
  • Bearer의 경우, 토큰이 최신이고 취소되지 않았는지 확인합니다.
  • Basic의 경우, 사용자 이름/비밀번호를 확인합니다 — Grafana Cloud에서는 사용자 이름이 숫자 인스턴스 ID이고 비밀번호가 액세스 정책 토큰입니다.
  • 매니지드 Mimir 기반 엔드포인트(Grafana Cloud)에서 예상되는 동작 — 이러한 경로는 노출되지 않습니다.
  • 쿼리 API(즉시, 범위, 레이블, 메타데이터)는 여전히 작동합니다. 타겟/규칙 검사 대신 쿼리를 사용하세요.
  • PROMETHEUS_URL이 HTTPS를 통해 CloudThinker에서 접근 가능한지 확인합니다.
  • 자체 호스팅 또는 네트워크 제한 엔드포인트의 경우, CloudThinker에서 네트워크 경로가 있는지 확인합니다.
  • URL에서 후행 /api/v1을 제거하세요 — 기본 URL만 입력합니다.
  • 레이블로 분할하기 전에 검색 쿼리로 메트릭이 존재하는지 확인합니다.
  • 시간 창을 넓히세요 — 요청한 범위에 시리즈의 샘플이 없을 수 있습니다.

​
보안

  • 최소 권한 — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
  • 기본 읽기 전용 — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
  • 자격증명 교체 — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
  • 오프보딩 시 취소 — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.
  • 설계상 읽기 전용 — 커넥터는 모니터링 백엔드에 쓰지 않습니다. 쓰기 권한이 필요하지 않습니다.
  • 최소 권한 자격 증명 — Grafana Cloud에서는 액세스 정책 토큰을 metrics read 범위로만 지정합니다.

​
관련 항목

Grafana 연결

대시보드 및 통합 옵저버빌리티

Datadog 연결

로그 검색, 메트릭, 인프라 모니터링