Merk
Tilgang til denne siden krever autorisasjon. Du kan prøve å logge på eller endre kataloger.
Tilgang til denne siden krever autorisasjon. Du kan prøve å endre kataloger.
Denne artikkelen gir konfigurasjonsveiledning for skrivebordsflytlogger, som er plassert under miljøets funksjonsinndeling i administrasjonssenteret for Power Platform og i Power Automate for detaljkonfigurasjon av bestemte flyter.
Note
Denne funksjonen gjelder for både skrivebordsflyter som startes fra en skyflyt, og lokale overvåkede kjøringer fra Power Automate for skrivebord.
Aktiveringsstatusen for innstillingen for kjøring av handlingslogger definerer når handlingslogger for skrivebordsflyten skal registreres, og til og med lar deg deaktivere dem fullstendig.
| Aktiveringsstatus | Detaljer |
|---|---|
| Aktivert (standard) | Dette alternativet er standard for både eksisterende og nye miljøer der systemet registrerer logger som vanlig. |
| Ved kjøringsfeil | Dette alternativet registrerer bare logger for skrivebordsflythandlinger når det oppstår en kjøretidsfeil. Denne innstillingen betyr at logger ikke er tilgjengelige for hver enkelt kjøring, men bare når det oppstår en feil. Hvis det oppstår en feil, er imidlertid alle logger for den bestemte kjøringen tilgjengelige, inkludert både vellykkede og mislykkede handlinger. |
| Deaktivert | Dette alternativet deaktiverer handlingslogger for skrivebordsflytkjøring. |
Forsiktig!
Hvis du endrer noen av disse innstillingene, kan det ha betydelig innvirkning på funksjoner som feilsøking av kjørefeil og overvåking. Vurder konsekvensene av å endre disse innstillingene før du fortsetter.
Forutsetninger
- Premium Power Automate lisens og administrative rettigheter for å konfigurere logginnstillinger
- Power Automate url- og IP-adressekonfigurasjoner
Konfigurer versjon av handlingslogg for skrivebordsflyt
Bruk versjonsinnstillingen for handlingslogger til å velge V1, V2 eller begge deler.
| Loggversjon | Forklaring |
|---|---|
| V1 – lagret i AdditionalContext-feltet i FlowSession-enheten | Dette alternativet er standard. Logger lagres i AdditionalContext-feltet i Flow-økttabellen, som er et filattributt som er lagret som en blob i Microsoft Dataverse. Logger V1 bruker datavers filkapasitet. |
| V2 – lagret i FlowLogs-enheten | Med dette alternativet kan du lagre logger i flowloggtabellen, som er lagret i elastiske tabeller. Logger V2 bruker datavers loggkapasitet. |
| Begge | Denne innstillingen gjør at logger kan lagres i både det tradisjonelle AdditionalContext-feltet i Flow Session-tabellen og Flow Logs-tabellen. Denne funksjonen bruker både Dataverse-filen og loggkapasiteten. Denne innstillingen er ment for feilsøking eller testing fordi den bruker både dataverslogg og filkapasitet. |
Varigheten i minutter for hvor lenge FlowLogs-enheten skal leve, bestemmer hvor lenge aktivitetslogger beholdes i den elastiske Flow Logs-tabellen. Datavers sletter automatisk poster som er eldre enn den angitte tidsrammen. Her er noen eksempelverdier for enkelhets skyld.
| Dager | Minutter |
|---|---|
| Én dag | 1440 minutter |
| Tre dager | 4320 minutter |
| Sju dager | 10 080 minutter |
| 14 dager | 20 160 minutter |
| 28 dager | 40 320 minutter |
| 60 dager | 86 400 minutter |
| 90 dager | 129 600 minutter |
| 180 dager | 259 200 minutter |
| 365 dager | 525 600 minutter |
| Alltid | 0 (null) minutter |
Important
Innstillingen time-to-live (TTL) gjelder bare for loggposter som er opprettet etter konfigurasjonsendringen. Eksisterende loggposter beholder den opprinnelige TTL-verdien og påvirkes ikke av etterfølgende endringer i denne innstillingen.
Hvis du for eksempel først angir oppbevaringsperioden til 90 dager og senere reduserer den til sju dager, beholdes logger som er opprettet før endringen, i de opprinnelige 90 dagene. Bare nye logger som er opprettet etter endringen, bruker den sju dager lange oppbevaringsperioden.
Hvis du må fjerne eksisterende logger umiddelbart, må du slette dem manuelt eller vente på at den opprinnelige TTL-en utløper.
Note
Før du aktiverer logger V2, må du kontrollere at du har tilstrekkelig datavers loggkapasitet som støtter innstillingene for dataoppbevaring og justerer med kapasitetsplanlegging og rettighet. Juster etter behov. Se eksempeldataverse kapasitetsbehovsberegninger for logger V2-delen for å få eksempler på størrelse.
Viktige forskjeller mellom skrivebordsflytloggene V1 og V2
Tabellen nedenfor beskriver forskjellene mellom skrivebordsflytloggene V1 og V2:
| Funksjon | Logger V1 | Logger V2 | Detaljer |
|---|---|---|---|
| Automatisk dataoppbevaring | Ikke tilgjengelig | Tilgjengelig | V2 bruker Elastiske tabeller, som Azure Cosmos DB krefter og leveres med en innebygd tid-til-live-funksjon for automatisk dataoppbevaring. |
| Støtte for store loggstørrelser | Omtrent opptil 50 000 til 80 000 handlingslogger (maksimum) | Minimum 100 000 handlinger, kan gå opp til 10 millioner handlinger avhengig av handlingene som genereres og varigheten av kjøringen | V2 kan teoretisk skalere opp til gigabyte verdt handlingslogger per kjøring i fremtiden, mens V1 bare kan skalere til volumet som er angitt i denne tabellen. |
| Støtte for avansert rapportering og styring | Ikke tilgjengelig | Tilgjengelig | I V1 er AdditionalContext-attributtet en filtype, lagret som en blob i Dataverse, noe som gjør det utfordrende å analysere for rapporterings- og styringskontroller. Logger er mye mer tilgjengelige i V2. |
| Støtte for Azure Synapse Link for datavers integrasjon | Ikke tilgjengelig | Tilgjengelig | I V1 er AdditionalContext-attributtet en filtype, lagret som en blob i Dataverse, som ikke støttes for synkronisering til Azure Synapse. |
| Støtte for datavers revisjon | Ikke tilgjengelig | Tilgjengelig | I V1 er AdditionalContext-attributtet en filtype, lagret som en blob i Dataverse, som ikke støttes i datavers overvåking. |
| Støtte for datavers langsiktig oppbevaring | Ikke tilgjengelig | Planlagt | I V1 er AdditionalContext-attributtet en filtype, lagret som en blob i Dataverse, som ikke støttes i datavers langsiktig oppbevaring. |
| Basert på dataverse Role-Based tilgangskontroll (RBAC) | Tilgjengelig | Tilgjengelig | Begge versjonene bruker Dataverse RBAC, som arver handlingsloggtillatelsene fra den overordnede flytøktoppføringen. |
Logger V2 gir betydelige forbedringer i den forrige versjonen, V1. V2 bruker funksjonen for elastiske tabeller , som er flott for håndtering av store datavolumer, for eksempel scenarioer for handlingslogg, og har innebygd dataoppbevaring (TTL). Det er ideelt for organisasjoner som trenger å få tilgang til betydelige mengder data for rapportering, styring og integrering med automatisk dataoppbevaringskontroll.
Dataverse kapasitetsbehovsberegninger for loggfiler V2
Tabellen nedenfor viser anslag på forbruk av Dataverse-logglagring per kjøring av desktopflyt ved bruk av logger V2. Den beskriver omtrentlig lagringsbehov for ulike antall handlinger, forutsatt et gjennomsnitt på 3 KB lagringsplass per handling.
| Antall handlinger | Lagringsbehov per handling (KB) | Totalt lagringsforbruk (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 |
Important
Forbruksfigurene for logglagring i Dataverse er bare anslag. Faktisk lagringsforbruk kan variere betraktelig. Den nøyaktige lagringsetterspørselen avhenger av de spesifikke detaljene og kompleksiteten i hver handlingslogg. Bruk disse tallene som en grov veiledning for å forstå den potensielle lagringsetterspørselen og planlegge lagringskravene dine.
Detaljer for handlingslogger
Med Desktop Flow Logs V2 kan du angi detaljnivåer for å balansere observerbarhet og lagringseffektivitet. Hvert nivå styrer hvor mange detaljer som vises i logger under flytkjøring. Denne delen beskriver de tilgjengelige detaljnivåene for handlingslogger for skrivebordsflyt, hvordan du konfigurerer dem på miljønivå i administrasjonssenteret for Power Platform (bare administratorer), og hvordan du konfigurerer dem for individuelle skrivebordsflyter.
Detaljnivåer i handlingslogger for skrivebordsflyt
| Detaljnivå | Beskrivelse | Inkluderer | Merknader |
|---|---|---|---|
| Komplett | Registrerer alle logger, inkludert innebygde systemhandlinger. | Betingelse, løkke og alle andre systemgenererte logger. | Standardinnstilling. Det er den mest omfattende, men kan bruke mer lagringsplass. |
| Feilsøke | Fokuserer på handlingsresultater. | Utdata og resultater fra hver handling som utføres i flyten. | Nyttig for detaljert feilsøking uten fullstendig systemstøy. |
| Egendefinert | Logger brukerdefinerte meldinger og alle advarsler og feil. | Eksplisitte Log Message handlinger av brukeren, pluss alle advarsler og feil. |
Gjør det mulig for brukere å kontrollere hva som blir logget. Kan brukes til å finjustere detaljnivået. |
| Advarsel! | Registrerer bare advarsel og feilmeldinger. | Eventuelle kjøretidsadvarsler eller -feil under flytkjøring. | Bidrar til å redusere støy samtidig som potensielle problemer synliggjøres. |
| Feil | Logger bare feilmeldinger. | Kritiske feil som stopper flytutførelse eller forårsaker feil atferd. | Minimal registrering for ytelseskritiske miljø. |
Konfigurer detaljnivået for handlingslogg i administrasjonssenteret for Power Platform (bare administrator)
Administratorer kan angi standard detaljnivå for et helt miljø. Denne innstillingen gjelder for alle skrivebordsflyter med mindre den overstyres på flytnivå.
Velg Administrer i navigasjonsruten.
Velg Miljøer i Administrer-delen, og velg deretter miljøet der skrivebordsflytene kjører.
Velg Innstillinger.
Utvid produkt og velg Funksjoner.
Finn innstillingen for detaljeringsgrad av handlingslogger i konfigurasjonsdelen for kjøring av skrivebordsflyt.
Velg standardnivå: Feil, Advarsel, Egendefinert, Feilsøking eller Fullstendig.
Velg Save for å bruke konfigurasjonen.
Note
Denne innstillingen fungerer som standard for hele miljøet.
Skapere kan overstyre innstillingen for bestemte prosesser (se neste del).
Tillat at noen minutter for å angi endringer trer i kraft.
Konfigurer detaljnivået for handlingslogg for en bestemt skrivebordsflyt
Utviklere kan konfigurere detaljnivået for hver skrivebordsflyt fra Power Automate-portalen. Denne lokale innstillingen overstyrer administratorstandarden.
Overstyr miljøinnstillingen når du må:
- Feilsøke en bestemt skrivebordsflyt uten å øke loggene for hele miljøet.
- Øk detaljnivået midlertidig under testing eller feilsøking.
Følg disse trinnene for å konfigurere detaljnivået for handlingsloggen for en bestemt skrivebordsflyt:
- Logg på Power Automate.
- Åpne flytinformasjonssiden for skrivebordsflyten du vil konfigurere.
- Velg Rediger , og finn detaljnivået for handlingsloggene.
- Velg ønsket detaljnivå for denne spesifikke flyten.
Important
Når en oppretter endrer detaljnivået for en individuell skrivebordsflyt, kan de bare velge et detaljnivå som er lik eller høyere enn miljøets standardverdi. Hvis miljøet for eksempel er konfigurert på Feilsøking, kan ikke oppretteren velge egendefinerte nivåer, advarsel eller feilnivåer.
Hvis administratorer senere endrer miljøets detaljnivå etter at en flyt er konfigurert individuelt, følger loggene som genereres alltid den høyeste verdien mellom miljøinnstillingen og skrivebordsflytens egen konfigurasjon.
- Lagre endringene.
Note
Du kan også konfigurere detaljnivå fra Power Automate skrivebordsapp (PAD).
Versjon 2 av spørringsdatalogger
Du kan få tilgang til skrivebordsflytens handlingslogger ved å foreta et API-kall til den dataverse serverdel. Du kan bruke den tradisjonelle API-kallsyntaksen eller den nye ExecuteCosmosSqlQuery-metoden . Ved hjelp av denne metoden kan du kjøre en SQL-spørring mot Dataverse, som gjør det mulig å hente og filtrere data.
V2-modellen for dataloggene er basert på en overordnet-underordnet-relasjon mellom flytøkten og flytloggtabellene. Hver oppføring arver tillatelser fra tilhørende oppføring for overordnet flytøkt. Bruk følgende spørringssyntaks for å spørre handlingslogger for en bestemt skrivebordsflytkjøring.
Syntaks for tradisjonelle Dataverse API-anrop
Følgende API-kall henter en bestemt flytøkt av ID-en (aaaaaaaa-0000-1111-2222-bbbbbbbbbb) og får deretter tilgang til de tilknyttede handlingsloggene gjennom flowsession_flowlog_parentobjectid relasjonen.
[Organization URI]/api/data/v9.0/flowsessions(aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb)/flowsession_flowlog_parentobjectid
Ny ExecuteCosmosSqlQuery API-kallsyntaks ved hjelp av FlowLogs-tabell
[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
Lær mer om spørring av JSON-kolonner i elastiske tabeller.
Bryte ned samtalen i individuelle deler
- Den grunnleggende URL-adressen (https://[min organisasjon].api.crm[mitt område].dynamics.com/api/data/v9.2/) er endepunktet for datavers web-API-en.
-
ExecuteCosmosSqlQueryer metoden du kaller opp. Denne metoden kjører en SQL-spørring mot Dataverse. - Parameterne for
ExecuteCosmosSqlQuerymetoden er angitt i parenteser etter metodenavnet:-
QueryText=@p1: SQL-spørringen som skal kjøres. Denne spørringen velger ulike egenskaper fra en tabell der typen er 100000001 (handlingstype for skrivebordsflyt) og bestiller resultatene etterstartTimeegenskapen i synkende rekkefølge. -
EntityLogicalName=@p2: Det logiske navnet på tabellen (flowlog) som lagrer handlingsloggene. -
QueryParameters=@p3: Et JSON-objekt som angir parametere for spørringen. I det forrige eksemplet angir den et nøkkelverdipar der nøklene er@referencingParentIdog@referencingParentLogicalNamemed verdieneflowsessionidfor (GUID) og tabelltypenflowsession. -
PageSize=p4: Størrelsen på spørringssiden.
-
Kjente begrensninger
- Logger V2 er bare tilgjengelige for skrivebordsflytkjøringer som brukeren starter fra en skyflyt gjennom koblingshandlingen for skrivebordsflyt.
- For øyeblikket støttes ikke massefjerningsjobber for Flow Log-tabellen.
- Du kan ikke vise flytloggposter ennå i Table-delen av Power Apps maker-portalen.
- Endring av handlingsloggversjon overfører ikke tidligere handlingslogger for skrivebordsflyt til den nye logglagringstypen.
- Ikke bruk FlowRun - og FlowLog-enhetene som mål for når en rad legges til, endres eller slettes flytutløseren . Bruk av disse enhetene som mål kan føre til en uendelig løkke fordi systemet oppretter poster i disse tabellene hver gang en flyt kjøres.