Partager via

Configuration des journaux d’actions de flux de bureau

  • Article

Cette page 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.

Important

  • Cette fonctionnalité s’applique uniquement aux flux Bureau lancés à partir d’un flux de cloud et n’est pas encore disponible pour les exécutions attended local à partir de Power Automate Bureau.
  • Bien que la configuration des journaux flux de bureau soit désormais généralement disponible, certaines configurations étiquetées "version préliminaire" telles que le type de journal d’action Logs V2 sont toujours dans version préliminaire et mises à disposition avant une version officielle afin que les clients puissent obtenir un accès anticipé et fournir des commentaires. Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes.

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.

Capture d’écran et paramètre au niveau de l’environnement vous permettant de configurer le moment où les journaux de flux de bureau doivent être capturés.

Statut de l’activation Informations
Activé (par défaut) Cette option est la valeur par défaut pour les environnements existants et nouveaux où les journaux sont capturés comme d’habitude.
En cas d’échec de l’exécution Cette option capture uniquement les journaux d’actions de flux de bureau en cas d’erreur d’exécution. Cela signifie que les journaux ne sont pas disponibles pour chaque exécution, mais uniquement lorsqu’une erreur se produit. Toutefois, si une erreur se produit, tous les journaux pour cette exécution particulière sont disponibles, y compris les actions ayant réussi et échoué.
Désactivé Cette option désactive efficacement les journaux des actions d’exécution du flux de bureau complètement.

Avertissement

La modification de l’un de ces paramètres peut avoir un impact significatif sur des fonctionnalités telles que la résolution des problèmes et l’audit en cas d’échec d’exécution. Tenez compte des implications de la modification de ces paramètres avant de continuer.

Configurer la version des journaux d’actions de flux de bureau (version préliminaire)

La Version des journaux d’actions vous permet de choisir V1, V2 ou les deux.

Capture d’écran et paramètre au niveau de l’environnement vous permettant de configurer les journaux de flux de bureau V2.

Version des journaux Explication
V1 – Stocké dans le champ AdditionalContext de l’entité FlowSession Il s’agit de l’option par défaut. Les journaux sont stockés dans le champ AdditionalContext de la table Session de flux, qui est un attribut de fichier stocké sous forme d’objet blob dans Microsoft Dataverse. Les journaux V1 consomment la capacité de fichier Dataverse. Cette fonctionnalité est généralement disponible (GA).
V2 – Stocké dans l’entité FlowLogs (version préliminaire) Cette nouvelle option version préliminaire vous permet de stocker les journaux dans la table Flow Logs, qui est stockée dans les tables élastiques. Les journaux V2 consomment la capacité de base de données Dataverse. Cette fonctionnalité est actuellement en version d'évaluation publique.
Les deux (version préliminaire) Ce paramètre version préliminaire permet de stocker les journaux à la fois dans le champ AdditionalContext traditionnel de la table Flow Session et dans la table Flow Logs. Cette fonctionnalité est en version préliminaire et consomme à la fois la capacité de fichier et de base de données Dataverse. Ce paramètre est destiné à des fins de débogage ou de test car il consomme à la fois la capacité de la base de données et celle du fichier Dataverse . Cette fonctionnalité est actuellement en version d'évaluation publique.

La valeur Durée de vie de l’entité FlowLogs en minutes (version préliminaire) détermine la durée pendant laquelle les journaux d’actions doivent être conservés dans la table élastique Journaux de flux. Dataverse supprime automatiquement les enregistrements plus anciens que l’intervalle de temps spécifié. Voici quelques exemples de valeurs à toutes fins utiles.

Jours Minutes
Un jour 1,440 minutes
Trois jours 4,320 minutes
Sept jours 10,080 minutes
Plus de 14 jours 20,160 minutes
28 jours 40,320 minutes
60 jours 86,400 minutes
Plus de 90 jours 129,600 minutes
180 jours 259,200 minutes
365 jours 525,600 minutes
Toujours Inférieur ou égal à 0 (zéro) minutes

Note

Avant d’activer les journaux V2 (version préliminaire), assurez-vous que vous disposez d’une capacité de base de données suffisante qui prend en charge les paramètres de conservation des données et qui correspond à votre planification de capacité, à vos droits et à Ajuster si nécessaire. Dataverse Consultez les exemples Dataverse de calculs de demande de capacité pour les journaux V2 dans la section suivante pour quelques exemples de dimensionnement.

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 :

Fonctionnalité Journaux V1 Journaux V2 Informations
Conservation automatique des données Non disponible Disponible V2 utilise des Tables élastiques, qui sont optimisées par Azure Cosmos DB et intègrent une fonctionnalité de durée de vie pour la conservation automatique des données.
Prise en charge des journaux de grande taille Environ 50 000 à 80 000 journaux d’actions (maximum) Environ deux fois le nombre de journaux d’actions V1 (initialement) V2 pourrait théoriquement évoluer jusqu’à des gigaoctets de journaux d’actions par exécution à l’avenir, tandis que V1 ne peut évoluer qu’au volume spécifié dans ce tableau.
Prise en charge de la gouvernance et des rapports avancés Non disponible Disponible Dans V1, l’attribut AdditionalContext est un type de fichier, stocké sous forme d’objet blob dans Dataverse, ce qui le rend difficile à analyser pour les contrôles de reporting et de gouvernance. Les journaux sont beaucoup plus accessibles dans V2.
Prise en charge de l’intégration d’Azure Synapse Link for Dataverse Non disponible Disponible Dans V1, l’attribut AdditionalContext est un type de fichier, stocké sous forme d’objet blob dans Dataverse, qui n’est pas pris en charge pour la synchronisation avec Azure Synapse.
Prise en charge de l’audit Dataverse Non disponible Disponible Dans V1, l’attribut AdditionalContext est un type de fichier, stocké sous forme d’objet blob dans Dataverse, qui n’est pas pris en charge dans l’audit Dataverse.
Prise en charge de la conservation à long terme Dataverse Non disponible Planifié Dans V1, l’attribut AdditionalContext est un type de fichier, stocké sous forme d’objet blob dans Dataverse, qui n’est pas pris en charge dans la conservation à long terme Dataverse.
Basé sur le contrôle d’accès en fonction du rôle (RBAC) Dataverse Disponible Disponible Les deux versions utilisent Dataverse RBAC, qui hérite des autorisations du journal d’actions de l’enregistrement de session de leur flux parent.

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). Idéale pour les organisations qui ont besoin d’accéder à une quantité importante de données à des fins de reporting, de gouvernance et d’intégration avec un contrôle de conservation automatique des données.

Dataverse calculs de demande de capacité pour les logarithmes V2 (version préliminaire)

Le tableau suivant présente des exemples d’estimations de consommation de stockage de base de données 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.

Nombre d’actions Demande de stockage par action (Ko) Consommation totale de stockage (Mo)
1 000 3 2.93
10,000 3 29.3
30,000 3 87.9
60 000 3 175.8
100 000 3 293
160,000 3 480

Important

Les chiffres présentés dans le tableau ci-dessus ne sont que des estimations et la consommation réelle de stockage peut varier considérablement. La demande exacte de stockage dépendra des détails spécifiques et de la complexité de chaque journal d’action. Par conséquent, ces chiffres doivent être utilisés comme guide approximatif pour comprendre la demande potentielle de stockage et planifier vos exigences de stockage en conséquence.

Interrogation des données des journaux V2 (version préliminaire)

L’accès aux données des journaux d’actions de flux de bureau peut être obtenu en effectuant un appel d’API au backend Dataverse, soit en utilisant la syntaxe d’appel d’API traditionnelle, soit en utilisant la nouvelle méthode ExecuteCosmosSqlQuery. Cette méthode vous permet d’exécuter une requête SQL sur Dataverse, permettant la récupération et le filtrage des données.

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

Syntaxe de l’appel d’API Dataverse traditionnel

L’appel d’API suivant récupère une session de flux spécifique par son ID (9d51aa1f-315e-43ab-894f-bc445dfb049b), puis accède aux journaux d’actions associés à l’aide de la relation flowsession_flowlog_parentobjectid.

[Organization URI]/api/data/v9.0/flowsessions(9d51aa1f-315e-43ab-894f-bc445dfb049b)/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,PartitionId=@p3,QueryParameters=@p4,PageSize=@p5)?
    @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: 'flowsession_40590757-a9c0-4f4c-abfc-e2f389049d90'
    @p4: {"Keys":["@referencingParentId","@referencingParentLogicalName"],"Values":[{"Type":"System.Guid","Value":"40590757-a9c0-4f4c-abfc-e2f389049d90"},{"Type":"System.String","Value":"flowsession"}]}
    @p5: 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://[my org].api.crm[my region].dynamics.com/api/data/v9.2/) est le point de terminaison pour l’API web Dataverse.
  • ExecuteCosmosSqlQuery est la méthode appelée. Cette méthode permet l’exécution d’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. Voici ces fonctionnalités :
    • QueryText=@p1 : requête SQL à exécuter. Dans ce cas, la requête sélectionne diverses propriétés dans une table où le type est 100000001 (type du journal d’actions de flux de bureau) et classe les résultats selon la propriété startTime dans l’ordre décroissant.
    • EntityLogicalName=@p2 : nom logique de la table (flowlog) qui stocke les journaux d’actions.
    • PartitionId=@p3 : ce paramètre est utilisé pour identifier la partition dans Azure Cosmos DB où la requête doit être exécutée. Il est défini sur flowsession_[flowsessionid].
    • QueryParameters=@p4 : objet JSON qui spécifie les paramètres de la requête. Dans l’exemple précédent, il spécifie un paire clé-valeur où les clés sont @referencingParentId et @referencingParentLogicalName avec des valeurs de flowsessionid (GUID) et le type de la table flowsession.
    • PageSize=p5:Il s’agit de la taille de la page de requête.

Limitations connues

  • Les journaux V2 (version préliminaire) ne sont disponibles que pour les exécutions flux de bureau lancées à partir d’un flux de cloud via l’action du connecteur flux de bureau.
  • 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.