Konfiguration av åtgärdsloggar för datorflöden
Den här sidan innehåller konfigurationsvägledning för datorflödeslogg, som finns under miljöns funktionsavsnitt i Power Platform administrationscenter.
Viktigt
- Den här funktionen gäller endast för datorflöden som startas från ett molnflöde och är ännu inte tillgänglig för lokalt bevakade körningar från Power Automate datorn.
Aktiveringsstatusen för körningsåtgärdsloggar anger när åtgärdsloggar ska loggas för stationärt flöde och gör det till och med möjligt att stänga av dem helt.
| Aktiveringsstatus | Details |
|---|---|
| Aktiverat (standard) | Det här alternativet är standard för både befintliga och nya miljöer där loggarna fångas in som vanligt. |
| Fel vid körning | Det här alternativet samlar endast in åtgärdsloggar för datorflöde när det uppstår ett körningsfel. Det innebär att loggar inte är tillgängliga för varje enskild körning, men bara när ett fel inträffar. Men om ett fel inträffar är alla loggar för den aktuella körningen tillgängliga, inklusive både lyckade och misslyckade åtgärder. |
| Inaktiverat | Med det här alternativet inaktiveras åtgärdsloggar för datorflödeskörning helt och hållet. |
Varning
Om du ändrar någon av dessa inställningar kan det påverka funktioner som felsökning och granskning av körningsfel. Fundera på vad det innebär att ändra inställningarna innan du går vidare.
Förutsättningar
- Premium Power Automate-licens och administratörsbehörighet för att konfigurera logginställningar
- Konfigurationer för Power Automate-URL och IP-adresser
Konfiguration av version för datorflödesåtgärdsloggar
Med Åtgärdsloggversionen kan du välja V1, V2 eller både och.
| Loggversion | Förklaring |
|---|---|
| V1 – Lagras i fältet AdditionalContext för entiteten FlowSession | Detta alternativ är standardinställningen. Loggar lagras i fältet AdditionalContext i tabellen Flödessession, vilket är ett filattribut som lagras som en blob i Microsoft Dataverse. Loggar V1 använder Dataverse filkapacitet. |
| V2 – Lagras i entiteten FlowLogs | Med det här alternativet kan du lagra loggar i tabellen Flödesloggar, som lagras i Elastiska tabeller. Loggar V2 använder Dataverse databaskapacitet. |
| Båda | Med den här inställningen kan loggar lagras i både det traditionella fältet AdditionalContext i tabellen Flödessession och tabellen Flödesloggar. Den här funktionen upptar både Dataverse-fil och databaskapacitet. Den här inställningen är avsedd för felsökning eller testning eftersom både Dataverse-databas och filkapacitet används. |
Värdet Livstid i minuter för Flödesloggar avgör hur länge åtgärdsloggar ska bevaras i den elastiska tabellen Flödesloggar. Dataverse tar automatiskt bort poster som är äldre än den angivna tidsramen. Här följer några exempel på värden som är praktiska att använda.
| dagar | Minuter |
|---|---|
| En dag | 1,440 minuter |
| Tre dagar | 4,320 minuter |
| Sju dagar | 10,080 minuter |
| 14 dagar | 20,160 minuter |
| 28 dagar | 40,320 minuter |
| 60 dagar | 86,400 minuter |
| 90 dagar | 129,600 minuter |
| 180 dagar | 259,200 minuter |
| 365 dagar | 525,600 minuter |
| Alltid | Mindre än eller eller lika med 0 (noll) minuter |
Kommentar
Innan du aktiverar loggarna V2 Dataverse bör du se till att du har tillräcklig databaskapacitet som stöder inställningarna för datalagring och anpassar inställningarna efter kapacitetsplanering, berättigande och justering efter behov. Se exempel på Dataverse-kapacitetsbehovberäkningar för loggar V2 i nedanstående avsnitt för exempel på storlekar.
Viktiga skillnader i datorflödesloggar V1 och V2
I följande tabell beskrivs skillnaderna mellan datorflödesloggar V1 och V2:
| Egenskap | Loggar V1 | Loggar V2 | Details |
|---|---|---|---|
| Automatisk datavalidering | Ej tillgängligt | Tillgängligt | V2 använder Elastiska tabeller som använder Azure Cosmos DB och har en inbyggd time-to-live-funktion för automatisk datalagring. |
| Stöd för stora loggstorlekar | Ungefärligt upp till 50 000 till 80 000 åtgärdsloggar (maximum) | Ungefär dubbelt så många V1-åtgärdsloggar (till att börja med) | V2 skulle kunna skala upp till åtgärdsloggar värda gigabyte per körning i framtiden, medan V1 endast kan skalas till den volym som anges i den här tabellen. |
| Stöd för avancerad rapportering och rapportering | Ej tillgängligt | Tillgängligt | I V1 är attributet AdditionalContext en filtyp som lagras som en blobb in Dataverse, vilket gör det svårt att parsa för rapporterings- och kontrollåtgärder. Loggar är mycket mer tillgängliga i V2. |
| Stöd för Azure Synapse Link for Dataverse-integration | Ej tillgängligt | Tillgängligt | I V1 är attributet AdditionalContext en filtyp som lagras som en blobb Dataverse i, som inte stöds för synkronisering till Azure Synapse. |
| Stöd för Dataverse-granskning | Ej tillgängligt | Tillgängligt | I V1 är attributet AdditionalContext en filtyp som lagras som en blobb Dataverse i, som inte stöds i Dataverse-granskning. |
| Stöd för Dataverse lagring på lång sikt | Ej tillgängligt | Planerat | I V1 är attributet AdditionalContext en filtyp som lagras som en blobb Dataverse i, som inte stöds i Dataverse långsiktig kvarhållning. |
| Baserad på Dataverse rollbaserad åtkomstkontroll (RBAC) | Tillgängligt | Tillgängligt | Båda versionerna använder Dataverse RBAC och ärver åtgärdsloggbehörigheter från den överordnade flödessessionsposten. |
Loggar V2 erbjuder viktiga förbättringar jämfört med den tidigare versionen, V1. V2 använder funktionen för tabellerna, som är bra för hantering av stora datamängder, som actionloggscenarier, och som har inbyggd datalagring (TTL). Passar bra för organisationer som behöver ha tillgång till stora mängder data för rapportering, rapportering och integrering med automatisk datalagringskontroll.
Dataverse kapacitetsberäkningar för loggar V2
I följande tabell visas exempeldatabaslagringsanvändningen Dataverse per stationärt flöde som körs med loggarna V2. Den ungefärliga lagringsefterfrågan för olika antal åtgärder förutsätter ett genomsnitt på 3 kB lagringsutrymme per åtgärd.
| Antal åtgärder | Lagrings begäran per åtgärd (KB) | Total lagringsanvändning (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 |
Viktigt
Siffrorna i tabellen ovan visar sig bara vara för hög och den faktiska lagringsanvändningen kan variera betydligt. Den exakta lagringsfrågan beror på den specifika informationen och komplexiteten i varje åtgärdslogg. Därför bör siffrorna användas som vägledning för att förstå de potentiella lagringsbehoven och planera lagringsbehoven därefter.
Frågeloggar V2-data
Åtkomst till flödesåtgärdsloggar för stationära datorer kan nås genom att ringa ett API-samtal Dataverse till backend, antingen med hjälp av den traditionella API-anropssyntaxen eller med den nya ExecuteCosquerlQuery-metoden. Med den här metoden kan du köra en SQL-fråga mot Dataverse och aktivera hämtning och filtrering av data.
Datamodellen för loggar V2 bygger på en relation mellan överordnad och underordnad relation mellan tabellerna Flödessession och Flödeslogg. Varje post ärver behörigheter från den överordnade flödessessionsposten. Om du vill fråga efter åtgärdsloggar för ett visst flöde på stationär dator kan du använda följande frågesyntax.
Syntax för Dataverse traditionella API-anrop
Följande API-samtal hämtar en specifik flödessession med dess ID (9d51aa1f-315e-43ab-894f-bc445dfb049b) och öppnar sedan de associerade åtgärdsloggarna med hjälp av relationen flowsession_flowlog_parentobjectid .
[Organization URI]/api/data/v9.0/flowsessions(9d51aa1f-315e-43ab-894f-bc445dfb049b)/flowsession_flowlog_parentobjectid
Syntax för nytt ExecuteCosquerSqlQuery API-anrop med hjälp av tabellen FlowLogs
[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äs mer om att fråga efter JSON-kolumner i tabellerna.
Dela upp samtalet i enskilda delar
- Bas-URL (https://[min org].api.crm[min region].dynamics.com/api/data/v9.2/) är slutpunkt för Dataverse webb-API.
- ExecuteCosquerSqlQuery är metoden som anropas. Den här metoden tillåter körning av en SQL-fråga mot Dataverse.
- Parametrarna för metoden ExecuteCosquerlQuery anges i parenteser enligt metodnamnet:
QueryText=@p1: SQL-frågan som ska köras. I det här fallet väljer frågan olika egenskaper från en tabell där typen är 100000001 (typ av åtgärdslogg för stationär dator) och beställer resultaten av egenskapen startTime i fallande ordning.EntityLogicalName=@p2: Det här avsnittet är det logiska namnet på tabellen (flowlog) som lagrar åtgärdsloggarna.QueryParameters=@p3: Det här avsnittet är ett JSON-objekt som anger parametrar för frågan. I det föregående exemplet anges nyckel/värde-paret där nycklarna är@referencingParentIdoch@referencingParentLogicalNamemed värden förflowsessionid(GUID) och typ av tabellflowsession.PageSize=p4: Det här avsnittet är frågesidans storlek.
Kända begränsningar
- Loggar V2 är endast tillgängliga för flödeskörningar på stationära datorer som lanseras från ett molnflöde genom åtgärden för att ansluta stationära datorer.
- Massborttagningsjobb stöds för närvarande inte för flödeslogg-tabellen.
- Flödesloggposter kan ännu inte visas i avsnittet Tabell i utvecklarportalen (make.powerapps.com).
- Om du ändrar versionen av åtgärdsloggen migreras inte tidigare flödesåtgärdsloggar för stationära datorer till den nya logglagringstypen.