Visualizzazione dei registri degli errori del portale

In qualità di amministratore o sviluppatore del portale, puoi utilizzare i portali Power Apps per creare un sito Web per i clienti. Un compito comune per uno sviluppatore è il debug dei problemi durante lo 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.

Yellow Screen of Death

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

Nota

Si consiglia di disabilitare solo gli errori personalizzati quando si è nella fase di sviluppo e di abilitare gli errori personalizzati quando si è pronti.

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 di Power Apps.

  2. Vai a Azioni del portale > Disabilita errori personalizzati

    Disabilitare un errore personalizzato

  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 di Power Apps.

  2. Vai a Azioni del portale > Abilita errori personalizzati

    Abilitare un errore personalizzato

  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.

Nota

  • Se modifichi l'istanza a cui è collegato il portale, 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 portale, altrimenti viene visualizzato un messaggio di errore.

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.

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:

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

Messaggio di errore personalizzato

Nota

Se il portale non può recuperare un frammento di contenuto perché non può connettersi a Common Data Service o se il frammento non è disponibile in Common Data Service, verrà visualizzato un messaggio di errore.

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.

Nota

Se si modifica l'istanza di Common Data Service a cui il portale è connesso, la registrazione diagnostica è disabilitata. È necessario abilitare nuovamente la registrazione diagnostica.

Abilita registrazione diagnostica

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

  2. Vai a Azioni del portale > Abilita registrazione diagnostica

    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:
      • 1 giorno
      • 7 giorni
      • 30 giorni
      • 60 giorni
      • 90 giorni
      • 180 giorni
      • Sempre

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

    Finestra Abilita registrazione diagnostica

  4. Fai clic su 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:

Account di Archiviazione BLOB di Azure

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 di Power Apps.

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

    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:
      • 1 giorno
      • 7 giorni
      • 30 giorni
      • 60 giorni
      • 90 giorni
      • 180 giorni
      • Sempre

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

    Finestra Aggiorna configurazione della registrazione diagnostica

  4. Fai clic su Aggiorna.

Disabilita registrazione diagnostica

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

  2. Vai a Azioni del portale > Disabilita registrazione diagnostica

    Disabilita registrazione diagnostica

  3. Nel messaggio di conferma fai clic su 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 Common Data Service. In genere è possibile accedere a questi errori disabilitando gli errori personalizzati o abilitando la registrazione diagnostica. Tuttavia, in alcuni casi, è più veloce visualizzare questi errori direttamente sul portale per diagnosticare il problema più rapidamente. A tale scopo, è possibile configurare il portale in modo che visualizzi errori di plug-in personalizzati di Common Data Service 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 entità
    • Recupero di record
  • Modulo dell'entità
    • Recupero
    • Creazione/aggiornamento e così via
  • Moduli Web
    • Recupero
    • 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

Microsoft Learn: manutenzione e risoluzione dei problemi del portale Power App