Share via


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

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

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.

  1. 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.

  2. Klona lagringsplatsen till den lokala datorn med följande kommando:

    git clone https://github.com/Azure/azure-iot-operations.git
    
  3. Gå till följande sökväg i din lokala kopia av lagringsplatsen:

    azure-iot-operations\tools\setup-3p-obs-infra

  4. 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

  1. 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
    
  2. 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.

  1. Logga in på Grafana-konsolen och välj + sedan ikonen i det övre högra området i Grafana-programmet

  2. 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

  3. När programmet frågar väljer du din hanterade Prometheus-datakälla

  4. Välj Importera