Solução de problemas de site do Power Pages

Concluído

Uma das principais responsabilidades de um administrador do Power Pages é garantir que o site esteja disponível e funcionando sem erros. O Power Pages fornece ferramentas para ajudar administradores e desenvolvedores a identificar, solucionar problemas e resolver problemas de runtime.

Problemas do site do Power Pages

Se todo o site estiver inacessível, um administrador poderá investigar várias possibilidades:

  • Se o site foi habilitado ou não
  • Se outros aplicativos do Microsoft Dataverse estão acessíveis
  • Problemas que podem ter ocorrido com os serviços de infraestrutura dos quais o Power Pages depende, como o Microsoft Entra ID ou o Serviço de Aplicativo do Azure
  • Se há avisos em Integridade do Serviço - Centro de administração do Microsoft 365

Um administrador também deve investigar se alguns metadados do site foram modificados recentemente, como o site ou as linhas de associação do site, o que também pode afetar a funcionalidade.

A execução do Verificador de Sites também pode identificar possíveis problemas com o site.

Problemas de funcionalidade e de página do site

Ocasionalmente, um administrador de site pode precisar resolver erros com páginas ou funções específicas do site.

O Power Pages tem várias ferramentas que permitem que um administrador identifique e resolva problemas rapidamente sem entrar em contato com o suporte da Microsoft.

Desabilitar erros personalizados

Um erro típico pode começar quando um visitante do site relata um problema ao visitar uma página do site. Geralmente, a mensagem de erro é curta e não descreve o problema subjacente.

No Centro de administração do Power Pages, a ação Desabilitar erros personalizados substitui a notificação por informações de erro detalhadas na página do site que podem fornecer informações extras para um administrador solucionar o problema.

Observação

A desabilitação de erros personalizados deve ser uma configuração temporária porque a mensagem de erro detalhada pode transmitir uma experiência negativa aumentada para os visitantes do site. Recomendamos que você só desabilite os erros personalizados quando estiver na fase de desenvolvimento e habilite-os depois de ativar o portal.

Outra opção é personalizar a mensagem de erro adicionando um trecho de conteúdo denominado erro genérico do portal com uma mensagem apropriada para os usuários do site. Para obter mais informações, consulte Exibir uma mensagem de erro personalizada.

Log de diagnóstico

Além dos erros visuais nas páginas do site, podem ocorrer problemas subjacentes não tão óbvios de isolar e solucionar. Você pode configurar o Power Pages para registrar informações de diagnóstico. Os logs de diagnóstico são armazenados no Armazenamento de Blobs do Azure em um contêiner chamado telemetry-logs. O administrador pode configurar o período de retenção de quanto tempo manter os logs.

Os logs podem fornecer informações sobre padrões, duração e frequência de erros específicos do site para ajudar a resolver possíveis erros e problemas. Para obter mais informações, consulte Exibir logs de erros.

Mais etapas de solução de problemas

Como o site pode estender determinadas funcionalidades de um aplicativo baseado em modelo, uma técnica para eliminar possíveis erros do site é tentar a mesma operação no aplicativo baseado em modelo. Por exemplo, se um erro for gerado quando um registro for adicionado por meio do site, tente adicionar ou atualizar o mesmo registro de dados que um usuário do site está tentando criar ou atualizar em um site. Depois que o erro foi resolvido no aplicativo baseado em modelo, ele geralmente será resolvido no site.

A criação da configuração do site Site/EnableCustomPluginError e a definição do valor como True exibirão o conteúdo do erro do plug-in em uma página do site, e não como uma mensagem de erro genérica.

Para obter mais informações, consulte Exibir erro de plug-in.