Kom igång: Konfigurera observerbarhet i förhandsversionen av Azure IoT Operations

Artikel
03/22/2024

Viktigt!

Förhandsversion av Azure IoT Operations – aktiverad av Azure Arc finns för närvarande i FÖRHANDSVERSION. Du bör inte använda den här förhandsgranskningsprogramvaran i produktionsmiljöer.

Juridiska villkor för Azure-funktioner i betaversion, förhandsversion eller som av någon annan anledning inte har gjorts allmänt tillgängliga ännu finns i kompletterande användningsvillkor för Microsoft Azure-förhandsversioner.

Observerbarhet ger insyn i varje lager i din Azure IoT Operations-konfiguration. Det ger dig insikt i det faktiska beteendet för problem, vilket ökar effektiviteten i platstillförlitlighetstekniken. Azure IoT Operations erbjuder observerbarhet via anpassade utvalda Grafana-instrumentpaneler som finns i Azure. Dessa instrumentpaneler drivs av Azure Monitor-hanterad tjänst för Prometheus och Container Insights. Den här artikeln beskriver hur du konfigurerar de tjänster som du behöver för observerbarhet.

Förutsättningar

Förhandsversionen av Azure IoT Operations har installerats. Mer information finns i Snabbstart: Distribuera Azure IoT Operations Preview till ett Arc-aktiverat Kubernetes-kluster.
Git för kloning av lagringsplatsen.

Konfigurera din prenumeration

Kör följande kod för att registrera leverantörer med prenumerationen där klustret finns:

az account set -s <subscription-id>
az provider register -n "Microsoft.Insights"
az provider register -n "Microsoft.AlertsManagement"

Installera observerbarhetskomponenter

Stegen i det här avsnittet installerar delade övervakningsresurser och konfigurerar ditt Arc-aktiverade kluster för att generera observerbarhetssignaler till dessa resurser. De delade övervakningsresurserna omfattar Azure Managed Grafana, Azure Monitor Workspace, Azure Managed Prometheus, Azure Log Analytics och Container Insights.

I konsolen går du till en lokal mapp där du vill klona Azure IoT Operations-lagringsplatsen:

Kommentar

Lagringsplatsen innehåller distributionsdefinitionen för Azure IoT Operations och exempel som innehåller de exempelinstrumentpaneler som används i den här artikeln.
Klona lagringsplatsen till den lokala datorn med följande kommando:
```
git clone https://github.com/Azure/azure-iot-operations.git
```
Gå till följande sökväg i din lokala kopia av lagringsplatsen:

azure-iot-operations\tools\setup-3p-obs-infra
Kör följande kommando för att distribuera observerbarhetskomponenterna. Använd prenumerations-ID:t och resursgruppen för det Arc-aktiverade kluster som du vill övervaka.

Kommentar

Information om andra valfria parametrar som du kan ange finns i bicep-filen. De valfria parametrarna kan ange saker som alternativa platser för klusterresurser.
```
az deployment group create \
      --subscription <subscription-id> \
      --resource-group <cluster-resource-group> \
      --template-file observability-full.bicep \
      --parameters grafanaAdminId=$(az ad user show --id $(az account show --query user.name --output tsv) --query=id --output tsv) \
                    clusterName=<cluster-name> \
                    sharedResourceGroup=<shared-resource-group> \
                    sharedResourceLocation=<shared-resource-location> \
      --query=properties.outputs
```
Föregående kommando ger administratörsåtkomst för den nyligen skapade Grafana-instansen till den användare som kör den. Om den åtkomsten inte är det du vill använda kör du följande kommando i stället. Du måste konfigurera behörigheter manuellt innan någon kan komma åt Grafana-instansen.
```
az deployment group create \
    --subscription <subscription-id> \
    --resource-group <cluster-resource-group> \
    --template-file observability-full.bicep \
    --parameters clusterName=<cluster-name> \
                  sharedResourceGroup=<shared-resource-group> \
                  sharedResourceLocation=<shared-resource-location> \
    --query=properties.outputs
```
Om du vill konfigurera behörigheter manuellt lägger du till en rolltilldelning i Grafana-instansen för alla användare som ska ha åtkomst. Tilldela en av Grafana-rollerna (Grafana Admin, Grafana Editor, Grafana Viewer) beroende på önskad åtkomstnivå.

Om distributionen lyckas skrivs några informationsdelar ut i slutet av kommandoutdata. Informationen innehåller Grafana-URL:en och resurs-ID:t för både Log Analytics- och Azure Monitor-resurserna som skapades. Med Grafana-URL:en kan du navigera till Grafana-instansen som du konfigurerar i Distribuera instrumentpaneler till Grafana. Med de två resurs-ID:na kan du konfigurera andra Arc-aktiverade kluster genom att följa stegen i Lägga till ett Arc-aktiverat kluster i befintlig observerbarhetsinfrastruktur.

Konfigurera Prometheus-måttsamling

Kopiera och klistra in följande konfiguration till en ny fil med namnet ama-metrics-prometheus-config.yaml och spara filen:

apiVersion: v1
data:
  prometheus-config: |2-
        scrape_configs:
        - job_name: e4k
          scrape_interval: 1m
          static_configs:
          - targets:
            - aio-mq-diagnostics-service.azure-iot-operations.svc.cluster.local:9600
        - job_name: nats
          scrape_interval: 1m
          static_configs:
          - targets:
            - aio-dp-msg-store-0.aio-dp-msg-store-headless.azure-iot-operations.svc.cluster.local:7777
        - job_name: otel
          scrape_interval: 1m
          static_configs:
          - targets:
            - aio-otel-collector.azure-iot-operations.svc.cluster.local:8889
        - job_name: aio-annotated-pod-metrics
          kubernetes_sd_configs:
          - role: pod
          relabel_configs:
          - action: drop
            regex: true
            source_labels:
            - __meta_kubernetes_pod_container_init
          - action: keep
            regex: true
            source_labels:
            - __meta_kubernetes_pod_annotation_prometheus_io_scrape
          - action: replace
            regex: ([^:]+)(?::\\d+)?;(\\d+)
            replacement: $1:$2
            source_labels:
            - __address__
            - __meta_kubernetes_pod_annotation_prometheus_io_port
            target_label: __address__
          - action: replace
            source_labels:
            - __meta_kubernetes_namespace
            target_label: kubernetes_namespace
          - action: keep
            regex: 'azure-iot-operations'
            source_labels:
            - kubernetes_namespace
          scrape_interval: 1m
kind: ConfigMap
metadata:
  name: ama-metrics-prometheus-config
  namespace: kube-system

Kör följande kommando för att tillämpa konfigurationsfilen som du skapade:

kubectl apply -f ama-metrics-prometheus-config.yaml

Distribuera instrumentpaneler till Grafana

Azure IoT Operations innehåller en samling instrumentpaneler som är utformade för att ge dig många av de visualiseringar som du behöver för att förstå hälsotillståndet och prestandan för din Azure IoT Operations-distribution.

Utför följande steg för att installera Azure IoT Operations-kurerade Grafana-instrumentpaneler.

Logga in på Grafana-konsolen och välj + sedan ikonen i det övre högra området i Grafana-programmet
Välj Importera instrumentpanel, följ anvisningarna för att bläddra till sökvägen samples\grafana-dashboards i din lokala klonade kopia av lagringsplatsen och välj en JSON-instrumentpanelsfil
När programmet frågar väljer du din hanterade Prometheus-datakälla
Välj Importera