Kubernetes クラスターの監視を有効にする

CLI を使用して有効にする

次のコマンドで既存の Azure Monitor ワークスペースを指定しないと、リソース グループの既定のワークスペースが使われます。 クラスターのリージョンに既定のワークスペースがまだ存在しない場合は、DefaultAzureMonitorWorkspace-<mapped_region> という形式の名前を持つワークスペースが、DefaultRG-<cluster_region> という名前のリソース グループに作成されます。

前提条件

• Az CLI バージョン 2.49.0 以降が必要です。
• az extension remove --name aks-preview コマンドを使って、aks-preview 拡張機能を AKS クラスターからアンインストールする必要があります。
• az extension add --name k8s-extension コマンドを使って、k8s-extension 拡張機能をインストールする必要があります。
• k8s-extension バージョン 1.4.1 以降が必要です。

AKS クラスター

az aks create または az aks update (新規クラスターの作成か、既存クラスターの更新かに応じて) で -enable-azure-monitor-metrics オプションを使って、Prometheus メトリックをスクレイピングするメトリック アドオンをインストールします。

サンプル コマンド

### Use default Azure Monitor workspace
az aks create/update --enable-azure-monitor-metrics --name <cluster-name> --resource-group <cluster-resource-group>

### Use existing Azure Monitor workspace
az aks create/update --enable-azure-monitor-metrics --name <cluster-name> --resource-group <cluster-resource-group> --azure-monitor-workspace-resource-id <workspace-name-resource-id>

### Use an existing Azure Monitor workspace and link with an existing Grafana workspace
az aks create/update --enable-azure-monitor-metrics --name <cluster-name> --resource-group <cluster-resource-group> --azure-monitor-workspace-resource-id <azure-monitor-workspace-name-resource-id> --grafana-resource-id  <grafana-workspace-name-resource-id>

### Use optional parameters
az aks create/update --enable-azure-monitor-metrics --name <cluster-name> --resource-group <cluster-resource-group> --ksm-metric-labels-allow-list "namespaces=[k8s-label-1,k8s-label-n]" --ksm-metric-annotations-allow-list "pods=[k8s-annotation-1,k8s-annotation-n]"

Arc 対応クラスター

### Use default Azure Monitor workspace
az k8s-extension create --name azuremonitor-metrics --cluster-name <cluster-name> --resource-group <resource-group> --cluster-type connectedClusters --extension-type Microsoft.AzureMonitor.Containers.Metrics

## Use existing Azure Monitor workspace
az k8s-extension create --name azuremonitor-metrics --cluster-name <cluster-name> --resource-group <resource-group> --cluster-type connectedClusters --extension-type Microsoft.AzureMonitor.Containers.Metrics --configuration-settings azure-monitor-workspace-resource-id=<workspace-name-resource-id>

### Use an existing Azure Monitor workspace and link with an existing Grafana workspace
az k8s-extension create --name azuremonitor-metrics --cluster-name <cluster-name> --resource-group <resource-group> --cluster-type connectedClusters --extension-type Microsoft.AzureMonitor.Containers.Metrics --configuration-settings azure-monitor-workspace-resource-id=<workspace-name-resource-id> grafana-resource-id=<grafana-workspace-name-resource-id>

### Use optional parameters
az k8s-extension create --name azuremonitor-metrics --cluster-name <cluster-name> --resource-group <resource-group> --cluster-type connectedClusters --extension-type Microsoft.AzureMonitor.Containers.Metrics --configuration-settings azure-monitor-workspace-resource-id=<workspace-name-resource-id> grafana-resource-id=<grafana-workspace-name-resource-id> AzureMonitorMetrics.KubeStateMetrics.MetricAnnotationsAllowList="pods=[k8s-annotation-1,k8s-annotation-n]" AzureMonitorMetrics.KubeStateMetrics.MetricLabelsAllowlist "namespaces=[k8s-label-1,k8s-label-n]"

どのコマンドでも、次の省略可能なパラメーターを使用できます。

• AKS: --ksm-metric-annotations-allow-list
  Arc: --AzureMonitorMetrics.KubeStateMetrics.MetricAnnotationsAllowList
  リソースの kube_resource_annotations メトリックで使用される Kubernetes 注釈キーのコンマ区切りリスト。 たとえば、kube_pod_annotations はポッド リソースの注釈メトリックです。 既定では、このメトリックには名前と名前空間のラベルのみが含まれます。 注釈をさらに含めるには、複数形のリソース名と、それらを許可する Kubernetes 注釈キーの一覧を指定します。 リソースごとに 1 つの * を指定して任意の注釈を許可できますが、これはパフォーマンスに重大な影響を及ぼします。 たとえば、pods=[kubernetes.io/team,...],namespaces=[kubernetes.io/team],... のようにします。
  
• AKS: --ksm-metric-labels-allow-list
  Arc: --AzureMonitorMetrics.KubeStateMetrics.MetricLabelsAllowlist
  リソースの kube_resource_labels メトリック kube_resource_labels メトリックで使用されるその他の Kubernetes ラベル キーのコンマ区切りリスト。 たとえば、kube_pod_labels はポッド リソースのラベル メトリックです。 既定では、このメトリックには名前と名前空間のラベルのみが含まれます。 さらに多くのラベルを含めるには、複数形のリソース名のリストと、それらに対して許可する Kubernetes ラベル キーを指定します。リソースごとに 1 つの * を指定して任意のラベルを許可できますが、これはパフォーマンスに重大な影響を及ぼします。 たとえば、pods=[app],namespaces=[k8s-label-1,k8s-label-n,...],... のようにします。
  
• AKS: --enable-windows-recording-rules Windows ダッシュボードの適切な機能に必要な記録ルール グループを有効にできます。

ARM テンプレートを使用して有効にする

前提条件

• Azure Monitor ワークスペースと Azure Managed Grafana インスタンスが既に作成されている必要があります。
• テンプレートは、Azure Managed Grafana インスタンスと同じリソース グループにデプロイする必要があります。
• Azure Managed Grafana のインスタンスが Azure Monitor ワークスペース サブスクリプション以外のサブスクリプションにある場合は、「リソース プロバイダーの登録」のガイダンスを使って、Azure Monitor ワークスペース サブスクリプションを Microsoft.Dashboard リソース プロバイダーに登録します。
• AKS クラスターのサブスクリプションで User Access Administrator ロールを持つユーザーは、テンプレートをデプロイすると、Monitoring Reader ロールを直接有効にできます。

Grafana リソースに必要な値を取得する

Azure Managed Grafana のインスタンスが Azure Monitor ワークスペースに既にリンクされている場合は、この一覧をテンプレートに含める必要があります。 Azure portal の Azure Managed Grafana インスタンスの [概要] ページで [JSON ビュー] を選び、次のサンプルのような azureMonitorWorkspaceIntegrations の値をコピーします。 存在しない場合、インスタンスはどの Azure Monitor ワークスペースともリンクされていません。

"properties": {
    "grafanaIntegrations": {
        "azureMonitorWorkspaceIntegrations": [
            {
                "azureMonitorWorkspaceResourceId": "full_resource_id_1"
            },
            {
                "azureMonitorWorkspaceResourceId": "full_resource_id_2"
            }
        ]
    }
}

テンプレートとパラメーター ファイルをダウンロードして編集する

1. 使用している Kubernetes クラスターの種類に必要なファイルをダウンロードします。

   AKS クラスターの ARM

   • テンプレート ファイル: https://aka.ms/azureprometheus-enable-arm-template
   • パラメーター ファイル: https://aka.ms/azureprometheus-enable-arm-template-parameters

   AKS クラスターの Bicep

   • テンプレート ファイル: https://aka.ms/azureprometheus-enable-bicep-template
   • パラメーター ファイル: https://aka.ms/azureprometheus-enable-bicep-template-parameters
   • DCRA モジュール: https://aka.ms/nested_azuremonitormetrics_dcra_clusterResourceId
   • プロファイル モジュール: https://aka.ms/nested_azuremonitormetrics_profile_clusterResourceId
   • Azure Managed Grafana ロールの割り当てモジュール: https://aka.ms/nested_grafana_amw_role_assignment

   Arc 対応クラスターの ARM

   • テンプレート ファイル: https://aka.ms/azureprometheus-arc-arm-template
   • パラメーター ファイル: https://aka.ms/azureprometheus-arc-arm-template-parameters

2. パラメーター ファイルで次の値を編集します。 ARM と Bicep 両方のテンプレートで同じ値のセットが使われます。 [概要] ページの [JSON ビュー] からリソースのリソース ID を取得します。

   パラメーター	値
   azureMonitorWorkspaceResourceId	Azure Monitor ワークスペースのリソース ID。 Azure Monitor ワークスペースの [概要] ページの [JSON ビュー] から取得します。
   azureMonitorWorkspaceLocation	Azure Monitor ワークスペースの場所。 Azure Monitor ワークスペースの [概要] ページの [JSON ビュー] から取得します。
   clusterResourceId	AKS クラスターのリソース ID。 クラスターの [概要] ページの [JSON ビュー] から取得します。
   clusterLocation	AKS クラスターの場所。 クラスターの [概要] ページの [JSON ビュー] から取得します。
   metricLabelsAllowlist	リソースのラベル メトリックで使用される Kubernetes ラベル キーのコンマ区切りリスト。
   metricAnnotationsAllowList	リソースの注釈メトリックで使用される追加の Kubernetes ラベル キーのコンマ区切りリスト。
   grafanaResourceId	マネージド Grafana インスタンスのリソース ID。 Grafana インスタンスの [概要] ページの [JSON ビュー] から取得します。
   grafanaLocation	マネージド Grafana インスタンスの場所。 Grafana インスタンスの [概要] ページの [JSON ビュー] から取得します。
   grafanaSku	マネージド Grafana インスタンスの SKU。 Grafana インスタンスの [概要] ページの [JSON ビュー] から取得します。 [sku.name] を使用します。

3. テンプレート ファイルを開き、ファイルの末尾にある grafanaIntegrations プロパティを、Grafana インスタンスから取得した値で更新します。 これは次のサンプルのようになります。 これらのサンプルでは、full_resource_id_1 と full_resource_id_2 は Azure Managed Grafana リソース JSON に既にありました。 最後の azureMonitorWorkspaceResourceId のエントリは既にテンプレートにあり、パラメーター ファイルに指定された Azure Monitor ワークスペース リソース ID にリンクするために使われます。

   ARM

   {
       "type": "Microsoft.Dashboard/grafana",
       "apiVersion": "2022-08-01",
       "name": "[split(parameters('grafanaResourceId'),'/')[8]]",
       "sku": {
           "name": "[parameters('grafanaSku')]"
       },
       "location": "[parameters('grafanaLocation')]",
       "properties": {
           "grafanaIntegrations": {
           "azureMonitorWorkspaceIntegrations": [
               {
                   "azureMonitorWorkspaceResourceId": "full_resource_id_1"
               },
               {
                   "azureMonitorWorkspaceResourceId": "full_resource_id_2"
               },
               {
                   "azureMonitorWorkspaceResourceId": "[parameters('azureMonitorWorkspaceResourceId')]"
               }
           ]
           }
       }
   }
   

   Bicep

       resource grafanaResourceId_8 'Microsoft.Dashboard/grafana@2022-08-01' = {
           name: split(grafanaResourceId, '/')[8]
           sku: {
               name: grafanaSku
           }
           identity: {
               type: 'SystemAssigned'
           }
           location: grafanaLocation
           properties: {
               grafanaIntegrations: {
                   azureMonitorWorkspaceIntegrations: [
                       {
                           azureMonitorWorkspaceResourceId: 'full_resource_id_1'
                       }
                       {
                           azureMonitorWorkspaceResourceId: 'full_resource_id_2'
                       }
                       {
                           azureMonitorWorkspaceResourceId: azureMonitorWorkspaceResourceId
                       }
                   ]
               }
           }
       }
   

4. Resource Manager テンプレートのデプロイに使用できる任意の方法を使用して、パラメーター ファイルと共にテンプレートをデプロイします。 さまざまな方法の例については、「サンプル テンプレートをデプロイする」を参照してください。

Terraform を使用して有効にする

前提条件

• Azure Monitor ワークスペースと Azure Managed Grafana ワークスペースが既に作成されている必要があります。
• テンプレートは、Azure Managed Grafana ワークスペースと同じリソース グループにデプロイする必要があります。
• AKS クラスターのサブスクリプションでユーザー アクセス管理者ロールを持つユーザーは、テンプレートをデプロイすると、監視閲覧者ロールを直接有効にできます。
• Azure Managed Grafana インスタンスが Azure Monitor ワークスペース サブスクリプション以外のサブスクリプションにある場合は、このドキュメントに従って Azure Monitor ワークスペース サブスクリプションを Microsoft.Dashboard リソース プロバイダーに登録します。

Grafana リソースに必要な値を取得する

Azure portal の Azure Managed Grafana インスタンスの [概要] ページで、[JSON ビュー] を選びます。

Azure Monitor ワークスペースに既にリンクされている既存の Azure Managed Grafana インスタンスを使用している場合は、Grafana 統合の一覧が必要です。 [azureMonitorWorkspaceIntegrations] フィールドの値をコピーします。 存在しない場合、インスタンスはどの Azure Monitor ワークスペースともリンクされていません。 main.tf の azure_monitor_workspace_integrations ブロックを、Grafana 統合のリストで更新します。

  azure_monitor_workspace_integrations {
    resource_id  = var.monitor_workspace_id[var.monitor_workspace_id1, var.monitor_workspace_id2]
  }

テンプレートをダウンロードして編集する

マネージド Prometheus アドオンを有効にした Terraform を使用して新しい AKS クラスターをデプロイする場合は、次の手順に従います。

1. AddonTerraformTemplate の下のすべてのファイルをダウンロードしてください。
2. 正しいパラメーター値を使用して variables.tf ファイル内の変数を編集します。
3. terraform init -upgrade を実行して、Terraform のデプロイを初期化します。
4. terraform plan -out main.tfplan を実行して、Terraform のデプロイを初期化します。
5. terraform apply main.tfplan を実行して、クラウド インフラストラクチャに実行プランを適用します。

注: main.tf の annotations_allowed および labels_allowed キーには、これらの値が存在する場合にのみ変数を渡します。 これらは省略可能なブロックです。

Azure Policy による有効化

1. Azure Policy テンプレートとパラメーター ファイルをダウンロードします。

   • テンプレート ファイル: https://aka.ms/AddonPolicyMetricsProfile
   • パラメーター ファイル: https://aka.ms/AddonPolicyMetricsProfile.parameters

2. 次の CLI コマンドを使って、ポリシー定義を作成します。

   az policy definition create --name "Prometheus Metrics addon" --display-name "Prometheus Metrics addon" --mode Indexed --metadata version=1.0.0 category=Kubernetes --rules AddonPolicyMetricsProfile.rules.json --params AddonPolicyMetricsProfile.parameters.json

3. ポリシー定義を作成したら、Azure portal で [ポリシー]、[定義] の順に選びます。 作成したポリシー定義を選びます。

4. [割り当て] を選び、[パラメーター] タブで詳細を入力します。[確認および作成] を選択します。

5. 既存のクラスターにポリシーを適用する場合は、[ポリシー割り当て] から、そのクラスター リソース用の修復タスクを作成します。

ポリシーがサブスクリプションに割り当てられた後、Prometheus が有効になっていない新しいクラスターを作成するたびに、ポリシーが実行およびデプロイされ、Prometheus 監視が有効になります。

AKS クラスターと Arc 対応クラスターの監視を有効にするには、次のいずれかのコマンドを使います。 既存の Log Analytics ワークスペースを指定しないと、リソース グループの既定のワークスペースが使われます。 クラスターのリージョンに既定のワークスペースがまだ存在していない場合は、DefaultWorkspace-<GUID>-<Region> という形式の名前で作成されます。

前提条件

• Azure CLI バージョン 2.43.0 以降
• CLI バージョン 2.49.0 以降では、マネージド ID 認証が既定です。
• Azure k8s-extension バージョン 1.3.7 以降
• マネージド ID 認証は、k8s-extension バージョン 1.43.0 以降の既定値です。
• マネージド ID 認証は、ARO (Azure Red Hat Openshift) または Windows ノードを使する Arc 対応 Kubernetes クラスターではサポートされていません。 レガシ認証を使ってください。
• CLI バージョン 2.54.0 以降の場合、ログ スキーマは ConfigMap を使って ContainerLogV2 に構成されます。

AKS クラスター

### Use default Log Analytics workspace
az aks enable-addons --addon monitoring --name <cluster-name> --resource-group <cluster-resource-group-name>

### Use existing Log Analytics workspace
az aks enable-addons --addon monitoring --name <cluster-name> --resource-group <cluster-resource-group-name> --workspace-resource-id <workspace-resource-id>

### Use legacy authentication
az aks enable-addons --addon monitoring --name <cluster-name> --resource-group <cluster-resource-group-name> --workspace-resource-id <workspace-resource-id> --enable-msi-auth-for-monitoring false

例

az aks enable-addons --addon monitoring --name "my-cluster" --resource-group "my-resource-group" --workspace-resource-id "/subscriptions/my-subscription/resourceGroups/my-resource-group/providers/Microsoft.OperationalInsights/workspaces/my-workspace"

Arc 対応クラスター

### Use default Log Analytics workspace
az k8s-extension create --name azuremonitor-containers --cluster-name <cluster-name> --resource-group <resource-group> --cluster-type connectedClusters --extension-type Microsoft.AzureMonitor.Containers

### Use existing Log Analytics workspace
az k8s-extension create --name azuremonitor-containers --cluster-name <cluster-name> --resource-group <resource-group> --cluster-type connectedClusters --extension-type Microsoft.AzureMonitor.Containers --configuration-settings logAnalyticsWorkspaceResourceID=<workspace-resource-id>

### Use managed identity authentication (default as k8s-extension version 1.43.0)
az k8s-extension create --name azuremonitor-containers --cluster-name <cluster-name> --resource-group <resource-group> --cluster-type connectedClusters --extension-type Microsoft.AzureMonitor.Containers --configuration-settings amalogs.useAADAuth=true

### Use advanced configuration settings
az k8s-extension create --name azuremonitor-containers --cluster-name <cluster-name> --resource-group <resource-group> --cluster-type connectedClusters --extension-type Microsoft.AzureMonitor.Containers --configuration-settings  amalogs.resources.daemonset.limits.cpu=150m amalogs.resources.daemonset.limits.memory=600Mi amalogs.resources.deployment.limits.cpu=1 amalogs.resources.deployment.limits.memory=750Mi

### With custom mount path for container stdout & stderr logs
### Custom mount path not required for Azure Stack Edge version > 2318. Custom mount path must be /home/data/docker for Azure Stack Edge cluster with version <= 2318
az k8s-extension create --name azuremonitor-containers --cluster-name <cluster-name> --resource-group <resource-group> --cluster-type connectedClusters --extension-type Microsoft.AzureMonitor.Containers --configuration-settings amalogs.logsettings.custommountpath=<customMountPath>

使用できる構成設定については、Helm チャートのリソース要求と制限のセクションをご覧ください。

例

az k8s-extension create --name azuremonitor-containers --cluster-name "my-cluster" --resource-group "my-resource-group" --cluster-type connectedClusters --extension-type Microsoft.AzureMonitor.Containers --configuration-settings logAnalyticsWorkspaceResourceID="/subscriptions/my-subscription/resourceGroups/my-resource-group/providers/Microsoft.OperationalInsights/workspaces/my-workspace"

転送プロキシを使用する Arc 対応クラスター

クラスターが転送プロキシで構成されている場合、プロキシ設定が拡張機能に自動的に適用されます。 AMPLS + プロキシを使用するクラスターの場合、プロキシ構成は無視する必要があります。 構成設定 amalogs.ignoreExtensionProxySettings=trueを使用して拡張機能をオンボードします。

az k8s-extension create --name azuremonitor-containers --cluster-name <cluster-name> --resource-group <resource-group> --cluster-type connectedClusters --extension-type Microsoft.AzureMonitor.Containers --configuration-settings amalogs.ignoreExtensionProxySettings=true

ARO、OpenShift または Windows ノードを使用する Arc 対応クラスター

マネージド ID 認証は、ARO (Azure Red Hat OpenShift)、OpenShift または Windows ノードを使用する Arc 対応 Kubernetes クラスターではサポートされていません。 次の例に示すように、amalogs.useAADAuth=false を指定してレガシ認証を使います。

az k8s-extension create --name azuremonitor-containers --cluster-name <cluster-name> --resource-group <resource-group> --cluster-type connectedClusters --extension-type Microsoft.AzureMonitor.Containers --configuration-settings amalogs.useAADAuth=false

拡張機能のインスタンスを削除する

次のコマンドでは、拡張機能インスタンスのみが削除され、Log Analytics ワークスペースは削除されません。 Log Analytics リソース内のデータはそのまま残ります。

az k8s-extension delete --name azuremonitor-containers --cluster-type connectedClusters --cluster-name <cluster-name> --resource-group <resource-group>

このセクションでは、ARM テンプレートと Bicep テンプレートの両方について説明します。

前提条件

• テンプレートはクラスターと同じリソース グループ内にデプロイする必要があります。

テンプレートをダウンロードしてインストールする

1. テンプレートとパラメーター ファイルをダウンロードして編集する

   AKS クラスターの ARM

   • テンプレート ファイル: https://aka.ms/aks-enable-monitoring-msi-onboarding-template-file
   • パラメーター ファイル: https://aka.ms/aks-enable-monitoring-msi-onboarding-template-parameter-file

   AKS クラスターの Bicep

   • テンプレート ファイル (Syslog): https://aka.ms/enable-monitoring-msi-syslog-bicep-template
   • パラメーター ファイル (Syslog なし): https://aka.ms/enable-monitoring-msi-syslog-bicep-parameters
   • テンプレート ファイル (Syslog なし): https://aka.ms/enable-monitoring-msi-bicep-template
   • パラメーター ファイル (Syslog なし): https://aka.ms/enable-monitoring-msi-bicep-parameters

   Arc 対応クラスターの ARM

   • テンプレート ファイル: https://aka.ms/arc-k8s-azmon-extension-msi-arm-template
   • パラメーター ファイル: https://aka.ms/arc-k8s-azmon-extension-msi-arm-template-params
   • テンプレート ファイル (レガシ認証): https://aka.ms/arc-k8s-azmon-extension-arm-template
   • パラメーター ファイル (レガシ認証): https://aka.ms/arc-k8s-azmon-extension-arm-template-params

2. パラメーター ファイルで次の値を編集します。 ARM と Bicep 両方のテンプレートで同じ値のセットが使われます。 [概要] ページの [JSON ビュー] からリソースのリソース ID を取得します。

   パラメーター	説明
   AKS: aksResourceId Arc: clusterResourceId	クラスターのリソース ID。
   AKS: aksResourceLocation Arc: clusterRegion	クラスターの場所。
   AKS: workspaceResourceId Arc: workspaceResourceId	Log Analytics ワークスペースのリソース ID。
   Arc: workspaceRegion	Log Analytics ワークスペースのリージョン。
   Arc: workspaceDomain	Log Analytics ワークスペースのドメイン。 opinsights.azure.com: Azure パブリック クラウドの場合 AzureUSGovernment のopinsights.azure.us。
   AKS: resourceTagValues	クラスターの既存のコンテナーの分析情報拡張機能のデータ収集ルール (DCR) に指定された既存のタグ値と、DCR の名前。 名前は MSCI-<clusterName>-<clusterRegion> となり、このリソースは AKS クラスターのリソース グループに作成されます。 初めてのオンボードでは、任意のタグ値を設定できます。

3. Resource Manager テンプレートのデプロイに使用できる任意の方法を使用して、パラメーター ファイルと共にテンプレートをデプロイします。 さまざまな方法の例については、「サンプル テンプレートをデプロイする」を参照してください。

新しい AKS クラスター

1. Syslog collection を有効にするかどうかに応じて、Terraform テンプレート ファイルをダウンロードします。

   Syslog

   • https://aka.ms/enable-monitoring-msi-syslog-terraform

   Syslog なし

   • https://aka.ms/enable-monitoring-msi-terraform

2. クラスターの設定に基づいて、main.tf で azurerm_kubernetes_cluster リソースを調整します。

3. variables.tf のパラメーターを更新して、"<>" の値を置き換えます

   パラメーター	説明
   aks_resource_group_name	リソース グループについて [AKS の概要] ページの値を使用します。
   resource_group_location	リソース グループについて [AKS の概要] ページの値を使用します。
   cluster_name	作成するクラスター名を定義します。
   workspace_resource_id	Log Analytics ワークスペースのリソース ID を使用します。
   workspace_region	Log Analytics ワークスペースの場所を使用します。
   resource_tag_values	クラスターの既存の Container Insights 拡張機能のデータ収集ルール (DCR) に指定された既存のタグ値と DCR の名前に一致します。 名前が MSCI-<clusterName>-<clusterRegion> と一致し、このリソースは AKS クラスターと同じリソース グループに作成されます。 初回オンボードの場合は、任意のタグ値をセットできます。
   enabledContainerLogV2	推奨される既定の ContainerLogV2 を使用するには、このパラメーター値を true に設定します
   コスト最適化パラメーター	データ コレクションのパラメーターを参照してください

4. terraform init -upgrade を実行して、Terraform のデプロイを初期化します。

5. terraform plan -out main.tfplan を実行して、Terraform のデプロイを初期化します。

6. terraform apply main.tfplan を実行して、クラウド インフラストラクチャに実行プランを適用します。

既存の AKS クラスター

1. 次のコマンドを使用して、既存のクラスター リソースを最初にインポートします: terraform import azurerm_kubernetes_cluster.k8s <aksResourceId>
2. oms_agent アドオン プロファイルを既存の azurerm_kubernetes_cluster リソースに追加します。

   oms_agent {
       log_analytics_workspace_id = var.workspace_resource_id
       msi_auth_for_monitoring_enabled = true
     }
   

3. Terraform テンプレートから DCR リソースと DCRA リソースをコピーします
4. terraform plan -out main.tfplan を実行し、変更によって oms_agent プロパティが追加されていることを確認します。 注: terraform プラン中に定義された azurerm_kubernetes_cluster リソースが異なる場合、既存のクラスターは破棄されて再作成されます。
5. terraform apply main.tfplan を実行して、クラウド インフラストラクチャに実行プランを適用します。

Azure portal

1. Azure portal の [ポリシー] メニューの [定義] タブで、次の詳細を使ってポリシー定義を作成します。

   • [定義の場所]: ポリシー定義を格納する Azure サブスクリプション。
   • [名前]: AKS-Monitoring-Addon
   • [説明]: Azure Kubernetes クラスターに対して監視アドオンを有効にする Azure カスタム ポリシー。
   • [カテゴリ]: [既存のものを使用] を選び、ドロップダウン リストから [Kubernetes] を選びます。
   • [ポリシー ルール]: 既存のサンプル JSON を https://aka.ms/aks-enable-monitoring-custom-policy の内容に置き換えます。

2. 新しいポリシー定義 AKS-Monitoring-Addon を選びます。

3. [割り当て] を選択し、ポリシーを割り当てる [スコープ] を指定します。

4. [次へ] を選択し、Log Analytics ワークスペースのリソース ID を指定します。

5. 選択したスコープ内の既存の AKS クラスターにポリシーを適用する場合は、修復タスクを作成します。

6. [確認と作成]、を選択して、ポリシーの割り当てを作成します。

Azure CLI

1. Azure Policy テンプレートとパラメーター ファイルをダウンロードします。

   • テンプレート ファイル: https://aka.ms/enable-monitoring-msi-azure-policy-template
   • パラメーター ファイル: https://aka.ms/enable-monitoring-msi-azure-policy-parameters

2. 次の CLI コマンドを使って、ポリシー定義を作成します。

   az policy definition create --name "AKS-Monitoring-Addon-MSI" --display-name "AKS-Monitoring-Addon-MSI" --mode Indexed --metadata version=1.0.0 category=Kubernetes --rules azure-policy.rules.json --params azure-policy.parameters.json
   

3. 次の CLI コマンドを使って、ポリシー定義を作成します。

   az policy assignment create --name aks-monitoring-addon --policy "AKS-Monitoring-Addon-MSI" --assign-identity --identity-scope /subscriptions/<subscriptionId> --role Contributor --scope /subscriptions/<subscriptionId> --location <location> --role Contributor --scope /subscriptions/<subscriptionId> -p "{ \"workspaceResourceId\": { \"value\":  \"/subscriptions/<subscriptionId>/resourcegroups/<resourceGroupName>/providers/microsoft.operationalinsights/workspaces/<workspaceName>\" } }"
   

ポリシーがサブスクリプションに割り当てられた後、Prometheus が有効になっていない新しいクラスターを作成するたびに、ポリシーが実行およびデプロイされ、Prometheus 監視が有効になります。