Azure Monitor エージェントのインストールと管理

エージェントをインストールし、Azure portal を使用してデータを収集するための DCR を作成するには、「Azure Monitor エージェントを使用してデータを収集する」のガイダンスに従ってください。

仮想マシン拡張機能を追加するための PowerShell コマンドを使用して、Azure 仮想マシンまたは Azure Arc 対応サーバーに Azure Monitor エージェントをインストールできます。

Azure 仮想マシン

次の PowerShell コマンドを使用して、Azure 仮想マシンに Azure Monitor エージェントをインストールします。 使用する認証方法に基づいて適切なコマンドを選択してください。

• Windows

  ## User-assigned managed identity
  Set-AzVMExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true -SettingString '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
  
  ## System-assigned managed identity
  Set-AzVMExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true
  

• Linux

  ## User-assigned managed identity
  Set-AzVMExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true -SettingString '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
  
  ## System-assigned managed identity
  Set-AzVMExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true
  

Azure 仮想マシン スケール セット

Add-AzVmssExtension PowerShell コマンドレットを使用して、Azure 仮想マシン スケール セットに Azure Monitor エージェントをインストールします。

Azure Arc 対応サーバー

次の PowerShell コマンドを使用して、Azure Arc 対応サーバーに Azure Monitor エージェントをインストールします。

• Windows

  New-AzConnectedMachineExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -MachineName <arc-server-name> -Location <arc-server-location> -EnableAutomaticUpgrade
  

• Linux

  New-AzConnectedMachineExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -MachineName <arc-server-name> -Location <arc-server-location> -EnableAutomaticUpgrade
  

仮想マシン拡張機能を追加するための Azure CLI コマンドを使用して、Azure 仮想マシンまたは Azure Arc 対応サーバーに Azure Monitor エージェントをインストールできます。

Azure 仮想マシン

次の Azure CLI コマンドを使用して、Azure 仮想マシンに Azure Monitor エージェントをインストールします。 使用する認証方法に基づいて適切なコマンドを選択してください。

ユーザー割り当てマネージド ID

• Windows

  az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true --settings '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
  

• Linux

  az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true --settings '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
  

システム割り当てマネージド ID

• Windows

  az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true
  

• Linux

  az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true
  

Azure 仮想マシン スケール セット

az vmss extension set Azure CLI コマンドレットを使用して、Azure 仮想マシン スケール セットに Azure Monitor エージェントをインストールします。

Azure Arc 対応サーバー

次の Azure CLI コマンドを使用して、Azure Arc 対応サーバーに Azure Monitor エージェントをインストールします。

• Windows

  az connectedmachine extension create --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --type AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --location <arc-server-location> --enable-auto-upgrade true
  

• Linux

  az connectedmachine extension create --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --type AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --location <arc-server-location> --enable-auto-upgrade true
  

Azure Resource Manager テンプレートを使用して Azure 仮想マシンまたは Azure Arc 対応サーバーに Azure Monitor エージェントをインストールし、DCR との関連付けを作成することができます。 DCR の関連付けを作成する前に、DCR を作成する必要があります。

エージェントをインストールし、関連付けを作成するためのサンプル テンプレートを次のリソースから取得します。

• Azure Monitor エージェントをインストールするためのテンプレート (Azure および Azure Arc)
• DCR を使用して関連付けを作成するためのテンプレート

次のコマンドを含む、Resource Manager テンプレートの任意のデプロイ方法を使用してテンプレートをインストールします。

• PowerShell

  New-AzResourceGroupDeployment -ResourceGroupName "<resource-group-name>" -TemplateFile "<template-filename.json>" -TemplateParameterFile "<parameter-filename.json>"
  

• Azure CLI

  az deployment group create --resource-group "<resource-group-name>" --template-file "<path-to-template>" --parameters "@<parameter-filename.json>"
  

Azure portal を使用して Azure Monitor エージェントをアンインストールするには、仮想マシン、スケール セット、または Azure Arc 対応サーバーに移動します。 [拡張機能] タブを選択し、[AzureMonitorWindowsAgent] または [AzureMonitorLinuxAgent] を選択します。 開いたダイアログで、[アンインストール] を選択します。

Azure 仮想マシンでのアンインストール

Azure 仮想マシン上の Azure Monitor エージェントをアンインストールするには、次の PowerShell コマンドを使用します。

• Windows

  Remove-AzVMExtension -Name AzureMonitorWindowsAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> 
  

• Linux

  Remove-AzVMExtension -Name AzureMonitorLinuxAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> 
  

Azure 仮想マシン スケール セットでのアンインストール

Remove-AzVmssExtension PowerShell コマンドレットを使用して、Azure 仮想マシン スケール セット上の Azure Monitor エージェントをアンインストールします。

Azure Arc 対応サーバーでのアンインストール

Azure Arc 対応サーバー上の Azure Monitor エージェントをアンインストールするには、次の PowerShell コマンドを使用します。

• Windows

  Remove-AzConnectedMachineExtension -MachineName <arc-server-name> -ResourceGroupName <resource-group-name> -Name AzureMonitorWindowsAgent
  

• Linux

  Remove-AzConnectedMachineExtension -MachineName <arc-server-name> -ResourceGroupName <resource-group-name> -Name AzureMonitorLinuxAgent
  

Azure 仮想マシンでのアンインストール

Azure 仮想マシン上の Azure Monitor エージェントをアンインストールするには、次の Azure CLI コマンドを使用します。

• Windows

  az vm extension delete --resource-group <resource-group-name> --vm-name <virtual-machine-name> --name AzureMonitorWindowsAgent
  

• Linux

  az vm extension delete --resource-group <resource-group-name> --vm-name <virtual-machine-name> --name AzureMonitorLinuxAgent
  

Azure 仮想マシン スケール セットでのアンインストール

Azure 仮想マシン スケール セット上の Azure Monitor エージェントをアンインストールするには、az vmss extension delete Azure CLI コマンドレットを使用します。

Azure Arc 対応サーバーでのアンインストール

Azure Arc 対応サーバー上の Azure Monitor エージェントをアンインストールするには、次の Azure CLI コマンドを使用します。

• Windows

  az connectedmachine extension delete --name AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name>
  

• Linux

  az connectedmachine extension delete --name AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name>
  

該当なし。

エージェントで 1 回限りの更新を行うには、まず既存のエージェント バージョンをアンインストールする必要があります。 次に、説明に従って新しいバージョンをインストールします。

拡張機能の自動アップグレードを有効にして、エージェントの自動更新を有効にすることをお勧めします。 仮想マシンまたはスケール セットに移動し、[拡張機能] タブを選択して、[AzureMonitorWindowsAgent] または [AzureMonitorLinuxAgent] を選択します。 開いたダイアログで、[自動アップグレードを有効にする] を選択します。

Azure 仮想マシンでの更新

エージェントで 1 回限りの更新を行うには、まず既存のエージェント バージョンをアンインストールする必要があります。 次に、説明に従って新しいバージョンをインストールします。

拡張機能の自動アップグレードにオプトインして、エージェントの自動更新を有効にすることをお勧めします。

次の PowerShell コマンドを使用します。

• Windows

  Set-AzVMExtension -ExtensionName AzureMonitorWindowsAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Publisher Microsoft.Azure.Monitor -ExtensionType AzureMonitorWindowsAgent -TypeHandlerVersion <version-number> -Location <location> -EnableAutomaticUpgrade $true
  

• Linux

  Set-AzVMExtension -ExtensionName AzureMonitorLinuxAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Publisher Microsoft.Azure.Monitor -ExtensionType AzureMonitorLinuxAgent -TypeHandlerVersion <version-number> -Location <location> -EnableAutomaticUpgrade $true
  

Azure Arc 対応サーバーでの更新

エージェントで 1 回限りのアップグレードを実行するには、次の PowerShell コマンドを使用します。

• Windows

  $target = @{"Microsoft.Azure.Monitor.AzureMonitorWindowsAgent" = @{"targetVersion"=<target-version-number>}}
  Update-AzConnectedExtension -ResourceGroupName $env.ResourceGroupName -MachineName <arc-server-name> -ExtensionTarget $target
  

• Linux

  $target = @{"Microsoft.Azure.Monitor.AzureMonitorLinuxAgent" = @{"targetVersion"=<target-version-number>}}
  Update-AzConnectedExtension -ResourceGroupName $env.ResourceGroupName -MachineName <arc-server-name> -ExtensionTarget $target
  

拡張機能の自動アップグレードにオプトインして、エージェントの自動更新を有効にすることをお勧めします。

次の PowerShell コマンドを使用します。

• Windows

  Update-AzConnectedMachineExtension -ResourceGroup <resource-group-name> -MachineName <arc-server-name> -Name AzureMonitorWindowsAgent -EnableAutomaticUpgrade
  

• Linux

  Update-AzConnectedMachineExtension -ResourceGroup <resource-group-name> -MachineName <arc-server-name> -Name AzureMonitorLinuxAgent -EnableAutomaticUpgrade
  

Azure 仮想マシンでの更新

エージェントで 1 回限りの更新を行うには、まず既存のエージェント バージョンをアンインストールする必要があります。 次に、この記事の説明に従って新しいバージョンをインストールします。

次の Azure CLI コマンドを使用して、拡張機能の自動アップグレード機能にオプトインし、エージェントの自動更新を有効にすることをお勧めします。

• Windows

  az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --vm-name <virtual-machine-name> --resource-group <resource-group-name> --enable-auto-upgrade true
  

• Linux

  az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --vm-name <virtual-machine-name> --resource-group <resource-group-name> --enable-auto-upgrade true
  

Azure Arc 対応サーバーでの更新

エージェントで 1 回限りのアップグレードを実行するには、次の Azure CLI コマンドを使用します。

• Windows

  az connectedmachine upgrade-extension --extension-targets "{\"Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\":{\"targetVersion\":\"<target-version-number>\"}}" --machine-name <arc-server-name> --resource-group <resource-group-name>
  

• Linux

  az connectedmachine upgrade-extension --extension-targets "{\"Microsoft.Azure.Monitor.AzureMonitorLinuxAgent\":{\"targetVersion\":\"<target-version-number>\"}}" --machine-name <arc-server-name> --resource-group <resource-group-name>
  

拡張機能の自動アップグレードにオプトインして、エージェントの自動更新を有効にすることをお勧めします。

以下の Azure CLI コマンドを使用します。

• Windows

  az connectedmachine extension update --name AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --enable-auto-upgrade true
  

• Linux

  az connectedmachine extension update --name AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --enable-auto-upgrade true
  

該当なし。

現在サポートされていません。

現在サポートされていません。

現在サポートされていません。

1. VM に Azure Monitor エージェントをインストールして環境を準備します。

2. DCR を作成する。

   この例では、Azure Monitor エージェントのキャッシュで使用される最大ディスク容量を 5,000 MB に設定します。

   {
   "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
   "contentVersion": "1.0.0.0",
   "parameters": {},
   "resources": [
       {
       "type": "Microsoft.Insights/dataCollectionRules",
       "name": "dcr-contoso-01",
       "apiVersion": "2023-03-11",
       "properties": 
           {
           "description": "A simple agent settings",
           "agentSettings": 
               {
               "logs": [
                   {
                   "name": "MaxDiskQuotaInMB",
                   "value": "5000"
                   }
               ]
               }
           },
       "kind": "AgentSettings",
       "location": "eastus"
       }
   ]
   }
   

3. DCR をマシンに関連付けます。 次の Resource Manager ファイルを使用します。

   テンプレート ファイル:

   {
     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
     "contentVersion": "1.0.0.0",
     "parameters": {
       "vmName": {
         "type": "string",
         "metadata": {
           "description": "The name of the virtual machine."
         }
       },
       "dataCollectionRuleId": {
         "type": "string",
         "metadata": {
           "description": "The resource ID of the data collection rule."
         }
       }
     },
     "resources": [
       {
         "type": "Microsoft.Insights/dataCollectionRuleAssociations",
         "apiVersion": "2021-09-01-preview",
         "scope": "[format('Microsoft.Compute/virtualMachines/{0}', parameters('vmName'))]",
         "name": "agentSettings",
         "properties": {
           "description": "Association of data collection rule. Deleting this association will break the data collection for this virtual machine.",
           "dataCollectionRuleId": "[parameters('dataCollectionRuleId')]"
         }
       }
     ]
   }
   

   パラメーター ファイル:

   {
     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
     "contentVersion": "1.0.0.0",
     "parameters": {
       "vmName": {
         "value": "my-azure-vm"
       },
       "dataCollectionRuleId": {
         "value": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr"
       }
      }
   }
   

4. 変更を適用するには、Azure Monitor エージェントを再起動します。