Delen via

Configuratie van logboeken voor bureaubladstroomacties

  • Artikel

Deze pagina biedt configuratierichtlijnen voor logboeken van bureaubladstromen, te vinden onder de functiesectie van de omgeving in het Power Platform-beheercentrum.

Belangrijk

  • Deze functie is alleen van toepassing op bureaubladstromen die worden gestart vanuit een cloudstroom en is nog niet beschikbaar voor uitvoeringen met lokaal toezicht vanuit Power Automate bureaublad.

Met de instelling Activeringsstatus van uitvoeringsactielogboeken wordt gedefinieerd wanneer uitvoeringsactielogboeken van bureaubladstromen moeten worden vastgelegd en hebt u zelfs de mogelijkheid deze volledig uit te schakelen.

Schermopname en instelling op omgevingsniveau waarmee u kunt configureren wanneer logboeken van bureaubladstromen moeten worden vastgelegd.

Activeringsstatus DETAILS
Ingeschakeld (standaard) Deze optie is de standaard voor zowel bestaande als nieuwe omgevingen waarin logboeken zoals gebruikelijk worden vastgelegd.
Fout bij uitvoeren Met deze optie worden alleen actielogboeken voor bureaubladstromen vastgelegd als er een runtimefout optreedt. Dit betekent dat logboeken niet voor elke afzonderlijke uitvoering beschikbaar zijn, maar alleen als er een fout optreedt. Als er echter een fout optreedt, zijn alle logboeken voor die specifieke uitvoering beschikbaar, inclusief zowel succesvolle als mislukte acties.
Disabled Deze optie zorgt praktisch voor volledige uitschakeling van actielogboeken van de bureaubladstroom.

Let op

Het wijzigen van een van deze instellingen kan een aanzienlijke impact hebben op functies zoals het oplossen van uitvoeringsfouten en het uitvoeren van audits. Denk na over de gevolgen van het wijzigen van deze instellingen voordat u verdergaat.

Voorwaarden

  • Premium Power Automate-licentie en beheerdersrechten om logboekinstellingen te configureren
  • Power Automate URL- en IP-adresconfiguraties

Versie voor actielogboek van bureaubladstromen configureren

Met de Versie voor actielogboeken kunt u V1, V2 of beide kiezen.

Schermopname en instelling op omgevingsniveau waarmee u logboeken van bureaubladstromen V2 kunt configureren.

Versie voor logboeken Uitleg
V1 - Opgeslagen in het veld AdditionalContext van de FlowSession-entiteit Deze optie is de standaardinstelling. Logboeken worden opgeslagen in het veld AdditionalContext van de tabel Stroomsessie, een bestandskenmerk dat is opgeslagen als een blob in Microsoft Dataverse. Logboeken V1 verbruikt Dataverse-bestandscapaciteit.
V2 - Opgeslagen in de FlowLogs-entiteit Met deze optie kunt u logboeken opslaan in de tabel Stroomlogboeken, die is opgeslagen in Elastische tabellen. Logboeken V2 verbruikt Dataverse-databasecapaciteit.
Beide Met deze instelling kunnen logboeken worden opgeslagen in zowel het traditionele veld AdditionalContext van de tabel Stroomsessie als de tabel Stroomlogboeken. Deze functie verbruikt zowel Dataverse-bestands- als databasecapaciteit. Deze instelling is bedoeld voor foutopsporings- of testdoeleinden, aangezien zowel Dataverse-database- als bestandscapaciteit wordt verbruikt.

De waarde van de Time to live van de FlowLogs-entiteit in minuten bepaalt hoe lang actielogboeken bewaard moeten blijven in de elastische tabel Flow Logs. Dataverse verwijdert automatisch records die ouder zijn dan het opgegeven tijdsbestek. Voor uw gemak zijn hier enkele voorbeeldwaarden.

dagen Minuten
Eén dag 1,440 minuten
Drie dagen 4,320 minuten
Zeven dagen 10,080 minuten
14 dagen 20,160 minuten
28 dagen 40,320 minuten
60 dagen 86,400 minuten
90 dagen 129,600 minuten
180 dagen 259,200 minuten
365 dagen 525,600 minuten
Permanent Minder dan of gelijk aan 0 (nul) minuten

Opmerking

Voordat u logboeken V2 inschakelt, moet u ervoor zorgen dat u voldoende Dataverse-databasecapaciteit hebt waarmee de instellingen voor het bewaren van gegevens worden ondersteund en die is afgestemd op uw capaciteitsplanning, rechten en aanpassing indien nodig. Zie de volgende sectie Voorbeeldberekeningen van Dataverse-capaciteitsvraag voor logboeken V2 voor enkele voorbeelden van het bepalen van de grootte van de vraag.

Belangrijke verschillen tussen logboeken V1 en V2 van bureaubladstromen

De volgende tabel beschrijft de verschillen tussen logboeken V1 en V2 van bureaubladstromen:

Functie Logboeken V1 Logboeken V2 DETAILS
Automatische gegevensretentie Niet beschikbaar Beschikbaar V2 maakt gebruik van elastische tabellen die worden mogelijk gemaakt door Azure Cosmos DB en worden geleverd met een ingebouwde TTL-functie (Time-to-Live) voor automatische gegevensretentie.
Ondersteuning voor grote logboekformaten Ongeveer 50.000 tot 80.000 actielogboeken (maximaal) Ongeveer tweemaal het aantal V1-actielogboeken (aanvankelijk) V2 zou in de toekomst theoretisch kunnen worden opgeschaald naar gigabytes aan actielogboeken per uitvoering, terwijl V1 slechts kan worden geschaald naar het volume dat in deze tabel is opgegeven.
Ondersteuning voor geavanceerde rapportage en governance Niet beschikbaar Beschikbaar In V1 is het kenmerk AdditionalContext een bestandstype dat is opgeslagen als een blob in Dataverse. Hierdoor is het lastig te parseren voor rapportage- en beheercontroles. Logboeken zijn veel beter toegankelijk in V2.
Ondersteuning voor Azure Synapse Link for Dataverse-integratie Niet beschikbaar Beschikbaar In V1 is het kenmerk AdditionalContext een bestandstype dat is opgeslagen als een blob in Dataverse en dat niet wordt ondersteund voor synchronisatie met Azure Synapse.
Ondersteuning voor Dataverse-controle Niet beschikbaar Beschikbaar In V1 is het kenmerk AdditionalContext een bestandstype dat is opgeslagen als een blob in Dataverse en dat niet wordt ondersteund in Dataverse-controle.
Ondersteuning voor Dataverse-langetermijnretentie Niet beschikbaar Gepland In V1 is het kenmerk AdditionalContext een bestandstype dat is opgeslagen als een blob in Dataverse en dat niet wordt ondersteund in Dataverse-langetermijnretentie.
Op basis van op rollen gebaseerd toegangsbeheer (RBAC) van Dataverse Beschikbaar Beschikbaar Beide versies maken gebruik van Dataverse-RBAC, waarbij de machtigingen voor actielogboeken worden overgenomen van de bijbehorende bovenliggende stroomsessierecord.

Logboeken V2 biedt aanzienlijke verbeteringen ten opzichte van de vorige versie, V1. V2 maakt gebruik van de functie voor elastische tabellen die perfect is voor het verwerken van grote gegevensvolumes, zoals actielogboekscenario's, en die ingebouwde gegevensretentie (TTL) heeft. Dit is ideaal voor organisaties die toegang moeten hebben tot een aanzienlijke hoeveelheid gegevens voor rapportage, governance en integratie met automatisch beheer van gegevensretentie.

Berekeningen van Dataverse-capaciteitsvraag voor logboeken V2

De volgende tabel toont voorbeelden van Dataverse-schattingen van het gebruik van databaseopslag per bureaubladstroomuitvoering bij gebruik van logboeken V2. In de tabel wordt de geschatte opslagvraag voor verschillende aantallen acties beschreven, waarbij wordt uitgegaan van een gemiddelde van 3 KB opslag per actie.

Aantal acties Opslagvraag per actie (KB) Totaal opslagverbruik (MB)
1,000 5 2.93
10,000 5 29.3
30,000 5 87.9
60,000 5 175.8
100.000 5 293
160,000 5 480

Belangrijk

De cijfers in de bovenstaande tabel zijn slechts schattingen en het daadwerkelijke opslagverbruik kan aanzienlijk variëren. De exacte opslagvraag zal afhangen van de specifieke details en complexiteit van elk actielogboek. Daarom moeten deze cijfers worden gebruikt als ruwe leidraad om de potentiële vraag naar opslag te begrijpen en om uw opslagbehoeften dienovereenkomstig te plannen.

Query's uitvoeren op gegevens van logboeken V2

Toegang tot de gegevens van actielogboeken van bureaubladstromen kan worden bereikt door een API-aanroep te doen naar de back-end van Dataverse, hetzij met behulp van de traditionele API-aanroepsyntaxis, hetzij met behulp van de nieuwe methode ExecuteCosmosSqlQuery. Met deze methode kunt u een SQL-query uitvoeren op Dataverse, waardoor het ophalen en filteren van gegevens mogelijk wordt.

Het gegevensmodel van logboeken V2 is gebaseerd op een relatie met bovenliggende en onderliggende elementen tussen de tabellen Stroomsessie en Stroomlogboek. Elke record neemt de machtigingen over van de bovenliggende stroomsessierecord. Om actielogboeken van een specifieke bureaubladstroomuitvoering op te vragen, kunt u de volgende querysyntaxis gebruiken.

Traditionele syntaxis van API-aanroep van Dataverse

Met de volgende API-aanroep wordt een specifieke stroomsessie opgehaald op basis van de id (9d51aa1f-315e-43ab-894f-bc445dfb049b) en worden vervolgens de bijbehorende actielogboeken met behulp van de relatie flowsession_flowlog_parentobjectid geopend.

[Organization URI]/api/data/v9.0/flowsessions(9d51aa1f-315e-43ab-894f-bc445dfb049b)/flowsession_flowlog_parentobjectid

Nieuwe syntaxis van API-aanroep ExecuteCosmosSqlQuery met behulp van de FlowLogs-tabel

    [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

Leer meer over het opvragen van JSON-kolommen in elastische tabellen.

De aanroep in afzonderlijke stukken opsplitsen

  • De basis-URL (https://[my org].api.crm[my region].dynamics.com/api/data/v9.2/) is het eindpunt voor de Dataverse-web-API.
  • ExecuteCosmosSqlQuery is de methode die wordt aangeroepen. Met deze methode kan een SQL-query worden uitgevoerd op Dataverse.
  • De parameters voor de ExecuteCosmosSqlQuery-methode staan tussen haakjes na de naam van de methode:
    • QueryText=@p1: de uit te voeren SQL-query. In dit geval worden met de query verschillende eigenschappen uit een tabel geselecteerd waarin het type 100000001 is (actielogboektype voor bureaubladstroom) en worden de resultaten op basis van de eigenschap startTime in aflopende volgorde gerangschikt.
    • EntityLogicalName=@p2: Deze sectie is de logische naam van de tabel (flowlog) waarin de actielogboeken worden opgeslagen.
    • QueryParameters=@p3: Deze sectie is een JSON-object dat parameters voor de query specificeert. In het vorige voorbeeld wordt een sleutelwaardepaar opgegeven waarbij de sleutels @referencingParentId en @referencingParentLogicalName zijn met waarden voor flowsessionid (GUID) en het type van de tabel flowsession.
    • PageSize=p4: deze sectie is het query-paginaformaat.

Bekende beperkingen

  • Logboeken V2 zijn alleen beschikbaar voor bureaubladstroomuitvoeringen die worden gestart vanuit een cloudstroom via de bureaubladstroomconnectoractie.
  • Bulkverwijderingstaken worden momenteel niet ondersteund voor de tabel Stroomlogboek.
  • Stroomlogboekrecords kunnen nog niet worden bekeken in het tabelgedeelte van de makerportal (make.powerapps.com).
  • Als u de versie van het actielogboek wijzigt, worden eerdere actielogboeken van de bureaubladstroom niet gemigreerd naar het nieuwe logboekopslagtype.