You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -22,12 +22,34 @@ Sign in to the Azure portal at [https://portal.azure.com/](https://portal.azure.
22
22
23
23
## Supported Grafana data sources
24
24
25
-
By design, Grafana can be configured with multiple data sources. A data source is an externalized storage backend that holds your telemetry information. Azure Managed Grafana supports many popular data sources. Azure-specific data sources are:
25
+
By design, Grafana can be configured with multiple data sources. A data source is an externalized storage backend that holds your telemetry information. Azure Managed Grafana supports many popular data sources.
26
26
27
-
-[Azure Data Explorer](https://github.com/grafana/azure-data-explorer-datasource?utm_source=grafana_add_ds)
You can find all available Grafana data sources by going to your resource and selecting **Configuration** > **Data sources** from the left menu. Search for the data source you need from the available list and select **Add data source**.
72
+
For more information about data sources, go to [Data sources](https://grafana.com/docs/grafana/latest/datasources/) on the Grafana Labs website.
73
+
74
+
## Add a datasource
75
+
76
+
A number of data sources are added by in your Grafana instance by default. To add more data sources, follow the steps below using the Azure portal or the Azure CLI.
77
+
78
+
### [Portal](#tab/azure-portal)
79
+
80
+
1. Open the Grafana UI of your Azure Managed Grafana instance and select **Configuration** > **Data sources** from the left menu.
81
+
1. Select **Add data source**, search for the data source you need from the available list, and select it.
82
+
1. Fill out the form with the data source settings and select **Save and test** to validate the connection to your data source.
51
83
52
84
:::image type="content" source="media/data-sources/add-data-source.png" alt-text="Screenshot of the Add data source page.":::
53
85
54
86
> [!NOTE]
55
87
> Installing Grafana plugins listed on the page **Configuration** > **Plugins** isn’t currently supported.
56
88
57
-
For more information about data sources, go to [Data sources](https://grafana.com/docs/grafana/latest/datasources/) on the Grafana Labs website.
89
+
### [Azure CLI](#tab/azure-cli)
90
+
91
+
Run the [az grafana data-source create](/cli/azure/grafana/data-source#az-grafana-data-source-create) command to add and manage Azure Managed Grafana data sources with the Azure CLI.
92
+
93
+
For example, to add an Azure SQL data source, run:
94
+
95
+
```azurecli-interactive
96
+
97
+
az grafana data-source create --name <instance-name> --definition '{
98
+
"access": "proxy",
99
+
"database": "testdb",
100
+
"jsonData": {
101
+
"authenticationType": "SQL Server Authentication",
102
+
"encrypt": "false"
103
+
},
104
+
"secureJsonData": {
105
+
"password": "verySecretPassword"
106
+
},
107
+
"name": "Microsoft SQL Server",
108
+
"type": "mssql",
109
+
"url": "testsql.database.windows.net",
110
+
"user": "admin1"
111
+
}'
112
+
```
113
+
114
+
---
115
+
116
+
## Update a data source
58
117
59
-
##Configuration for Azure Monitor
118
+
### Azure Monitor configuration
60
119
61
-
The Azure Monitor data source is automatically added to all new Managed Grafana resources. To review or modify its configuration, follow these steps in your Managed Grafana endpoint:
120
+
The Azure Monitor data source is automatically added to all new Managed Grafana resources. To review or modify its configuration, follow these steps below in the Grafana UI of your Azure Managed Grafana instance or in the Azure CLI.
121
+
122
+
### [Portal](#tab/azure-portal)
62
123
63
124
1. From the left menu, select **Configuration** > **Data sources**.
64
125
@@ -69,20 +130,62 @@ The Azure Monitor data source is automatically added to all new Managed Grafana
69
130
70
131
:::image type="content" source="media/data-sources/configure-Azure-Monitor.png" alt-text="Screenshot of the Azure Monitor page in data sources.":::
71
132
72
-
Authentication and authorization are then made through the provided managed identity. With Managed Identity, you can assign permissions for your Managed Grafana instance to access Azure Monitor data without having to manually manage service principals in Azure Active Directory (Azure AD).
133
+
Authentication and authorization are made through the provided managed identity. Using managed identity, lets you assign permissions for your Managed Grafana instance to access Azure Monitor data without having to manually manage service principals in Azure Active Directory (Azure AD).
134
+
135
+
### [Azure CLI](#tab/azure-cli)
136
+
137
+
Run the [az grafana data-source update](/cli/azure/grafana/data-source#az-grafana-data-source-update) command to update the configuration of your Azure Monitor data sources using the Azure CLI.
Azure Managed Grafana can also access data sources using a service principal set up in Azure Active Directory (Azure AD).
80
181
182
+
### [Portal](#tab/azure-portal)
183
+
81
184
1. From the left menu, select **Configuration** > **Data sources**.
82
185
83
186
:::image type="content" source="media/data-sources/configuration.png" alt-text="Screenshot of the Add data sources page.":::
84
187
85
-
1.**Azure Data Explorer Datasource**is listed as a built-in data source for your Managed Grafana instance. Select this data source.
188
+
1.Add the **Azure Data Explorer Datasource** data source to your Managed Grafana instance.
86
189
1. In the **Settings** tab, fill out the form under **Connection Details**, and optionally also edit the **Query Optimizations**, **Database schema settings**, and **Tracking** sections.
87
190
88
191
:::image type="content" source="media/data-sources/data-explorer-connection-settings.jpg" alt-text="Screenshot of the Connection details section for Data Explorer in data sources.":::
@@ -91,6 +194,33 @@ Azure Managed Grafana can also access data sources using a service principal set
91
194
92
195
1. Select **Save & test** to validate the connection. "Success" is displayed on screen and confirms that Azure Managed Grafana is able to fetch the data source through the provided connection details, using the service principal in Azure AD.
93
196
197
+
### [Azure CLI](#tab/azure-cli)
198
+
199
+
1. Run the [az grafana data-source create](/cli/azure/grafana/data-source#az-grafana-data-source-create) command to create the Azure Data Explorer data source.
200
+
201
+
For example:
202
+
203
+
```azurecli-interactive
204
+
az grafana data-source create --name <grafana-instance-name> --definition '{
205
+
"access": "proxy",
206
+
"jsonData": {
207
+
"azureCloud": "azuremonitor",
208
+
"clientId": "<client-ID>",
209
+
"clusterUrl": "<cluster URL>",
210
+
"dataConsistency": "strongconsistency",
211
+
"defaultDatabase": "<database-name>",
212
+
"queryTimeout": "120s",
213
+
"tenantId": "<tenant-ID>"
214
+
},
215
+
"name": "<data-source-name>",
216
+
"type": "grafana-azure-data-explorer-datasource",
217
+
}'
218
+
```
219
+
220
+
1. Run the [az grafana data-source update](/cli/azure/grafana/data-source#az-grafana-data-source-update) command to update the configuration of the Azure Data Explorer data source.
description: Activate Grafana Enterprise (preview) to access Grafana Enterprise plugins within Azure Managed Grafana
4
+
author: maud-lv
5
+
ms.author: malev
6
+
ms.service: managed-grafana
7
+
ms.topic: how-to
8
+
ms.date: 01/09/2022
9
+
---
10
+
11
+
# Enable Grafana Enterprise (preview)
12
+
13
+
In this guide, learn how to activate the Grafana Enterprise (preview) add-on in Azure Managed Grafana, update your Grafana Enterprise plan, and access [Grafana Enterprise plugins](https://grafana.com/docs/plugins/).
14
+
15
+
The Grafana Enterprise plans offered through Azure Managed Grafana enable users to access Grafana Enterprise plugins to do more with Azure Managed Grafana.
16
+
17
+
Grafana Enterprise plugins, as of January 2023:
18
+
19
+
- AppDynamics
20
+
- Azure DevOps
21
+
- Datadog
22
+
- Databricks
23
+
- Dynatrace
24
+
- GitLab
25
+
- Honeycomb
26
+
- Jira
27
+
- MongoDB
28
+
- New Relic
29
+
- Oracle Database
30
+
- Salesforce
31
+
- SAP HANA®
32
+
- ServiceNow
33
+
- Snowflake
34
+
- Splunk
35
+
- Splunk Infrastructure Monitoring
36
+
- Sqlyze Datasource
37
+
- Wavefront
38
+
39
+
> [!NOTE]
40
+
> Grafana Enterprise plugins are directly supported by Grafana Labs. For more information and an updated list, go to [Grafana Enterprise plugins](https://grafana.com/docs/plugins/).
41
+
42
+
You can enable access to Grafana Enterprise plugins by selecting a Grafana Enterprise plan when creating a new workspace, or you can add a Grafana Enterprise plan on an already-created Azure Managed Grafana instance.
43
+
44
+
> [!NOTE]
45
+
> The Grafana Enterprise monthly plan is a paid plan, owned and charged by Grafana Labs, through Azure Marketplace. Go to [Azure Managed Grafana pricing](https://azure.microsoft.com/pricing/details/managed-grafana/) for details.
46
+
47
+
> [!IMPORTANT]
48
+
> Grafana Enterprise is currently in preview within Azure Managed Grafana.
49
+
> See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
50
+
51
+
## Prerequisites
52
+
53
+
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free).
54
+
- This guide assumes that you already know the basics of [creating an Azure Managed Grafana instance](quickstart-managed-grafana-portal.md).
55
+
56
+
## Create a workspace with Grafana Enterprise enabled
57
+
58
+
To activate Grafana Enterprise plugins when creating an Azure Managed Grafana Workspace, in **Create a Grafana Workspace**, go to the **Basics** tab and follow the steps below:
59
+
60
+
1. Under **Project Details**, select an Azure subscription and enter a resource group name or use the generated suggested resource group name
61
+
1. Under **Instance Details**, select an Azure region and enter a resource name.
62
+
1. Under **Grafana Enterprise**, check the box **Grafana Enterprise**, select **Free Trial - Azure Managed Grafana Enterprise Upgrade** and keep the option **Recurring billing** on **Disabled**.
63
+
64
+
:::image type="content" source="media/grafana-enterprise/create-with-enterprise-plan.png" alt-text="Screenshot of the Grafana dashboard, instance creation basic details.":::
65
+
66
+
> [!CAUTION]
67
+
> Each Azure subscription can benefit from one free Grafana Enterprise trial. The free trial lets you try the Grafana Enterprise plan for one month. If you select a free trial and enable recurring billing, you will start getting charged after the end of your first month. Disable recurring billing if you just want to test Grafana Enterprise.
68
+
69
+
1. Select **Review + create** and review the information about your new instance, including the costs that may be associated with the Grafana Enterprise plan and potential other paid options.
70
+
71
+
:::image type="content" source="media/grafana-enterprise/creation-cost-review.png" alt-text="Screenshot of the Grafana dashboard. Workspace information and cost review.":::
72
+
73
+
1. Read and check the box at the bottom of the page to state that you agree with the terms displayed, and select **Create** to finalize the creation of your new Azure Managed Grafana instance.
74
+
75
+
## Activate Grafana Enterprise on an existing workspace
76
+
77
+
To enable Grafana Enterprise on an existing Azure Managed Grafana instance, follow the steps below:
78
+
79
+
1. In the Azure portal, open your Grafana instance and under **Settings**, select **Grafana Enterprise**.
80
+
:::image type="content" source="media/grafana-enterprise/enable-grafana-enterprise.png" alt-text="Screenshot of the Grafana dashboard showing how to enable Grafana enterprise on an existing workspace." lightbox="media/grafana-enterprise/enable-grafana-enterprise.png":::
81
+
1. Select **Free Trial - Azure Managed Grafana Enterprise Upgrade** to test Grafana Enterprise for free or select the monthly plan. Review the associated costs to make sure that you selected a plan that suits you. Recurring billing is disabled by default.
82
+
> [!CAUTION]
83
+
> Each Azure subscription can benefit from one free Grafana Enterprise trial. The free trial lets you try the Grafana Enterprise plan for one month. If you select a free trial and enable recurring billing, you will start getting charged after the end of your first month. Disable recurring billing if you just want to test Grafana Enterprise.
84
+
85
+
1. Read and check the box at the bottom of the page to state that you agree with the terms displayed, and select **Update** to finalize the creation of your new Azure Managed Grafana instance.
86
+
87
+
## Update a Grafana Enterprise plan
88
+
89
+
To update the Grafana Enterprise plan of an existing Azure Managed Grafana instance, optionally follow the steps below:
90
+
91
+
1. In the Azure portal, open your Grafana instance and under **Settings**, select **Grafana Enterprise**. Review the available information about your current plan, price and billing.
92
+
:::image type="content" source="media/grafana-enterprise/update-grafana-enterprise.png" alt-text="Screenshot of the Grafana dashboard showing how to update a Grafana Enterprise plan." lightbox="media/grafana-enterprise/update-grafana-enterprise.png":::
93
+
1. Select **Change plan** to review available Grafana Enterprise plans and select another plan. Then select **Update** at the bottom of the page to switch to the selected plan.
94
+
1. Select **Edit recurring billing** and select **Enabled** to activate recurring billing and agree to be billed on your renewal date, or select **Disabled** to disable the renewal of your Grafana Enterprise plan. The subscription will expire on the date displayed on screen. To confirm, select **Update**.
95
+
1. Select **Cancel enterprise** option to cancel the Grafana Enterprise subscription. Enter the name of the plan and select **Cancel enterprise** again to confirm.
96
+
97
+
> [!NOTE]
98
+
> If you configure Grafana Enterprise data sources and later cancel your subscription, you will no longer have access to them. Your Grafana Enterprise data sources and associated dashboards will remain in your Grafana instance but you will need to subscribe again to Grafana Enterprise to regain access to your data.
99
+
100
+
The Azure platform displays some useful links at the bottom of the page.
101
+
102
+
## Start using Grafana Enterprise plugins
103
+
104
+
Grafana Enterprise gives you access to preinstalled plugins reserved for Grafana Enterprise customers. Once you've activated a Grafana Enterprise plan, go to the Grafana platform, and then select **Configuration > Data sources** from the left menu to set up a data source.
105
+
106
+
:::image type="content" source="media/grafana-enterprise/access-data-sources.png" alt-text="Screenshot of the Grafana dashboard. Access data sources.":::
107
+
108
+
## Next steps
109
+
110
+
In this how-to guide, you learned how to enable Grafana Enterprise plugins. To learn how to configure data sources, go to:
111
+
112
+
> [!div class="nextstepaction"]
113
+
> [Configure data sources](how-to-data-source-plugins-managed-identity.md)
0 commit comments