대시보드 링크 관리

링크를 사용해 자주 사용하는 대시보드 사이를 탐색하거나 다른 사람을 내 시각화로 연결할 수 있어요. 링크는 다른 대시보드, 패널, 심지어 외부 웹사이트에 대한 바로가기를 만들 수 있게 해줍니다. Grafana는 대시보드 링크, 패널 링크, 데이터 링크를 지원해요.

출처: 문서

본문

링크로 자주 사용하는 대시보드 사이를 탐색하거나 다른 사람을 시각화로 연결할 수 있습니다. Grafana는 대시보드 링크, 패널 링크, 데이터 링크를 지원합니다. 대시보드 링크는 대시보드 상단에 표시되고, 패널 링크는 패널 제목 옆 아이콘을 클릭해 접근할 수 있어요.

현재 대시보드 사이를 어떻게 탐색하는지부터 파악하세요. 자주 한 대시보드 집합을 오가며 각각 같은 컨텍스트를 찾는 데 어려움을 겪고 있다면 링크가 워크플로우 최적화에 도움이 됩니다. 그 다음 워크플로우에 맞는 링크 유형을 정하세요:

  • 링크가 대시보드의 대부분(전부는 아니더라도) 패널과 관련된다면 dashboard links 사용.
  • 특정 패널로 드릴다운하려면 panel links 사용.
  • 외부 사이트로 링크하려면 dashboard link 또는 panel link 사용.
  • 특정 시리즈나 단일 측정값으로 드릴다운하려면 data links 사용.

URL로 시간 범위 제어 (Controlling time range using the URL)

패널·대시보드의 시간 범위를 제어하려면 대시보드 URL에 쿼리 매개변수를 제공할 수 있어요:

  • from - 시간 범위의 하한, ms epoch으로 지정
  • to - 시간 범위의 상한, ms epoch으로 지정
  • time 와 time.window - time-time.window/2 에서 time+time.window/2 까지의 시간 범위 정의. 두 매개변수 모두 ms로 지정. 예: ?time=1500000000000&time.window=10000 은 1499999995000~1500000005000의 10초 시간 범위가 됨

대시보드 링크를 만들 때 시간 범위와 현재 템플릿 변수를 포함해 다른 대시보드의 같은 컨텍스트로 바로 이동할 수 있어요. 이렇게 하면 링크를 보내는 사람이 올바른 데이터를 보고 있는지 걱정할 필요가 없어요. 다른 링크 유형은 Data link variables를 참고하세요. 대시보드 링크는 현재 대시보드 이름으로 GitHub 이슈 제출 같은 외부 시스템 바로가기로도 사용할 수 있어요. 대시보드 링크 예시는 Dashboard links with variables와 Prometheus repeat을 참고하세요.

대시보드 링크를 추가하면 대시보드 오른쪽 위에 나타납니다.

대시보드에 링크 추가 (Add links to dashboards):

  1. 링크하려는 대시보드에서 Edit 를 클릭합니다.
  2. 툴바에서 Dashboard options 아이콘을 클릭합니다.
  3. 사이드바에서 Settings 를 클릭합니다.
  4. Links 탭으로 이동한 뒤 Add dashboard link 를 클릭합니다. 기본 링크 유형은 Dashboards 입니다.
  5. With tags 드롭다운 목록에 입력한 태그가 있는 대시보드로만 연결하도록 태그를 입력합니다. 태그를 추가하지 않으면 Grafana는 모든 다른 대시보드에 대한 링크를 포함합니다.
  6. 링크 옵션 설정:
    • Show as dropdown – 많은 대시보드로 연결한다면 이 옵션을 선택하고 드롭다운에 선택적 제목을 추가합니다. 그렇지 않으면 Grafana가 대시보드 링크를 대시보드 상단에 나란히 표시합니다.
    • Include current time range – 링크에 대시보드 시간 범위를 포함하려면 선택. 사용자가 링크를 클릭하면 연결된 대시보드가 지정된 시간 범위로 열립니다. 예: https://play.grafana.org/d/000000010/annotations?orgId=1&from=now-3h&to=now
    • Include current template variable values – 링크에 현재 사용 중인 템플릿 변수를 쿼리 매개변수로 포함하려면 선택. 사용자가 링크를 클릭하면 연결된 대시보드의 일치하는 템플릿이 링크의 값으로 설정됩니다. 자세한 내용은 Dashboard URL variables 참고.
    • Open link in new tab – 새 탭이나 창에서 열리게 하려면 선택.
    • Show in controls menu – 대시보드 상단 대신 컨트롤 메뉴에 표시하려면 선택. 대시보드 컨트롤 메뉴는 대시보드 툴바의 버튼으로 나타납니다.
  7. Save 를 클릭합니다.
  8. (선택) 변경 사항 설명을 입력합니다.
  9. Save 를 클릭합니다.
  10. Back 및 Exit edit 을 클릭합니다.

팁: 대시보드를 떠나지 않고 링크를 추가하려면 대시보드 툴바의 Add new element 아이콘을 클릭하고 Link 를 선택하세요. 자세한 내용은 Dashboard controls 문서를 참고하세요.

대시보드에 URL 링크 추가 (Add a URL link to a dashboard):

  1. Edit → Dashboard options → Settings 로 이동.
  2. Links 탭에서 Add dashboard link 를 클릭.
  3. Type 드롭다운에서 Link 선택.
  4. URL 필드에 링크할 URL 입력. 대상에 따라 필드 값을 포함하고 싶을 수 있어요. 예: https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests
  5. Tooltip 필드에 사용자가 마우스를 올릴 때 표시할 툴팁 입력.
  6. Icon 드롭다운에서 링크와 함께 표시할 아이콘 선택.
  7. 링크 옵션 설정(URL 링크의 경우 기본적으로 활성화됨): Include current time range, Include current template variable values, Open link in new tab, Show in controls menu.
  8. Save 클릭 → (선택) 설명 입력 → Save → Back 및 Exit edit.

대시보드 링크 업데이트 (Update a dashboard link): Edit → Dashboard options → Settings → Links 탭에서 다음 중 하나를 수행합니다:

  • Edit(편집): 링크 이름을 클릭해 링크 설정 업데이트.
  • Duplicate(복제): 복제하려는 링크 옆의 복사 링크 아이콘 클릭.
  • Delete(삭제): 삭제하려는 링크 옆의 빨간 X 클릭 후 Delete.

그런 다음 Save → (선택) 설명 입력 → Save → Back 및 Exit edit.

각 패널은 자체 링크 집합을 가질 수 있으며, 패널 제목 뒤 대시보드 왼쪽 위에 표시됩니다. 대시보드, 패널, 외부 사이트 등 어떤 URL이든 연결할 수 있어요. Grafana에서 올바른 데이터에 확대되어 있도록 시간 범위를 제어할 수도 있습니다. 패널 제목 옆 아이콘을 클릭해 사용 가능한 패널 링크를 확인하세요.

패널 링크 추가 (Add a panel link):

  1. 링크를 추가할 패널의 아무 부분에 마우스를 올려 오른쪽 위에 작업 메뉴를 표시합니다.
  2. 메뉴를 클릭하고 Edit 를 선택합니다. (단축키: 패널 위에 마우스를 올리고 e 누르기)
  3. Panel options 섹션을 펼치고 Panel links 까지 스크롤합니다.
  4. Add link 를 클릭합니다.
  5. Title 을 입력합니다. UI에 표시될 사람이 읽을 수 있는 라벨이에요.
  6. 연결할 URL 을 입력합니다. 대시보드에 정의된 템플릿 변수도 추가할 수 있어요. URL 필드에서 Ctrl+Space 또는 Cmd+Space를 눌러 사용 가능한 변수를 확인하세요. 패널 링크에 템플릿 변수를 추가하면 관련 변수가 이미 설정된 올바른 컨텍스트로 사용자를 보냅니다. 시간 변수도 사용할 수 있어요: from, to, time·time.window.
  7. 새 탭에서 열리게 하려면 Open in new tab 을 선택합니다.
  8. Save 를 클릭해 변경을 저장하고 대화상자를 닫습니다.
  9. Save → (선택) 설명 입력 → Save → Back 및 Exit edit.

패널 링크 업데이트: Edit → Panel options → Panel links 로 이동해 변경할 링크를 찾고 Edit(연필) 아이콘을 클릭해 Edit link 창을 엽니다. 필요에 따라 변경하고 Save → Save → Back 및 Exit edit.

패널 링크 삭제: Edit → Panel options → Panel links 로 이동해 삭제할 링크를 찾고 옆의 X 아이콘을 클릭합니다. 그런 다음 Save → Save → Back 및 Exit edit.

더 알아보기 (Learn more)