Začínáme: Konfigurace pozorovatelnosti v Azure IoT Operations Preview

Důležité

Azure IoT Operations Preview – Služba Azure Arc je aktuálně ve verzi PREVIEW. Tento software ve verzi Preview byste neměli používat v produkčních prostředích.

Právní podmínky, které platí pro funkce Azure, které jsou ve verzi beta, verzi Preview nebo které zatím nejsou veřejně dostupné, najdete v Dodatečných podmínkách použití pro Microsoft Azure verze Preview.

Pozorovatelnost poskytuje přehled o každé vrstvě konfigurace provozu Azure IoT. Poskytuje přehled o skutečném chování problémů, což zvyšuje efektivitu techniky spolehlivosti lokality. Operace Azure IoT nabízí pozorovatelnost prostřednictvím vlastních kurátorovaných řídicích panelů Grafana hostovaných v Azure. Tyto řídicí panely využívají spravovanou službu Azure Monitor pro Prometheus a container Přehledy. V tomto článku se dozvíte, jak nakonfigurovat služby, které potřebujete pro pozorovatelnost.

Požadavky

Nakonfigurujte si vaše předplatné

Spuštěním následujícího kódu zaregistrujte poskytovatele v předplatném, ve kterém se nachází váš cluster:

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

Instalace komponent pozorovatelnosti

Kroky v této části nainstalují sdílené monitorovací prostředky a nakonfigurují cluster s podporou Arc tak, aby pro tyto prostředky generoval signály pozorovatelnosti. Mezi sdílené monitorovací prostředky patří Azure Managed Grafana, Azure Monitor Workspace, Azure Managed Prometheus, Azure Log Analytics a container Přehledy.

  1. V konzole přejděte do místní složky, do které chcete naklonovat úložiště operací Azure IoT:

    Poznámka:

    Úložiště obsahuje definici nasazení operací Azure IoT a ukázky, které zahrnují ukázkové řídicí panely použité v tomto článku.

  2. Naklonujte úložiště do místního počítače pomocí následujícího příkazu:

    git clone https://github.com/Azure/azure-iot-operations.git
    
  3. V místní kopii úložiště přejděte na následující cestu:

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

  4. Pokud chcete nasadit komponenty pozorovatelnosti, spusťte následující příkaz. Použijte ID předplatného a skupinu prostředků clusteru s podporou Arc, který chcete monitorovat.

    Poznámka:

    Další volitelné parametry, které můžete nastavit, najdete v souboru bicep. Volitelné parametry můžou určovat například alternativní umístění pro prostředky clusteru.

    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
    

    Předchozí příkaz udělí uživateli, který ji spouští, přístup správce pro nově vytvořenou instanci Grafana. Pokud tento přístup není to, co chcete, spusťte místo toho následující příkaz. Abyste mohli získat přístup k instanci Grafana, musíte oprávnění nastavit ručně.

    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
    

    Pokud chcete oprávnění nastavit ručně, přidejte do instance Grafany přiřazení role všem uživatelům, kteří by měli mít přístup. Přiřaďte jednu z rolí Grafana (Grafana Správa, Grafana Editor, Grafana Viewer) v závislosti na požadované úrovni přístupu.

Pokud nasazení proběhne úspěšně, na konci výstupu příkazu se vytiskne několik informací. Tyto informace zahrnují adresu URL Grafany a ID prostředků pro vytvořené prostředky Log Analytics i Azure Monitor. Adresa URL Grafany umožňuje přejít na instanci Grafany, kterou nakonfigurujete v části Nasazení řídicích panelů do Grafany. Dvě ID prostředků umožňují nakonfigurovat další clustery s podporou Arc podle kroků v části Přidání clusteru s podporou arc do existující infrastruktury pozorovatelnosti.

Konfigurace kolekce metrik Prometheus

  1. Zkopírujte a vložte následující konfiguraci do nového souboru s názvem ama-metrics-prometheus-config.yaml a uložte soubor:

    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. Pokud chcete použít konfigurační soubor, který jste vytvořili, spusťte následující příkaz:

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

Nasazení řídicích panelů do Grafany

Operace Azure IoT poskytují kolekci řídicích panelů navržených tak, aby vám poskytly řadu vizualizací, které potřebujete k pochopení stavu a výkonu nasazení operací Azure IoT.

Provedením následujících kroků nainstalujte řídicí panely Grafana s kurátorovanými operacemi Azure IoT.

  1. Přihlaste se ke konzole Grafana a pak v pravém horním rohu aplikace Grafana vyberte + ikonu.

  2. Vyberte Importovat řídicí panel, podle pokynů přejděte na cestu samples\grafana-dashboards v místní klonované kopii úložiště a vyberte soubor řídicího panelu JSON.

  3. Po zobrazení výzvy aplikace vyberte spravovaný zdroj dat Prometheus.

  4. Vyberte příkaz Importovat