Grafana

제공 도구 13

발신·파괴적 작업 등 되돌리기 어려운 도구는 실행 전 사용자 승인을 거칩니다.

• grafana__api_destructive파괴적승인 필요

  Grafana 공식 API destructive 작업 실행 — operation·입력 스키마는 grafana__operations 에서 조회한다. ⚠️ 삭제·권한·알림 설정과 데이터소스 질의는 되돌릴 수 없거나 별도 복구가 필요하다. input 에 작업별 path·query·header·body 를 넣는다. 결과: operation · status · data 또는 data_chunk · next_page · truncated. 조회 출력은 output_offset 으로 이어 읽는다.

• grafana__silence_alert파괴적승인 필요

  Grafana 알림 사일런스(침묵 창) 생성 — matchers 라벨 조건에 맞는 알림의 통지를 duration(기본 1h) 동안 멈춘다. ⚠️ 침묵 창 동안 누락된 통지는 복구할 수 없다. grafana__operations 에서 사일런스 조회·해제 operation 을 찾을 수 있다. matchers 는 grafana__list_alerts 결과 instances[].labels 에서 골라 [{"name":…,"value":…}] 로 바꿔 준다(빈 matchers 는 거부). 시각은 RFC3339·now·now-1h 형식만 — 못 읽으면 조용히 지금으로 바뀐다. 결과: silenced · silence_id · matchers · until.

• grafana__api_send발신승인 필요

  Grafana 공식 API send 작업 실행 — operation·입력 스키마는 grafana__operations 에서 조회한다. ⚠️ 알림·외부 호출이 전달될 수 있고 전달된 알림은 회수할 수 없다. 요청에 대상·본문이 다 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다(승인 카드엔 본문이 없다). input 에 작업별 path·query·header·body 를 넣는다. 결과: operation · status · data 또는 data_chunk · next_page · truncated. 조회 출력은 output_offset 으로 이어 읽는다.

• grafana__api_write쓰기

  Grafana 공식 API write 작업 실행 — operation·입력 스키마는 grafana__operations 에서 조회한다. input 에 작업별 path·query·header·body 를 넣는다. 결과: operation · status · data 또는 data_chunk · next_page · truncated. 조회 출력은 output_offset 으로 이어 읽는다.

• grafana__create_annotation쓰기

  애노테이션 생성 — 배포·점검 등 사건을 그래프 위에 남긴다(삭제로 되돌릴 수 있음)

• grafana__api_read읽기

  Grafana 공식 API read 작업 실행 — operation·입력 스키마는 grafana__operations 에서 조회한다. input 에 작업별 path·query·header·body 를 넣는다. 결과: operation · status · data 또는 data_chunk · next_page · truncated. 조회 출력은 output_offset 으로 이어 읽는다.

• grafana__get_dashboard읽기

  대시보드 상세 — 패널 목록과 각 패널의 질의식(PromQL/LogQL/SQL). 여기서 얻은 질의를 grafana__query_metrics 로 재실행할 수 있다

• grafana__list_alerts읽기

  알림 규칙과 현재 상태 — 기본은 발생 중(firing)만. 결과: 규칙마다 rule · state · folder · group · summary · instances[](labels · since · value, 정상이 아닌 것 5개까지) — labels 가 grafana__silence_alert 의 matchers 재료다.

• grafana__list_datasources읽기

  데이터소스 목록(uid·이름·타입) — 질의 툴에 넘길 데이터소스를 여기서 고른다

• grafana__operations읽기

  Search the fixed Grafana operation registry (legacy /api + /apis). Pass operation to get its exact path/query/header/body schema, required RBAC, limitations and fixed tool. Search examples: silences, dashboards, queryMetrics, folders. Never invent an operation ID.

• grafana__query_logs읽기

  Loki 데이터소스에 LogQL 질의 — 최신 로그부터 반환. 장애 원인 진단에 쓴다

• grafana__query_metrics읽기

  Prometheus 호환 데이터소스에 PromQL 질의. start 를 주면 구간 질의(계열별 요약+샘플), 없으면 현재값

• grafana__search_dashboards읽기

  대시보드 검색 — 다른 Grafana 툴에 쓸 uid 를 여기서 확보한다

연동 준비

1. Use a Grafana instance service-account token (glsa_), not a Grafana Cloud access-policy token (glc_). Viewer permits authorized reads; grant Editor/Admin or explicit RBAC actions and resource scopes for writes. Enterprise/Cloud APIs also require the applicable plan and feature flags. Basic-only global admin/user APIs are unavailable. On 403 grant the service account the required RBAC action/scope; on 401 reissue the token and reconnect. Grafana uses api_key authentication, not OAuth: no OAuth scope migration or re-consent can elevate an existing token. This catalog update grants no permissions. SQL/data-source queries, alert suppression/configuration, permission changes and deletions require approval.