diff --git a/docs/sources/dashboards/share-dashboards-panels/_index.md b/docs/sources/dashboards/share-dashboards-panels/_index.md index ef8e67c1bb0..b9d84b58ab6 100644 --- a/docs/sources/dashboards/share-dashboards-panels/_index.md +++ b/docs/sources/dashboards/share-dashboards-panels/_index.md @@ -52,6 +52,21 @@ refs: destination: /docs/grafana//setup-grafana/image-rendering/#configuration - pattern: /docs/grafana-cloud/ destination: /docs/grafana//setup-grafana/image-rendering/#configuration + max-width: + - pattern: /docs/grafana/ + destination: /docs/grafana//setup-grafana/image-rendering/#viewport-maximum-width + - pattern: /docs/grafana-cloud/ + destination: /docs/grafana//setup-grafana/image-rendering/#viewport-maximum-width + max-height: + - pattern: /docs/grafana/ + destination: /docs/grafana//setup-grafana/image-rendering/#viewport-maximum-height + - pattern: /docs/grafana-cloud/ + destination: /docs/grafana//setup-grafana/image-rendering/#viewport-maximum-height + max-scale: + - pattern: /docs/grafana/ + destination: /docs/grafana//setup-grafana/image-rendering/#maximum-device-scale-factor + - pattern: /docs/grafana-cloud/ + destination: /docs/grafana//setup-grafana/image-rendering/#maximum-device-scale-factor --- # Share dashboards and panels @@ -239,20 +254,29 @@ To share a personalized, direct link to your panel within your organization, fol - **Lock time range** - Change the current relative time range to an absolute time range. This option is enabled by default. - **Shorten link** - Shorten the panel link. This option is disabled by default. 1. Select the theme for the dashboard. Choose from **Current**, **Dark**, or **Light**. -1. Do one or both of the following: - - Click **Copy link**. - - Click **Render image**, which [renders the panel as a PNG image](ref:image-rendering). -1. Send the copied link or image URL to a Grafana user with authorization to view it. +1. Click **Copy link**. +1. Send the copied link to a Grafana user with authorization to view it. +1. (Optional) To [generate an image of the panel as a PNG file](ref:image-rendering), customize the image settings: + + - **Width** - In pixels. The default is 1000. + - **Height** - In pixels. The default is 500. + - **Scale factor** - The default is 1. + + There are maximums for [width](ref:max-width), [height](ref:max-height), and [scale factor](ref:max-scale) in the image renderer configuration that you can customize if needed. + +1. (Optional) Click **Generate image** to see a preview of the panel image. +1. (Optional) Click **Download image**. +1. Send the copied image to a Grafana user with authorization to view it. 1. Click the **X** at the top-right corner to close the share drawer. #### Query string parameters for server-side rendered images -When you click **Render image** in the panel link settings, Grafana generates a PNG image of the panel with the following default parameters: +When you click **Generate image** in the panel link settings, Grafana generates a PNG image of the panel with the following default parameters: | Parameter | Description | | --------- | ------------------------------------------------------------------------------------------------------------------------------ | -| width | Width in pixels. Default is 800. | -| height | Height in pixels. Default is 400. | +| width | Width in pixels. Default is 1000. | +| height | Height in pixels. Default is 500. | | tz | Timezone in the format `UTC%2BHH%3AMM` where HH and MM are offset in hours and minutes after UTC. | | timeout | Number of seconds. The timeout can be increased if the query for the panel needs more than the default 30 seconds. | | scale | Numeric value to configure device scale factor. Default is 1. Use a higher value to produce more detailed images (higher DPI). |