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

  • [アーティクル]

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

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

拡張機能のデプロイの状態に関するデータは、Azure portal で取得できます。

次のトラブルシューティング手順は、すべての VM 張機能に適用されます。

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

  2. Windows の場合、特定の拡張機能の詳細な拡張機能ログは %SystemDrive%\ProgramData\GuestConfig\extension_logs\<Extension> で確認できます。 Linux の場合、拡張機能の出力は、インストールされる拡張機能ごとに /var/lib/GuestConfig/extension_logs のファイルに記録されます。

  3. エラーコードや既知の問題などについて、拡張機能固有のドキュメントのトラブルシューティングのセクションを確認します。各拡張機能の追加のトラブルシューティング情報については、拡張機能の概要の「トラブルシューティングとサポート」セクションを参照してください。 これには、ログに書き込まれたエラー コードの説明が含まれます。 拡張機能の記事は、拡張機能の表にリンクされています。

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

特定の拡張シナリオのトラブルシューティング

VM Insights

  • Azure Arc 対応サーバーで VM Insights を有効にすると、Dependency and Log Analytics エージェントがインストールされます。 低速の、あるいは低速のネットワークに接続しているマシンの場合、インストール プロセス中にタイムアウトが発生することがあります。 Microsoft は、この状態を改善するために、Connected Machine エージェントでこの問題に対処する措置を講じています。 暫定的に、インストールの再試行が成功する場合があります。

Linux 用 Log Analytics エージェント

  • Log Analytics エージェント バージョン 1.13.9 (対応する拡張機能バージョンは 1.13.15) が、アップロードされたデータを Azure Arc 対応サーバーのリソース ID で正しくマークしていません。 ログはサービスに送信されますが、選択した対応サーバーのデータを表示しようとして [ログ] または [分析情報] を選択した場合、データは返されません。 ワークスペースにスコープが設定されている Azure Monitor Logs または Azure Monitor for VMs からクエリを実行することで、データを表示できます。

  • 現在、一部のディストリビューションは、Linux 用 Log Analytics エージェントでサポートされていません。 エージェントには、Python 2 などの追加の依存関係をインストールする必要があります。 こちらのサポート マトリックスと前提条件を確認してください。

  • ステータス メッセージのエラー コード 52 は、不足している依存関係があることを示しています。 不足している依存関係に関する詳細情報を出力とログで確認します。

  • インストールが失敗した場合は、拡張機能の概要に関するページのトラブルシューティングとサポートのセクションを確認してください。 ほとんどの場合、ステータス メッセージにはエラー コードが含まれています。 Linux 用 Log Analytics エージェントの場合、ステータス メッセージとこの VM 拡張機能の一般的なトラブルシューティング情報については、こちらを参照してください。

次のステップ

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

  • Microsoft Q&A を通じて、Azure 専門家からの回答を得ることができます。

  • @AzureSupport (カスタマー エクスペリエンスを向上させるための Microsoft Azure の公式アカウント) に連絡する。 Azure サポートにより、Azure コミュニティの回答、サポート、エキスパートと結び付けられます。

  • Azure サポート インシデントを送信する。 Azure サポートのサイトに移動して、[サポートの要求] を選択します。