Konfiguration af logfiler til skrivebordsflowhandlinger
Denne side indeholder en konfigurationsvejledning til skrivebordsflowlogge, der findes under afsnittet med miljøets funktion i Power Platform Administration.
Vigtigt!
- Denne funktion gælder kun for skrivebordsflow, der startes fra et cloudflow, og den er endnu ikke tilgængelig for lokalt overvågede kørsler fra Power Automate skrivebordsflow.
Indstillingen Aktiveringsstatus for kørselshandlingslogge definerer, hvornår handlingslogfiler til skrivebordsflow skal registreres, og giver dig mulighed for at slå dem helt fra.
| Aktiveringsstatus | Oplysninger |
|---|---|
| Aktiveret (standard) | Denne indstilling er standard for både eksisterende og nye miljøer, hvor der registreres logge som normalt. |
| Fejl under kørsel | Denne indstilling registrerer kun logfiler for skrivebordsflowhandlinger, når der opstår en kørselsfejl. Det betyder, at logge ikke er tilgængelige for hver enkelt kørsel, men kun når der opstår en fejl. Men hvis der opstår en fejl, er alle logge for den pågældende kørsel tilgængelige, herunder både vellykkede og mislykkede handlinger. |
| Disabled | Med denne indstilling deaktiveres handlingslogfiler for kørslen af skrivebordsflow helt. |
Advarsel
Hvis du ændrer en af disse indstillinger, kan det have en betydelig indvirkning på funktioner som fejlfinding og overvågning af kørselsfejl. Overvej konsekvenserne af at ændre disse indstillinger, inden du fortsætter.
Forudsætninger
- Premium Power Automate-licens og administrative rettigheder til konfiguration af logindstillinger
- Power Automate URL- og IP-adressekonfigurationer
Konfigurere logversion til skrivebordsflowhandling
Du kan bruge Version af handlingslogge til at vælge V1, V2 eller begge dele.
| Logversion | Forklaring |
|---|---|
| V1 – Gemt i feltet AdditionalContext for objektet FlowSession | Denne indstilling er standarden. Logfiler gemmes i feltet AdditionalContext i tabellen over flowsessioner, som er en filattribut, der gemmes som blob i Microsoft Dataverse. Logge V1 forbruger Dataverse-filkapacitet. |
| V2 – Gemt i objektet FlowLogs | Denne nye indstilling giver dig mulighed for at gemme logge i tabellen Flowlogge, som gemmes i elastiske tabeller. Logge V2 forbruger Dataverse-databasekapacitet. |
| Både | Denne indstilling gør det muligt at gemme logge i både traditionelle AdditionalContext-felter i tabellen over flowsessioner og i tabellen over flowlogge. Denne funktion forbruger både Dataverse fil- og databasekapacitet. Denne indstilling er beregnet til fejlfindings- eller testformål, da den bruger både Dataverse database- og filkapacitet. |
Værdien FlowLogs-objektets tid til at leve i minutter bestemmer, hvor længe handlingslogfiler skal bevares i den elastiske tabel med flowlogfiler. Dataverse sletter automatisk poster, der er ældre end den angivne tidsramme. Her er et par eksempler på disse værdier.
| Dage | Minutter |
|---|---|
| Én dag | 1.440 minutter |
| Tre dage | 4.320 minutter |
| Seneste dage | 10.080 minutter |
| 14 dage | 20.160 minutter |
| 28 dage | 40.320 minutter |
| 60 dage | 86.400 minutter |
| 90 dage | 129.600 minutter |
| 180 dage | 259.200 minutter |
| 365 dage | 525.600 minutter |
| For evigt | 0 (nul) minutter |
Bemærk
Før du aktiverer logfiler V2, skal du sikre dig, at du har tilstrækkelig Dataverse-databasekapacitet, som understøtter indstillingerne for opbevaring af data, og som er i overensstemmelse med kapacitetsplanlægningen, berettigelsen og tilpasningen efter behov. Se afsnittet Eksempel på beregninger af Dataverse-kapacitetsbehov for logfiler V2 for at få eksempler på størrelsen.
De vigtigste forskelle i skrivebordsflowlogge V1 og V2
I følgende tabel beskrives forskellene mellem skrivebordsflowlogfilerne V1 og V2:
| Funktion | Logge V1 | Logge V2 | Oplysninger |
|---|---|---|---|
| Automatisk dataopbevaring | Ikke tilgængelig | Tilgængelig | V2 bruger Elastiske tabeller, som drives af Azure Cosmos DB og leveres med en indbygget time-to-live-funktion til automatisk dataopbevaring. |
| Understøttelse af store logfilstørrelser | Omtrent op til 50.000 til 80.000 handlingslogge (maksimum) | Omtrent det dobbelte af antallet af V1-handlingslogge (oprindeligt) | V2 kan potentielt skalere op til gigabytes værdi af handlingslogfiler pr. kørsel i fremtiden, mens V1 kun kan skaleres til den mængde, der er angivet i denne tabel. |
| Understøttelse af avanceret rapportering og styring | Ikke tilgængelig | Tilgængelig | I V1 er AdditionalContext-attributten en filtype, der er gemt som blob i Dataverse, hvilket gør det udfordrende at fortolke for rapporterings- og styringskontrolelementer. Der er meget lettere adgang til logge i V2. |
| Understøttelse af Azure Synapse Link for Dataverse-integration | Ikke tilgængelig | Tilgængelig | I V1 er attributten AdditionalContext en filtype, der er gemt som en blob i Dataverse, og som ikke understøttes for synkronisering til Azure Synapse. |
| Understøttelse af Dataverse-overvågning | Ikke tilgængelig | Tilgængelig | I V1 er attributten AdditionalContext en filtype, der er gemt som en blob i Dataverse, og som ikke understøttes i Dataverse-overvågning. |
| Understøttelse af Dataverse-opbevaring i lang tid | Ikke tilgængelig | Planlagt | I V1 er attributten AdditionalContext en filtype, der er gemt som en blob i Dataverse, og som ikke understøttes i Dataverse-langsigtet opbevaring. |
| Basere på Dataverse-rollebaseret adgangskontrol (RBAC) | Tilgængelig | Tilgængelig | I begge versioner bruges Dataverse RBAC, og de arver tilladelser til handlingslogfiler fra deres overordnede flowsessionspost. |
Logfiler V2 tilbyder en betydelig forbedring i forhold til den tidligere version, V1. V2 bruger funktionen elastiske tabeller, som er fremragende til håndtering af store datamængder, f.eks. scenarier med logfiler, og som har indbygget dataopbevaring (TTL). Er velegnede til organisationer, der har brug for at få adgang til en stor mængde data til rapportering, styring og integration med automatisk kontrol af dataopbevaring.
Dataverse-kapacitetsefterspørgselsberegninger for logge V2
I følgende tabel vises overslag over forbruget af Dataverse-databaselagerplads pr. kørsel af skrivebordsflow ved brug af logge V2. Den viser det anslåede lagerbehov for forskellige antal handlinger, hvis der antages et gennemsnit på 3 KB lagerplads pr. handling.
| Antal handlinger | Lagerkrav pr. handling (KB) | Samlet lagerforbrug (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 |
Vigtigt!
De tal, der vises i ovenstående tabel, er blot overslag, og det faktiske lagerforbrug kan variere betydeligt. Det nøjagtige lagerbehov afhænger af de specifikke detaljer og kompleksiteten af de enkelte handlingslogge. Disse tal skal derfor bruges som en rå vejledning til at forstå det potentielle lagerbehov og planlægge lagerkravene tilsvarende.
Forespørge på log V2-data
Adgang til data om skrivebordsflows handlingslogfiler kan opnås ved at foretage et API-kald til Dataverse-backend'en, enten ved hjælp af den traditionelle API-kaldesyntaks eller ved hjælp af den nye ExecuteCosmosSqlQuery-metode. Denne metode giver dig mulighed for at udføre en SQL-forespørgsel på Dataverse og dermed aktivere hentning og filtrering af data.
Datamodellen for logfiler V2 er baseret på en overordnet-underordnet relation mellem flowsessionens og flowloggens tabeller. Alle poster arver tilladelser fra dens overordnede flowsessionspost. Hvis du vil forespørge på handlingslogfiler for et bestemt skrivebordsflow, kan du bruge følgende forespørgselssyntaksen.
Syntaks for traditionelle Dataverse API-kald
Følgende API-kald henter en bestemt flowsession efter id (9d51aa1f-315e-43ab-894f-bc445dfb049b) og får derefter adgang til de tilknyttede handlingslogfiler ved hjælp af flowsession_flowlog_parentobjectid-relationen.
[Organization URI]/api/data/v9.0/flowsessions(9d51aa1f-315e-43ab-894f-bc445dfb049b)/flowsession_flowlog_parentobjectid
Syntaks for det nye API-kald ExecuteCosmosSqlQuery ved hjælp af 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
Få mere at vide om forespørgsel på JSON-kolonner i elastiske tabeller.
Inddele kaldet i enkelte stykker
- URL-adressens basis (https://[min org].api.crm[mit område].dynamics.com/api/data/v9.2/) er slutpunkttet for web-API'en i Dataverse.
- ExecuteCosmosSqlQuery er den metode, der kaldes. Denne metode gør det muligt at køre en SQL-forespørgsel i Dataverse.
- Parametrene for metoden ExecuteCosmosSqlQuery findes i parentes efter metodenavnet:
QueryText=@p1: Den SQL-forespørgsel, der skal udføres. I dette tilfælde vælger forespørgslen forskellige egenskaber fra en tabel, hvor typen er 100000001 (logtype for skrivebordsflowhandling), og resultaterne sorteres efter egenskaben startTime i faldende rækkefølge.EntityLogicalName=@p2: Dette er det logiske navn på den tabel (flowlog), hvor handlingsloggene gemmes.QueryParameters=@p3: Denne sektion er et JSON-objekt, der angiver parametre for forespørgslen. I det forrige eksempel angives et nøgleværdipar, hvor nøglerne er@referencingParentIdog@referencingParentLogicalNamemed værdierneflowsessionid(GUID) og tabeltypenflowsession.PageSize=p4: Dette afsnit er størrelsen på forespørgselssiden.
Kendte begrænsninger
- Logge V2 er kun tilgængelige for kørsler af skrivebordsflow, der startes fra et cloudflow via handlingen for skrivebordsflow-connectoren.
- Massesletningsjob understøttes i øjeblikket ikke for tabellen Flow Log.
- Flowlog-poster kan endnu ikke ses i sektionen Tabel på Maker Portal (make.powerapps.com).
- Hvis du ændrer en handlingslogversion, overføres tidligere skrivebordsflowhandlingslogge ikke til den nye loglagertype.