Visualizza log degli errori del sito Web

Gli amministratori e gli sviluppatori utilizzano Power Pages per creare siti Web per i clienti. Gli sviluppatori spesso eseguono il debug dei problemi di sviluppo del sito Web. Per facilitare il debug, è possibile accedere a registri degli errori dettagliati per qualsiasi problema sul sito Web. Esistono diversi modi per ottenere i registri degli errori per il sito Web.

Suggerimento

Per informazioni sui ruoli richiesti per eseguire le attività di questo articolo, leggi Ruoli di amministratore richiesti per le attività amministrative del portale.

Errore personalizzato

Se si verifica un'eccezione lato server nel sito Web, per impostazione predefinita viene visualizzata una pagina di errore personalizzata con un messaggio di errore intuitivo. Per configurare il messaggio di errore, vedi Visualizzare un messaggio di errore personalizzato.

Tuttavia, è meglio visualizzare la pagina di errore dettagliata di ASP.NET, nota anche come Yellow Screen of Death (YSOD), a scopo di debug. La pagina di errore dettagliata consente di ottenere l'intero stack di errori del server.

Per abilitare YSOD, è necessario disabilitare gli errori personalizzati nel sito Web.

Nota

• Si consiglia di disabilitare solo gli errori personalizzati quando si è nella fase di sviluppo e di abilitare gli errori personalizzati quando si è pronti.
• Gli errori personalizzati vengono visualizzati costantemente sul sito privato e non possono essere disattivati.

Ulteriori informazioni sull'errore personalizzato: Visualizzazione di una pagina di errore personalizzata

Disabilitare un errore personalizzato

È possibile disabilitare gli errori personalizzati sui siti Web Power Pages per visualizzare il messaggio di eccezione dettagliato se si verifica un'eccezione sul lato server nel sito Web.

1. Apri l'interfaccia di amministrazione di Power Platform.

2. Nella sezione Risorse, seleziona Siti Power Pages.

3. Seleziona il tuo sito Web.

4. Dal menu Azioni sito, seleziona Disabilita errori personalizzati.

1. Nel messaggio di conferma seleziona Disabilita. Mentre gli errori personalizzati vengono disabilitati, il sito Web si riavvia e non sarà disponibile.

Abilitare un errore personalizzato

È possibile abilitare gli errori personalizzati sui siti Web per visualizzare una pagina dall'aspetto professionale anziché YSOD. Questa pagina fornisce informazioni significative se si verifica un'eccezione nell'applicazione.

1. Apri l'interfaccia di amministrazione di Power Platform.

2. Nella sezione Risorse, seleziona Siti Power Pages.

3. Seleziona il tuo sito Web.

4. Dal menu Azioni sito, seleziona Abilita errori personalizzati.

5. Nel messaggio di conferma seleziona Abilita. Mentre gli errori personalizzati vengono abilitati, il sito Web si riavvia e non sarà disponibile.

Nota

• Se modifichi l'istanza a cui è collegato il sito Web, l'impostazione degli errori personalizzati viene impostata su abilitata. È necessario disabilitare nuovamente gli errori personalizzati, se necessario.
• Non si deve abilitare o disabilitare gli errori personalizzati quando viene modificata l'istanza a cui è collegato il sito Web, altrimenti viene visualizzato un messaggio di errore.

Visualizzare un messaggio di errore personalizzato

È possibile configurare il sito Web per visualizzare un errore personalizzato dall'aspetto professionale anziché un errore generico.

Per definire un errore personalizzato, utilizza il frammento contenuto Portal Generic Error. Il contenuto definito in questo frammento viene mostrato nella pagina di errore. Questo frammento di contenuto non è già disponibile e devi crearlo. Il frammento di contenuto Tipo può essere Testo o HTML. Per creare o modificare un frammento di contenuto, vedere Personalizzazione di contenuto mediante frammenti di contenuto.

Nota

Se il codice Liquid è scritto nel frammento di contenuto, verrà ignorato e non verrà visualizzato.

Quando si abilitano gli errori personalizzati, il messaggio viene visualizzato nella seguente struttura nella pagina di errore:

<Content Snippet>
<Error ID >
<Date and time>
<Portal ID>

Di seguito è riportato un esempio di un messaggio di errore personalizzato che utilizza un frammento di contenuto di tipo HTML:

This is a custom error, file a support ticket with screenshot of error by clicking here

Nota

Se il sito Web non può recuperare un frammento di contenuto perché non può connettersi a Microsoft Dataverse o se il frammento non è disponibile in Dataverse, verrà visualizzato un messaggio di errore.

Accesso ai registri degli errori del sito Web

Dopo aver sviluppato e pubblicato il sito Web, è ancora necessario poter accedere ai registri del sito Web per eseguire il debug dei problemi segnalati dagli utenti. Per accedere ai registri, è possibile configurare il sito Web per l'invio di tutti gli errori dell'applicazione a un account di Archiviazione BLOB di Azure di proprietà dell'utente. Accedendo ai log degli errori del sito Web, è possibile rispondere in modo efficiente alle richieste degli utenti in quanto si dispone dei dettagli del problema. Per ottenere i registri degli errori del sito Web nell'Archiviazione BLOB di Azure, è necessario abilitare la registrazione diagnostica dall'interfaccia di amministrazione di Power Platform.

Nota

Se si modifica l'istanza di Dataverse a cui il sito Web è connesso, la registrazione diagnostica è disabilitata. È necessario abilitare nuovamente la registrazione diagnostica.

Abilita registrazione diagnostica

1. Apri l'interfaccia di amministrazione di Power Platform.

2. Nella sezione Risorse, seleziona Siti Power Pages.

3. Seleziona il tuo sito Web.

4. Dal menu Azioni sito, seleziona Abilita i log di diagnostica.

5. Il pannello laterale verrà visualizzato in riquadri Abilita registrazione diagnostica, immetti i seguenti valori:

   • Seleziona periodo di memorizzazione: durata per la conservazione dei registri degli errori del portale nell'archiviazione BLOB. I registri degli errori vengono cancellati dopo la durata selezionata. È possibile selezionare uno dei seguenti valori:

     • Un giorno
     • Sette giorni
     • 30 giorni
     • 60 giorni
     • 90 giorni
     • 180 giorni
     • Sempre

     Per impostazione predefinita, il periodo di conservazione è di 30 giorni.

   • Stringa di connessione al servizio Archiviazione BLOB di Azure: URL del servizio Archiviazione BLOB di Azure per archiviare i registri degli errori del sito Web. La lunghezza massima dell'URL è 2048 caratteri. Se l'URL è più lungo di 2048 caratteri, viene visualizzato un messaggio di errore. Ulteriori informazioni sulla stringa di connessione: Configurare le stringhe di connessione dello spazio di Archiviazione di Azure

     

6. Seleziona Abilita.

Una volta configurata la registrazione diagnostica, viene creato un nuovo contenitore BLOB telemetry-logs telemetria nell'account di Archiviazione di Azure e i registri vengono scritti nei file BLOB memorizzati nel contenitore. La seguente schermata mostra il contenitore BLOB telemetry-logs in Azure Storage Explorer:

Quando la registrazione diagnostica è abilitata correttamente, saranno disponibili le seguenti azioni dal menu Azioni sito:

• Disabilita registrazione diagnostica: consente di disabilitare la configurazione della registrazione diagnostica per il portale.
• Aggiorna configurazione della registrazione diagnostica: consente di aggiornare o rimuovere la configurazione della registrazione diagnostica per il portale.

Aggiornamento della registrazione diagnostica

1. Apri l'interfaccia di amministrazione di Power Platform.

2. Nella sezione Risorse, seleziona Siti Power Pages.

3. Seleziona il tuo sito Web.

4. Dal menu Azioni sito, seleziona Aggiorna configurazione della registrazione diagnostica.

5. Nel riquadro Aggiorna configurazione della registrazione diagnostica immetti i seguenti valori:

   • Vuoi aggiornare la stringa di connessione del servizio Archiviazione BLOB di Azure?: consente di specificare se aggiornare la stringa di connessione del servizio Archiviazione BLOB di Azure. Per impostazione predefinita, non è selezionato.

   • Seleziona periodo di memorizzazione: durata per la conservazione dei registri degli errori del sito Web nell'archiviazione BLOB. I registri degli errori vengono cancellati dopo la durata selezionata. È possibile selezionare uno dei seguenti valori:

     • Un giorno
     • Sette giorni
     • 30 giorni
     • 60 giorni
     • 90 giorni
     • 180 giorni
     • Sempre

     Per impostazione predefinita, il periodo di conservazione è di 30 giorni.

   • Stringa di connessione al servizio Archiviazione BLOB di Azure: URL del servizio Archiviazione BLOB di Azure per archiviare i registri degli errori del sito Web. La lunghezza massima dell'URL può essere di 2048 caratteri. Se l'URL è più lungo di 2048 caratteri, viene visualizzato un messaggio di errore. Questo campo viene visualizzato solo se la casella di controllo Vuoi aggiornare la stringa di connessione del servizio Archiviazione BLOB di Azure? è selezionata. Ulteriori informazioni sulla stringa di connessione: Configurare le stringhe di connessione dello spazio di Archiviazione di Azure

Disabilita registrazione diagnostica

1. Apri l'interfaccia di amministrazione di Power Platform.

2. Nella sezione Risorse, seleziona Siti Power Pages.

3. Seleziona il tuo sito Web.

4. Dal menu Azioni sito, seleziona Disabilita registrazione diagnostica.

5. Nel messaggio di conferma seleziona Disabilita.

Visualizzare un errore di plug-in

Un altro scenario che si verifica spesso durante lo sviluppo di un sito Web è un errore generato dai plug-in personalizzati e dalle regole business scritte nell'ambiente di Dataverse. In genere è possibile accedere a questi errori disabilitando gli errori personalizzati o abilitando la registrazione diagnostica. In alcuni casi, è più veloce visualizzare questi errori direttamente sul sito Web per diagnosticare il problema più rapidamente. Puoi eseguire questa operazione configurando il sito Web in modo che visualizzi errori di plug-in personalizzati di Dataverse sulla schermata della pagina Web.

Per visualizzare gli errori personalizzati dei plug-in, crea l'impostazione del sitoSite/EnableCustomPluginError e imposta il valore relativo su True. Gli errori del plug-in personalizzati verranno visualizzati nella schermata al posto di un errore generico L'errore mostrerà solo la parte del messaggio dell'errore del plug-in e non la traccia dello stack completa.

Di seguito sono riportate le schermate in cui verranno visualizzati gli errori personalizzati dei plug-in:

• Elenco
  • Recupero di record
• Modulo di base
  • Retrieve
  • Creazione/aggiornamento e così via
• Moduli con più passaggi
  • Retrieve
  • Creazione/aggiornamento e così via

Se l'impostazione del sito non è presente, verrà considerata come False per impostazione predefinita e gli errori del plug-in non verranno visualizzati.