Bagikan melalui


Memulai: mengonfigurasi pengamatan di Pratinjau Operasi Azure IoT

Penting

Pratinjau Operasi Azure IoT – diaktifkan oleh Azure Arc saat ini dalam PRATINJAU. Anda tidak boleh menggunakan perangkat lunak pratinjau ini di lingkungan produksi.

Lihat Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure untuk persyaratan hukum yang berlaku pada fitur Azure dalam versi beta, pratinjau, atau belum dirilis secara umum.

Pengamatan memberikan visibilitas ke setiap lapisan konfigurasi Azure IoT Operations Anda. Ini memberi Anda wawasan tentang perilaku aktual masalah, yang meningkatkan efektivitas rekayasa keandalan situs. Operasi Azure IoT menawarkan pengamatan melalui dasbor Grafana yang dikurasi kustom yang dihosting di Azure. Dasbor ini didukung oleh layanan terkelola Azure Monitor untuk Prometheus dan oleh Container Insights. Artikel ini memperlihatkan kepada Anda cara mengonfigurasi layanan yang Anda butuhkan untuk pengamatan.

Prasyarat

Mengonfigurasi langganan Anda

Jalankan kode berikut untuk mendaftarkan penyedia dengan langganan tempat kluster Anda berada:

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

Menginstal komponen pengamatan

Langkah-langkah di bagian ini menginstal sumber daya pemantauan bersama dan mengonfigurasi kluster berkemampuan Arc Anda untuk memancarkan sinyal pengamatan ke sumber daya ini. Sumber daya pemantauan bersama termasuk Azure Managed Grafana, Azure Monitor Workspace, Azure Managed Prometheus, Azure Log Analytics, dan Container Insights.

  1. Di konsol Anda, navigasikan ke folder lokal tempat Anda ingin mengkloning repositori Operasi Azure IoT:

    Catatan

    Repositori berisi definisi penyebaran Operasi Azure IoT, dan sampel yang menyertakan dasbor sampel yang digunakan dalam artikel ini.

  2. Kloning repositori ke komputer lokal Anda, menggunakan perintah berikut:

    git clone https://github.com/Azure/azure-iot-operations.git
    
  3. Navigasi ke jalur berikut di salinan repositori lokal Anda:

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

  4. Untuk menyebarkan komponen observabilitas, jalankan perintah berikut. Gunakan ID langganan dan grup sumber daya kluster berkemampuan Arc yang ingin Anda pantau.

    Catatan

    Untuk menemukan parameter opsional lain yang dapat Anda atur, lihat file bicep. Parameter opsional dapat menentukan hal-hal seperti lokasi alternatif untuk sumber daya kluster.

    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
    

    Perintah sebelumnya memberikan akses admin untuk instans Grafana yang baru dibuat kepada pengguna yang menjalankannya. Jika akses tersebut bukan yang Anda inginkan, jalankan perintah berikut sebagai gantinya. Anda perlu menyiapkan izin secara manual sebelum siapa pun dapat mengakses instans Grafana.

    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
    

    Untuk menyiapkan izin secara manual, tambahkan penetapan peran ke instans Grafana untuk setiap pengguna yang harus memiliki akses. Tetapkan salah satu peran Grafana (Grafana Admin, Grafana Editor, Grafana Viewer) tergantung pada tingkat akses yang diinginkan.

Jika penyebaran berhasil, beberapa informasi akan dicetak di akhir output perintah. Informasi ini mencakup URL Grafana dan ID sumber daya untuk sumber daya Log Analytics dan Azure Monitor yang dibuat. URL Grafana memungkinkan Anda menavigasi ke instans Grafana yang Anda konfigurasi di Menyebarkan dasbor ke Grafana. Dua ID sumber daya memungkinkan Anda mengonfigurasi kluster berkemampuan Arc lainnya dengan mengikuti langkah-langkah dalam Menambahkan kluster berkemampuan Arc ke infrastruktur pengamatan yang ada.

Mengonfigurasi koleksi metrik Prometheus

  1. Salin dan tempel konfigurasi berikut ke file baru bernama ama-metrics-prometheus-config.yaml, dan simpan file:

    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. Untuk menerapkan file konfigurasi yang Anda buat, jalankan perintah berikut:

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

Menyebarkan dasbor ke Grafana

Operasi Azure IoT menyediakan kumpulan dasbor yang dirancang untuk memberi Anda banyak visualisasi yang Anda butuhkan untuk memahami kesehatan dan performa penyebaran Operasi Azure IoT Anda.

Selesaikan langkah-langkah berikut untuk menginstal dasbor Grafana yang dikumpulkan Azure IoT Operations.

  1. Masuk ke konsol Grafana, lalu di area kanan atas aplikasi Grafana, pilih + ikon

  2. Pilih Impor dasbor, ikuti perintah untuk menelusuri jalur samples\grafana-dashboards di salinan repositori kloning lokal Anda, dan pilih file dasbor JSON

  3. Saat aplikasi meminta, pilih sumber data Prometheus terkelola Anda

  4. Pilih Impor