Azure Monitor VM 分析情報の Dependency Agent
Dependency Agent は、仮想マシンで実行されているプロセスおよびその外部プロセスの依存関係に関するデータを収集します。 更新プログラムには、バグ修正または新機能のサポートが含まれます。 この記事では、Dependency Agent の要件と、それを手動または自動でアップグレードする方法について説明します。
Note
Dependency Agent は InsightsMetrics テーブルにハートビート データを送信し、ユーザーにはそれに対するデータ インジェスト料金が発生します。 この動作は、Azure Monitor エージェントとは異なります。Azure Monitor エージェントは、エージェントの正常性データを Heartbeat テーブルに送信し、データ収集料金は無料です。
Dependency Agent の要件
- Azure Monitor エージェントを同じマシンにインストールする必要があります。
- 仮想マシンからアドレス 169.254.169.254 への接続が必要です。 このアドレスは、Azure メタデータ サービス エンドポイントを識別します。
- 現在、Windows Server 2008 SP2 と Azure Stack HCI を除き、Windows Server 2019 までの Azure Monitor エージェントがサポートするのと同じ Windows バージョンがサポートされます。 Linux については、Dependency Agent Linux のサポートに関する記事を参照してください。
Linux に関する考慮事項
Linux マシンに VM Insights の依存関係エージェントをインストールする前に、次の点を考慮してください。
- 既定と SMP Linux のカーネル リリースのみがサポートされています。
- 物理アドレス拡張 (PAE) や Xen などの非標準のカーネル リリースは、どの Linux ディストリビューションでもサポートされていません。 たとえば、リリースの文字列が 2.6.16.21-0.8-xen であるシステムはサポートされていません。
- カスタム カーネル (標準カーネルの再コンパイルを含む) はサポートされていません。
- バージョン 9.4 以外の Debian ディストリビューションの場合、マップ機能はサポートされていません。 パフォーマンス機能は、Azure Monitor メニューからのみ使用できます。 Azure VM の左側のウィンドウから直接使用することはできません。
- CentOSPlus カーネルはサポートされています。
- 依存関係エージェントをインストールすると Linux カーネルがテイントされ、マシンがリセットされるまで Linux ディストリビューションからのサポートが失われる可能性があります。
Spectre と Meltdown の脆弱性のために、Linux カーネルに修正プログラムを適用する必要があります。 詳細については、Linux ディストリビューション ベンダーに問い合わせてください。 次のコマンドを実行して、Spectre または Meltdown が軽減されているかどうかの可能性を確認します。
$ grep . /sys/devices/system/cpu/vulnerabilities/*
このコマンドの出力は次のようになり、マシンがどちらの問題に対して脆弱であるかを特定します。 これらのファイルが見つからない場合、マシンには修正プログラムが適用されていません。
/sys/devices/system/cpu/vulnerabilities/meltdown:Mitigation: PTI
/sys/devices/system/cpu/vulnerabilities/spectre_v1:Vulnerable
/sys/devices/system/cpu/vulnerabilities/spectre_v2:Vulnerable: Minimal generic ASM retpoline
Dependency Agent をインストールまたはアップグレードする
Note
プロセスと接続データに対して VM Insights がマシンで有効になっている場合、Dependency Agent は自動的にインストールされます。 VM Insights がパフォーマンス データについてのみ有効にされている場合、Dependency Agent はインストールされません。
デプロイのシナリオとマシンが実行されている環境に応じ、次の方法を使って、Windows および Linux 用の Dependency Agent を手動または自動でアップグレードできます。
Environment | インストール方法 | アップグレード方法 |
---|---|---|
Azure VM | Windows および Linux 用の Dependency Agent VM 拡張機能 | autoUpgradeMinorVersion プロパティを false に設定してオプトアウトするよう Azure Resource Manager テンプレートを構成していない限り、エージェントは既定で自動的にアップグレードされます。 自動アップグレードが無効なマイナー バージョンのアップグレードと、メジャー バージョンのアップグレードは、拡張機能をアンインストールしてから再インストールするという同じ方法で実行されます。 |
カスタム Azure VM イメージ | Windows と Linux 用の Dependency Agent の手動インストール | コマンド ラインから Windows インストーラー パッケージまたは Linux 自己解凍およびインストール可能シェル スクリプト バンドルを実行して、エージェントの最新バージョンへの VM の更新を実行する必要があります。 |
Azure 以外の VM | Windows と Linux 用の Dependency Agent の手動インストール | コマンド ラインから Windows インストーラー パッケージまたは Linux 自己解凍およびインストール可能シェル スクリプト バンドルを実行して、エージェントの最新バージョンへの VM の更新を実行する必要があります。 |
Windows 上の Dependency Agent を手動でインストールまたはアップグレードする
コマンド プロンプトから、スクリプトまたは他のオートメーションソリューションを使って、または InstallDependencyAgent-Windows.exe セットアップ ウィザードを使って、Windows VM 上のエージェントを更新します。
前提条件
- 最新バージョンの Windows エージェントを aka.ms/dependencyagentwindows からダウンロードします。
セットアップ ウィザードの使用
管理者権限を持つアカウントでコンピューターにサインオンします。
InstallDependencyAgent-Windows.exe を実行してセットアップ ウィザードを開始します。
Dependency Agent セットアップ ウィザードに従って、以前のバージョンの Dependency Agent をアンインストールし、最新バージョンをインストールします。
コマンド ラインから
管理者権限を持つアカウントを使ってコンピューターにサインインします。
次のコマンドを実行します。
InstallDependencyAgent-Windows.exe /S /RebootMode=manual
/RebootMode=manual
パラメーターを指定すると、一部のプロセスで以前のバージョンのファイルが使用されており、ロックされている場合、アップグレードによってマシンが自動的に再起動されなくなります。アップグレードが正常に完了したことを確認するには、
install.log
で詳細な設定情報を確認します。 ログ ディレクトリは、 %Programfiles%\Microsoft Dependency Agent\logs にあります。
Linux 上の Dependency Agent を手動でインストールまたはアップグレードする
Linux 上の以前のバージョンの Dependency Agent からのアップグレードがサポートされており、新規インストールと同じコマンドに従って実行されます。
前提条件
- 最新バージョンの Linux エージェントを、aka.ms/dependencyagentlinux から、または curl を使ってダウンロードします。
curl -L -o DependencyAgent-Linux64.bin https://aka.ms/dependencyagentlinux
Note
curl を使うと、実行アクセス許可は自動的に設定されません。 chmod を使って手動で設定する必要があります。
chmod +x DependencyAgent-Linux64.bin
コマンド ラインから
root としてコマンドを実行する sudo 特権を持つユーザー アカウントでコンピューターにサインインします。
次のコマンドを実行します。
sudo <path>/InstallDependencyAgent-Linux64.bin
Dependency Agent が起動しない場合は、ログで詳細なエラー情報を調べます。 Linux エージェントのログ ディレクトリは、 /var/opt/microsoft/dependency-agent/log にあります。
Dependency Agent のアンインストール
Note
手動でインストールした Dependency Agent は Azure portal に表示されないため、手動でアンインストールする必要があります。 Azure portal、PowerShell、ARM テンプレートのデプロイ、または Azure Policy を使ってインストールした場合にのみ表示されます。
Azure portal の [仮想マシン] メニューから、仮想マシンを選択します。
[拡張機能とアプリケーション]>[DependencyAgentWindows] または [DependencyAgentLinux]>[アンインストール] を選択します。
Windows 上の Dependency Agent を手動でアンインストールする
方法 1: Windowsで [プログラムの追加と削除] に移動し、Microsoft Dependency Agent を見つけ、省略記号をクリックしてコンテキスト メニューを開き、[アンインストール] を選びます。
方法 2: Microsoft Dependency Agent のフォルダーにあるアンインストーラーを使います (例: C:\Program Files\Microsoft Dependency Agent"\Uninstall_v.w.x.y.exe
(v.w.x.y はバージョン番号です))。
Linux 上の Dependency Agent を手動でアンインストールする
root としてコマンドを実行する sudo 特権を持つユーザー アカウントでコンピューターにサインインします。
次のコマンドを実行します。
sudo /opt/microsoft/dependency-agent/uninstall -s
Dependency Agent Linux のサポート
Dependency Agent はカーネル レベルで動作するため、サポートもカーネルのバージョンに依存します。 Dependency Agent バージョン 9.10.* の時点では、エージェントは * カーネルをサポートします。 次の表は、Linux OS のメジャーおよびマイナー リリースと、Dependency Agent でサポートされているカーネル バージョンの一覧です。
Note
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では、依存関係エージェントはサポートされません。
次のステップ
VM の監視を一定期間停止する場合、または VM Insights を完全に削除する場合は、「VM Insights での VM の監視を無効にする」を参照してください。