Linux オペレーティング システム (OS) の Azure Monitor エージェント トラブルシューティング ツールの使用方法
注意事項
この記事では、サービス終了 (EOL) 状態となっている Linux ディストリビューションである CentOS について説明します。 適宜、使用と計画を検討してください。 詳細については、「CentOS のサポート終了に関するガイダンス」を参照してください。
Azure Monitor エージェント (AMA) トラブルシューティング ツールは、エージェントに関する問題を特定し、一般的な正常性評価を実行する際に役立つように設計されています。 これは、エージェントが適切にインストールされ、接続されていることを確認するためのさまざまなチェックを実行できます。また、診断対象のマシンから AMA 関連のログを収集することもできます。
Note
AMA トラブルシューティング ツールは、Linux の 1.25.1 より新しいすべてのバージョンのエージェントに付属する実行可能ファイルです。
前提条件
Python の要件
Linux AMA トラブルシューティング ツールでは、Python 2.6 以降または任意の Python 3 バージョンがマシンにインストールされている必要があります。
お使いのマシンに Python がインストールされているかどうかを確認するには、次のコマンドをコピーし、Bash で root として実行します。
sudo python -V
sudo python3 -V
Python の複数のバージョンをインストールして別名を付けることができます。複数のバージョンがインストールされている場合は、次を使用します。
ls -ls /usr/bin/python*
既定で Python 3 が含まれないディストリビューションが仮想マシンで使用されている場合、それをインストールする必要があります。 次のサンプル コマンドは、異なるディストリビューションに Python 3 をインストールします。
sudo yum install -y python3
さらに、次の Python パッケージを実行する必要があります (Python 2 または Python 3 の既定のインストールでは、すべてが存在する必要があります)。
| Python パッケージ | Python 2 に必須かどうか | Python 3 に必須かどうか |
|---|---|---|
| copy | はい | はい |
| DATETIME | はい | はい |
| json | はい | はい |
| os | はい | はい |
| プラットフォーム | はい | はい |
| re | はい | はい |
| requests | no | はい |
| shutil | はい | はい |
| subprocess | はい | はい |
| url lib | はい | no |
| xml.dom.minidom | はい | はい |
トラブルシューティング ツールの存在チェック
診断対象のマシンに AMA エージェント トラブルシューティング ツールのディレクトリが存在するかどうかを確認して、エージェント トラブルシューティング ツールのインストールを確認します。
/var/lib/waagent/Microsoft.Azure.Monitor.AzureMonitorLinuxAgent-{version}
Azure Monitor エージェント トラブルシューティング ツールが存在することを確認するには、次のコマンドをコピーし、Bash で root として実行します:
ls -ltr /var/lib/waagent | grep "Microsoft.Azure.Monitor.AzureMonitorLinuxAgent-*"
ディレクトリが存在しない場合、またはインストールに失敗した場合は、「基本的なトラブルシューティングの手順」に従ってください。
ディレクトリが存在する場合は、「トラブルシューティング ツールの実行」に進みます。
トラブルシューティング ツールの実行
診断するマシンで、エージェント トラブルシューティング ツールを実行します。
ログ モードを使用すると、ログの収集が可能になります。ログは、エクスポートまたはレビューのために .tgz 形式に圧縮できます。 対話モードを使用すると、ユーザーはトラブルシューティング シナリオに積極的に取り組み、シェル内で直接出力を表示できます。
ログ モードでエージェント トラブルシューティング ツールを起動するには、次のコマンドをコピーし、Bash で root として実行します。
Note
{version} は、インストールされている実際のバージョン番号と一致するように更新する必要があります。 次の例では、バージョンは 1.28.11 です。
cd /var/lib/waagent/Microsoft.Azure.Monitor.AzureMonitorLinuxAgent-{version}/ama_tst/
sudo sh ama_troubleshooter.sh -L
出力ログの保存先のパスを入力します。 たとえば、/tmp を使用できます。
一連のアクティビティが実行され、指定した出力ディレクトリに .tgz ファイルが出力されます。 このプロセスが完了するまでお待ちください。
よく寄せられる質問
新しいエージェントから以前のエージェントにトラブルシューティング ツールをコピーして、以前のエージェントでそれを実行し、以前のエージェントの問題を診断できますか?
トラブルシューティング ツールを使用して、以前のバージョンのエージェントをコピーして診断することはできません。 トラブルシューティング ツールが正常に動作するには、最新バージョンのエージェントが必要です。