Grafana 딥링크 생성

Grafana MCP 서버를 사용해 AI 어시스턴트가 대시보드, 패널, Grafana Explore에 대한 올바른 딥링크 URL을 생성하도록 할 수 있어요. 서버는 Grafana API로 URL을 만들어서, 추측한 경로 대신 동작하는 링크를 얻을 수 있어요.

출처: 문서

본문

달성할 내용

어시스턴트에게 대시보드 링크, 특정 패널 링크, 또는 지정한 데이터소스(및 선택적 시간 범위)가 있는 Explore 링크를 요청해요. 어시스턴트는 서버의 딥링크 도구를 사용해 열거나 공유할 수 있는 URL을 반환해요.

시작하기 전에

  • 서버가 Grafana에 접근하도록 설정되고 구성되어 있어야 해요.
  • 링크 생성에는 추가 RBAC가 필요 없어요(읽기 전용 URL 생성).

대시보드 및 패널 링크 가져오기

어시스턴트에게 UID로 대시보드 링크를, 또는 특정 패널(대시보드 UID와 패널 ID) 링크를 생성하라고 요청해요. 시간 범위(예: 지난 1시간)를 요청하면 링크가 해당 범위로 열려요. 어시스턴트는 서버 도구를 사용해 http://localhost:3000/d/<uid>?viewPanel=<id>&from=now-1h&to=now 같은 URL을 반환해요.

Explore 링크 가져오기

특정 데이터소스(UID로)가 있는 Grafana Explore 링크를 요청해요. 선택적으로 시간 범위나 기타 쿼리 파라미터를 지정할 수 있어요. 어시스턴트는 해당 데이터소스와 옵션이 미리 채워진 상태로 Explore를 여는 URL을 반환해요.

긴 링크 줄이기

Explore 링크는 인코딩된 left 상태를 포함하면 길어질 수 있어요. 어시스턴트에게 shorten=true로 generate_deeplink를 호출하라고 요청해요. 서버는 Grafana의 POST /api/short-urls 엔드포인트를 시도하고 간결한 /goto/<uid> URL을 반환해요. 단축이 불가능하면 전체 딥링크를 대신 반환해요.

다음 단계