﻿---
title: PDF/PNG
description: For more advice about common problems, refer to Troubleshooting. Reporting comes with a built-in utility to try to automatically find common issues. When...
url: https://www.elastic.co/elastic/docs-builder/docs/2970/explore-analyze/report-and-share/reporting-troubleshooting-pdf
products:
  - Kibana
applies_to:
  - Elastic Cloud Serverless: Unavailable
  - Elastic Stack: Generally available
---

# PDF/PNG
<note>
  We recommend using PNG/PDF reports to export moderate amounts of data only. The feature enables a high-level export capability, but it’s not intended for bulk export. If you need to export several pages of image data, consider using multiple report jobs to export a small number of pages at a time. If the screenshot of exported dashboard contains a large number of pixels, consider splitting the large dashboard into smaller artifacts to use less memory and CPU resources.For the most reliable configuration of PDF/PNG reporting features, consider installing Kibana using [Docker](https://www.elastic.co/elastic/docs-builder/docs/2970/deploy-manage/deploy/self-managed/install-kibana-with-docker) or using [Elastic Cloud](https://cloud.elastic.co).
</note>

For more advice about common problems, refer to [Troubleshooting](https://www.elastic.co/elastic/docs-builder/docs/2970/explore-analyze/report-and-share/reporting-troubleshooting).

## Reporting diagnostics

Reporting comes with a built-in utility to try to automatically find common issues. When Kibana is running, navigate to the **Report Listing** page, and click **Run reporting diagnostics**. This will open up a diagnostic tool that checks various parts of the Kibana deployment and comes up with any relevant recommendations.
If the diagnostic information doesn’t reveal the problem, you can troubleshoot further by starting the Kibana server with an environment variable for revealing additional debugging logs. Refer to [Puppeteer debug logs](#reporting-troubleshooting-puppeteer-debug-logs).

## Network security service libraries

You must install Network Security Service (NSS) libraries for reporting features to work. Reporting using the Chromium browser relies on these libraries. Install the appropriate nss package for your distribution. Refer to [Install the dependencies for the headless browser](/elastic/docs-builder/docs/2970/explore-analyze/report-and-share#install-reporting-packages).

## Chromium sandbox requirements

Chromium uses sandboxing techniques that are built on top of operating system primitives. The Linux sandbox depends on user namespaces, which were introduced with the 3.8 Linux kernel. However, many distributions don’t have user namespaces enabled by default or they require the CAP_SYS_ADMIN capability. If the sandbox is not explicitly disabled in Kibana, either based on operating system detection or with the `xpack.screenshotting.browser.chromium.disableSandbox` setting, Chrome will try to enable the sandbox. If it fails due to operating system or permissions restrictions, Chrome will crash during initialization.
Elastic recommends that you research the feasibility of enabling unprivileged user namespaces before disabling the sandbox. An exception is if you are running Kibana in Docker because the container runs in a user namespace with the built-in seccomp/bpf filters.

## Text rendered incorrectly in generated reports

If a report label is rendered as an empty rectangle, no system fonts are available. Install at least one font package on the system.
If the report is missing certain Chinese, Japanese or Korean characters, ensure that a system font with those characters is installed.

## Missing data in PDF report of data table visualization

There is currently a known limitation with the data table visualization that only the first page of data rows, which are the only data visible on the screen, are shown in PDF reports.

## Connection refused errors

If PDF or PNG reports are not working due to a "connection refused" or "unable to connect" type of error, ensure that the [`kibana.yml`](https://www.elastic.co/elastic/docs-builder/docs/2970/deploy-manage/stack-settings) file uses the setting of `server.host: 0.0.0.0`. Also verify that no firewall rules or other routing rules prevent local services from accessing this address. Find out more at [Set the `server.host` for the headless browser](/elastic/docs-builder/docs/2970/explore-analyze/report-and-share#set-reporting-server-host).

## File permissions

Ensure that the `headless_shell` binary located in your Kibana data directory is owned by the user who is running Kibana, that the user has the execute permission, and if applicable, that the filesystem is mounted with the `exec` option.
<note>
  The Chromium binary is located in the Kibana installation directory as `data/headless_shell-OS_TYPE/headless_shell`. The full path is logged the first time Kibana starts when verbose logging is enabled.
</note>


## Puppeteer debug logs

The Chromium browser that Kibana launches on the server is driven by a NodeJS library for Chromium called Puppeteer. The Puppeteer library has its own command-line method to generate its own debug logs, which can sometimes be helpful, particularly to figure out if a problem is caused by Kibana or Chromium. Learn more [debugging tips](https://github.com/GoogleChrome/puppeteer/blob/v1.19.0/README.md#debugging-tips).
Using Puppeteer’s debug method when launching Kibana would look like:
```
env DEBUG="puppeteer:*" ./bin/kibana
```

The internal DevTools protocol traffic will be logged via the `debug` module under the `puppeteer` namespace.
The Puppeteer logs are very verbose and could possibly contain sensitive information. Handle the generated output with care.

## System requirements

In Elastic Cloud, the Kibana instances that most configurations provide by default is for 1GB of RAM for the instance. That is enough for Kibana reporting features when the visualization or dashboard is relatively simple, such as a single pie chart or a dashboard with a few visualizations. However, certain visualization types incur more load than others. For example, a TSVB panel has a lot of network requests to render.
If the Kibana instance doesn’t have enough memory to run the report, the report fails with an error such as `Error: Page crashed!`. In this case, try increasing the memory for the Kibana instance to 2GB.

## Unable to connect to Elastic Maps Service

[Elastic Maps Service (EMS)](https://www.elastic.co/elastic-maps-service) is a service that hosts tile layers and vector shapes of administrative boundaries. If a report contains a map with a missing basemap layer or administrative boundary, the Kibana server does not have access to EMS. Refer to [*Connect to Elastic Maps Service*](https://www.elastic.co/elastic/docs-builder/docs/2970/explore-analyze/visualize/maps/maps-connect-to-ems) for information about how to connect your Kibana server to EMS.

## Manually install the Chromium browser for Darwin

Chromium is not embedded into Kibana for the Darwin (Mac OS) architecture. When running Kibana on Darwin, reporting features will download Chromium into the proper area of the Kibana installation path the first time the server starts. If the server does not have access to the internet, you must download the Chromium browser and install it into the Kibana installation path.
1. Download the Chromium zip file:
   - For [x64](https://commondatastorage.googleapis.com/chromium-browser-snapshots/Mac/901912/chrome-mac.zip) systems
- For [ARM](https://commondatastorage.googleapis.com/chromium-browser-snapshots/Mac_Arm/901913/chrome-mac.zip) systems
2. Copy the zip file into the holding area. Relative to the root directory of Kibana, the path is:
   - `.chromium/x64` for x64 systems
- `.chromium/arm64` for ARM systems

When Kibana starts, it will automatically extract the browser from the zip file and is then ready for PNG and PDF reports.