Linux 用 Azure Monitor Dependency 仮想マシン拡張機能

[アーティクル]
03/10/2024

Azure Monitor for VMs のマップ機能では、Microsoft Dependency Agent からデータが取得されます。 Linux 用の Azure VM Dependency エージェント仮想マシン拡張機能を使うと、Azure 仮想マシンに Dependency エージェントがインストールされます。このドキュメントでは、Linux 用 Azure VM Dependency Agent 仮想マシン拡張機能でサポートされているプラットフォーム、構成、デプロイオプションについて詳しく説明します。

前提条件

オペレーティングシステム

Azure VM 依存関係エージェントはカーネルレベルで動作するため、オペレーティングシステムのサポートもカーネルのバージョンに依存します。依存関係エージェントバージョン 9.10 時点では、カーネルが*サポート*されます。次の表は、Linux OS のメジャーおよびマイナーリリースと依存関係エージェントでサポートされているカーネルバージョンの一覧です。

注意

Dependency Agent 9.10.15 以降では、サポートされていないカーネルバージョンのインストールはブロックされませんが、エージェントはデグレードモードで実行されます。このモードでは、VMConnection テーブルと VMBoundport テーブルに格納されている接続データとポートデータは収集されません。 VMProcess テーブルにはデータが含まれている場合がありますが、最小限になります。

Distribution	OS バージョン	カーネルバージョン
Red Hat Linux 8	8.6	4.18.0-372.el8.x86_64、4.18.0-372.el8_6.x86_64
	8.5	4.18.0-348.el8_5.x86_644.18.0-348.el8.x86_64
	8.4	4.18.0-305.el8.x86_64, 4.18.0-305.el8_4.x86_64
	8.3	4.18.0-240.*el8_3.x86_64
	8.2	4.18.0-193.*el8_2.x86_64
	8.1	4.18.0-147.*el8_1.x86_64
	8.0	4.18.0-80.el8.x86_64 4.18.0-80.el8_0.x86_64
Red Hat Linux 7	7.9	3.10.0-1160
	7.8	3.10.0-1136
	7.7	3.10.0-1062
	7.6	3.10.0-957
	7.5	3.10.0-862
	7.4	3.10.0-693
Red Hat Linux 6	6.10	2.6.32-754
	6.9	2.6.32-696
CentOS Linux 8	8.6	4.18.0-372.el8.x86_64、4.18.0-372.el8_6.x86_64
	8.5	4.18.0-348.el8_5.x86_644.18.0-348.el8.x86_64
	8.4	4.18.0-305.el8.x86_64, 4.18.0-305.el8_4.x86_64
	8.3	4.18.0-240.*el8_3.x86_64
	8.2	4.18.0-193.*el8_2.x86_64
	8.1	4.18.0-147.*el8_1.x86_64
	8.0	4.18.0-80.el8.x86_64 4.18.0-80.el8_0.x86_64
CentOS Linux 7	7.9	3.10.0-1160
	7.8	3.10.0-1136
	7.7	3.10.0-1062
CentOS Linux 6	6.10	2.6.32-754.3.5 2.6.32-696.30.1
	6.9	2.6.32-696.30.1 2.6.32-696.18.7
Ubuntu Server	20.04	5.8 5.4*
	18.04	5.3.0-1020 5.0 (Azure で調整されたカーネルを含む) 4.18* 4.15*
	16.04.3	4.15。*
	16.04	4.13.* 4.11.* 4.10.* 4.8.* 4.4.*
	14.04	3.13.-generic 4.4.-generic
SUSE Linux 12 Enterprise Server	12 SP5	4.12.14-122.-default、4.12.14-16.-azure
	12 SP4	4.12。* (Azure で調整されたカーネルを含む)
	12 SP3	4.4.*
	12 SP2	4.4.*
SUSE Linux 15 Enterprise Server	15 SP1	4.12.14-197.-default、4.12.14-8.-azure
	15	4.12.14-150.*-default
Debian	9	4.9

注意

Ampere Altra の ARM ベースのプロセッサを使用する Azure Virtual Machinesでは、依存関係エージェントはサポートされません。

拡張機能のスキーマ

次の JSON は、Azure Linux VM に対する Azure VM Dependency Agent 拡張機能のスキーマを示したものです。

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
      "vmName": {
        "type": "string",
        "metadata": {
            "description": "The name of existing Linux Azure VM."
      }
    }
  },
  "variables": {
      "vmExtensionsApiVersion": "2017-03-30"
  },
  "resources": [
    {
      "type": "Microsoft.Compute/virtualMachines/extensions",
      "name": "[concat(parameters('vmName'),'/DAExtension')]",
      "apiVersion": "[variables('vmExtensionsApiVersion')]",
      "location": "[resourceGroup().location]",
      "dependsOn": [],
      "properties": {
          "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
          "type": "DependencyAgentLinux",
          "typeHandlerVersion": "9.5",
          "autoUpgradeMinorVersion": true,
          "settings": {
              "enableAMA": "true"
        }
      }
    }
  ],
    "outputs": {
    }
}

プロパティ値

名前	値/例
apiVersion	2015-01-01
publisher	Microsoft.Azure.Monitoring.DependencyAgent
type	DependencyAgentLinux
typeHandlerVersion	9.5
設定	"enableAMA": "true"

重要

Azure Monitor エージェントを使っている場合は、必ずテンプレートに enableAMA を追加してください。それ以外の場合は、Dependency エージェントで、従来の Log Analytics エージェントへのデータの送信が試みられます。

テンプレートのデプロイ

Azure VM 拡張機能は、Azure Resource Manager テンプレートでデプロイできます。前のセクションで詳しく説明した JSON スキーマを Azure Resource Manager テンプレートで使用すると、Azure Resource Manager テンプレートのデプロイ時に Azure VM Dependency Agent 拡張機能を実行できます。

仮想マシン拡張機能の JSON は、仮想マシンリソース内に入れ子にすることができます。または、Resource Manager JSON テンプレートのルートまたは最上位に配置することができます。 JSON の配置は、リソースの名前と種類の値に影響します。詳細については、子リソースの名前と種類の設定に関する記事を参照してください。

次の例では、Dependency Agent 拡張機能が仮想マシンリソース内で入れ子になっていることを前提としています。拡張機能リソースを入れ子にすると、JSON は仮想マシンの "resources": [] オブジェクトに配置されます。

{
	"type": "extensions",
	"name": "DAExtension",
	"apiVersion": "[variables('apiVersion')]",
	"location": "[resourceGroup().location]",
	"dependsOn": [
      "[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
	],
	"properties": {
        "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
        "type": "DependencyAgentLinux",
        "typeHandlerVersion": "9.5",
        "autoUpgradeMinorVersion": true,
        "settings": {
            "enableAMA": "true"
        }
	}
}

拡張子 JSON をテンプレートのルートに配置すると、リソース名には親仮想マシンへの参照が含まれます。種類には、入れ子にされた構成が反映されます。

{
	"type": "Microsoft.Compute/virtualMachines/extensions",
	"name": "<parentVmResource>/DAExtension",
	"apiVersion": "[variables('apiVersion')]",
	"location": "[resourceGroup().location]",
	"dependsOn": [
      "[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
	],
	"properties": {
        "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
        "type": "DependencyAgentLinux",
        "typeHandlerVersion": "9.5",
        "autoUpgradeMinorVersion": true,
        "settings": {
            "enableAMA": "true"
        }
	}
}

Azure CLI でのデプロイ

Azure CLI を使用して、Dependency Agent VM 拡張機能を既存の仮想マシンにデプロイすることができます。


az vm extension set \
    --resource-group myResourceGroup \
    --vm-name myVM \
    --name DependencyAgentLinux \
    --publisher Microsoft.Azure.Monitoring.DependencyAgent \
    --version 9.5

拡張機能の自動アップグレード

依存関係拡張機能のマイナーバージョンを自動的にアップグレードする新しい機能が、利用できるようになりました。

拡張機能の自動アップグレードを拡張機能に対して有効にするには、プロパティ enableAutomaticUpgrade が true に設定され、拡張機能テンプレートに追加されているようにする必要があります。このプロパティは、すべての VM または VM スケールセットで個別に有効にする必要があります。有効化のセクションで説明されているいずれかの方法を使用して、VM または VM スケールセットに対してこの機能を有効にします。

VM または VM スケールセットで拡張機能の自動アップグレードが有効になっていると、拡張機能の発行元がその拡張機能の新しいバージョンをリリースするたびに、拡張機能が自動的にアップグレードされます。このアップグレードは、こちらで説明されているように、可用性優先の原則に従って安全に適用されます。

enableAutomaticUpgrade 属性の機能は、autoUpgradeMinorVersion の機能とは異なります。拡張機能の発行元から新しいバージョンがリリースされる場合は、autoUpgradeMinorVersion 属性によるマイナーバージョンの自動更新は行われません。 autoUpgradeMinorVersion 属性は、デプロイ時に新しいマイナーバージョンが使用可能な場合に、それを拡張機能で使用する必要があるかどうかを示します。ただし、デプロイされると、このプロパティが true に設定されていても、再デプロイされない限り、拡張機能でマイナーバージョンはアップグレードされません。

拡張機能のバージョンを最新の状態に保つために、拡張機能のデプロイで enableAutomaticUpgrade を使用することをお勧めします。

重要

テンプレートに enableAutomaticUpgrade を追加する場合は、必ず API バージョン 2019-12-01 以上で使用してください。

トラブルシューティングとサポート

トラブルシューティング

拡張機能のデプロイ状態に関するデータを取得するには、Azure portal か Azure CLI を使用します。特定の VM の拡張機能のデプロイ状態を確認するには、Azure CLI を使用して次のコマンドを実行します。

az vm extension list --resource-group myResourceGroup --vm-name myVM -o table

拡張機能の実行の出力は、次のファイルにログ記録されます。

/var/opt/microsoft/dependency-agent/log/install.log

サポート

この記事についてさらにヘルプが必要な場合は、いつでも Microsoft Q&A および Stack Overflow のフォーラムで Azure エキスパートにお問い合わせください。または、Azure サポートインシデントを送信できます。その場合は、 Azure サポートのサイトに移動して、 [サポートの要求] をクリックします。 Azure サポートの使用方法の詳細については、「Microsoft Azure サポートに関する FAQ」を参照してください。