Grafana Cloud

Grafana Cloud를 연결하면 에이전트가 대시보드를 읽고, 데이터소스를 질의하고, Grafana 알림을 검사할 수 있습니다.

설정

1. Grafana Cloud 포털에서 https://yourstack.grafana.net 같은 스택 URL을 확인합니다.
2. Grafana 스택에서 Administration → Users and access → Service accounts를 엽니다.
3. Editor 역할로 서비스 계정을 만듭니다. Editor는 에이전트가 대시보드를 읽고, 데이터소스를 질의하고, 주석을 만들 수 있게 하며, Polylane이 Grafana 경보를 구독할 수 있게 합니다.
4. 서비스 계정에 토큰을 추가하고 두 값을 Polylane에 붙여 넣습니다. Polylane이 스택에 대해 이를 검증하고 연결합니다.

토큰은 저장 전에 암호화되며 에이전트는 이를 절대 보지 못합니다.

Grafana Cloud 무료 티어 스택은 비활성 상태가 지속되면 휴면합니다. 검증에서 스택에 접근할 수 없다고 보고하면, 브라우저에서 스택을 한 번 열고 다시 시도하세요.

경보와 지속적인 모니터링

연결 시 Polylane은 스택에 웹훅 연락 지점을 프로비저닝하고 알림 정책 트리에 모든 경보를 잡는 라우트를 추가합니다. 이 라우트는 모든 경보와 일치하고 기존 라우트로 계속 이어지므로, 현재의 전달은 그대로 유지되고, 나중에 만드는 경보 규칙도 자동으로 Polylane에 알립니다. 발생한 경보는 워크스페이스에 도착하여 트리아지되고 조사를 시작할 수 있습니다.

Polylane은 또한 모든 대시보드를 읽고 각 패널 질의를 이상 검사로 지속적으로 실행하며, 대시보드가 놓치는 신호에 대한 핵심 질의를 찾아냅니다.

에이전트가 할 수 있는 것

• 대시보드 검색과 패널 정의 및 질의 읽기
• 데이터소스 나열과 헬스 체크 실행
• Grafana의 질의 프록시를 통해 PromQL, LogQL, TraceQL 및 다른 데이터소스 네이티브 질의 실행
• 경보 규칙, 그 실시간 상태와 상태 정보, 지금 발생 중인 경보 검사
• 차트 주석 읽기, 그리고 배포와 인시던트 기간에 대한 새 주석 만들기

연결 해제

Polylane에서 Grafana Cloud의 연결을 해제하세요. 프로비저닝한 연락 지점과 알림 정책 라우트가 제거됩니다. 그 다음 Grafana에서 서비스 계정 토큰을 삭제하세요. 라우트가 Terraform에 있으면 동시에 제거하세요.

시간별 조정 작업이 polylane 연락 지점과 그 캐치올 정책 라우트를 유지합니다. grafana_notification_policy 리소스는 정책 트리 전체를 관리하므로, 라우트를 생략한 Terraform apply는 이를 제거하고 조정 작업이 다시 추가합니다. 라우트를 트리의 첫 정책으로 두고, 자신의 라우트도 계속 모든 것을 받도록 continue = true를 설정하고, 연락 지점 자체는 Polylane에 맡기세요:

resource "grafana_notification_policy" "tree" {
  # ...

  policy {
    contact_point = "polylane"
    continue      = true
  }

  # your existing routes follow
}

경보 규칙에는 규칙별 설정이 필요하지 않습니다: 라우트가 모든 경보와 일치합니다. 통합의 연결을 해제하면 연락 지점과 라우트가 제거되므로, 동시에 Terraform 구성에서도 라우트를 제거하세요.