Azure Arc 対応サーバーの VM 拡張機能に関する問題をトラブルシューティングする

この記事では、Azure Arc 対応サーバーに Azure 仮想マシン (VM) 拡張機能をデプロイまたは削除しようとしたときに発生する可能性がある問題のトラブルシューティングと解決について説明します。 一般的な情報については、 Azure Arc 対応サーバーを使用した仮想マシン拡張機能の管理に関するページを参照してください。

一般的なトラブルシューティング

拡張機能のデプロイの状態に関するデータは、Azure portal から該当するマシンを選択し、[設定] > [拡張機能] を選択することで取得できます。

一般的なトラブルシューティングを行うには、次の手順を試してください。 これらの手順は、すべての VM 拡張機能に適用されます。

1. Azure Connected Machine エージェント (azcmagent) が接続されていること、および依存サービスが 実行中またはアクティブであることを確認します。

   azcmagent show コマンドを実行し、出力の状態を確認します (Azure Arc プロキシは無視できます)。

   

   Azure Arc プロキシ以外のサービスが停止している場合は、サービスを再起動して拡張機能の操作を再開します。

2. 拡張機能のインストールを再試行します。

   拡張機能は、さまざまな理由で 失敗 または他の状態でスタックする可能性があります。 拡張機能の状態が [成功] と表示されていない場合は、拡張機能を削除してもう一度インストールします。 拡張機能を削除するには、次の Azure PowerShell コマンドを使用できます。

   Remove-AzConnectedMachineExtension -Name <Extension Name> -ResourceGroupName <RG Name> -MachineName <Machine Name>
   

3. ゲスト エージェントのログを確認し、拡張機能がプロビジョニングされたときのアクティビティを確認します。 Windows の場合は %SystemDrive%\ProgramData\GuestConfig\ext_mgr_logs、Linux の場合は /var/lib/GuestConfig/ext_mgr_logs を確認します。

4. 拡張機能ログで、特定の拡張機能に関する詳細を確認します。

   Windows マシンの場合:

   • ログはC:\ProgramData\GuestConfigに保存されます
   • 拡張機能の設定と状態ファイルは C:\Packages\Plugins にあります

   Linux マシンの場合:

   • ログは/var/lib/GuestConfigに保存されます
   • 拡張機能の設定と状態ファイルは /var/lib/waagent にあります

   拡張サービス ログは …GuestConfig\ext_mgr_logs\gc_ext.log に書き込まれます。 そこにはパッケージのダウンロードまたは検証に関するエラーが示されています。

5. エラー コード、既知の問題、その他の詳細については、拡張機能固有のドキュメントのトラブルシューティング セクションを参照してください。 拡張機能 の表には、多くの拡張機能のドキュメントがあります。

6. システム ログを確認します。 排他的パッケージ マネージャー アクセスを必要とする別のアプリケーションの実行時間の長いインストールなど、拡張機能に干渉する可能性のあるその他の操作を確認します。

既知の問題

拡張機能に必要な HandlerManifest.json ファイルが存在しません。

拡張機能が Deleting 状態でスタックしています。 拡張機能サービス ログ (gc_ext.log) に、次のエラーが表示されます。

HandlerManifest.json file does not exist for extension

分析

拡張子に HandlerManifest.json ファイルがありません。 これは、拡張機能が正しくアンインストールされなかった場合に発生する可能性があります。

Solution

1. 拡張機能を削除するには、az connectedmachine extension delete、--extension-name、および--machine-nameパラメーターで--resource-groupを使用します。

2. 拡張機能がまだ同じ状態の場合は、マシンから拡張機能を手動で削除します。 一部の拡張機能では、追加のクリーンアップ手順が必要になる場合があります。 詳細なガイダンスについては、 拡張機能の表の拡張機能 固有のドキュメントを参照してください。

   Windows マシンの場合:

   • C:\Packages\Plugins\ に移動します
   • 拡張機能に対応するフォルダーを削除する

   Linux マシンの場合:

   • /var/lib/waagent/ に移動します
   • 拡張機能に対応するフォルダーを削除する

3. 拡張機能を Azure からアンインストールし、再インストールします。

次のステップ

該当する問題がここにない場合、または問題を解決できない場合は、サポートを受けるために、次のいずれかのチャネルをお試しください。

• Microsoft Q&A を通じて、Azure 専門家からの回答を得ることができます。
• サポートリクエストを開いてサポートを受けます。 詳細については、「Azure サポート リクエストを作成する方法」を参照してください。