대시보드와 패널 공유

대시보드와 패널 공유 (Share dashboards and panels)

Grafana는 조직 내 다른 사용자와, 특정 상황에서는 웹에 공개적으로 대시보드와 패널을 공유할 수 있게 해 줘요. 직접 링크, 스냅샷(snapshot), 임베드(embed), PDF, PNG, JSON 파일, 보고서(report), 라이브러리 패널 등 여러 방법으로 공유할 수 있답니다.

출처: Share dashboards and panels

본문

직접 링크로 렌더링된 이미지를 보려면 인가된 viewer 권한이 필요해요. 임베드된 링크를 보려면 Grafana 인스턴스에 익명 접근 권한이 활성화되어 있지 않으면 같은 권한이 필요해요.

참고: 익명 접근 권한은 Grafana Cloud에서 사용할 수 없어요. 이 기능은 Grafana Enterprise와 Grafana Open Source에서만 지원돼요.

대시보드 공유 (Share dashboards)

대시보드를 공유하는 방법은 여러 가지예요.

  • 내부적으로 링크로
  • 외부적으로 누구나 또는 특정 사람에게
  • 보고서로
  • 스냅샷으로
  • PDF 내보내기로
  • JSON 파일 내보내기로
  • 이미지 내보내기로

대시보드를 링크나 이메일로 외부 공유하면 그 대시보드는 공유 대시보드 목록에 포함돼요. 이 목록을 보고 관리하려면 Dashboards > Shared dashboards로 이동해요.

참고: 대시보드를 변경했다면 공유 전에 변경 사항을 저장했는지 확인하세요.

내부 링크 공유 (Share an internal link):

  1. 메인 메뉴에서 Dashboards를 클릭해요.
  2. 공유할 대시보드를 클릭해요.
  3. 오른쪽 상단의 Share 드롭다운 목록을 클릭하고 Share internally를 선택해요.
  4. (선택) 열린 Share internally 서랍에서 다음 옵션을 설정해요.
    • Lock time range — 현재 상대 시간 범위를 절대 시간 범위로 변경(기본 활성화).
    • Shorten link — 대시보드 링크 단축(기본 활성화).
    • 대시보드 테마 선택(Current, Dark, Light).
  5. Copy link를 클릭해요.
  6. 링크를 볼 권한이 있는 Grafana 사용자에게 복사한 링크를 보내요.

빠른 내부 링크 공유 (Quick-share an internal link): 커스텀 내부 링크를 만든 뒤 Share 버튼(드롭다운 아이콘 아님)을 클릭하면 단축 링크가 복사돼요. 이 링크에는 이전에 설정한 시간 범위 잠금이나 테마 같은 커스터마이즈가 포함돼요.

외부 링크 공유 (Share an external link): 외부 공유 대시보드는 누구와도 Grafana 대시보드를 공유할 수 있게 해 줘요. 조직 접근 없이도 세계에 대시보드를 공개하고 싶을 때 유용해요. 설정·관리 방법은 Externally shared dashboards 문서를 참고하세요.

보고서 예약 (Schedule a report):

참고: Grafana Enterprise에서만 사용 가능해요.

  1. 메인 메뉴에서 Dashboards를 클릭하고 공유할 대시보드를 열어요.
  2. Share 드롭다운 목록을 클릭하고 Schedule a report를 선택해요.
  3. 보고서를 구성해요. 스케줄 설정에 따라 옵션이 달라져요. Schedule send 또는 Send now를 클릭해요. 보고서를 초안으로 저장할 수도 있어요.
  4. 보고서 관리는 Dashboards > Reporting > Reports로 이동해요.

스냅샷 공유 (Share a snapshot):

대시보드 스냅샷은 쿼리와 패널 링크 같은 민감한 데이터를 제거하고 보이는 메트릭과 시리즈 이름만 남겨 대시보드를 공개적으로 공유해요. 링크가 있는 사람은 누구나 스냅샷에 접근할 수 있어요. 스냅샷은 로컬 인스턴스나 snapshots.raintank.io에 게시할 수 있어요. 후자는 Grafana Labs가 제공하는 무료 서비스로, 대시보드 스냅샷을 외부 Grafana 인스턴스에 게시하게 해 줘요. 특정 시간 후 제거하려면 만료 시간을 설정할 수 있어요.

참고: snapshots.raintank.io 옵션은 Grafana Cloud에서 기본적으로 비활성화돼 있어요. 구성 파일을 업데이트해 활성화할 수 있어요.

조직에서 공유된 다른 스냅샷을 보려면 메인 메뉴의 Dashboards > Snapshots로 이동해요.

  1. 메인 메뉴에서 Dashboards를 클릭하고 공유할 대시보드를 열어요.
  2. Share 드롭다운 목록을 클릭하고 Share snapshot을 선택해요.
  3. 열린 Share snapshot 서랍의 Snapshot name 필드에 설명 제목을 입력해요.
  4. 스냅샷의 만료 옵션을 선택해요: 1 Hour, 1 Day, 1 Week, Never.
  5. Publish snapshot 또는 Publish to snapshots.raintank.io를 클릭해요. Grafana가 스냅샷 링크를 생성해요. 커스텀 패널이 포함된 대시보드 스냅샷은 snapshot.raintank.io에 게시할 수 없어요.
  6. Copy link를 클릭해 조직 내부 또는 웹에 공개적으로 공유해요.

스냅샷 삭제 (Delete a snapshot):

  1. Dashboards > Snapshots로 이동해요.
  2. 삭제할 스냅샷인지 확인하려면 스냅샷 행에서 View를 클릭해요. 같은 대시보드의 패널·대시보드 스냅샷 URL은 비슷해 보이므로 먼저 보면 구분할 수 있어요.
  3. 삭제할 스냅샷 옆의 빨간 x를 클릭해요.
  4. 스냅샷은 즉시 삭제돼요. 확인은 브라우저 캐시를 지우거나 시크릿 브라우저를 사용해야 할 수 있어요.

대시보드 내보내기 (Export dashboards)

링크, 보고서, 스냅샷으로 공유하는 것 외에 PDF나 JSON 파일로 내보낼 수 있어요.

대시보드를 PDF로 내보내기:

참고: Grafana Enterprise에서만 사용 가능해요.

  1. 메인 메뉴에서 Dashboards를 클릭하고 내보낼 대시보드를 열어요.
  2. 도구 모음의 Export 드롭다운을 클릭하고 Export as PDF를 선택해요.
  3. 열린 Export dashboard PDF 서랍에서 PDF 방향을 Landscape 또는 Portrait로 선택해요.
  4. PDF 레이아웃을 Grid 또는 Simple로 선택해요.
  5. Zoom 레벨을 설정해 텍스트를 확대하거나 패널당 더 많은 데이터를 보려면 축소해요.
  6. Generate PDF를 클릭해요. PDF가 다른 탭에서 열려 다운로드할 수 있어요.

대시보드를 코드로 내보내기 (Export a dashboard as code):

레이아웃, 변수, 스타일, 데이터 소스, 쿼리 등 필요한 모든 것을 포함하는 Grafana JSON 파일을 내보내 나중에 대시보드를 가져올 수 있어요.

  1. 메인 메뉴에서 Dashboards를 클릭하고 내보낼 대시보드를 열어요.
  2. 도구 모음에서 Export 아이콘을 클릭하고 Export as code를 선택해요.
  3. Export dashboard 서랍이 열려요.
  4. (선택) Advanced options를 클릭하고 다음을 선택해요.
    • Model: Classic 또는 V2 Resource 선택.
    • Format: V2 Resource만 해당, JSON 또는 YAML 선택.
  5. (선택) Share dashboard with another instance 토글을 켜면 Grafana 인스턴스 특유의 세부 사항을 제거해요.
  6. Download file 또는 Copy to clipboard를 클릭해요.
  7. JSON을 다른 위치에 붙여 넣어요.

참고: 대시보드를 Grafana 커뮤니티 카탈로그에 게시하려면 Classic 모델로 내보내야 해요.

대시보드를 이미지로 내보내기:

참고: 이미지로 내보내려면 Grafana Image Renderer 서비스가 구성되어 있어야 해요.

  1. 메인 메뉴에서 Dashboards를 클릭하고 내보낼 대시보드를 열어요.
  2. 도구 모음의 Export 드롭다운을 클릭하고 Export as image를 선택해요.
  3. Export as image 서랍이 열려요.
  4. Generate image를 클릭해요. 이미지 미리보기가 표시돼요.
  5. Download image를 클릭해요.
  6. 생성된 이미지는 브라우저에서 대시보드가 보이는 모습을 반영해요. 변경하려면 대시보드나 브라우저를 줌 인/아웃하거나 크기를 조정해요.

커뮤니티 대시보드 게시 (Publish a community dashboard):

대시보드를 Grafana 커뮤니티 카탈로그에 게시해 공개 공유할 수 있어요. 게시된 대시보드는 누구나 발견하고 가져올 수 있어요.

  1. Classic 모델로 대시보드를 내보내요.
  2. Grafana로 이동해 Grafana Cloud 계정에 로그인해요.
  3. My dashboards로 이동해 Upload dashboard를 클릭해요.
  4. Grafana에서 내보낸 Classic JSON 파일을 업로드해요.
  5. 필수 메타데이터 필드를 채운 뒤 Save and Publish를 클릭해요.
  6. 게시 후에는 카탈로그에 Submit 버튼이 표시돼요. 클릭하면 스크린샷, 로고, README 콘텐츠를 포함한 메타데이터 변경을 저장하고 게시해요.

패널 공유 (Share panels)

패널 공유 방법은 내부 링크, 임베드, 스냅샷이에요. 패널 변경 시 공유 전 저장을 확인하세요.

내부 링크 공유:

  1. 공유할 패널의 아무 부분 위에 마우스를 올려 오른쪽 상단의 작업 메뉴를 표시해요.
  2. 메뉴를 클릭하고 Share link를 선택해요.
  3. (선택) Link settings 서랍에서 옵션을 설정해요.
    • Lock time range — 현재 상대 시간 범위를 절대 시간 범위로 변경(기본 활성화).
    • Shorten link — 패널 링크 단축(기본 비활성화).
    • 테마 선택(Current, Dark, Light).
  4. Copy link를 클릭해요.
  5. 링크를 볼 권한이 있는 Grafana 사용자에게 보내요.
  6. (선택) 패널을 PNG로 생성하려면 이미지 설정을 커스터마이즈해요.
    • Width — 픽셀. 기본·최소 1000.
    • Height — 픽셀. 기본·최소 500.
    • Scale factor — 기본 1.
  7. (선택) Generate image를 클릭해 미리보기를 보고, (선택) Download image를 클릭해요.

서버 측 렌더링 이미지의 쿼리 문자열 파라미터:

패널 링크 설정에서 Generate image를 클릭하면 Grafana가 다음 기본 파라미터로 패널의 PNG를 생성해요.

파라미터 설명
width 픽셀 단위. 기본·최소 1000.
height 픽셀 단위. 기본·최소 500.
tz UTC%2BHH%3AMM 형식의 시간대(HH·MM은 UTC 이후 오프셋).
timeout 초 단위. 패널 쿼리가 기본 30초 이상 필요하면 시간 초과 증가 가능.
scale 장치 스케일 팩터 설정용 숫자 값. 기본 1. 더 상세한 이미지(고DPI)를 원하면 높은 값 사용.

참고: 이미지 렌더러는 너비 1000px, 높이 500px 최소 크기를 적용해요. 자체 관리 Grafana에서는 이미지 렌더러 구성으로 이 최소값을 커스터마이즈할 수 있어요. Grafana Cloud에서는 구성이 Grafana가 관리하므로 수정할 수 없어요. API로 이미지를 렌더링할 때 크기 관련 오류가 발생하면 크기가 최소 요구사항을 충족하는지 확인하세요.

서버 측 렌더링 PNG 링크 예시:

https://play.grafana.org/render/d-solo/ktMs4D6Mk?from=2024-09-03T11:55:44.442Z&to=2024-09-03T17:55:44.442Z&panelId=panel-13&width=1000&height=500&tz=UTC

임베드 공유 (Share an embed):

iframe으로 패널을 다른 웹사이트에 임베드할 수 있어요. Grafana 익명 접근 권한이 활성화되어 있지 않으면 사용자가 패널을 보려면 Grafana에 로그인해야 해요.

참고: 패널 임베딩과 익명 접근 권한은 Grafana Cloud에서 사용할 수 없어요. 외부 공유 대시보드의 패널에서도 마찬가지에요. 이 기능은 Grafana Enterprise와 오픈소스에서만 지원돼요.

  1. 공유할 패널 위에 마우스를 올려 작업 메뉴를 표시하고 Share embed를 선택해요.
  2. Share embed 서랍이 열려요.
  3. (선택) Lock time range 스위치로 현재 상대·절대 시간 범위를 설정해요(기본 활성화).
  4. 테마를 선택해요.
  5. (선택) HTML을 필요에 따라 변경해요.
  6. Copy to clipboard를 클릭해 웹사이트 코드에 붙여 넣어요.

결과는 iframe에 임베드된 인터랙티브 Grafana 시각화예요.

패널 스냅샷 공유:

패널 스냅샷은 쿼리와 패널 링크 같은 민감한 데이터를 제거하고 보이는 메트릭과 시리즈 이름만 남겨 인터랙티브 패널을 공개적으로 공유해요. 링크가 있는 사람은 누구나 접근할 수 있어요. 로컬 인스턴스나 snapshots.raintank.io에 게시할 수 있고, 만료 시간을 설정할 수 있어요.

참고: snapshots.raintank.io는 Grafana Cloud에서 기본 비활성화. 구성 파일로 활성화 가능.

  1. 공유할 패널 위에 마우스를 올려 메뉴를 표시하고 Share snapshot을 선택해요.
  2. Share snapshot 서랍에서 Snapshot name에 설명 제목을 입력해요.
  3. 만료 옵션(1 Hour, 1 Day, 1 Week, Never)을 선택해요.
  4. Publish snapshot 또는 Publish to snapshots.raintank.io를 클릭해요. 커스텀 패널이 포함된 스냅샷은 snapshot.raintank.io에 게시할 수 없어요.
  5. Copy link를 클릭해 공유해요.

패널 스냅샷 삭제: Dashboards > Snapshots로 이동해 삭제할 스냅샷을 확인한 뒤(View 클릭) 빨간 x를 클릭해 삭제해요.

더 알아보기 (Learn more)