보고서 만들기 및 관리
보고서 만들기 및 관리 (Create and manage reports)
Reporting 기능은 대시보드에서 자동화·스케줄 된 이메일을 보내게 해 줘요. 보고서의 여러 요소를 구성하고 PDF와 CSV 파일을 생성할 수 있어요. 보고서에 사용된 대시보드를 변경하면 다음 보고서 전송 시 반영된답니다. (Grafana Enterprise/Cloud, 재설계된 기능은 공개 미리보기)
본문
참고: 재설계된 reporting 기능은 현재 공개 미리보기 상태예요. 사용하려면 구성 파일에서
newShareReportDrawerfeature toggle을 활성화하거나(Grafana Cloud는 Support에 문의), 한정된 지원과 일반 제공 전 호환성 변경이 있을 수 있어요.
요구사항 (Requirements)
Grafana Enterprise의 Reporting 기능 요구사항:
- 보고서 전송을 위해 SMTP가 구성되어야 해요. SMTP 구성 문서 참고.
- **Grafana image renderer 서비스**가 설정되어야 해요.
렌더링 구성 (Rendering configuration)
기본적으로 10MB보다 큰 첨부 파일(PDF, CSV, 임베드 이미지)은 전송되지 않아 이메일 서버가 거부하는 것을 방지해요. 이 한도는 reporting 구성에서 조정할 수 있어요. 보고서 파일이 생성되면 Grafana data 폴더의 해당 폴더(csv, pdf, png)에 임시로 기록돼요. 백그라운드 작업이 10분마다 실행되어 임시 파일을 제거해요. 파일이 제거되기 전 저장될 기간은 ini 파일의 temp_data_lifetime 설정으로 구성할 수 있어요.
접근 제어 (Access control)
기본적으로 조직 관리자만 보고서를 만들 수 있어요. RBAC로 누가 보고서를 만들 수 있는지 맞춤 설정할 수 있어요. RBAC가 활성화되면 보고서를 만들고 관리하려면 관련 권한이 필요해요.
보고서 만들기 (Create a report)
보고서 생성 과정은 다단계지만 순서대로 완료할 필요는 없어요. 초기 생성 중 언제라도 보고서를 초안(draft)으로 저장할 수 있어요. 대시보드에서 직접 또는 Reporting 페이지에서 만들 수 있어요.
대시보드에서 직접 만들기:
- 메인 메뉴에서 Dashboards를 클릭하고 보고서를 만들 대시보드로 이동해요.
- 대시보드 오른쪽 상단의 Share 드롭다운 목록을 클릭하고 Schedule report를 클릭해요.
- Schedule report 서랍이 열려요. 이 대시보드를 사용하는 다른 보고서가 서랍에 나열돼요. See all reports를 클릭해 모든 대시보드에서 생성된 보고서의 전체 목록을 보려면 Reporting으로 이동할 수도 있어요.
- + Create a new report를 클릭해요.
- 필요하면 보고서 이름을 업데이트해요. 기본적으로 보고서 이름은 대시보드 이름이에요.
- 필요에 따라 각 섹션을 펼쳐 완성해요: Dashboards, Schedule, Email settings, Recipients, Attachments.
- 하단에서 다음 버튼 중 하나를 클릭해요.
- 메뉴 아이콘: Download CSV, Preview PDF, Report settings(새 브라우저 탭에서 Reporting으로 이동해 조직 수준 보고서 설정 구성), Send preview(원하는 수신자에게 미리보기 전송) 옵션.
- Schedule report: 설정한 스케줄에 따라 보고서 전송.
- Save draft: 생성 과정 중 언제라도 초안 저장(필수 필드 누락 가능). 초안 상태에서 스케줄 전송은 되지 않음.
- 서랍 상단의 x를 스케줄링도 초안 저장도 안 하고 클릭하면 보고서가 폐기돼요. 되돌릴 수 없어요.
Reporting 페이지에서 만들기:
- 메인 메뉴에서 Dashboards > Reporting을 클릭해요.
- + Create a new report를 클릭해요.
- Schedule report 서랍이 열려요.
- 보고서 이름을 입력해요.
- 각 섹션(Dashboards, Schedule, Email settings, Recipients, Attachments)을 펼쳐 완성해요.
- 하단 버튼으로 스케줄 전송, 세부 옵션, 초안 저장을 처리해요.
1. Dashboards:
| 옵션 | 설명 |
|---|---|
| Source dashboard (필수) | 보고서를 생성할 대시보드 선택/업데이트. 대시보드에서 만들었다면 이 필드는 이미 현재 대시보드 이름으로 채워져 있음. |
| Time range | 보고서 시간 범위 업데이트. 대시보드에서 만들었다면 기본은 대시보드의 시간 범위, 아니면 기본은 Last 6 hours. |
| Customize template variables | 선택한 대시보드의 변수 값을 선택·커스터마이즈. 대시보드에 변수가 있을 때만 표시. |
| + Add dashboard | 보고서에 대시보드 더 추가. |
Time range 필드를 비워 두면 보고서는 대시보드의 저장된 시간 범위를 사용해요. 커스텀 시간 범위는 보고서 대시보드의 시간 범위를 덮어써요. Customize template variables로 보고서별 템플릿 변수를 구성할 수 있어요. 변수가 있는 쿼리 결과가 변하면 보고서에 저장된 쿼리 변수가 오래될 수 있어요(예: 호스트네임 목록을 쿼리할 때 새 호스트 추가). 이 경우 선택한 변수를 보고서에서 수동 업데이트해야 해요. 변수에 All 값을 선택하거나 대시보드의 원래 변수 선택을 유지하면 새 값이 추가될 때 보고서가 최신 상태를 유지해요.
2. Schedule:
| 옵션 | 설명 |
|---|---|
| Schedule | Send now는 저장 직후 보고서 전송(멈추려면 종료 날짜 추가). Send later는 나중 날짜에 스케줄(시작 날짜/시간/시간대 필요). |
| Frequency | 일회, 시간별, 일별, 주별, 월별 반복, 또는 커스텀 간격으로 전송 가능. |
| Start date / Start time / Time zone | 보고서 전송 시작 날짜·시간·시간대 설정. |
| End date | 보고서 전송 중단 날짜. 비워 두면 무기한 전송. |
| Send only from Monday to Friday | 시간별/일별 주파수 보고서를 월~금만 전송 가능. |
| Send on the last day of the month | 월별 주파수·시작 날짜가 29~31일이면 해당 날짜가 있는 달에만 전송. 매달 전송하려면 이 옵션 선택. |
Time zone: 보고서는 생성된 대시보드의 시간대를 사용해요. 대시보드를 특정 시간대로 설정해 보고서 시간대를 제어할 수 있어요(모든 사용자의 대시보드 표시에 영향을 줌). 대시보드가 Browser Time 설정이면 생성된 보고서는 Grafana 서버의 시간대를 사용하므로 보고서를 만들거나 받는 사용자와 다를 수 있어요. 특정 시간대를 원하면 Browser Time 대신 고정 시간대로 대시보드를 저장하세요.
3. Email settings:
| 옵션 | 설명 |
|---|---|
| Email subject | 비워 두면 보고서 이름이 메일 제목으로 사용. |
| Message | 보고서 이메일의 메시지 본문. |
| Reply-to-email address | 메일의 Reply to 필드에 표시되는 주소. |
| Include a dashboard link | 보고서 이메일에 대시보드 링크 포함. |
| Embed dashboard image | 보고서 이메일에 임베드된 대시보드 이미지와 함께 전송되므로 수신자가 한눈에 볼 수 있음. |
4. Recipients: 보고서를 받을 사람이거나 팀의 이메일 주소를 콤마 또는 세미콜론으로 구분해 입력해요.
5. Attachments: 하나 이상의 첨부 옵션 선택. 여러 개 선택 가능하지만 최소 하나는 선택해야 해요.
- Attach the report as a PDF — 하나의 PDF 파일로 첨부.
- Attach a separate PDF of table data — 선택한 대시보드의 각 테이블 패널에 대해 별도 PDF 파일 첨부(공개 미리보기 전용).
- Attach a CSV file of table panel data — 선택한 대시보드의 각 테이블 패널에 대한 CSV 파일 첨부.
PDF 형식:
| 옵션 | 설명 |
|---|---|
| Orientation | 보고서 방향을 Portrait 또는 Landscape로 설정. |
| Layout | Simple — 각 패널을 PDF 전체 너비로 렌더링. Grid — 소스 대시보드와 같은 패널 배열·너비로 렌더링. |
| Zoom | PDF에서 텍스트를 확대하거나 패널당 더 많은 데이터(테이블 열)를 보려면 축소. |
| Combine all dashboard PDFs in one file | 보고서에 여러 대시보드가 있을 때 하나의 PDF 생성(여러 대시보드일 때만 표시). |
| Show template variables | 대시보드 변수 표시(변수 포함 보고서에서만 표시). |
| Include table data as PDF appendix | 대시보드 PDF에 테이블 데이터 부록 추가(테이블 시각화에 대시보드 PDF에 표시할 수 있는 것보다 많은 데이터가 있을 때 유용, 공개 미리보기 전용). |
레이아웃과 방향:
| 레이아웃 | 방향 | 설명 |
|---|---|---|
| Simple | Portrait | 페이지당 3개 패널이 있는 A4 세로 페이지 생성. |
| Simple | Landscape | 페이지당 단일 패널이 있는 A4 가로 페이지 생성. |
| Grid | Portrait | 원래 대시보드와 같은 배열의 패널이 있는 A4 세로 페이지 생성. |
| Grid | Landscape | 원래 대시보드와 같은 배열의 패널이 있는 A4 가로 페이지 생성. |
PDF의 테이블 데이터:
참고: Grafana Image Renderer 서비스가 있는 Grafana Enterprise와 Grafana Cloud에서 공개 미리보기(
pdfTablesfeature toggle)로 사용 가능.
테이블 시각화에 대시보드 PDF에 표시할 수 있는 것보다 많은 데이터가 있을 때, 보고서에서 모든 테이블 시각화 데이터를 PDF로 접근하려면 두 옵션 중 하나를 선택할 수 있어요. Include table data as PDF appendix — 대시보드 PDF에 부록 추가. Attach a separate PDF of table data — 별도 PDF 파일 생성.
API로 보고서 보내기 (Send a report using the API)
HTTP API의 send report 엔드포인트로 프로그래밍 방식으로 보고서를 보낼 수 있어요.
보고서 관리 (Manage reports)
모든 보고서를 확인·관리하고 새로 만들려면 Reporting 페이지를 이용해요. 또는 어떤 대시보드에서든 그 대시보드에서 생성된 보고서를 보고 관리하고 새 보고서를 만들 수 있어요.
보고서 편집: Dashboards > Reporting으로 이동하거나 대시보드에서 Share > Schedule report를 열고, 업데이트할 보고서의 행을 클릭하고, 변경 후 Update report를 클릭해요.
보고서 일시 중지·재개: 보고서 목록 보기에서 보고서 행의 일시 중지 아이콘을 클릭하면 스케줄 전송이 중단되고, 재개 아이콘으로 이전 스케줄을 재개해요. Update report 서랍에서도 가능해요.
보고서 삭제: 보고서 행의 휴지통 아이콘을 클릭하고 Delete로 확인해요. 삭제는 되돌릴 수 없어요.
Reporting 트러블슈팅 (Troubleshoot Reporting)
구성 파일에서 디버그 로깅을 활성화해 트러블슈팅해요.
[log]
filters = rendering:debug,report.api:debug,report.render:debug,report.scheduler:debug,report.sender:debug,report.service:debug