import-export-print-snapshot.mdx 4.9 KB

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