Konfiguracija zapisnika akcija toka radne površine

Ova stranica sadrži smjernice za konfiguraciju zapisnika tok radne površine koji se nalaze u odjeljku značajki okruženja u Power Platform centru za administratore.

Važno

• Ta je značajka primjenjiva samo na tijekove radne površine koji se pokreću iz tok oblaka i još nije dostupna za lokalno nadzirani pokreti s Power Automate radne površine.
• Iako je konfiguracija zapisnika tok radne površine sada općenito dostupna, određene konfiguracije označene kao "pretpregled", kao što je vrsta zapisnika radnji Dnevnici V2, još uvijek su u pretpregledu i dostupne su prije službenog izdanja kako bi korisnici mogli dobiti rani pristup i dati povratne informacije. Značajke pretpregleda nisu namijenjene za produkcijsku upotrebu i možda imaju ograničenu funkcionalnost.

Postavka Status aktivacije zapisnika radnji pokretanja definira kada treba zabilježiti zapisnike radnji pokretanja tok radne površine i čak vam omogućuje da ih potpuno isključite.

Status aktivacije	Pojedinosti
Omogućeno (zadano)	Ova je mogućnost zadana za postojeća i nova okruženja u kojima se zapisnici bilježe kao i obično.
Neuspjeh u pokretanju	Ova mogućnost bilježi zapisnike radnji tok radne površine samo kada postoji pogreška tijekom izvođenja. To znači da zapisnici nisu dostupni za svako pojedinačno izvođenje, već samo kada dođe do pogreške. Međutim, ako dođe do pogreške, dostupni su svi zapisnici za to određeno izvođenje, uključujući uspješne i neuspjele radnje.
Onemogućen	Ova opcija u potpunosti onemogućuje zapisnike pokretanja tok radne površine.

Oprez

Promjena bilo koje od ovih postavki može imati značajan utjecaj na značajke kao što su rješavanje problema s pogreškama pokretanja i nadzor. Razmotrite implikacije promjene ovih postavki prije nego što nastavite.

Konfiguriranje verzije zapisnika radnji tok radne površine (pretpregled)

Verzija Action logs omogućuje vam odabir V1, V2 ili oboje.

Verzija zapisnika	Objašnjenje
V1 – pohranjeno u polju AdditionalContext entiteta FlowSession	Ova je opcija zadana. Zapisnici se pohranjuju u polje AdditionalContext tablice Flow Session, što je atribut datoteke pohranjen kao blob Microsoft Dataverse. Zapisnici V1 troše Dataverse kapacitet datoteke. Ova je značajka općenito dostupna (GA).
V2 – pohranjeno u entitetu FlowLogs (pretpregled)	Ova nova mogućnost pretpregleda omogućuje vam pohranu zapisnika u tablicu zapisnika tijeka, koja je pohranjena u elastičnim tablicama. Zapisnici V2 troše Dataverse kapacitet baze podataka. Ta je značajka trenutačno u javnom pretpregledu.
Oboje (pretpregled)	Ova postavka pretpregleda omogućuje pohranu zapisnika u tradicionalno polje AdditionalContext tablice Sesija tijeka i tablica Zapisnici tijeka. Ta je značajka u pretpregledu i troši Dataverse kapacitet datoteke i baze podataka. Ova je postavka namijenjena za otklanjanje pogrešaka ili testiranje jer troši i Dataverse kapacitet baze podataka i datoteke. Ta je značajka trenutačno u javnom pretpregledu.

Vrijednost entiteta FlowLogs vrijeme života u minutama (pretpregled) određuje koliko dugo se zapisnici radnji trebaju zadržati u elastičnoj tablici Zapisnici tijeka. Dataverse Automatski briše zapise koji su stariji od navedenog vremenskog okvira. Evo nekoliko primjera vrijednosti za vašu udobnost.

Dan/a	Minute
Jedan dan	1,440 minuta
Tri dana	4,320 minuta
Sedam dana	10,080 minuta
14 dana	20,160 minuta
28 dana	40,320 minuta
60 dana	86,400 minuta
90 dana	129,600 minuta
180 dana	259,200 minuta
365 dana	525,600 minuta
Zauvijek	Manje od ili jednako 0 (nula) minuta

Napomena

Prije nego što omogućite zapisnike V2 (pretpregled), provjerite imate li dovoljan Dataverse kapacitet baze podataka koji bi podržavao postavke zadržavanja podataka i usklađen s planiranjem kapaciteta, pravom i prilagodbom prema potrebi. Pogledajte sljedeći odjeljak Primjeri Dataverse zahtjeva za kapacitetom za zapisnike V2 za neke primjere veličine.

Ključne razlike zapisnika tok radne površine V1 i V2

U sljedećoj tablici opisane su razlike između zapisnika tok radne površine V1 i V2:

Značajka	Dnevnici V1	Dnevnici V2	Pojedinosti
Automatsko zadržavanje podataka	Nedostupno	Dostupan	V2 koristi elastične tablice koje pokreće Azure Cosmos DB i dolazi s ugrađenom značajkom vremena do života za automatsko zadržavanje podataka.
Podrška za velike veličine trupaca	Otprilike do 50.000 do 80.000 zapisnika radnji (maksimalno)	Otprilike dvostruko veći broj zapisnika akcija V1 (u početku)	V2 bi teoretski mogao skalirati do gigabajta vrijednih dnevnika radnji po pokretanju u budućnosti, dok V1 može skalirati samo na volumen naveden u ovoj tablici.
Podrška za napredno izvješćivanje i upravljanje	Nedostupno	Dostupan	U verziji V1 atribut AdditionalContext vrsta je datoteke pohranjena kao blob Dataverse, što otežava raščlanjivanje za izvješćivanje i kontrole upravljanja. Zapisnici su mnogo dostupniji u V2.
Podrška za Azure Synapse Link for Dataverse integraciju	Nedostupno	Dostupan	U verziji 1 atribut AdditionalContext vrsta je datoteke pohranjena kao blob u Dataverse kojoj nije podržana sinkronizacija Azure Synapse.
Podrška za Dataverse reviziju	Nedostupno	Dostupan	U verziji 1 atribut AdditionalContext vrsta je datoteke pohranjena kao blob Dataverse, a koja nije podržana u Dataverse nadzoru.
Podrška za Dataverse dugoročno zadržavanje	Nedostupno	Planirano	U verziji 1 atribut AdditionalContext vrsta je datoteke pohranjena kao blob u, Dataverse a koja nije podržana u Dataverse dugoročnom zadržavanju.
Na temelju Dataverse kontrole pristupa na temelju uloga (RBAC)	Dostupan	Dostupan	Obje verzije koriste Dataverse RBAC, nasljeđujući dozvole zapisnika radnji iz zapisa sesije nadređeni tok.

Logs V2 nudi značajna poboljšanja u odnosu na prethodnu verziju, V1. V2 koristi značajku elastičnih tablica , koja je izvrsna za rukovanje velikim količinama podataka, kao što su scenariji zapisnika radnji, i ima ugrađeno zadržavanje podataka (TTL). Idealno za tvrtke ili ustanove koje trebaju pristupiti značajnoj količini podataka za izvješćivanje, upravljanje i integraciju s automatskom kontrolom zadržavanja podataka.

Dataverse Izračuni potražnje za kapacitetom za logove V2 (pretpregled)

U sljedećoj tablici prikazane su primjere Dataverse procjene potrošnje prostora za pohranu baze podataka po tok radne površine kada se koriste zapisnici V2. Ocrtava približnu potražnju za pohranom za različit broj akcija, pod pretpostavkom da je u prosjeku 3 KB prostora za pohranu po akciji.

Broj radnji	Potreba za pohranom po akciji (KB)	Ukupna potrošnja prostora za pohranu (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

Važno

Brojke prikazane u gornjoj tablici samo su procjene i stvarna potrošnja skladištenja može značajno varirati. Točna potražnja za pohranom ovisit će o specifičnim detaljima i složenosti svakog dnevnika radnji. Stoga bi se ovi brojevi trebali koristiti kao grubi vodič za razumijevanje potencijalne potražnje za skladištenjem i planiranje vaših zahtjeva za skladištenjem u skladu s tim.

Postavljanje upita zapisnicima V2 (pretpregled) podataka

Pristup podacima zapisnika akcija tok radne površine može se postići upućivanjem API poziva na Dataverse pozadinu, bilo korištenjem tradicionalne sintakse API poziva ili korištenjem nove metode ExecuteCosmosSqlQuery . Ova metoda omogućuje izvršavanje SQL upita protiv Dataverse, omogućujući dohvaćanje i filtriranje podataka.

Podatkovni model zapisnika V2 temelji se na nadređenom odnosu između tablica Flow Session i Flow Log. Svaki zapis nasljeđuje dozvole od svog zapisa sesije nadređeni tok. Da biste upitali zapisnike radnji određenog tok radne površine, možete koristiti sljedeću sintaksu upita.

Tradicionalna Dataverse sintaksa poziva API-ja

Sljedeći poziv API-ja dohvaća određenu sesiju tijeka prema njenom ID-u (9d51aa1f-315e-43ab-894f-bc445dfb049b), a zatim pristupa povezanim zapisnicima radnji pomoću odnosa flowsession_flowlog_parentobjectid .

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

Nova sintaksa poziva API-ja ExecuteCosmosSqlQuery pomoću tablice FlowLogs

    [Organization URI]/api/data/v9.2/ExecuteCosmosSqlQuery(
    QueryText=@p1,EntityLogicalName=@p2,PartitionId=@p3,QueryParameters=@p4,PageSize=@p5)?
    @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: 'flowsession_40590757-a9c0-4f4c-abfc-e2f389049d90'
    @p4: {"Keys":["@referencingParentId","@referencingParentLogicalName"],"Values":[{"Type":"System.Guid","Value":"40590757-a9c0-4f4c-abfc-e2f389049d90"},{"Type":"System.String","Value":"flowsession"}]}
    @p5: 50

Saznajte više o postavljanju upita JSON stupcima u elastičnim tablicama.

Raščlanjivanje poziva na pojedinačne dijelove

• Osnovni URL (https://[moja organizacija].api.crm[moja regija].dynamics.com/api/data/v9.2/) krajnja točka je za Dataverse web API.
• ExecuteCosmosSqlQuery je metoda koja se poziva. Ova metoda omogućuje izvršavanje SQL upita protiv Dataverse.
• Parametri za metodu ExecuteCosmosSqlQuery navedeni su u zagradama iza naziva metode. To su:
  • QueryText=@p1: SQL upit koji treba izvršiti. U tom slučaju upit odabire različita svojstva iz tablice u kojoj je vrsta 100000001 (tok radne površine vrsta zapisnika akcija) i redoslijedom rezultate prema svojstvu startTime silaznim redoslijedom.
  • EntityLogicalName=@p2: To je logički naziv tablice (flowlog) koja pohranjuje zapisnike radnji.
  • PartitionId=@p3: Ovaj se parametar koristi za identifikaciju particije unutar platforme Azure Cosmos DB na kojoj se upit treba izvršiti. Postavljeno je flowsession_[flowsessionid].
  • QueryParameters=@p4: Ovo je JSON objekt koji određuje parametre za upit. U prethodnom primjeru određuje par ključ-vrijednost gdje su @referencingParentId ključevi i @referencingParentLogicalName s vrijednostima flowsessionid (GUID) i vrstom tablice flowsession.
  • PageSize=p5: Ovo je veličina stranice upita.

Poznata ograničenja

• Dnevnici V2 (pretpregled) dostupni su samo za izvođenja tok radne površine koja se pokreću iz tok oblaka putem radnje poveznika tok radne površine.
• Promjena verzije zapisnika radnji ne migrira prethodne zapisnike radnji tok radne površine u novu vrstu pohrane zapisnika.