|
1 | 1 | ---
|
2 |
| -title: Learn about Grafana settings |
| 2 | +title: How to Configure Grafana Settings |
3 | 3 | titleSuffix: "Azure Managed Grafana"
|
4 |
| -description: Learn about Grafana settings in Azure Managed Grafana, including Viewers can Edit and External Enabled. |
| 4 | +description: Learn how to configure Grafana settings in Azure Managed Grafana, including enabling Viewers can Edit and External Enabled. |
5 | 5 | author: maud-lv
|
6 | 6 | ms.author: malev
|
7 | 7 | ms.service: azure-managed-grafana
|
8 |
| -ms.topic: concept-article |
9 |
| -ms.date: 08/09/2024 |
10 |
| -#customer intent: In this document, learn about the custom Grafana options available in the Grafana settings tab, in Azure Managed Grafana. |
| 8 | +ms.topic: how-to-article |
| 9 | +ms.date: 11/06/2024 |
| 10 | +#customer intent: In this document, learn how to configure the custom Grafana options available in the Grafana settings tab, in Azure Managed Grafana. |
11 | 11 |
|
12 | 12 | ---
|
13 | 13 |
|
14 |
| -# Grafana settings |
| 14 | +# How to configure Grafana settings |
15 | 15 |
|
16 |
| -This article introduces the Grafana settings available in Azure Managed Grafana. These settings are designed to enable Azure Managed Grafana customers to customize their Grafana instances by enabling or disabling the Grafana options listed below. |
| 16 | +This article provides step-by-step instructions on how to configure Grafana settings in Azure Managed Grafana. These settings allow you to customize your Grafana instance by enabling or disabling specific options. These Grafana settings are also referenced in Grafana's documentation, under [Grafana configuration](https://grafana.com/docs/grafana/latest/setup-grafana/configure-grafana/). |
17 | 17 |
|
18 |
| -These settings are located in Azure Managed Grafana's **Settings** > **Configuration** menu, in the **Grafana Settings (Preview)** tab. |
| 18 | +## Prerequisites |
| 19 | + |
| 20 | +- An Azure account with an active subscription. |
| 21 | +- An Azure Managed Grafana instance. |
| 22 | + |
| 23 | +## Access Grafana Settings |
| 24 | + |
| 25 | +1. Open the Azure portal and navigate to your Azure Managed Grafana instance. |
| 26 | +1. In the left menu, select **Settings** > **Configuration**. |
| 27 | +1. Open the **Grafana Settings (Preview)** tab. |
19 | 28 |
|
20 | 29 | :::image type="content" source="media/grafana-settings/grafana-settings-tab.png" alt-text="Screenshot of the Azure platform showing the Grafana settings tab." lightbox="media/grafana-settings/grafana-settings-tab.png":::
|
21 | 30 |
|
22 |
| -They are also referenced in Grafana's documentation, under [Grafana configuration](https://grafana.com/docs/grafana/latest/setup-grafana/configure-grafana/). |
| 31 | +## Enable or disable Viewers Can Edit |
| 32 | + |
| 33 | +The **Viewers Can Edit** setting allows users with the Grafana Viewer role to edit dashboards without saving changes permanently. This feature is designed to enable Grafana Viewers to run tests and interact with dashboards without making permanent changes. |
| 34 | + |
| 35 | +With this setting enabled, Grafana Viewers can: |
| 36 | +- Edit dashboards temporarily, without saving. |
| 37 | +- Access the **Explore** menu to perform interactive queries and analyze data. |
23 | 38 |
|
24 |
| -## Viewers Can Edit |
| 39 | +1. In the **Grafana Settings (Preview)** tab, locate the **Viewers can edit** option. |
| 40 | +1. This option is disabled by default. Toggle the switch to enable this setting. |
25 | 41 |
|
26 |
| -The **Viewers Can Edit** setting allows users with the Grafana Viewer role to edit dashboards. This feature is designed to enable Grafana Viewers to run tests and interact with dashboards without making permanent changes. While they can edit dashboards, they can't save these edits. |
| 42 | +## Enable or disable External Enabled |
27 | 43 |
|
28 |
| -This option also gives Grafana Viewers access to the **Explore** menu in the Grafana UI, where they can perform interactive queries and analyze data within Grafana. However, it's important to note that any changes made by Viewers won't be saved permanently unless they have the appropriate Editor permissions. |
| 44 | +The **External Enabled** setting controls the public sharing of snapshots. |
29 | 45 |
|
30 |
| -To enable or disable this option, open an Azure Managed Grafana instance in the Azure portal and go to **Settings** > **Configuration** > **Grafana Settings (Preview)** > **Viewers can edit**. This option is disabled by default. |
| 46 | +With this setting enabled, users can publish snapshots of dashboards to an external URL by opening a dashboard, selecting **Share** > **Snapshot** > **Publish to snapshots.raintanks.io**. |
31 | 47 |
|
32 |
| -## External Enabled |
| 48 | +1. In the **Grafana Settings (Preview)** tab, locate the **External Enabled** option. |
| 49 | +1. This option is enabled by default, allowing users to publicly share snapshots of their dashboards. To restrict the public sharing of snapshots, toggle off the switch to disable this setting. |
33 | 50 |
|
34 |
| -The **External Enabled** setting controls the public sharing of snapshots. This option is enabled by default, allowing users to publish snapshots of their dashboards. |
| 51 | +## Enable or disable CSRF Always Check |
35 | 52 |
|
36 |
| -With this option enabled, users can publish a snapshot of a dashboard to an external URL by opening a dashboard, selecting **Share** > **Snapshot**, and then **Publish to snapshots.raintanks.io**. |
| 53 | +The **CSRF Always Check** setting enhances security by rejecting requests that have an origin header that does not match the origin of the Grafana instance. This setting helps to prevent Cross-Site Request Forgery (CSRF) attacks. This option is disabled by default. |
37 | 54 |
|
38 |
| -You can disable the External Enabled option to restrict the public sharing of snapshots. To do this, open an Azure Managed Grafana instance in the Azure portal and go to **Settings** > **Configuration** > **Grafana Settings (Preview)** and toggle off the **External Enabled** setting. |
| 55 | +1. In the **Grafana Settings (Preview)** tab, locate the **CSRF Always Check** option. |
| 56 | +1. Toggle the switch to enable or disable this setting based on your security requirements. |
39 | 57 |
|
40 |
| -## Related content |
| 58 | +## Related Content |
41 | 59 |
|
42 | 60 | - [Grafana UI](grafana-app-ui.md)
|
43 | 61 | - [Manage plugins](how-to-manage-plugins.md)
|
0 commit comments