Konfiguration der Desktop-Flow-Aktionsprotokolle

Artikel
01/03/2025

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

Wichtig

Diese Funktion gilt nur für Desktop-Flows, die aus einem Cloud-Flow gestartet werden, und ist noch nicht für lokal beaufsichtigte Ausführungen über Power Automate verfügbar.

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.

Aktivierungsstatus	Informationen
Aktiviert (Standard)	Diese Option ist die Standardeinstellung sowohl für bestehende als auch für neue Umgebungen, in denen Protokolle wie üblich erfasst werden.
Bei Ausführungsfehler	Diese Option erfasst nur dann Desktop-Flow-Aktionsprotokolle, wenn ein Laufzeitfehler vorliegt. Dies bedeutet, dass nicht für jeden einzelnen Durchlauf Protokolle verfügbar sind, sondern nur, wenn ein Fehler auftritt. Sollte dennoch ein Fehler auftreten, stehen alle Protokolle für die jeweilige Ausführung zur Verfügung, einschließlich der erfolgreichen und fehlgeschlagenen Aktionen.
Deaktiviert	Diese Option deaktiviert effektiv Desktop-Flowausführungs-Aktionsprotokolle komplett.

Vorsicht

Das Ändern dieser Einstellungen kann erhebliche Auswirkungen auf Funktionen wie die Problembehandlung bei Ausführungsfehlern und die Überwachung haben. Berücksichtigen Sie die Auswirkungen einer Änderung dieser Einstellungen, bevor Sie fortfahren.

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.

Protokollversion	Erläuterung
V1 - Im Feld AdditionalContext der FlowSession-Entität gespeichert	Dies ist die Standardoption. Protokolle werden im Feld „AdditionalContext“ der Flowsitzungstabelle gespeichert, einem Dateiattribut, das als Blob in Microsoft Dataverse gespeichert wird. Protokolle V1 verbrauchen Dataverse-Dateikapazität.
V2 – In der FlowLogs-Entität gespeichert	Mit dieser Option können Sie Protokolle in der Flowprotokolltabelle speichern, die in Elastischen Tabellen gespeichert ist. Protokolle V2 verbrauchen Dataverse-Datenbankkapazität.
Beides	Mit dieser Einstellung können Protokolle sowohl im herkömmlichen AdditionalContext-Feld der Flowsitzungstabelle als auch in der Flowprotokolltabelle gespeichert werden. Diese Funktion verbraucht sowohl Datei- als auch Dataverse Datenbankkapazität. Diese Einstellung ist für Debugging- oder Testzwecke vorgesehen, da sie sowohl Dataverse-Datenbank- als auch -Dateikapazität verbraucht.

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.

Tage	Minuten
Ein Tag	1,440 Minuten
Drei Tage	4,320 Minuten
Sieben Tage	10,080 Minuten
14 Tage	20,160 Minuten
28 Tage	40,320 Minuten
60 Tage	86,400 Minuten
90 Tage	129,600 Minuten
180 Tage	259,200 Minuten
365 Tage	525,600 Minuten
Ewig	0 (null) Minuten

Anmerkung

Stellen Sie vor dem Aktivieren von Protokollen V2 sicher, dass Sie über ausreichend Dataverse-Datenbankkapazität verfügen, die die Datenaufbewahrungseinstellungen unterstützt und mit Ihrer Kapazitätsplanung und Berechtigung übereinstimmt, und nehmen Sie bei Bedarf Anpassungen vor. Einige Größenbeispiele finden Sie im folgenden Abschnitt Beispielberechnung des Dataverse-Kapazitätsbedarfs für Protokolle V2.

Wichtige Unterschiede zwischen Desktop-Flowprotokollen V1 und V2

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

Feature	Protokolle V1	Protokolle V2	Informationen
Automatische Datenaufbewahrung	Nicht verfügbar	Verfügbar	V2 verwendet Elastische Tabellen powered by Azure Cosmos DB, und sie verfügen über eine integrierte Time-to-Live-Funktion zur automatischen Datenaufbewahrung.
Unterstützung für große Protokollgrößen	Etwa 50.000 bis 80.000 Aktionsprotokolle (maximal)	Ungefähr die doppelte Anzahl der V1-Aktionsprotokolle (zunächst)	V2 könnte in Zukunft theoretisch auf einen Umfang von mehreren Gigabyte an Aktionsprotokollen pro Ausführung skaliert werden, während V1 nur auf das in dieser Tabelle angegebene Volumen skaliert werden kann.
Unterstützung für erweiterte Berichterstellung und Governance	Nicht verfügbar	Verfügbar	In V1 ist das AdditionalContext-Attribut ein Dateityp, der als Blob in Dataverse gespeichert wird, was die Analyse für Berichts- und Governance-Kontrollen erschwert. Protokolle sind in V2 viel besser zugänglich.
Unterstützung für Azure Synapse Link for Dataverse-Integration	Nicht verfügbar	Verfügbar	In V1 ist das AdditionalContext-Attribut ein Dateityp, der als Blob in Dataverse gespeichert wird, dessen Synchronisierung mit Azure Synapse nicht unterstützt wird.
Unterstützung für Dataverse-Überwachung	Nicht verfügbar	Verfügbar	In V1 ist das AdditionalContext-Attribut ein Dateityp, der als Blob in Dataverse gespeichert wird, der in Dataverse-Überwachung nicht unterstützt wird.
Unterstützung für Dataverse-Langzeitaufbewahrung	Nicht verfügbar	Geplant	In V1 ist das AdditionalContext-Attribut ein Dateityp, der als Blob in Dataverse gespeichert wird, der in Dataverse-Langzeitaufbewahrung nicht unterstützt wird.
Basiert auf rollenbasierte Zugriffssteuerung (RBAC) in Dataverse	Verfügbar	Verfügbar	Beide Versionen verwenden Dataverse-RBAC und erben die Aktionsprotokollberechtigungen von ihrem übergeordneten Flow-Sitzungsdatensatz.

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

In der folgenden Tabelle sind Beispielschätzungen des Dataverse-Datenbankspeicherverbrauchs pro Desktop-Flowausführung bei Verwendung von Protokollen V2 aufgeführt. 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.

Anzahl an Aktionen	Speicherbedarf pro Aktion (KB)	Gesamtspeicherverbrauch (MB)
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

Wichtig

Bei den in der obigen Tabelle angegebenen Zahlen handelt es sich lediglich um Schätzungen und der tatsächliche Speicherverbrauch kann erheblich abweichen. Der genaue Speicherbedarf hängt von den spezifischen Details und der Komplexität jedes Aktionsprotokolls ab. Daher sollten Sie diese Zahlen als grobe Richtlinie verwenden, um den potenziellen Speicherbedarf zu verstehen und Ihren Speicherbedarf entsprechend zu planen.

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 (9d51aa1f-315e-43ab-894f-bc445dfb049b) und greift dann auf die zugehörigen Aktionsprotokolle mithilfe der flowsession_flowlog_parentobjectid-Beziehung zu.

[Organization URI]/api/data/v9.0/flowsessions(9d51aa1f-315e-43ab-894f-bc445dfb049b)/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.

Freigeben über