SQL Server 用 Azure 拡張機能のトラブルシューティング

適用対象:SQL Server

始める前に、ログの場所を記録しておきます。

ログ ファイルの場所

拡張機能ログ

拡張機能ログ ファイルは次の場所にあります。

C:\ProgramData\GuestConfig\extension_logs\Microsoft.AzureData.WindowsAgent.SqlServer\

ログ ファイル名は、SQL Server 用 Azure 拡張機能のバージョンによって異なります。最新バージョンの SQL Server 用 Azure 拡張機能の場合、ログ ファイルは次のようになります。

unifiedagent.log

拡張機能のバージョンが 1.1.24724.69 以前の場合、ログ ファイルは次のようになります。

ExtensionLog_0.log

デプロイ機能ログ

デプロイ機能のログは、次の場所にデプロイされます。

C:\ProgramData\GuestConfig\extension_logs\Microsoft.AzureData.WindowsAgent.SqlServer\<extension version>\deployer.log

<extension version> をご使用の拡張機能のバージョンに置き換えます。 次に例を示します。

C:\ProgramData\GuestConfig\extension_logs\Microsoft.AzureData.WindowsAgent.SqlServer\1.1.0.0\deployer.log

Arc 対応 SQL Server リソースが作成されない問題については、いくつかの原因が考えられます。

拡張機能のインストールが失敗した

接続されたサーバーに移動し、デプロイ機能のログを調べます。 通常なら、次のメッセージが記録されています。

[YY/MM/DDDD HH:MM:SS UTC] [INFO]          Status of service 'SqlServerExtension' before attempting start: Stopped
[YY/MM/DDDD HH:MM:SS UTC] [INFO]          Status of service 'SqlServerExtension' after attempting start: Stopped

表示されない場合は、拡張機能が正しくインストールされていません。 次の手順を試してみてください。

1. イベント ログを調べて、インストールを妨げているものがあるかどうかを確認します。 次のフォルダーから、SqlServerExtension.msi をインストールしてみてください: C:\Packages\Plugins\Microsoft.AzureData.WindowsAgent.SqlServer{version}。 インストールの UI にエラーの詳細が表示される場合があります。

2. サービス アプリとサーバー マネージャーを閉じてから、いずれかの接続方法で拡張機能のインストールを再試行します。

拡張機能はインストールされたが開始されなかった

ログ ファイルでアプリケーション エラーを調べます。

サーバー - Azure Arc ARM リソースが手動で削除された

拡張機能のログで次のレコードを調べます。

[YY/MM/DDDD HH:MM:SS PM UTC] [ERROR]   [UploadServiceProvider]      [ExtensionHandlerStatusQueryError] ArcSqlInstancesRequest request is null, not sending data to RP.

これは、マシンが接続されたサーバーとして認識されなくなっていることを意味します。 サーバーを Azure Arc にオンボードし、いずれかの接続方法で拡張機能のインストールを再試行してください。

サーバーのマネージド ID に十分なアクセス許可がない

拡張機能のログで次のレコードを調べます。

[INFO] [UploadServiceProvider] [ExtensionHandlerArcUploadServicesNotifications] [AzureUpload] Arc post request failed with error: Forbidden message: {"ErrorDescription":{"ErrorCode":6,"Message":"The user has no access to the provided Azure resource."},"ResponseUrl":null}

マシンのマネージド ID に、Azure Connected SQL Server のオンボード ロールが割り当てられていることを確認してください。 「マシンが Arc 対応サーバーに既に接続されている場合」のロールの割り当て手順を参照してください。

ユーザーが Arc 対応 SQL Server リソースを新しいリソース プロバイダーに移行しなかった

拡張機能のログで次のレコードを調べます。

[YY/MM/DDDD HH:MM:SS PM UTC] [INFO] [UploadServiceProvider] [ExtensionHandlerArcUploadServicesNotifications] [AzureUpload] Arc for Sql Server upload response status: InternalServerError.`

Arc 対応 SQL Server リソースを Microsoft.AzureArcData に移行してください。

拡張機能が長時間異常な状態 (作成中/削除中) で停止している場合

Azure Arc から SQL Server インスタンスを切断する