github-mirrors/kibana
1
0
Fork 0
mirror of https://github.com/elastic/kibana.git synced 2025-04-24 17:59:23 -04:00
Code Issues Projects Releases Packages Wiki Activity

[Docs] Update Sharing docs (#190318)

Browse source 
## Summary

This PR updates the docs regarding the **Share** menu in Kibana.

Note1: Please advise on the public URL/anonymous access feature. I'm not
sure whether it is still present nor under which form for the Link and
Embed sharing options.

Note2: @eokoneyo also has related updates in
https://github.com/elastic/kibana/pull/191067

![Reporting Getting
Started](https://github.com/user-attachments/assets/d2c123a2-b7db-4d5e-928f-79785409ff07)

Note: The step ordering for the last section in the screenshot has been
fixed in the source.

Closes: https://github.com/elastic/platform-docs-team/issues/355
This commit is contained in:
florent-leborgne 2024-09-23 11:31:03 +02:00 • committed by GitHub
parent dc9fb65041
commit 9e2ad98d06
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
3 changed files with 44 additions and 66 deletions
Download patch file Download diff file Expand all files Collapse all files

BIN
docs/user/reporting/images/embed-code-public-url.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 37 KiB

BIN
docs/user/reporting/images/permalink-public-url.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 24 KiB

110
docs/user/reporting/index.asciidoc
View file

@ -7,37 +7,40 @@
:frontmatter-description: {kib} provides you with several options to share *Discover* saved searches, dashboards, *Visualize Library* visualizations, and *Canvas* workpads with others, or on a website.
:frontmatter-tags-products: [kibana]
{kib} provides you with several options to share *Discover* saved searches, dashboards, *Visualize Library* visualizations, and *Canvas* workpads.
{kib} provides you with several options to share *Discover* saved searches, dashboards, *Visualize Library* visualizations, and *Canvas* workpads. These sharing options are available from the *Share* menu in the toolbar.
You access the options from the *Share* menu in the toolbar. The sharing options include the following:
[float]
[[share-a-direct-link]]
== Share with a direct link
* *PDF Reports* — Generate and download PDF files of dashboards, visualizations, and *Canvas* workpads. PDF reports are a link:https://www.elastic.co/subscriptions[subscription feature].
You can share direct links to saved searches, dashboards, and visualizations. When clicking **Share**, look for the **Links** tab to get the shareable link and copy it.
* *PNG Reports* — Generate and download PNG files of dashboards and visualizations. PNG reports are a link:https://www.elastic.co/subscriptions[subscription feature].
TIP: When sharing an object with unsaved changes, you get a temporary link that might break in the future, for example in case of upgrade. Save the object to get a permanent link instead.
To access the object shared with the link, users need to authenticate.
Anonymous users can also access the link if you have configured <<anonymous-authentication,Anonymous authentication>> and your anonymous service account has privileges to access what you want to share.
image::https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blt49f2b5a80ec89a34/66b9e919af508f4ac182c194/share-dashboard.gif[getting a shareable link for a dashboard]
[float]
[[manually-generate-reports]]
== Export as a file
NOTE: For more information on how to configure reporting in {kib}, refer to <<secure-reporting,Configure reporting in {kib}>>
Create and download PDF, PNG, or CSV reports of saved searches, dashboards, visualizations, and workpads.
* *PDF* &mdash; Generate and download PDF files of dashboards, visualizations, and *Canvas* workpads. PDF reports are a link:https://www.elastic.co/subscriptions[subscription feature].
* *PNG* &mdash; Generate and download PNG files of dashboards and visualizations. PNG reports are a link:https://www.elastic.co/subscriptions[subscription feature].
* *CSV Reports* &mdash; Generate CSV reports of saved searches. <<csv-limitations,Certain limitations apply>>.
* *CSV Download* &mdash; Generate and download CSV files of *Lens* visualizations.
* *Get links* &mdash; Share direct links to saved searches, dashboards, and visualizations.
* *Download as JSON* &mdash; Generate and download JSON files of *Canvas* workpads.
* beta[] *Share on a website* &mdash; Download and securely share *Canvas* workpads on any website.
* *Embed code* &mdash; Embed fully interactive dashboards as an iframe on web pages.
[[reporting-on-cloud-resource-requirements]]
NOTE: For Elastic Cloud deployments, {kib} instances require a minimum of 2GB RAM to generate PDF or PNG reports. To
change {kib} sizing, {ess-console}[edit the deployment].
For more information on how to configure reporting in {kib}, refer to <<secure-reporting,Configure reporting in {kib}>>
[float]
[[manually-generate-reports]]
== Create reports
Create and download PDF, PNG, or CSV reports of saved searches, dashboards, visualizations, and workpads.
[[reporting-layout-sizing]]
The layout and size of the report depends on what you are sharing.
@ -55,17 +58,19 @@ image::user/reporting/images/shareable-container.png["Shareable Container"]
. From the toolbar, click *Share*, then select the report option.
* If you are creating dashboard PDFs, select *Optimize for printing* to create printer-friendly PDFs with multiple A4 portrait pages and two visualizations per page.
* If you are creating dashboard PDFs, select *For printing* to create printer-friendly PDFs with multiple A4 portrait pages and two visualizations per page.
+
NOTE: When you create a dashboard report that includes a data table or saved search, the PDF includes only the visible data.
* If you are creating workpad PDFs, select *Full page layout* to create PDFs without margins that surround the workpad.
. Generate the report.
. Generate the report by clicking **Export file**, **Generate CSV**, or **Generate PDF**, depending on the object you want to export.
+
NOTE: You can use the *Copy POST URL* option instead to generate the report from outside Kibana or from Watcher.
. When the report generates, a message appears. On the message, click **Download report**.
. A message appears, indicating that the report is in the export queue.
. To view and manage reports, open the main menu, then click *Stack Management > Reporting*.
You can then download it from that message, or go to the *Stack Management > Reporting* page to view and access all of your reports.
NOTE: In "stateful" deployments, reports are stored in {es} and managed by the `kibana-reporting` {ilm}
({ilm-init}) policy. By default, the policy stores reports forever. To learn more about {ilm-init} policies, refer
@ -83,33 +88,6 @@ include::reporting-csv-limitations.asciidoc[]
include::reporting-pdf-limitations.asciidoc[]
[float]
[[share-a-direct-link]]
== Share direct links
Create and share direct links to saved searches, dashboards, and visualizations. To access the shared object, authentication is required.
. Open the main menu, then open the saved search, dashboard, or visualization you want to share.
. From the toolbar, click *Share*, then select *Get links*.
. Specify how you want to generate the link:
* To display only the current state of the object, select *Snapshot*.
* To display up-to-date changes, select *Saved object*.
* To generate a shortened link, select *Short URL*.
* To automatically log in anonymous users when you have multiple authentication providers enabled, select *Public URL*.
+
[role="screenshot"]
image::images/permalink-public-url.png[Permalink share menu with Public URL option highlighted]
+
NOTE: *Public URL* is available only when anonymous access is configured and your anonymous service account has privileges to access what you want to share. For more information, refer to <<anonymous-authentication,Anonymous authentication>>.
. Click *Copy link*.
[float]
[[download-as-json]]
== Create JSON files
@ -122,6 +100,18 @@ Create and share JSON files for workpads.
. From the toolbar, click *Share*, then select *Download as JSON*.
[float]
== Embed outside of {kib}
* beta[] *Share on a website* &mdash; Download and securely share *Canvas* workpads on any website.
* *Embed code* &mdash; Embed fully interactive dashboards as an iframe on web pages.
[[reporting-on-cloud-resource-requirements]]
NOTE: For Elastic Cloud deployments, {kib} instances require a minimum of 2GB RAM to generate PDF or PNG reports. To
change {kib} sizing, {ess-console}[edit the deployment].
[float]
[[add-workpad-website]]
== Share workpads on a website
@ -154,24 +144,12 @@ For information about granting access to embedded dashboards, refer to <<kibana-
. Click *Share > Embed code*.
. Specify how you want to generate the code:
. Specify which parts of the dashboard you want to include: Top menu, query, time filter, and filter bar.
* To display the current state, select *Snapshot*.
. Click *Copy embed code*.
* To display up-to-date changes, select *Saved object*.
* Select the dashboard components you want to share.
* To generate a shortened link, select *Short URL*.
* To automatically log in anonymous users when you have multiple authentication providers enabled, select *Public URL*.
+
[role="screenshot"]
image::images/embed-code-public-url.png[Embed code share menu with Public URL option highlighted]
+
NOTE: *Public URL* is available only when anonymous access is configured and your anonymous service account has privileges to access what you want to embed. For more information, refer to <<anonymous-authentication,Anonymous authentication>>.
. Click *Copy iFrame code*.
--