대시보드 검색 및 검사하기
대시보드 검색 및 검사하기 (Search and inspect dashboards)
이 문서에서는 Grafana MCP 서버를 사용해 AI 어시스턴트가 대시보드를 검색하고 검사(요약, 패널 쿼리, 특정 속성)할 수 있게 하는 방법을 알아봐요. 전체 대시보드 JSON을 가져오지 않으므로 컨텍스트 창 사용을 제어할 수 있어요.
출처: 문서
본문
달성할 목표 (What you'll achieve)
어시스턴트에게 대시보드를 찾거나, 대시보드를 요약하거나, 패널과 쿼리를 나열하거나, 특정 필드를 추출하도록 요청해요. 어시스턴트는 상황에 맞게 검색(search), 요약 가져오기(get summary), 패널 쿼리 가져오기(get panel queries), 속성 가져오기(get property) 도구를 사용해요.
시작하기 전에 (Before you begin)
- 설정 구성
dashboards:read
대시보드 검색 (Search for dashboards)
어시스턴트에게 제목, 폴더, 태그, 또는 별표(starred) 상태로 대시보드를 검색하도록 요청해요. 서버의 검색 도구는 메타데이터와 함께 일치하는 대시보드를 반환해요. 원하는 대시보드의 UID나 폴더를 찾는 데 사용해요.
대시보드 요약 또는 패널 쿼리 가져오기 (Get a dashboard summary or panel queries)
전체 JSON 없이 대시보드 개요가 필요할 때 dashboard summary를 요청해요. 제목, 패널 수, 패널 유형, 변수, 그 외 유사한 메타데이터를 받아요. 각 패널이 무엇을 쿼리하는지 보려면 panel queries를 요청해요. 어시스턴트는 모든 패널에 대해 패널 제목, 쿼리 문자열, 데이터소스 UID와 유형을 반환하는 도구를 사용해요.
JSONPath로 특정 속성 가져오기 (Get specific properties with JSONPath)
대시보드의 특정 부분만 필요할 때(예: 패널 하나의 설정) 어시스턴트에게 JSONPath 표현식(예: $.panels[0].title)과 함께 get_dashboard_property를 사용하도록 요청해요. 그러면 요청한 데이터만 가져오고 전체 대시보드를 로드하지 않아요.
이전 대시보드 버전 검사 (Inspect a previous dashboard version)
대시보드가 이전 저장 시점에 어떻게 보였는지 보려면 먼저 해당 버전을 나열해요. 서버는 전체 JSON이 아닌 컴팩트한 메타데이터(버전 번호, 작성자, 타임스탬프, 저장 메시지)만 반환해요. 그런 다음 해당 버전 번호와 함께 대시보드를 UID로 요청해요. version을 생략하면 여전히 현재 대시보드를 반환해요.
다음 단계 (Next steps)
- Grafana로 딥링크 생성하기
- 알림 규칙 관리하기