Partager via

Afficher les journaux d’erreurs du site web

  • Article

Les administrateurs et les développeurs de site web utilisent Power Pages pour créer des sites web pour leurs clients. Les développeurs déboguent souvent les problèmes au moment du développement du site web. Pour faciliter le débogage, vous pouvez accéder aux journaux d’erreurs détaillés pour tout problème sur votre site web. Vous trouverez les diverses manières d’obtenir les journaux d’erreurs pour votre site web.

Astuce

Pour en savoir plus sur les rôles requis pour effectuer les tâches de cet article, lisez Rôles d’administrateur requis pour les tâches d’administration du portail.

Erreur personnalisée

Si une exception côté serveur se produit dans votre site web, une page d’erreur personnalisée avec un message d’erreur convivial s’affiche par défaut. Pour configurer le message d’erreur, voir Afficher un message d’erreur personnalisé.

Cependant, il est préférable de consulter la page d’erreur détaillée ASP.NET, également appelée Yellow Screen of Death (YSOD), à des fins de débogage. La page d’erreur détaillée vous permet d’obtenir la pile complète des erreurs de serveur.

Yellow Screen of Death.

Pour activer YSOD, vous devez désactiver les erreurs personnalisées sur votre site web.

Note

  • Il est conseillé de désactiver uniquement les erreurs personnalisées quand vous êtes en phase de développement et d’activer les erreurs personnalisées une fois que vous êtes en ligne.
  • Les erreurs personnalisées sont systématiquement affichées sur le site privé et ne peuvent pas être désactivées.

Informations supplémentaires sur l’erreur personnalisée : Displaying a Custom Error Page

Désactiver les erreurs personnalisées

Vous pouvez désactiver les erreurs personnalisées sur les sites web Power Pages pour afficher le message d’exception détaillé si une exception côté serveur se produit dans votre site web.

  1. Ouvrez le centre d’administration de Power Platform.

  2. Dans la section Ressources, sélectionnez Sites Power Pages.

  3. Sélectionnez votre site web.

  4. Dans le menu Actions du site, sélectionnez Désactiver les erreurs personnalisées.

  5. Sélectionnez Désactiver dans le message de confirmation. Quand les erreurs personnalisées sont désactivées, le site web redémarre et est temporairement indisponible.

Activer les erreurs personnalisées

Vous pouvez activer les erreurs personnalisées sur les sites web pour afficher une page d’aspect professionnel au lieu de la page YSOD. Cette page contient des informations significatives si une exception se produit dans l’application.

  1. Ouvrez le centre d’administration de Power Platform.

  2. Dans la section Ressources, sélectionnez Sites Power Pages.

  3. Sélectionnez votre site web.

  4. Dans le menu Actions du site, sélectionnez Activer les erreurs personnalisées.

  5. Sélectionnez Activer dans le message de confirmation. Quand les erreurs personnalisées sont activées, le site web redémarre et est temporairement indisponible.

Note

  • Si vous modifiez l’instance à laquelle votre site web est connecté, le paramètre Erreurs personnalisées est défini sur Activé. Vous devez désactiver les erreurs personnalisées de nouveau, si nécessaire.
  • Vous ne devez pas activer ni désactiver les erreurs personnalisées quand l’instance à laquelle votre site web est connecté est en cours de modification, sinon un message d’erreur apparaît.

Afficher un message d’erreur personnalisée

Vous pouvez configurer votre site web pour qu’il affiche une erreur personnalisée d’aspect professionnel au lieu d’une erreur générique.

Pour définir une erreur personnalisée, utilisez l’extrait de contenu Portal Generic Error. Le contenu défini dans cet extrait est affiché sur la page d’erreur. Cet extrait de contenu n’est pas disponible immédiatement et vous devez le créer. L’extrait de contenu Type peut être Texte ou HTML. Pour créer ou modifier l’extrait de code de contenu, voir Personnaliser le contenu en utilisant des extraits de code de contenu.

Note

Si du code Liquid est saisi dans l’extrait de contenu, il sera ignoré et ne sera pas affiché.

Quand vous activez les erreurs personnalisées, le message apparaît dans la structure suivante sur la page d’erreur :

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

Le message suivant est un exemple de message d’erreur personnalisée, qui utilise un extrait de contenu de type HTML :

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

Message d’erreur personnalisée.

Note

Si le site web ne peut pas récupérer un extrait de contenu, car il ne peut pas se connecter à Microsoft Dataverse, ou si l’extrait n’est pas disponible dans Dataverse, un message d’erreur s’affiche.

Accéder aux journaux d’erreurs du site web

Après avoir développé et publié le site web, vous devez toujours pouvoir accéder aux journaux du site web pour résoudre les problèmes signalés par vos utilisateurs. Pour accéder aux journaux, configurez votre site web pour qu’il envoie toutes les erreurs de l’application à un compte de stockage Blob Azure que vous possédez. En accédant aux journaux d’erreurs du site web, vous pouvez répondre efficacement aux requêtes des utilisateurs car vous disposez des détails liés au problème. Pour obtenir les journaux d’erreurs du site web dans votre stockage Blob Azure, vous devez activer la journalisation des diagnostics depuis le centre d’administration Power Platform.

Note

Si vous modifiez l’instance Dataverse à laquelle votre site web est connecté, la journalisation des diagnostics est désactivée. Vous devez réactiver la journalisation des diagnostics.

Activer la journalisation des diagnostics

  1. Ouvrez le centre d’administration de Power Platform.

  2. Dans la section Ressources, sélectionnez Sites Power Pages.

  3. Sélectionnez votre site web.

  4. Dans le menu Actions du site, sélectionnez Activer les erreurs de diagnostic.

  5. Un volet latéral intitulé Activer la journalisation des diagnostics s’affiche ; entrez les valeurs suivantes :

    • Sélectionner la période de conservation : Durée de conservation des journaux d’erreurs du portail dans le stockage Blob. Les journaux d’erreurs sont supprimés après la durée sélectionnée. Vous pouvez sélectionner une des valeurs suivantes :

      • Un jour

      • Sept jours

      • 30 jours

      • 60 jours

      • Plus de 90 jours

      • 180 jours

      • Toujours

        Par défaut, la période de validité est de 30 jours.

      Note

      L’interface utilisateur n’affiche actuellement que la période de conservation par défaut de 30 jours. Les modifications apportées à la période de conservation ne sont pas reflétées dans l’interface utilisateur.

    • Chaîne de connexion du service Stockage Blob Azure : URL du service Stockage Blob Azure pour stocker les journaux d’erreurs du site web. La longueur maximale de l’URL est de 2048 caractères. Si la longueur de l’URL est supérieure à 2048 caractères, un message d’erreur s’affiche. Informations supplémentaires sur la chaîne de connexion : Configure Azure Storage connection strings

  6. Sélectionnez Activer.

Une fois la journalisation des diagnostics configurée, un nouveau conteneur d’objets blob telemetry-logs est créé dans votre compte de stockage Azure et les journaux sont écrits dans les fichiers blob stockés dans le conteneur. Le capture d’écran suivante affiche le conteneur d’objets blob telemetry-logs dans l’Explorateur de stockage Azure :

Texte utilisé par les lecteurs d’écran.

Quand la journalisation des diagnostics est activée correctement, les actions suivantes deviennent disponibles dans le menu Actions du site :

  • Désactiver la configuration de la journalisation des diagnostics: Vous permet de désactiver la configuration de journalisation des diagnostics pour le portail.
  • Mettre à jour la configuration de la journalisation des diagnostics: Vous permet de mettre à jour ou de supprimer la configuration de journalisation des diagnostics pour le portail.

Mettre à jour la journalisation des diagnostics

  1. Ouvrez le centre d’administration de Power Platform.

  2. Dans la section Ressources, sélectionnez Sites Power Pages.

  3. Sélectionnez votre site web.

  4. Dans le menu Actions du site, sélectionnez Mettre à jour la configuration de la journalisation des diagnostics.

  5. Dans le volet Mettre à jour la configuration de la journalisation des diagnostics, entrez les valeurs suivantes :

    • Voulez-vous mettre à jour la chaîne de connexion du service de stockage Blob Azure ?: Vous permet de spécifier s’il faut mettre à jour la chaîne de connexion du service de stockage Blob Azure. Cette option n’est pas sélectionnée par défaut.

    • Sélectionner la période de conservation : durée de conservation des journaux d’erreurs du site web dans le stockage Blob. Les journaux d’erreurs sont supprimés après la durée sélectionnée. Vous pouvez sélectionner une des valeurs suivantes :

      • Un jour
      • Sept jours
      • 30 jours
      • 60 jours
      • Plus de 90 jours
      • 180 jours
      • Toujours

      Par défaut, la période de validité est de 30 jours.

    • Chaîne de connexion du service Stockage Blob Azure : URL du service Stockage Blob Azure pour stocker les journaux d’erreurs du site web. La longueur maximale de l’URL peut être de 2048 caractères. Si la longueur de l’URL est supérieure à 2048 caractères, un message d’erreur s’affiche. Ce champ est affiché uniquement si la case à cocher Voulez-vous mettre à jour la chaîne de connexion du service de stockage Blob Azure ? est sélectionnée. Informations supplémentaires sur la chaîne de connexion : Configure Azure Storage connection strings

Désactiver la journalisation des diagnostics

  1. Ouvrez le centre d’administration de Power Platform.

  2. Dans la section Ressources, sélectionnez Sites Power Pages.

  3. Sélectionnez votre site web.

  4. Dans le menu Actions du site, sélectionnez Désactiver la journalisation des diagnostics.

  5. Sélectionnez Désactiver dans le message de confirmation.

Erreur du plug-in d’affichage

Un autre scénario qui se produit souvent au moment du développement d’un site web est une erreur générée par les plug-ins personnalisés et la logique métier figurant dans votre environnement Dataverse. Ces erreurs peuvent généralement être accessibles par désactivation des erreurs personnalisées ou activation de la journalisation des diagnostics. Dans certains cas, il est plus rapide d’afficher ces erreurs directement sur le site web pour diagnostiquer le problème plus rapidement. Vous pouvez accomplir cette tâche en configurant votre site web pour afficher les erreurs de plug-in personnalisées de Dataverse sur votre page web.

Pour afficher les erreurs de plug-in personnalisées, créez le paramètre de siteSite/EnableCustomPluginError et définissez sa valeur sur True. Les erreurs de plug-in personnalisées sont affichées sur l’écran au lieu d’une erreur générique. L’erreur affiche seulement la partie du message de l’erreur du plug-in et non la trace complète de la pile.

Voici les écrans où les erreurs de plug-in personnalisées apparaissent :

  • Liste
    • Récupération d’enregistrements
  • Formulaire de base
    • Retrieve
    • Créer/Mettre à jour, etc.
  • Formulaires à plusieurs étapes
    • Retrieve
    • Créer/Mettre à jour, etc.

Si le paramètre de site n’est pas présent, il est traité avec la valeur False par défaut et les erreurs de plug-in ne sont pas affichées.

Afficher les erreurs côté serveur dans l’extension DevTools

Vous pouvez afficher les messages d’erreur côté serveur et les solutions potentielles à l’aide de l’extension DevTools Power Pages. Vous pouvez également déboguer le code côté serveur en enregistrant des messages personnalisés. Pour en savoir plus, consultez Extension DevTools Power Pages : enregistrer des messages personnalisés avec Liquid.