この記事では、Azure Arc 対応サーバーに Azure 仮想マシン (VM) 拡張機能をデプロイまたは削除しようとしたときに発生する可能性がある問題のトラブルシューティングと解決について説明します。 一般的な情報については、 Azure Arc 対応サーバーを使用した仮想マシン拡張機能の管理に関するページを参照してください。
一般的なトラブルシューティング
拡張機能のデプロイの状態に関するデータは、Azure portal から該当するマシンを選択し、[設定] > [拡張機能] を選択することで取得できます。
一般的なトラブルシューティングを行うには、次の手順を試してください。 これらの手順は、すべての VM 拡張機能に適用されます。
Azure Connected Machine エージェント (
azcmagent) が接続されていること、および依存サービスが 実行中またはアクティブであることを確認します。azcmagent showコマンドを実行し、出力の状態を確認します (Azure Arc プロキシは無視できます)。
Azure Arc プロキシ以外のサービスが停止している場合は、サービスを再起動して拡張機能の操作を再開します。
拡張機能のインストールを再試行します。
拡張機能は、さまざまな理由で 失敗 または他の状態でスタックする可能性があります。 拡張機能の状態が [成功] と表示されていない場合は、拡張機能を削除してもう一度インストールします。 拡張機能を削除するには、次の Azure PowerShell コマンドを使用できます。
Remove-AzConnectedMachineExtension -Name <Extension Name> -ResourceGroupName <RG Name> -MachineName <Machine Name>ゲスト エージェントのログを確認し、拡張機能がプロビジョニングされたときのアクティビティを確認します。 Windows の場合は
%SystemDrive%\ProgramData\GuestConfig\ext_mgr_logs、Linux の場合は/var/lib/GuestConfig/ext_mgr_logsを確認します。拡張機能ログで、特定の拡張機能に関する詳細を確認します。
Windows マシンの場合:
- ログは
C:\ProgramData\GuestConfigに保存されます - 拡張機能の設定と状態ファイルは
C:\Packages\Pluginsにあります
Linux マシンの場合:
- ログは
/var/lib/GuestConfigに保存されます。 - 拡張機能の設定と状態ファイルは
/var/lib/waagentにあります
拡張サービス ログは
…GuestConfig\ext_mgr_logs\gc_ext.logに書き込まれます。 そこにはパッケージのダウンロードまたは検証に関するエラーが示されています。- ログは
エラー コード、既知の問題、その他の詳細については、拡張機能固有のドキュメントのトラブルシューティング セクションを参照してください。 拡張機能 の表には、多くの拡張機能のドキュメントがあります。
システム ログを確認します。 排他的パッケージ マネージャー アクセスを必要とする別のアプリケーションの実行時間の長いインストールなど、拡張機能に干渉する可能性のあるその他の操作を確認します。
次のステップ
該当する問題がここにない場合、または問題を解決できない場合は、サポートを受けるために、次のいずれかのチャネルをお試しください。
- Microsoft Q&A を通じて、Azure 専門家からの回答を得ることができます。
- サポートリクエストを開いてサポートを受けます。 詳細については、「Azure サポート リクエストを作成する方法」を参照してください。