概要: Azure IoT Operations プレビューでスクリプトを使用して監視を構成する

監視により、Azure IoT Operations Preview 構成のすべてのレイヤーが可視化されます。 これは、問題の実際の動作に関する分析情報を提供し、サイト信頼性エンジニアリングの有効性を高めます。 Azure IoT Operations を使用すると、Azure でホストされているカスタム キュレーションされた Grafana ダッシュボードを通じて、可観測性が提供されます。 これらのダッシュボードは、Prometheus 用の Azure Monitor マネージド サービスと Container Insights を利用しています。 この記事では、監視に必要なサービスを構成する方法を示します。

前提条件

• Azure IoT Operations Preview がインストールされていること。 詳細については、「クイックスタート: K3s を使用して GitHub Codespaces で Azure IoT Operations プレビューを実行する」を参照してください。
• リポジトリをクローンするための Git。

サブスクリプションの構成

次のコードを実行して、クラスターが配置されているサブスクリプションにプロバイダーを登録します。

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

監視コンポーネントをインストールする

このセクションの手順では、共有監視リソースをインストールし、これらのリソースに監視信号を出力するように Arc 対応クラスターを構成します。 共有監視リソースには、Azure Managed Grafana、Azure Monitor ワークスペース、Azure Managed Prometheus、Azure Log Analytics、Container Insights が含まれます。

1. コンソール内で、Azure IoT Operations リポジトリをクローンするローカル フォルダーに移動します。

   Note

   リポジトリには、Azure IoT Operations のデプロイ定義と、この記事で使用するサンプル ダッシュボードを含むサンプルが含まれています。

2. 次のコマンドを使用して、リポジトリをローカル コンピューターにクローンします。

   git clone https://github.com/Azure/azure-iot-operations.git
   

3. リポジトリのローカル コピー内で次のパスを参照します。

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

4. 監視コンポーネントをデプロイするには、次のコマンドを実行します。 監視する Arc 対応クラスターのサブスクリプション ID とリソース グループを使用します。

   Note

   設定できるその他の省略可能なパラメーターについては、bicep ファイルを参照してください。 省略可能なパラメーターでは、クラスター リソースの代替の場所などを指定できます。

   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
   

   前のコマンドでは、新しく作成された Grafana インスタンスの管理者アクセス権を、それを実行するユーザーに付与します。 そのアクセス権が必要でない場合は、代わりに次のコマンドを実行します。 誰もが 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
   

   アクセス許可を手動で設定するには、アクセス権を持つ必要があるすべてのユーザーの Grafana インスタンスにロールの割り当てを追加します。 必要なアクセス レベルに応じて、いずれかの Grafana ロール (Grafana 管理者、Grafana 編集者、Grafana 閲覧者) を割り当てます。

デプロイが成功すると、コマンド出力の最後にいくつかの情報が出力されます。 この情報には、Grafana URL と、作成された Log Analytics と Azure Monitor の両方のリソースのリソース ID が含まれます。 Grafana URL を使用すると、「ダッシュボードを Grafana にデプロイする」の中で構成した Grafana インスタンスに移動できます。 2 つのリソース ID を使用すると、「＠既存の監視インフラストラクチャ に Arc 対応クラスターを追加する」の手順に従って、他の Arc 対応クラスターを構成できます。

Prometheus メトリック コレクションを構成する

1. 次の構成をコピーし、ama-metrics-prometheus-config.yaml という名前の新しいファイルに貼り付け、ファイルを保存します。

   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. 作成した構成ファイルを適用するには、次のコマンドを実行します。

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

ダッシュボードを Grafana にデプロイする

Azure IoT Operations には、Azure IoT Operations デプロイの正常性とパフォーマンスを把握するために必要な視覚化の多くを提供するように設計された、ダッシュボードのコレクションが用意されています。

Azure IoT Operations でキュレーションされた Grafana ダッシュボードをインストールするには、次の手順を実行します。

1. Grafana コンソールにサインインし、Grafana アプリケーションの右上の領域で [+] アイコンを選択します

2. [ダッシュボードのインポート] を選択し、プロンプトに従って、クローンしたリポジトリのローカル コピーの samples\grafana-dashboards パスを参照し、JSON ダッシュボード ファイルを選びます

3. アプリケーションのプロンプトが表示されたら、マネージド Prometheus データ ソースを選択します

4. インポート を選択する

関連するコンテンツ

• Azure Monitor の概要
• 監視リソースを手動で展開する方法