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
You can share observability resources across multiple Arc-enabled clusters that run Azure IoT Operations. This article shows how to add another Arc-enabled cluster to the observability infrastructure that you created in [Get started: configure observability](howto-configure-observability.md).
17
+
You can share observability resources across multiple Arc-enabled clusters that run Azure IoT Operations. This article shows how to add another Arc-enabled cluster to the observability infrastructure that you created in [Deploy observability resources with a script](howto-configure-observability.md).
18
18
19
19
## Prerequisites
20
20
21
-
- Azure IoT Operations installed. For more information, see [Get started: configure observability](howto-configure-observability.md).
21
+
- Azure IoT Operations installed. For more information, see [Deploy observability resources with a script](howto-configure-observability.md).
22
22
23
23
## Add an Arc-enabled cluster
24
24
To create this setup, run the following command. Specify the two resource IDs for the observability components that were output when you ran the steps in [Install observability components](howto-configure-observability.md#install-observability-components).
@@ -53,4 +53,4 @@ To set up Prometheus metrics collection for the new Arc enabled cluster, follow
53
53
54
54
## Access Grafana dashboards
55
55
56
-
Navigate to the endpoint for the Grafana instance that you created previously in [Get started: configure observability](howto-configure-observability.md). If you didn't already do so, create the relevant dashboards by going to the [dashboard list](https://github.com/Azure/azure-iot-operations/tree/main/samples/grafana-dashboards). In the dashboards, you see the name of the new Arc-enabled cluster in the **Cluster** selector dropdown.
56
+
Browse to the endpoint for the Grafana instance that you created previously in [Deploy observability resources with a script](howto-configure-observability.md). If you didn't already do so, create the relevant dashboards by going to the [dashboard list](https://github.com/Azure/azure-iot-operations/tree/main/samples/grafana-dashboards). In the dashboards, you see the name of the new Arc-enabled cluster in the **Cluster** selector dropdown.
Copy file name to clipboardExpand all lines: articles/iot-operations/configure-observability-monitoring/howto-clean-up-observability-resources.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,7 +17,7 @@ This article shows how to clean up the observability resources in your cluster w
17
17
18
18
To uninstall the observability resources, complete the following steps.
19
19
20
-
1.Navigate to the resource group where you installed the shared resources, and delete the following resources:
20
+
1.Browse to the resource group where you installed the shared resources, and delete the following resources:
21
21
22
22
- Azure Monitor Workspace
23
23
- Azure Managed Grafana
@@ -28,7 +28,7 @@ To uninstall the observability resources, complete the following steps.
28
28
29
29
:::image type="content" source="media/howto-clean-up-observability-resources/shared-resource-delete.png" alt-text="Screenshot that lists a set of shared resources." lightbox="media/howto-clean-up-observability-resources/shared-resource-delete-expanded.png":::
30
30
31
-
1.Navigate to the resource group where your cluster is located (if different from the resource group for the previous resources). Delete the following resources:
31
+
1.Browse to the resource group where your cluster is located (if different from the resource group for the previous resources). Delete the following resources:
32
32
33
33
- The data collection endpoint
34
34
- The two data collection rules (one ends with "logsDataCollectionRule" and the other ends with "metricsDataCollectionRule")
This article shows how to install and configure Azure IoT Operations observability components manually. This approach provides more options and control over your environment. For a simplified setup process that installs all the components you need to get started, see [Get started: configure observability](howto-configure-observability.md).
17
+
This article shows how to install and configure Azure IoT Operations observability components manually. This approach provides more options and control over your environment. For a simplified setup process that installs all the components you need to get started, see [Deploy observability resources with a script](howto-configure-observability.md).
18
18
19
19
## Configure your subscription
20
20
21
-
Run the following code to register providers with the subscription where your cluster is located:
21
+
Run the following code to register providers with the subscription where your cluster is located.
22
+
23
+
>[!NOTE]
24
+
>This step only needs to be run once per subscription. To register resource providers, you need permission to do the `/register/action` operation, which is included in subscription Contributor and Owner roles. For more information, see [Azure resource providers and types](../../azure-resource-manager/management/resource-providers-and-types.md).
22
25
23
26
```azurecli
24
27
az account set -s <subscription-id>
@@ -36,7 +39,7 @@ To set up Prometheus metrics collection for the new Arc-enabled cluster, follow
36
39
## Install Container Insights
37
40
Container Insights monitors the performance of container workloads deployed to the cloud. It gives you performance visibility by collecting memory and processor metrics from controllers, nodes, and containers that are available in Kubernetes through the Metrics API. After you enable monitoring from Kubernetes clusters, metrics and container logs are automatically collected through a containerized version of the Log Analytics agent for Linux. Metrics are sent to the metrics database in Azure Monitor. Log data is sent to your Log Analytics workspace.
38
41
39
-
To monitor container workload performance, complete the steps to [enable container insights](../../azure-monitor/containers/container-insights-onboard.md).
42
+
To monitor container workload performance, complete the steps to [enable container insights](../../azure-monitor/containers/kubernetes-monitoring-enable.md).
40
43
41
44
## Install Grafana
42
45
Azure Managed Grafana is a data visualization platform built on top of the Grafana software by Grafana Labs. Azure Managed Grafana is a fully managed Azure service operated and supported by Microsoft. Grafana helps you bring together metrics, logs and traces into a single user interface. With its extensive support for data sources and graphing capabilities, you can view and analyze your application and infrastructure telemetry data in real-time.
@@ -53,4 +56,4 @@ To install Azure Managed Grafana, complete the following steps:
Copy file name to clipboardExpand all lines: articles/iot-operations/configure-observability-monitoring/howto-configure-observability.md
+12-9Lines changed: 12 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
-
title: Get started with observability
3
-
description: How to get started with configuring observability features in Azure IoT Operations so that you can monitor your solution.
2
+
title: Deploy observability resources with a script
3
+
description: How to get started with configuring observability features with a script in Azure IoT Operations, so that you can monitor your solution.
4
4
author: kgremban
5
5
ms.author: kgremban
6
6
ms.topic: how-to
@@ -11,20 +11,23 @@ ms.date: 02/27/2024
11
11
# CustomerIntent: As an IT admin or operator, I want to be able to monitor and visualize data on the health of my industrial assets and edge environment.
12
12
---
13
13
14
-
# Get started: configure observability in Azure IoT Operations Preview
14
+
# Get started: configure observability with a script in Azure IoT Operations Preview
Observability provides visibility into every layer of your Azure IoT Operations configuration. It gives you insight into the actual behavior of issues, which increases the effectiveness of site reliability engineering. Azure IoT Operations offers observability through custom curated Grafana dashboards that are hosted in Azure. These dashboards are powered by Azure Monitor managed service for Prometheus and by Container Insights. This article shows you how to configure the services you need for observability.
19
19
20
20
## Prerequisites
21
21
22
-
- Azure IoT Operations Preview installed. For more information, see [Quickstart: Deploy Azure IoT Operations Preview to an Arc-enabled Kubernetes cluster](../get-started/quickstart-deploy.md).
22
+
- Azure IoT Operations Preview installed. For more information, see [Quickstart: Run Azure IoT Operations Preview in Github Codespaces with K3s](../get-started-end-to-end-sample/quickstart-deploy.md).
23
23
-[Git](https://git-scm.com/downloads) for cloning the repository.
24
24
25
25
## Configure your subscription
26
26
27
-
Run the following code to register providers with the subscription where your cluster is located:
27
+
Run the following code to register providers with the subscription where your cluster is located.
28
+
29
+
>[!NOTE]
30
+
>This step only needs to be run once per subscription. To register resource providers, you need permission to do the `/register/action` operation, which is included in subscription Contributor and Owner roles. For more information, see [Azure resource providers and types](../../azure-resource-manager/management/resource-providers-and-types.md).
28
31
29
32
```azurecli
30
33
az account set -s <subscription-id>
@@ -35,7 +38,7 @@ az provider register -n "Microsoft.AlertsManagement"
35
38
## Install observability components
36
39
The steps in this section install shared monitoring resources and configure your Arc enabled cluster to emit observability signals to these resources. The shared monitoring resources include Azure Managed Grafana, Azure Monitor Workspace, Azure Managed Prometheus, Azure Log Analytics, and Container Insights.
37
40
38
-
1. In your console, navigate to a local folder where you want to clone the Azure IoT Operations repo:
41
+
1. In your console, go to the local folder where you want to clone the Azure IoT Operations repo:
39
42
> [!NOTE]
40
43
> The repo contains the deployment definition of Azure IoT Operations, and samples that include the sample dashboards used in this article.
41
44
@@ -45,7 +48,7 @@ The steps in this section install shared monitoring resources and configure your
1. Navigate to the following path in your local copy of the repo:
51
+
1. Browse to the following path in your local copy of the repo:
49
52
50
53
*azure-iot-operations\tools\setup-3p-obs-infra*
51
54
@@ -81,7 +84,7 @@ The steps in this section install shared monitoring resources and configure your
81
84
82
85
To set up permissions manually, [add a role assignment](../../managed-grafana/how-to-share-grafana-workspace.md#add-a-grafana-role-assignment) to the Grafana instance for any users who should have access. Assign one of the Grafana roles (Grafana Admin, Grafana Editor, Grafana Viewer) depending on the level of access desired.
83
86
84
-
If the deployment succeeds, a few pieces of information are printed at the end of the command output. The information includes the Grafana URL and the resource IDs for both the Log Analytics and Azure Monitor resources that were created. The Grafana URL allows you to navigate to the Grafana instance that you configure in [Deploy dashboards to Grafana](#deploy-dashboards-to-grafana). The two resource IDs enable you to configure other Arc enabled clusters by following the steps in [Add an Arc-enabled cluster to existing observability infrastructure](howto-add-cluster.md).
87
+
If the deployment succeeds, a few pieces of information are printed at the end of the command output. The information includes the Grafana URL and the resource IDs for both the Log Analytics and Azure Monitor resources that were created. The Grafana URL allows you to go to the Grafana instance that you configure in [Deploy dashboards to Grafana](#deploy-dashboards-to-grafana). The two resource IDs enable you to configure other Arc enabled clusters by following the steps in [Add an Arc-enabled cluster to existing observability infrastructure](howto-add-cluster.md).
85
88
86
89
## Configure Prometheus metrics collection
87
90
1. Copy and paste the following configuration to a new file named *ama-metrics-prometheus-config.yaml*, and save the file:
@@ -160,4 +163,4 @@ Complete the following steps to install the Azure IoT Operations curated Grafana
0 commit comments