Felsöka utvärdering av metodtips på SQL Server
gäller för:SQL Server
Innan du fortsätter kontrollerar du att alla nödvändiga krav är uppfyllda.
Loggfilsplatser
Tilläggslogg
Loggfilen för tillägget finns på:
C:\ProgramData\GuestConfig\extension_logs\Microsoft.AzureData.WindowsAgent.SqlServer\
Loggfilens namn beror på versionen av Azure-tillägget för SQL Server. För den senaste versionen av Azure-tillägget för SQL Server är loggfilen:
unifiedagent.log
För tilläggsversion 1.1.24724.69
och tidigare är loggfilen:
ExtensionLog_0.log
Azure Monitor-agentlogg
Azure Monitor-agentloggen finns på:
C:\ProgramData\GuestConfig\extension_logs\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\Extension.1.log
Du kan stöta på följande problem när du aktiverar utvärdering av bästa praxis.
Ingen Log Analytics-arbetsyta är tillgänglig i listrutans meny
Se till att användaren som konfigurerar SQL BPA måste ha rollen Log Analytics-deltagare inom resursgruppen eller prenumerationen för Log Analytics-arbetsytan. Listan över förkunskapskrav finns här.
Felmeddelanden som kräver att användarna väntar i fem minuter
Om ett sådant meddelande visas och du håller sidan öppen försöker portalen automatiskt utföra åtgärden igen efter fem minuter. Om sidan uppdateras rekommenderar portalen att du väntar i fem minuter innan du försöker utföra åtgärden igen. Om samma fel kvarstår efter en lång tid kontrollerar du tillståndet för WindowsAgent.SqlServer-tillägget och kontrollerar att tillägget inte har fastnat i ett Uppdatera tillstånd. Om tillägget fortfarande har fastnat kontrollerar du Arc-datorns anslutning.
Utvärderingskörningen misslyckades
Om utvärderingskörningen misslyckas väljer du motsvarande rad för att öppna en sida som visar felmeddelandet.
SQL Server-anslutningsfel, allmänt nätverksfel
Beskrivning
Anslutningstest för SQL-utvärdering misslyckades anger att utvärderingen inte kunde ansluta till SQL Server-instansen. Då returneras:
Beslut
Följ stegen i Felsöka anslutningsproblem i SQL Server.
Serverprincipalen kan inte komma åt modell-databasen
Beskrivning
Serverhuvudprincipen NT Authority/SYSTEM
är inte kapabel att komma åt databasen "model" under den aktuella säkerhetskontexten.
Server-principal kan inte komma åt databasen under den aktuella säkerhetskontexten och det returnerar detta fel i portalen.
Beslut
Kontrollera att den inbyggda SQL Server-inloggningen NT AUTHORITY\SYSTEM är medlem i SQL Server sysadmin-serverrollen för alla SQL Server-instanser som körs på datorn.
Om detta inte är tillåtet kan du konfigurera ett konto med minst behörighet för Azure-tillägget för SQL Server-tjänsten på SQL Server-datorn. Lägsta behörighetskonto är tillgängligt för förhandsversion.
För att konfigurera din server följer du stegen i Kör SQL Server aktiverad av Azure Arc med lägsta möjliga privilegier.
Det gick inte att ladda upp Azure Monitor-agenten
Om felet anger att uppladdningen misslyckades för Azure Monitor Agent (AMA) kontrollerar du att AMA har etablerats och konfigurerats korrekt. Följande komponenter måste konfigureras korrekt för att säkerställa att agenten kan ladda upp loggar till arbetsytan:
- Den länkade Log Analytics-arbetsytan måste ha en tabell med namnet
SqlAssessment_CL
.- Gå till fliken Tabeller under den länkade Log Analytics-arbetsytan.
- Tabellen
SqlAssessment_CL
ska finnas.
- Azure Monitor-agenten (version >= 1.10.0) bör tillhandahållas framgångsrikt.
- Gå till fliken Tillägg under Arc-resursen.
- AMA med nödvändig version bör framgångsrikt provisioneras.
- Datainsamlingsregeln (DCR) och datainsamlingsslutpunkten (DCE) måste finnas på samma plats som Log Analytics-arbetsytan.
- Gå till fliken Översikt i resursgruppen som Log Analytics-arbetsytan tillhör.
- I listan över resurser kan DCR- och DCE- identifieras med deras prefix, sqlbpa-.
- Kontrollera att DCR- och DCE- finns på samma plats som Log Analytics-arbetsytan.
- Datainsamlingsregeln (DCR) bör konfigureras korrekt.
- Gå till fliken Resources under relevant DCR. Arc-datornamnet ska finnas i listan.
- Gå till fliken Datakällor under relevant DCR. Välj posten anpassade textloggar.
- Under fliken datakällor ska tabellnamnet vara
SqlAssessment_CL
. - Under fliken datakällor ska den konfigurerade sökvägen för logginsamling vara
C:\Windows\System32\config\systemprofile\AppData\Local\Microsoft SQL Server Extension Agent\Assessment\*.csv
. - Under fliken Mål bör namnet på Log Analytics-arbetsytan finnas med.
- Under fliken datakällor ska tabellnamnet vara
Om någon av komponenterna saknas gör du följande:
- Inaktivera utvärdering genom att välja Konfiguration>Inaktivera utvärdering.
- Bekräfta att du har de behörigheter som krävs för att aktivera utvärdering.
- Aktivera utvärdering genom att välja Aktivera utvärdering.
Utvärderingsdistributionen misslyckades
- Gå till distributionen och felsök felet.
- Om det finns några problem med distributionen av Azure Monitor-agenten kontrollerar du att Arc-datorn är ansluten.
- Utplaceringen kan alltid återaktiveras med samma Log Analytics-arbetsyta genom att välja knappen Aktivera utvärdering.
Ändra Log Analytics-arbetsytan
Följ stegen nedan om du vill ändra Log Analytics-arbetsytan som är länkad för utvärderingen av bästa praxis.
Inaktivera utvärdering av metodtips om den för närvarande är aktiverad via Azure-portalen.
Gör ett GET-anrop till API:et och hämta Azure-tillägget för SQL Server-inställningar. Mer information finns i Så här anropar du Azure REST API:er med curl.
För att kunna slutföra den här uppgiften måste du hämta ägartoken för att kunna utföra den här åtgärden mot resursen i Azure-portalen. Från Azure-portalen:
- Gå till motsvarande SQL Server – Azure Arc resurs.
- Välj Ctrl+Skift+I tillsammans, gå till fliken Nätverk.
- Välj Översikt för resursen SQL Server – Azure Arc.
- I namnkolumnen letar du upp och väljer posten för ArcServer-namn?api-version.
- I det högra fönstret går du till Begäranhuvuden.
- Kopiera den fullständiga texten för Authorization: Bearer för att hämta ägarauktoriseringstoken.
GET https://edge.management.azure.com/subscriptions/ <subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.HybridCompute/machines/<arc-resource-name>/extensions/WindowsAgent.SqlServer?api-version=2022-03-10
Utvärderingsinställningarna för bästa praxis före ändringen.
"AssessmentSettings": { "Enable": true, "RunImmediately": true, "schedule": { "dayOfWeek": "Sunday", "Enable": true, "monthlyOccurrence": null, "StartDate": null, "startTime": "00:00", "WeeklyInterval": 1 }, "WorkspaceResourceId": null, "WorkspaceLocation": null, "ResourceNamePrefix": null, "settingsSaveTime": 1673278632 }
Uppdatera de arbetsyterelaterade inställningarna till null enligt följande.
"AssessmentSettings": { "Enable": false, "RunImmediately": true, "schedule": { "dayOfWeek": "Sunday", "Enable": true, "monthlyOccurrence": null, "StartDate": null, "startTime": "00:00", "WeeklyInterval": 1 }, "WorkspaceResourceId": null, "WorkspaceLocation": null, "ResourceNamePrefix": null, "SettingsSaveTime": 1673278632 }
Gör ett
PATCH
anrop till API:et för att uppdatera Azure-tillägget för SQL Server-utvärderingsinställningar.PATCH https://management.azure.com/subscriptions/ <subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.HybridCompute/machines/<arc-resource-name>/extensions/WindowsAgent.SqlServer?api-version=2022-08-11-preview
Gå till Best Practices Assessment på din Arc-aktiverade SQL Server-resurssida i Azure-portalen och återaktivera utvärdering av bästa praxis och välj en ny log analytics-arbetsyta.
Om du vill ha mer hjälp skapar du ett supportärende med Microsoft och bifogar loggfilerna. Besök Skapa en supportförfrågan till Azure