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

適用対象:SQL Server

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

ログ ファイルの場所

拡張ログ

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

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

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

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. イベント ログを調べて、インストールを妨げているものがあるかどうかを確認します。 次のフォルダー C:\Packages\Plugins\Microsoft.AzureData.WindowsAgent.SqlServer{version} から SqlServerExtension.msi をインストールしてみてください。 インストール 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 Arcconnection メソッドのいずれかを再試行して拡張機能をインストールします。

サーバーのマネージド 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 Onboarding ロールが割り当てられていることを確認します。 「マシンが 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

削除されたリソースは、Azure ポータルに引き続き表示されます

SQL Server - Azure Arc リソースを削除した後も、そのリソースが一定期間Azure ポータルに表示され続ける可能性があります。 この動作は想定されており、Azure Resource Managerキャッシュが原因です。 通常、リソースはキャッシュの更新後に消えます。 数時間後もリソースが表示される場合は、Azure Resource Graphクエリを実行するか、Azure CLIを使用して、リソースが正常に削除されたことを確認できます。 それ以上の操作は必要ありません。リソースは機能せず、削除後に料金は発生しません。