Visualizzare i log degli errori del portale

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

Errore personalizzato

Se si verifica un'eccezione lato server nel portale, 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 portale.

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

Disabilitare un errore personalizzato

È possibile disabilitare gli errori personalizzati sui portali per visualizzare il messaggio di eccezione dettagliato se si verifica un'eccezione sul lato server nel portale.

1. Apri l'interfaccia di amministrazione dei portali Power Apps.

2. Vai a Azioni del portale > Disabilita errori personalizzati

   

3. Nel messaggio di conferma seleziona Disabilita. Mentre gli errori personalizzati vengono disabilitati, il portale si riavvia e non sarà disponibile. Quado gli errori personalizzati sono disabilitati, viene visualizzato un messaggio.

Abilitare un errore personalizzato

È possibile abilitare gli errori personalizzati sui portali 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 dei portali Power Apps.

2. Vai a Azioni del portale > Abilita errori personalizzati

   

3. Nel messaggio di conferma seleziona Abilita. Mentre gli errori personalizzati vengono abilitati, il portale si riavvia e non sarà disponibile. Quado gli errori personalizzati sono abilitati, viene visualizzato un messaggio.

Visualizzare un messaggio di errore personalizzato

È possibile configurare il portale 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.

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:

Questo è un errore personalizzato, inviare un ticket di supporto con screenshot dell'errore facendo clic qui

Accesso ai registri degli errori del portale

Dopo aver sviluppato e pubblicato il portale, è ancora necessario poter accedere ai registri del portale per eseguire il debug dei problemi segnalati dai clienti. Per accedere ai registri, è possibile configurare il portale 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 portale, è possibile rispondere in modo efficiente alle richieste dei clienti in quanto si dispone dei dettagli del problema. Per ottenere i registri degli errori del portale nell'Archiviazione BLOB di Azure, è necessario abilitare la registrazione diagnostica dall'interfaccia di amministrazione dei portali Power Apps.

Abilita registrazione diagnostica

1. Apri l'interfaccia di amministrazione dei portali Power Apps.

2. Vai a Azioni del portale > Abilita registrazione diagnostica

   

3. Nella finestra Abilita registrazione diagnostica, immetti i seguenti valori:

   • Stringa di connessione al servizio Archiviazione BLOB di Azure: URL del servizio Archiviazione BLOB di Azure per archiviare i registri degli errori del portale. 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
   • 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.

   

4. Selezionare Configura.

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, sarà disponibile la seguente azione:

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

Aggiornamento della registrazione diagnostica

1. Apri l'interfaccia di amministrazione dei portali Power Apps.

2. Vai a Azioni del portale > Aggiorna configurazione della registrazione diagnostica.

   

3. Nella finestra 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, questa opzione è selezionata.
   • Stringa di connessione al servizio Archiviazione BLOB di Azure: URL del servizio Archiviazione BLOB di Azure per archiviare i registri degli errori del portale. 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
   • 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.

   

4. Selezionare Aggiorna.

Disabilita registrazione diagnostica

1. Apri l'interfaccia di amministrazione dei portali Power Apps.

2. Vai a Azioni del portale > Disabilita registrazione diagnostica

   

3. Nel messaggio di conferma seleziona Disabilita.

Visualizzare un errore di plug-in

Un altro scenario che si verifica spesso durante lo sviluppo di un portale è 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 portale per diagnosticare il problema più rapidamente. Puoi eseguire questa operazione configurando il portale in modo che visualizzi errori di plug-in personalizzati di Dataverse sulla schermata del portale.

Per visualizzare gli errori personalizzati dei plug-in, crea l'impostazione del sito Site/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.

Vedi anche

Manutenzione e risoluzione dei problemi del portale Power App