Merge pull request #293756 from dominicbetts/iiot-grafana

IoT: Add Grafana details back to industrial tutorial.

Author: prmerger-automator[bot]

articles/iot/tutorial-iot-industrial-solution-architecture.md

@@ -59,7 +59,7 @@ The following table describes the key components in this solution:
 | [UA Edge Translator](https://github.com/opcfoundation/ua-edgetranslator) | This open-source industrial connectivity reference application translates from proprietary asset interfaces to OPC UA. The solution uses the W3C Web of Things descriptions as the schema to describe the industrial asset interface. |
 
 > [!NOTE]
-> In a real-world deployment, something as critical as opening a pressure relief valve would be done on-premises. This is just a simple example of how to achieve the digital feedback loop.
+> In a real-world deployment, something as critical as opening a pressure relief valve would be done on-premises. This example simply demonstrates how to achieve the digital feedback loop.
 
 ## Production line simulation
 
@@ -209,7 +209,7 @@ Before you deploy Azure IoT Operations, confirm that you started the production
 
 ### Configure your Azure IoT Operations deployment
 
-You can configure your Azure IoT Operations deployment by using the [operations experience](https://iotoperations.azure.com/) web UI. Add the asset endpoints, assets and data flows to process the data from the production line simulation and route it to the **data** hub in your Event Hubs namespace.
+You can configure your Azure IoT Operations deployment by using the [operations experience](https://iotoperations.azure.com/) web UI. Add the asset endpoints, assets, and data flows to process the data from the production line simulation and route it to the **data** hub in your Event Hubs namespace.
 
 In your Azure IoT Operations deployment, create asset endpoints that define connections to the following OPC UA servers in the production simulation:
 
@@ -255,6 +255,81 @@ For best results, change the `Layout` option to `Grouped`.
 
 :::image type="content" source="media/concepts-iot-industrial-solution-architecture/isa-95-graph.png" alt-text="Graph that shows an ISA-95 asset hierarchy." lightbox="media/concepts-iot-industrial-solution-architecture/isa-95-graph.png" border="false" :::
 
+## Use Azure Managed Grafana
+
+You can also use Azure Managed Grafana to create a dashboard on Azure for the solution described in this article. Use Grafana within manufacturing to create dashboards that display real-time data. The following steps show you enable Grafana on Azure, and create a dashboard with the simulated production line data from Azure Data Explorer.
+
+### Enable the Azure Managed Grafana service
+
+To create an Azure Managed Grafana service, and configure it with permissions to access the ontologies database:
+
+1. In the Azure portal, search for *Grafana*, and then select the **Azure Managed Grafana** service.
+
+1. To create the service, on the **Create Grafana Workspace** page enter a name your instance. Choose all the default options.
+
+1. After the service is created, make sure your Grafana instance has a system assigned managed identity, navigate to the **Identity** blade of your Azure Managed Grafana instance in the Azure portal. If the system assigned managed identity isn't enabled, enable it. Make a note of the **Object (principal) ID** value, you need it later.
+
+1. To grant permission for the managed identity to access the ontologies database in Azure Data Explorer:
+
+    1. Navigate to the **Permissions** blade of the ontologies database in your Azure Data Explorer instance in the Azure portal.
+    1. Select **Add > AllDatabasesViewer**.
+    1. Search for and select the **Object (principal) ID** value, you made a note of previously.
+
+### Add a new data source in Grafana
+
+Add a new data source to connect to Azure Data Explorer. In this sample, you use a system assigned managed identity to connect to Azure Data Explorer. To configure the authentication, follow these steps:
+
+To add the data source in Grafana, follow these steps:
+
+1. Navigate to the endpoint URL for your Grafana instance. You can find the endpoint URL in the Azure Managed Grafana page for your instance in the Azure portal. Then sign in to your Grafana instance.
+
+1. In the Grafana dashboard, select **Connections > Data sources**, and then select **Add new data source**. Scroll down and select **Azure Data Explorer Datasource**.
+
+1. Choose **Managed Identity** as the authentication menu. Then add the URL of your Azure Data Explorer cluster. You can find the URL in the Azure Data Explorer instance menu in the Azure portal under **URI**.
+
+1. Select **Save and test** to verify the datasource connection.
+
+### Import a sample dashboard
+
+Now you're ready to import the sample dashboard.
+
+1. Download the [Sample Grafana Manufacturing Dashboard](https://github.com/digitaltwinconsortium/ManufacturingOntologies/blob/main/Tools/GrafanaDashboard/samplegrafanadashboard.json) dashboard.
+
+1. In the Grafana menu, navigate to **Dashboards** and then select **New > Import**.
+
+1. Select **Upload dashboard JSON file** and select the *samplegrafanadashboard.json* file that you downloaded previously. Select **Import**.
+
+1. For each of the panels in the dashboard, select **Edit** and then select the **Data source** you setup previously.
+
+### Configure alerts
+
+In Grafana, you can also create alerts. In this example, you create a low OEE alert for one of the production lines.
+
+1. In the Grafana menu, navigate to **Alerting > **Alert rules**.
+
+1. Select **New alert rule**.
+
+1. Give your alert a name and select **Azure Data Explorer** as data source. Select **KQL** in the **Define query and alert condition** pane.
+
+1. In the query field, enter the following query. This example uses the Seattle production line:
+
+    ```kql
+    let oee = CalculateOEEForStation("assembly", "seattle", 10000, now(), now(-1h));
+    print round(oee * 100, 2)
+    ```
+
+1. Select **Set as alert condition**.
+
+1. Scroll down to the **Expressions** section. Delete the **Reduce** expression, you don't need it.
+
+1. For the alert threshold, select **A** as **Input**. Select **IS BELOW** and enter **10**.
+
+1. Scroll down to the **Set evaluation behavior** section. Create a new **Folder** to save your alerts. Create a new **Evaluation group** and specify **2m**.
+
+1. Select the **Save rule and exit** button in the top right.
+
+In the overview of your alerts, you can now see that an alert is triggered when your OEE is less than 10.
+
 ## Connect the reference solution to Microsoft Power BI
 
 To connect the reference solution Power BI, you need access to a Power BI subscription.