Aracılığıyla paylaş


Kullanmaya başlama: Azure IoT İşlemleri Önizlemesi'nde gözlemlenebilirliği yapılandırma

Önemli

Azure Arc tarafından etkinleştirilen Azure IoT İşlemleri Önizlemesi şu anda ÖNİzLEME aşamasındadır. Bu önizleme yazılımını üretim ortamlarında kullanmamalısınız.

Beta veya önizleme aşamasında olan ya da başka bir şekilde henüz genel kullanıma sunulmamış olan Azure özelliklerinde geçerli olan yasal koşullar için bkz. Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları.

Gözlemlenebilirlik, Azure IoT İşlemleri yapılandırmanızın her katmanında görünürlük sağlar. Sorunların gerçek davranışı hakkında içgörü sağlar ve bu da site güvenilirliği mühendisliğinin verimliliğini artırır. Azure IoT İşlemleri, Azure'da barındırılan özel seçilmiş Grafana panoları aracılığıyla gözlemlenebilirlik sunar. Bu panolar Prometheus için Azure İzleyici yönetilen hizmeti ve Container Analizler tarafından desteklenir. Bu makalede, gözlemlenebilirlik için ihtiyacınız olan hizmetleri nasıl yapılandırabileceğiniz gösterilmektedir.

Önkoşullar

Aboneliğinizi yapılandırma

Sağlayıcıları kümenizin bulunduğu aboneliğe kaydetmek için aşağıdaki kodu çalıştırın:

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

Gözlemlenebilirlik bileşenlerini yükleme

Bu bölümdeki adımlar paylaşılan izleme kaynaklarını yükler ve Arc özellikli kümenizi bu kaynaklara gözlemlenebilirlik sinyalleri yayacak şekilde yapılandırabilir. Paylaşılan izleme kaynakları Arasında Azure Yönetilen Grafana, Azure İzleyici Çalışma Alanı, Azure Yönetilen Prometheus, Azure Log Analytics ve Container Analizler yer alır.

  1. Konsolunuzda, Azure IoT İşlemleri deponuzu kopyalamak istediğiniz yerel klasöre gidin:

    Not

    Depo, Azure IoT İşlemlerinin dağıtım tanımını ve bu makalede kullanılan örnek panoları içeren örnekleri içerir.

  2. Aşağıdaki komutu kullanarak depoyu yerel makinenize kopyalayın:

    git clone https://github.com/Azure/azure-iot-operations.git
    
  3. Deponuzun yerel kopyasında aşağıdaki yola gidin:

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

  4. Gözlemlenebilirlik bileşenlerini dağıtmak için aşağıdaki komutu çalıştırın. İzlemek istediğiniz Arc özellikli kümenizin abonelik kimliğini ve kaynak grubunu kullanın.

    Not

    Ayarlayabileceğiniz diğer isteğe bağlı parametreleri bulmak için bicep dosyasına bakın. İsteğe bağlı parametreler, küme kaynakları için alternatif konumlar gibi öğeleri belirtebilir.

    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
    

    Önceki komut, yeni oluşturulan Grafana örneği için yönetici erişimini çalıştıran kullanıcıya verir. İstediğiniz erişim bu değilse, bunun yerine aşağıdaki komutu çalıştırın. Herkesin Grafana örneğine erişebilmesi için önce izinleri el ile ayarlamanız gerekir.

    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
    

    İzinleri el ile ayarlamak için, erişimi olması gereken tüm kullanıcılar için Grafana örneğine bir rol ataması ekleyin. İstenen erişim düzeyine bağlı olarak Grafana rollerinden birini (Grafana Yönetici, Grafana Düzenleyicisi, Grafana Görüntüleyicisi) atayın.

Dağıtım başarılı olursa, komut çıkışının sonunda birkaç bilgi parçası yazdırılır. Bilgiler Grafana URL'sini ve oluşturulan Log Analytics ve Azure İzleyici kaynaklarının kaynak kimliklerini içerir. Grafana URL'si, Panoları Grafana'ya dağıtma bölümünde yapılandırdığınız Grafana örneğine gitmenize olanak tanır. İki kaynak kimliği, Mevcut gözlemlenebilirlik altyapısına Arc özellikli küme ekleme bölümünde yer alan adımları izleyerek Diğer Arc özellikli kümeleri yapılandırmanıza olanak tanır.

Prometheus ölçüm koleksiyonunu yapılandırma

  1. Aşağıdaki yapılandırmayı kopyalayıp ama-metrics-prometheus-config.yaml adlı yeni bir dosyaya yapıştırın ve dosyayı kaydedin:

    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. Oluşturduğunuz yapılandırma dosyasını uygulamak için aşağıdaki komutu çalıştırın:

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

Grafana'ya pano dağıtma

Azure IoT İşlemleri, Azure IoT İşlemleri dağıtımınızın sistem durumunu ve performansını anlamanız için ihtiyacınız olan görselleştirmelerin birçoğunu size sunmak için tasarlanmış bir pano koleksiyonu sağlar.

Azure IoT İşlemleri tarafından seçilmiş Grafana panolarını yüklemek için aşağıdaki adımları tamamlayın.

  1. Grafana konsolunda oturum açın, ardından Grafana uygulamasının + sağ üst kısmında

  2. Panoyu içeri aktar'ı seçin, istemleri izleyerek deponun yerel kopyanızdaki samples\grafana-dashboards yoluna gidin ve bir JSON pano dosyası seçin

  3. Uygulama sorulduğunda yönetilen Prometheus veri kaynağınızı seçin

  4. İçeri aktar'ı seçin