Konfiguration der Desktop-Flow-Aktionsprotokolle

Auf dieser Seite finden Sie Konfigurationshinweise für Desktop-Flow-Protokolle. Sie finden diese im Abschnitt „Funktionen“ der Umgebung im Power Platform Admin Center.

Die Einstellung Aktivierungsstatus von Ausführungsaktionsprotokollen legt fest, wann Ausführungsaktionsprotokolle für den Desktop-Flow erfasst werden sollen, und ermöglicht Ihnen sogar, diese vollständig zu deaktivieren.

Anforderungen

• Premium-Lizenz Power Automate und Administratorrechte zum Konfigurieren von Protokolleinstellungen
• Power Automate-URL- und IP-Adresskonfigurationen
  • Public Cloud
  • Government Cloud

Desktop-Flow-Aktionsprotokollversion konfigurieren

Bei der Aktionsprotokollversion können Sie zwischen V1, V2 oder beiden wählen.

Der Wert Lebensdauer der FlowLogs-Entität in Minuten bestimmt, wie lange Aktionsprotokolle in der elastischen Flowprotokolltabelle aufbewahrt werden sollen. Dataverse löscht automatisch Datensätze, die älter als der angegebene Zeitrahmen sind. Hier sind einige Beispielwerte aus Gründen der Benutzerfreundlichkeit.

Wichtige Unterschiede zwischen Desktop-Flowprotokollen V1 und V2

Die folgende Tabelle beschreibt die Unterschiede zwischen den Desktop-Flowprotokollen V1 und V2:

Protokolle V2 bietet wesentliche Verbesserungen gegenüber der vorherigen Version V1. V2 verwendet die Funktion elastische Tabellen, die sich hervorragend für die Verarbeitung großer Datenmengen, etwa in Aktionsprotokollszenarien, eignet und über eine integrierte Datenaufbewahrung (TTL) verfügt. Ideal für Organisationen, die für die Berichterstellung, Governance und Integration mit automatischer Datenaufbewahrungskontrolle auf große Datenmengen zugreifen müssen.

Dataverse-Kapazitätsbedarfsberechnungen für Protokolle V2

Die folgende Tabelle zeigt Schätzungen des Dataverse Protokollspeicherverbrauchs pro Desktop-Flow-Ausführung bei Verwendung von Protokollen V2. Es beschreibt den ungefähren Speicherbedarf für eine unterschiedliche Anzahl von Aktionen, wobei von einem durchschnittlichen Speicherbedarf von 3 KB pro Aktion ausgegangen wird.

Ausführlichkeit von Aktionsprotokollen

Mit Desktop Flow Logs V2 können Sie Ausführlichkeitsstufen festlegen, um ein Gleichgewicht zwischen Sichtbarkeit und Speichereffizienz herzustellen. Jede Ebene steuert, wie viele Details in Protokollen während der Flowausführung angezeigt werden.

Abfragen von Protokolle-V2-Daten

Der Zugriff auf die Daten der Desktop-Flowaktionsprotokolle kann durch einen API-Aufruf an das Dataverse-Backend erfolgen, entweder mit der traditionellen API-Aufrufsyntax oder mit der neuen ExecuteCosmosSqlQuery-Methode. Mit dieser Methode können Sie eine SQL-Abfrage gegen Dataverse ausführen, wodurch das Abrufen und Filtern von Daten ermöglicht wird.

Das Datenmodell der Protokolle V2 basiert auf einer über- und untergeordneten Beziehung zwischen der Flowsitzungs- und Flowprotokolltabelle. Jeder Datensatz erbt die Berechtigungen von seinem übergeordneten Flow-Sitzungsdatensatz. Um Aktionsprotokolle einer bestimmten Desktop-Flowausführung abzufragen, können Sie die folgende Abfragesyntax verwenden.

Traditionelle Dataverse-API-Aufrufsyntax

Der folgende API-Aufruf ruft eine bestimmte Flowsitzung anhand ihrer ID ab (aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb) und greift dann auf die zugehörigen Aktionsprotokolle mithilfe der flowsession_flowlog_parentobjectid-Beziehung zu.

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

Neue ExecuteCosmosSqlQuery-API-Aufrufsyntax mithilfe der FlowLogs-Tabelle

    [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

Weitere Informationen zum Abfragen von JSON-Spalten in elastischen Tabellen.

Aufteilung des Aufrufs in einzelne Teile

• Die Basis-URL (https://[meine Organisation].api.crm[meine Region].dynamics.com/api/data/v9.2/) ist der Endpunkt für die Dataverse-Web-API.
• ExecuteCosmosSqlQuery ist die aufgerufene Methode. Diese Methode ermöglicht die Ausführung einer SQL-Abfrage gegen Dataverse.
• Die Parameter für die ExecuteCosmosSqlQuery-Methode werden in Klammern nach dem Methodennamen angegeben:
  • QueryText=@p1: Die auszuführende SQL-Abfrage. In diesem Fall wählt die Abfrage verschiedene Eigenschaften aus einer Tabelle aus, wobei der Typ 100000001 (Desktop-Flow-Aktionsprotokolltyp) ist, und sortiert die Ergebnisse nach der startTime-Eigenschaft in absteigender Reihenfolge.
  • EntityLogicalName=@p2: Dieser Abschnitt ist der logische Name der Tabelle (flowlog), in der die Aktionsprotokolle gespeichert werden.
  • QueryParameters=@p3: Dieser Abschnitt ist ein JSON-Objekt, das Parameter für die Abfrage angibt. Im vorherigen Beispiel wird ein Schlüsselwertpaar angegeben, wobei die Schlüssel @referencingParentId und @referencingParentLogicalName mit Werten von flowsessionid (GUID) und dem Typ der Tabelle flowsession sind.
  • PageSize=p4: In diesem Abschnitt wird die Seitengröße der Abfrage angegeben.

Bekannte Einschränkungen

• Protokolle V2 sind nur für Desktop-Flowausführungen verfügbar, die von einem Cloud-Flow über die Desktop-Flow-Connector-Aktion gestartet werden.
• Massenlöschaufträge werden für die Flow-Protokolltabelle derzeit nicht unterstützt.
• Flow-Protokolldatensätze können im Maker Portal (make.powerapps.com) noch nicht im Abschnitt „Tabelle“ angezeigt werden.
• Durch das Ändern der Aktionsprotokollversion werden vorherige Desktop-Flow-Aktionsprotokolle nicht zum neuen Protokollspeichertyp migriert.