Condividi tramite


Risolvere i problemi relativi alla valutazione delle procedure consigliate su SQL Server

Si applica a:SQL Server

Prima di procedere, verifica che siano soddisfatti tutti i prerequisiti necessari.

Percorsi dei file di registro

Log dell'estensione

Il file di resoconto dell'estensione si trova in:

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

Il nome del file di log dipende dalla versione dell'estensione Azure per SQL Server; nel caso della versione più recente, il file di log è:

unifiedagent.log

Per la versione 1.1.24724.69 dell'estensione e precedenti, il file di resoconto è:

ExtensionLog_0.log

Log dell’agente di monitoraggio di Azure

Il log dell'agente di monitoraggio di Azure si trova in:

C:\ProgramData\GuestConfig\extension_logs\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\Extension.1.log

Quando si abilita la valutazione delle procedure consigliate, potrebbero verificarsi i problemi seguenti.

Nessuna area di lavoro Log Analytics è disponibile nel menu a discesa

Screenshot che mostra il messaggio di errore quando non è visibile alcun valore nell'elenco a discesa del selettore dell'area di lavoro Log Analytics.

Accertati che l’utente che configura l’automazione dei processi aziendali SQL abbia un Ruolo Collaboratore di Log Analytics nel gruppo di risorse o nella sottoscrizione dell'area di lavoro Log Analytics. L'elenco dei prerequisiti è reperibile qui.

Notifiche di errore che richiedono agli utenti di attendere cinque minuti

Screenshot che mostra le notifiche di errore che informano gli utenti di attendere cinque minuti.

Se viene visualizzata una notifica di questo tipo e si mantiene aperta la pagina, il portale ritenta automaticamente l'operazione dopo cinque minuti. Se la pagina viene aggiornata, il portale consiglia di attendere cinque minuti prima di ripetere l'operazione. Se lo stesso errore persiste dopo molto tempo, verifica lo stato dell'estensione WindowsAgent.SqlServer e accertati che l'estensione non sia bloccata in uno stato di aggiornamento. Se l'estensione è ancora bloccata, verifica la connettività del computer Arc.

Esecuzione della valutazione non riuscita

Se l'esecuzione della valutazione non riesce, seleziona la riga corrispondente per aprire una pagina che visualizza il messaggio di errore.

Errori di collegamento di SQL Server, errore di rete generale

Descrizione

Test di collegamento per la valutazione SQL non riuscito indica che la valutazione non è riuscita a collegarsi all'istanza di SQL Server. Il risultato è il seguente:

Screenshot che mostra il messaggio di errore che indica che SQL Server è offline.

Risoluzione

Segui i passaggi in Risolvere gli errori di connettività di SQL Server.

L’entità di sicurezza del server non è in grado di accedere al database modello

Descrizione

L'entità di sicurezza del server NT Authority/SYSTEM non è in grado di accedere al database "modello" nel contesto di protezione corrente.

L'entità di sicurezza del server non è in grado di accedere al database nel contesto di protezione corrente e restituisce questo errore nel portale.

Screenshot che mostra il messaggio di errore che l'entità server non è in grado di accedere al database.

Risoluzione

Verifica che l'accesso predefinito di SQL Server NT AUTHORITY\SYSTEM sia un membro del ruolo del server amministratore di sistema di SQL Server per tutte le istanze di SQL Server in esecuzione nel computer.

Se non è consentito, puoi configurare un account con privilegi minimi per l'estensione di Azure per il servizio SQL Server nel computer SQL Server. L'account con privilegi minimi è disponibile per l'anteprima.

Per configurare il server, segui la procedura descritta in Gestire SQL Server abilitato da Azure Arc con privilegi minimi (anteprima).

Caricamento dell'agente di Monitoraggio di Azure non riuscito

Se l'errore indica che il caricamento non è riuscito per l'agente di Monitoraggio di Azure (AMA), verifica che il provisioning e la configurazione dell'AMA siano corretti. I componenti seguenti devono essere configurati correttamente per assicurarsi che l'operatore possa caricare i log nell'area di lavoro:

  1. L'area di lavoro Log Analytics collegata deve avere una tabella denominata SqlAssessment_CL.
    1. Passa alla scheda Tabelle nell'area di lavoro Log Analytics collegata.
    2. La tabella SqlAssessment_CL deve essere presente.
  2. Il provisioning dell'agente di Monitoraggio di Azure (versione >= 1.10.0) deve essere eseguito correttamente.
    1. Passa alla scheda Estensioni nella risorsa Arc.
    2. È necessario eseguire correttamente il provisioning di AMA con la versione richiesta.
  3. La regola di raccolta di dati (DCR) e l'endpoint di raccolta dati (DCE) devono trovarsi nella stessa posizione dell'area di lavoro Log Analytics.
    1. Passa alla scheda Informazioni generali del gruppo di risorse a cui appartiene l'area di lavoro Log Analytics.
    2. Nell'elenco delle risorse, il DCR e il DCE possono essere identificati dai prefissi sqlbpa-.
    3. Verifica che DCR e DCE si trovino nella stessa posizione dell'area di lavoro Log Analytics.
  4. La regola di raccolta di dati (DCR) deve essere configurata correttamente.
    1. Passa alla scheda Risorse nel DCR pertinente. Il nome del computer Arc deve essere presente nell'elenco.
    2. Passa alla scheda Origini dati nel DCR pertinente. Seleziona la voce Log di testo personalizzati.
      1. Nella scheda Origini dati, il nome tabella deve essere SqlAssessment_CL.
      2. Nella scheda Origini dati il percorso di raccolta dei log configurato deve essere C:\Windows\System32\config\systemprofile\AppData\Local\Microsoft SQL Server Extension Agent\Assessment\*.csv.
      3. Nella scheda Destinazione deve essere presente il nome dell'area di lavoro Log Analytics.

Se uno dei componenti non è presente, esegui le operazioni seguenti:

  1. Disabilita una valutazione selezionando Configurazione>Disabilita valutazione.
  2. Conferma di avere le autorizzazioni necessarie per abilitare la valutazione.
  3. Abilita la valutazione selezionando Abilita valutazione.

Distribuzione della valutazione non riuscita

  1. Passa alla distribuzione e risolvi l'errore.
  2. Se si verificano problemi con la distribuzione dell'agente di monitoraggio di Azure, verifica che il computer Arc sia collegato.
  3. La distribuzione può sempre essere ritentata con la stessa area di lavoro Log Analytics facendo clic sul pulsante Abilita valutazione.

Modificare l’area di lavoro Log Analytics

Per modificare l'area di lavoro Log Analytics collegata per la valutazione delle procedure consigliate, segui questa procedura.

  1. Disabilita la valutazione delle procedure consigliate se è attualmente abilitata tramite il portale di Azure.

  2. Effettua una chiamata GET all'API e ottieni l'estensione di Azure per le impostazioni di SQL Server. Per altre informazioni, vedere Come richiamare le API REST di Azure con Postman

    Per completare questo task, devi ottenere il bearer token per eseguire questa azione sulla risorsa in portale di Azure. Dal portale di Azure:

    1. Passa alla risorsa di SQL Server - Azure Arc corrispondente.
    2. Seleziona CTRL+MAIUSC+I insieme, passa alla scheda Rete.
    3. Seleziona Informazioni generali per la risorsa SQL Server - Azure Arc.
    4. Nella colonna nome, individua e seleziona l’immissione ArcServer name?api-version.
    5. Nella finestra destra, passa a Intestazioni della richiesta.
    6. Copia il testo completo per Autorizzazione: Bearer per ottenere il bearer token di autorizzazione.
    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
    

    Impostazioni della valutazione delle procedure consigliate prima della modifica.

    "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
    }
    
  3. Aggiorna le impostazioni correlate all'area di lavoro su Null come indicato di seguito.

    "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
    }
    
  4. Effettua una chiamata PATCH seguente all'API per aggiornare le impostazioni della valutazione dell’estensione di Azure per SQL Server.

    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
    
  5. Passa a Valutazione delle procedure consigliate nella pagina risorsa di SQL Server abilitata per Arc in portale di Azure, abilita nuovamente la valutazione delle procedure consigliate e seleziona una nuova area di lavoro Log Analytics.

Per ulteriore assistenza, crea un ticket di supporto con Microsoft e allega i file di resoconto. Visita Creare una richiesta di supporto in Azure

Passaggi successivi