Configuration des journaux d’actions de flux de bureau

Cet article fournit des conseils de configuration pour les journaux de flux de bureau, situés sous la section des fonctionnalités de l’environnement dans le centre d’administration Power Platform et dans Power Automate pour la configuration détaillée de flux spécifiques.

Le paramètre Statut d’activation des journaux d’actions d’exécution définit le moment où les journaux d’actions d’exécution de flux de bureau doivent être capturés et vous permet même de les désactiver complètement.

Configuration requise

• Licence Premium Power Automate et privilèges d’administration pour configurer les paramètres de journal
• Configuration de l’URL et de l’adresse IP pour Power Automate
  • Cloud public
  • Cloud du secteur public

Configurer la version des journaux d’actions de flux de bureau

Utiliser le paramètre Version des journaux d’actions pour choisir V1, V2 ou les deux.

La valeur de durée de vie de l’entité FlowLogs, exprimée en minutes, détermine la durée de conservation des journaux d’actions dans la table élastique Journaux de flux. Dataverse supprime automatiquement les enregistrements plus anciens que le délai d’exécution spécifié. Voici quelques exemples de valeurs à toutes fins utiles.

Principales différences entre les journaux de flux de bureau V1 et V2

Le tableau suivant décrit les différences entre les journaux de flux de bureau V1 et V2 :

Les journaux V2 offrent des améliorations significatives par rapport à la version précédente, V1. V2 utilise la fonctionnalité de tables élastiques, qui est idéale pour gérer de gros volumes de données, comme les scénarios de journaux d’actions, et intègre la conservation des données (TTL). Cela est idéal pour les organisations qui ont besoin d’accéder à des quantités importantes de données pour la création de rapports, la gouvernance et l’intégration avec un contrôle automatique de la conservation des données.

Calculs de la demande de capacité Dataverse pour les journaux V2

La table suivante présente des exemples d’estimations de la consommation de stockage de journaux Dataverse par exécution de flux de bureau lors de l’utilisation des journaux V2. Il décrit la demande de stockage approximative pour différents nombres d’actions, en supposant une moyenne de 3 Ko de stockage par action.

Commentaires des journaux d’action

Les journaux de flux de bureau V2 vous permettent de définir des niveaux de commentaires pour équilibrer l’observabilité et l’efficacité du stockage. Chaque niveau contrôle la quantité de détails affichés dans les journaux pendant l’exécution du flux. Cette section décrit les niveaux de détail disponibles pour les journaux d’actions de flux de bureau, comment les configurer au niveau de l’environnement dans le centre d’administration de Power Platform (administrateurs uniquement) et comment les configurer pour des flux de bureau individuels.

Niveaux de commentaires des journaux d’exécution de flux de bureau

Configurer le niveau de détail du journal des actions dans le centre d’administration de Power Platform (administrateur uniquement)

Les administrateurs peuvent définir le niveau de détail par défaut pour un environnement entier. Ce paramètre s’applique à tous les flux de bureau, sauf s’il est remplacé au niveau du flux.

1. Connectez-vous au Centre d’administration Power Platform.

2. Dans le volet de navigation, sélectionnez Gérer.

3. Dans la section Gérer, sélectionnez Environnements, puis l’environnement dans lequel vos flux de bureau s’exécutent.

4. Cliquez sur Paramètres.

5. Développez Produit et sélectionnez Fonctionnalités.

6. Localisez le paramètre Détail des journaux d’action dans la section Configuration des journaux d’action d’exécution de flux de bureau.

7. Choisissez votre niveau par défaut : Erreur, Avertissement, Personnalisé, Débogage ou Complet.

8. Sélectionnez Enregistrer pour appliquer la configuration.

   

Configurer le niveau de détail du journal des actions pour un flux de bureau spécifique

Les créateurs peuvent configurer le niveau de détail de chaque flux de bureau à partir du portail Power Automate. Ce paramètre local remplace le paramètre administrateur par défaut.

Remplacez le paramètre d’environnement lorsque vous devez :

• Déboguer un flux de bureau spécifique sans augmenter les journaux pour l’ensemble de l’environnement.
• Augmenter temporairement le niveau de détail pendant les tests ou le dépannage.

Suivez ces étapes pour configurer le niveau de détail du journal des actions pour un flux de bureau spécifique :

1. Se connecter à Power Automate.
2. Ouvrez la page des détails du flux pour le flux de bureau que vous souhaitez configurer.
3. Sélectionnez Modifier et localisez la section Détail des journaux d’action.
4. Sélectionnez le niveau de détail souhaité pour ce flux spécifique.

1. Enregistrez vos modifications.

Interroger les journaux de données V2

Vous pouvez accéder aux données des journaux d’action du flux de bureau en effectuant un appel d’API vers le back-end Dataverse. Vous pouvez utiliser la syntaxe d’appel d’API traditionnelle ou la nouvelle méthode ExecuteCosmosSqlQuery . En utilisant cette méthode, vous pouvez exécuter une requête SQL sur Dataverse, ce qui vous permet de récupérer et de filtrer les données.

Le modèle de journaux de données V2 est basé sur une relation parent-enfant entre la session de flux et les tables de journal de flux. Chaque enregistrement hérite des autorisations de l’enregistrement de session de son flux parent. Pour interroger les journaux d’actions d’une exécution de flux de bureau spécifique, utilisez la syntaxe de requête suivante.

Syntaxe d’appel d’API Dataverse traditionnelle

L’appel d’API suivant récupère une session de flux spécifique par son ID (aaaaa-0000-1111-2222-bbbbbbbb), puis accède aux journaux d’actions associés via la relation flowsession_flowlog_parentobjectid.

[Organization URI]/api/data/v9.0/flowsessions(aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb)/flowsession_flowlog_parentobjectid  

Nouvelle syntaxe de l’appel d’API ExecuteCosmosSqlQuery en utilisant la table FlowLogs

    [Organization URI]/api/data/v9.2/ExecuteCosmosSqlQuery(
    QueryText=@p1,EntityLogicalName=@p2,QueryParameters=@p3,PageSize=@p4)?
    @p1: 'SELECT c.props.flowlogid as flowlogid, c.props.createdon as createdon, c.props.data as data, c.props.level as level, c.props.type as type, c.ttl as ttlinseconds, c.props.cloudflowid as cloudflowid, c.props.cloudflowrunid as cloudflowrunid, c.props.desktopflowid as desktopflowid, c.props.flowmachineid as flowmachineid, c.props.flowmachinegroupid as flowmachinegroupid, c.props.flowsessionid as flowsessionid, c.props.workqueueid as workqueueid, c.props.workqueueitemid as workqueueitemid FROM c WHERE c.props.type IN (100000001) ORDER BY c.props.data.startTime DESC'
    @p2: 'flowlog'
    @p3: {"Keys":["@referencingParentId","@referencingParentLogicalName"],"Values":[{"Type":"System.Guid","Value":"40590757-a9c0-4f4c-abfc-e2f389049d90"},{"Type":"System.String","Value":"flowsession"}]}
    @p4: 50

En savoir plus sur l’interrogation des colonnes JSON dans les tables élastiques.

Décomposition de l’appel en blocs individuels

• L’URL de base (https://[mon organisation].api.crm[ma région].dynamics.com/api/data/v9.2/) est le point de terminaison de l’API Web Dataverse.
• ExecuteCosmosSqlQuery est la méthode que vous appelez. Cette méthode exécute une requête SQL sur Dataverse.
• Les paramètres de la méthode ExecuteCosmosSqlQuery sont fournis entre parenthèses après le nom de la méthode :
  • QueryText=@p1 : la requête SQL à exécuter. Cette requête sélectionne diverses propriétés dans une table où le type est 100000001 (type journal d’action de flux de bureau) et classe les résultats par propriété dans l’ordre décroissant startTime.
  • EntityLogicalName=@p2 : nom logique de la table (flowlog) qui contient les journaux d’actions.
  • QueryParameters=@p3 : objet JSON spécifiant les paramètres de la requête. Dans l’exemple précédent, il spécifie une paire clé-valeur où se trouvent les clés @referencingParentId et @referencingParentLogicalName avec les valeurs de flowsessionid (GUID) et le type de la table flowsession.
  • PageSize=p4 : taille de la page de la requête.

Limitations connues

• Les journaux V2 ne sont disponibles que pour les exécutions de flux de bureau que l’utilisateur démarre à partir d’un flux de cloud via l’action du connecteur de flux de bureau.
• Les tâches de suppression en bloc ne sont pas actuellement prises en charge pour la table Journal de flux.
• Vous ne pouvez pas encore afficher les enregistrements du journal de flux dans la section Table du Power Apps Maker Portal.
• La modification de la version du journal d’actions ne migre pas les journaux d’actions de flux de bureau précédents vers le nouveau type de stockage de journaux.
• N’utilisez pas les entités FlowRun et FlowLog comme cibles pour le déclencheur de flux Lorsqu’une ligne est ajoutée, modifiée ou supprimée. L’utilisation de ces entités comme cibles peut provoquer une boucle infinie, car le système crée des enregistrements dans ces tables chaque fois qu’un flux s’exécute.