Link Search Menu Expand Document Documentation Menu

This version of the OpenSearch documentation is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.

Reporting

You can use OpenSearch Dashboards to create PNG, PDF, and CSV reports. To create reports, you must have the correct permissions. For a summary of the predefined roles and the permissions they grant, see the security plugin.

CSV reports have a non-configurable 10,000 row limit. They have no explicit size limit (e.g. in MB), but extremely large documents could cause report generation to fail with an out of memory error from the V8 JavaScript engine.

Create reports from Discovery, Visualize, or Dashboard

Quickly generate an on-demand report from the current view.

  1. From the top menu bar, choose Reporting.
  2. For dashboards or visualizations, choose Download PDF or Download PNG. From the Discover page, choose Download CSV.

    Reports generate asynchronously in the background and might take a few minutes, depending on the size of the report. A notification appears when your report is ready to download.

  3. To create a schedule-based report, choose Create report definition. Then proceed to Create reports using a definition. This option pre-fills many of the fields for you based on the visualization, dashboard, or data you were viewing.

Create reports using a definition

Definitions let you generate reports on a periodic schedule.

  1. From the navigation panel, choose Reporting.
  2. Choose Create.
  3. Under Report settings, enter a name and optional description for your report.
  4. Choose the Report Source (i.e. the page from which the report is generated). You can generate reports from the Dashboard, Visualize, or Discover pages.
  5. Select your dashboard, visualization, or saved search. Then choose a time range for the report.
  6. Choose an appropriate file format for the report.
  7. (Optional) Add a header or footer to the report. Headers and footers are only available for dashboard or visualization reports.
  8. Under Report trigger, choose either On-demand or Schedule.

    For scheduled reports, select either Recurring or Cron based. You can receive reports daily or at some other time interval. Cron expressions give you even more flexiblity. See Cron expression reference for more information.

  9. Choose Create.

Troubleshooting

Chromium fails to launch with OpenSearch Dashboards

While creating a report for dashboards or visualizations, you might see a the following error:

OpenSearch Dashboards reporting pop-up error message

This problem can occur for two reasons:

  • You don’t have the correct version of headless-chrome to match the operating system on which OpenSearch Dashboards is running. Download the correct version here.

  • You’re missing additional dependencies. Install the required dependencies for your operating system from the additional libraries section.