import-export-print-snapshot.mdx 4.3 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283
  1. ---
  2. title: "Import, export, and print a snapshot"
  3. description: "Snapshots can be incredibly useful for diagnosing anomalies after they've already happened, and are interoperable with any other node running Netdata."
  4. type: how-to
  5. custom_edit_url: https://github.com/netdata/netdata/edit/master/docs/dashboard/import-export-print-snapshot.mdx
  6. ---
  7. # Import, export, and print snapshots
  8. Netdata can export snapshots of the contents of your dashboard at a given time, which you can then import into any other
  9. node running Netdata. Or, you can create a print-ready version of your dashboard to save to PDF or actually print to
  10. paper.
  11. Snapshots can be incredibly useful for diagnosing anomalies after they've already happened. Let's say Netdata triggered
  12. a warning alarm while you were asleep. In the morning, you can [pick the
  13. timeframe](/docs/dashboard/visualization-date-and-time-controls.mdx) when the alarm triggered, export a snapshot, and send it to a
  14. colleague for further analysis.
  15. Or, send the Netdata team a snapshot of your dashboard when [filing a bug
  16. report](https://github.com/netdata/netdata/issues/new?assignees=&labels=bug%2Cneeds+triage&template=BUG_REPORT.yml) on
  17. GitHub.
  18. ![The export, import, and print
  19. buttons](https://user-images.githubusercontent.com/1153921/114218399-360fb600-991e-11eb-8dea-fabd2bffc5b3.gif)
  20. ## Import a snapshot
  21. To import a snapshot, click on the **import** icon ![Import
  22. icon](https://raw.githubusercontent.com/netdata/netdata-ui/98e31799c1ec0983f433537ff16d2ac2b0d994aa/src/components/icon/assets/upload.svg)
  23. in the top panel.
  24. Select the Netdata snapshot file to import. Once the file is loaded, the modal updates with information about the
  25. snapshot and the system from which it was taken. Click **Import** to begin to process.
  26. Netdata takes the data embedded inside the snapshot and re-creates a static replica on your dashboard. When the import
  27. finishes, you're free to move around and examine the charts.
  28. Some caveats and tips to keep in mind:
  29. - Only metrics in the export timeframe are available to you. If you zoom out or pan through time, you'll see the
  30. beginning and end of the snapshot.
  31. - Charts won't update with new information, as you're looking at a static replica, not the live dashboard.
  32. - The import is only temporary. Reload your browser tab to return to your node's real-time dashboard.
  33. ## Export a snapshot
  34. To export a snapshot, first pan/zoom any chart to an appropriate _visible timeframe_. The export snapshot will only
  35. contain the metrics you see in charts, so choose the most relevant timeframe.
  36. Next, click on the **export** icon ![Export
  37. icon](https://raw.githubusercontent.com/netdata/netdata-ui/98e31799c1ec0983f433537ff16d2ac2b0d994aa/src/components/icon/assets/download.svg)
  38. in the top panel.
  39. Select the metrics resolution to export. The default is 1-second, equal to how often Netdata collects and stores
  40. metrics. Lowering the resolution will reduce the number of data points, and thus the snapshot's overall size.
  41. Edit the snapshot file name and select your desired compression method. Click on **Export**. When the export is
  42. complete, your browser will prompt you to save the `.snapshot` file to your machine.
  43. ## Print a snapshot
  44. To print a snapshot, click on the **print** icon ![Import
  45. icon](https://raw.githubusercontent.com/netdata/netdata-ui/98e31799c1ec0983f433537ff16d2ac2b0d994aa/src/components/icon/assets/print.svg)
  46. in the top panel.
  47. When you click **Print**, Netdata opens a new window to render every chart. This might take some time. When finished,
  48. Netdata opens a browser print dialog for you to save to PDF or print.
  49. ## What's next?
  50. Now that you understand snapshots, now is a good time to delve deeper into some of the dashboard's lesser-known
  51. features, such as [customization](/docs/dashboard/customize.mdx) or [building new, custom
  52. dashboards](/web/gui/custom/README.md).
  53. ### Further reading & related information
  54. - Dashboard
  55. - [How the dashboard works](/docs/dashboard/how-dashboard-works.mdx)
  56. - [Interact with charts](/docs/dashboard/interact-charts.mdx)
  57. - [Chart dimensions, contexts, and families](/docs/dashboard/dimensions-contexts-families.mdx)
  58. - [Select timeframes to visualize](/docs/dashboard/visualization-date-and-time-controls.mdx)
  59. - **[Import, export, and print a snapshot](/docs/dashboard/import-export-print-snapshot.mdx)**
  60. - [Customize the standard dashboard](/docs/dashboard/customize.mdx)