Exibir os logs de erro do portal

Aministradores ou desenvolvedores do portal usam os portais do Power Apps para criar um site para seus clientes. Os desenvolvedores costumam depurar os problemas ao desenvolver o portal. Para ajudar na depuração, você pode acessar logs de erros detalhados de qualquer problema no seu portal. Há várias formas de obter os logs de erros dos seus portais.

Erro personalizado

Se ocorrer uma exceção no lado do servidor do seu portal, uma página de erro personalizada será mostrada por padrão com uma mensagem de erro amigável. Para configurar a mensagem de erro, consulte Exibir uma mensagem de erro personalizada.

Entretanto, é melhor que você consulte a página de erro detalhada ASP.NET, também conhecida como tela amarela de erro, para fins de depuração. A página de erro detalhada ajuda você a obter a pilha completa de erros do servidor.

Para habilitar a tela amarela de erro, você precisa desabilitar erros personalizados do seu portal.

Mais informações sobre erros personalizados: Exibindo uma Página de Erro Personalizada

Desabilitar erro personalizado

Você pode desabilitar erros personalizados nos portais para exibir a mensagem de exceção detalhada caso ocorra uma exceção no lado do servidor do seu portal.

1. Abra o Centro de administração de portais do Power Apps.

2. Vá para Ações do Portal > Desabilitar erros personalizados.

   

3. Selecione Desabilitar na mensagem de confirmação. Enquanto os erros personalizados estiverem sendo desabilitados, o portal será reiniciado e ficará indisponível. Uma mensagem de erro é exibida quando erros personalizados são desabilitados.

Habilitar erro personalizado

Você pode habilitar erros personalizados nos portais para exibir uma página com aspecto profissional em vez da tela amarela de erro. Essa página fornecerá informações úteis se ocorrer qualquer exceção no aplicativo.

1. Abra o Centro de administração de portais do Power Apps.

2. Vá para Ações do Portal > Habilitar erros personalizados.

   

3. Selecione Habilitar na mensagem de confirmação. Enquanto os erros personalizados estiverem sendo habilitados, o portal será reiniciado e ficará indisponível. Uma mensagem de erro é exibida quando erros personalizados são habilitados.

Exibir uma mensagem de erro personalizada

Você pode configurar seu portal para exibir uma mensagem de erro com aspecto profissional em vez de um erro genérico.

Para definir um erro personalizado, use o trecho do conteúdo de Portal Generic Error. O conteúdo definido nesse trecho é mostrado na página de erro. Esse trecho do conteúdo não está disponível pronto para uso, e você deve criá-lo. O trecho do conteúdo Tipo pode ser Texto ou HTML. Criar ou editar o conteúdo de trecho, consulte Personalize conteúdo usando trechos de conteúdo.

Quando você habilita os erros personalizados, a mensagem é exibida na estrutura a seguir da página de erro:

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

Veja a seguir um exemplo de uma mensagem de erro personalizada, usando trecho do conteúdo do tipo HTML:

Este é um erro personalizado, envie um tíquete de suporte com a captura de tela do erro clicando aqui

Acessar logs de erros do portal

Após desenvolver e publicar o portal, você ainda precisará ter acesso aos logs do portal para depurar problemas relatados pelos clientes. Para acessar os logs, você pode configurar seu portal para enviar todos os erros do aplicativo a uma conta do Armazenamento de Blobs do Azure que você possua. Acessando os logs de erros do portal, você pode responder a consultas de clientes com eficiência, pois você tem os detalhes do erro. Para mover os logs de erros do portal para o Armazenamento de Blobs do Azure, você deve habilitar o log de diagnósticos do centro de administração dos portais do Power Apps.

Habilitar log de diagnóstico

1. Abra o Centro de administração de portais do Power Apps.

2. Vá para Ações do Portal > Habilitar log do diagnóstico.

   

3. Na janela de Habilitar log de diagnóstico, digite os seguintes valores:

   • Cadeia de Conexão do Serviço de Armazenamento de Blobs do Azure: URL do serviço de Armazenamento de Blobs do Azure para armazenar logs de erros do portal. O tamanho máximo da URL é 2048 caracteres. Se a URL for maior do que 2048 caracteres, uma mensagem de erro será exibida. Mais informações sobre cadeia de conexão: Configurar cadeias de conexão do Armazenamento do Azure
   • Selecionar período de retenção: a duração para manter os logs de erro do portal no armazenamento de blobs. Os logs de erros serão excluídos após o término da duração selecionada. Você pode selecionar um dos seguintes valores:
     • Um dia
     • Sete dias
     • 30 dias
     • 60 dias
     • 90 dias
     • 180 dias
     • Sempre

   Por padrão, o período de retenção é de 30 dias.

   

4. Selecione Configurar.

Quando o log de diagnóstico estiver configurado, um novo contêiner de blob telemetry-logs será criado na sua conta do armazenamento do Azure, e os logs serão gravados nos arquivos de blob do contêiner. A captura de tela a seguir mostra o contêiner de blob telemetry-logs no Gerenciador de Armazenamento do Azure:

Quando o log de diagnóstico é habilitado com êxito, as ações a seguir ficam disponíveis:

• Atualizar configuração de log de diagnóstico: permite que você atualize ou remova a configuração de log de diagnóstico para o portal.
• Desabilitar log de diagnóstico: permite que você desabilite ou remova a configuração de log de diagnóstico para o portal.

Atualizar log de diagnóstico

1. Abra o Centro de administração de portais do Power Apps.

2. Vá para Ações do Portal > Atualizar configuração de log de diagnóstico.

   

3. Na janela de Atualizar configuração de log de diagnóstico, insira os seguintes valores:

   • Deseja atualizar a cadeia de conexão do serviço de Armazenamento de Blobs do Azure?: permite que você especifique se deseja atualizar ou não a cadeia de conexão do serviço de Armazenamento de Blobs do Azure. Ela é selecionada por padrão.
   • Cadeia de Conexão do Serviço de Armazenamento de Blobs do Azure: URL do serviço de Armazenamento de Blobs do Azure para armazenar logs de erros do portal. O tamanho da URL pode ser no máximo de 2048 caracteres. Se a URL for maior do que 2048 caracteres, uma mensagem de erro será exibida. Esse campo será exibido somente se a caixa seleção Deseja atualizar a cadeia de conexão do serviço de Armazenamento de Blobs do Azure? estiver marcada. Mais informações sobre cadeia de conexão: Configurar cadeias de conexão do Armazenamento do Azure
   • Selecionar período de retenção: a duração para manter os logs de erro do portal no armazenamento de blobs. Os logs de erros serão excluídos após o término da duração selecionada. Você pode selecionar um dos seguintes valores:
     • Um dia
     • Sete dias
     • 30 dias
     • 60 dias
     • 90 dias
     • 180 dias
     • Sempre

   Por padrão, o período de retenção é de 30 dias.

   

4. Selecione Atualizar.

Desabilitar log de diagnóstico

1. Abra o Centro de administração de portais do Power Apps.

2. Vá para Ações do Portal > Desabilitar log de diagnóstico.

   

3. Selecione Desabilitar na mensagem de confirmação.

Exibir erro de plug-in

A outra situação que ocorre com frequência ao desenvolver um portal é um erro gerado por plug-ins personalizados e lógicas de negócios gravadas no seu ambiente Dataverse. Geralmente, esses erros podem ser acessados desabilitando erros personalizados ou habilitando o log de diagnóstico. Em alguns casos, é mais rápido exibir esses erros diretamente no portal para diagnosticar o problema mais rapidamente. Você pode fazer isso ao configurar seu portal para exibir erros de plug-in do Dataverse na tela do portal.

Para exibir outros erros de plug-in personalizados, crie a configuração do site Site/EnableCustomPluginError e defina seu valor como True. Erros de plug-in personalizados serão exibidos na tela em vez de um erro genérico. O erro exibirá somente a parte da mensagem do erro de plug-in e não exibirá o rastreamento completo da pilha.

Veja a seguir as as telas em que os erros de plug-in personalizados serão exibidos:

• Lista
  • Recuperação de registros
• Formulário básico
  • Retrieve
  • Criar/Atualizar e assim por diante
• Formulários de várias etapas
  • Retrieve
  • Criar/Atualizar e assim por diante

Se a definição do site não estiver presente, ele será tratado por padrão como false e erros de plug-in não serão renderizados.

Confira também

Manutenção e solução de problemas do portal do Power App