Konfigurace protokolů akcí desktopového toku
Tato stránka poskytuje konfigurační pokyny pro protokoly desktopových toků, které se nacházejí v sekci funkcí prostředí v centru pro správu Power Platform.
Důležité
- Tato funkce se vztahuje pouze na desktopové toky, které jsou spouštěny z cloudového toku, a zatím není k dispozici pro místní obsluhovaná spuštění z Power Automate Desktop.
Nastavení Stav aktivace protokolů akcí spuštění definuje, kdy by se měly zaznamenávat protokoly akcí spuštění desktopových toků, a dokonce vám umožňuje je úplně vypnout.
| Stav aktivace | Detaily |
|---|---|
| Povoleno (výchozí) | Tato možnost je výchozí pro stávající i nová prostředí, kde se protokoly zaznamenávají jako obvykle. |
| Selhání při spuštění | Tato možnost zachycuje pouze protokoly akcí desktopových toků, když dojde k chybě za běhu. To znamená, že protokoly nejsou dostupné pro každé jednotlivé spuštění, ale pouze v případě, že dojde k chybě. Pokud však dojde k chybě, jsou k dispozici všechny protokoly pro tento konkrétní běh, včetně úspěšných i neúspěšných akcí. |
| Disabled | Tato možnost efektivně zcela vypne protokoly akcí spuštění desktopových toků. |
Upozornění
Změna kteréhokoli z těchto nastavení může mít významný dopad na funkce, jako je odstraňování problémů se selháním a auditování. Než budete pokračovat, zvažte důsledky změn těchto nastavení.
Předpoklady
- Licence Power Automate Premium a oprávnění správce pro konfiguraci nastavení protokolu
- Konfigurace adresy URL a IP adresy Power Automate
Konfigurace verze protokolů akcí desktopových toků
verze protokolů akcí vám umožňuje vybrat V1, V2 nebo obojí.
| Verze protokolů | Vysvětlení |
|---|---|
| V1 – Uloženo v poli AdditionalContext entity FlowSession | Tato možnost je výchozí. Protokoly jsou uloženy v poli AdditionalContext tabulky Relace toku, což je atribut souboru uložený jako objekt blob v Microsoft Dataverse. Protokoly V1 spotřebovávají kapacitu souborů Dataverse. |
| V2 – Uloženo v entitě FlowLogs | Tato možnost umožňuje ukládat protokoly do tabulky Protokoly toků, která je uložena v elastických tabulkách. Protokoly V2 spotřebovávají kapacitu databáze Dataverse. |
| Oba | Toto nastavení umožňuje ukládání protokolů do tradičního pole AdditionalContext tabulky Relace toku i tabulky Protokoly toku. Tato funkce spotřebovává kapacitu souborů i databáze Dataverse. Toto nastavení je určeno pro účely ladění nebo testování, protože spotřebovává kapacitu databáze i souborů Dataverse. |
Hodnota time to live v minutách entity FlowLogs určuje, jak dlouho by měly být protokoly akcí uchovávány v elastické tabulce Protokoly toků. Dataverse automaticky odstraní záznamy, které jsou starší než zadaný časový rámec. Zde je několik příkladů hodnot.
| dny | Minuty |
|---|---|
| Jeden den | 1,440 minut |
| Tři dny | 4,320 minut |
| Sedm dní | 10,080 minut |
| 14 dní | 20,160 minut |
| 28 dní | 40,320 minut |
| 60 dní | 86,400 minut |
| 90 dní | 129,600 minut |
| 180 dní | 259,200 minut |
| 365 dní | 525,600 minut |
| Navždy | Méně nebo rovna 0 (nula) minut |
Poznámka:
Před povolením protokolů V2 se ujistěte, že máte dostatečnou kapacitu databáze Dataverse, která by podporovala nastavení uchovávání dat a byla v souladu s vaším plánováním kapacity, oprávněním a podle potřeby ji upravte. Některé příklady dimenzování najdete v části Ukázka výpočtů poptávky po kapacitě Dataverse protokolů V2.
Klíčové rozdíly protokolů desktopových toků V1 a V2
Následující tabulka popisuje rozdíly mezi protokoly desktopových toků V1 a V2:
| Funkce | Protokoly V1 | Protokoly V2 | Detaily |
|---|---|---|---|
| Automatické uchovávání dat | Není k dispozici | dostupný | V2 používá Elastické tabulky, které využívají Azure Cosmos DB a přichází s vestavěnou funkcí time-to-live pro automatické uchovávání dat. |
| Podpora pro velké velikosti protokolů | Zhruba 50 000 až 80 000 protokolů akcí (maximum) | Zhruba dvojnásobný počet protokolů akcí V1 (zpočátku) | V2 by se teoreticky mohlo v budoucnu škálovat až na gigabajty protokolů akcí na běh, zatímco V1 se může škálovat pouze na objem uvedený v této tabulce. |
| Podpora pokročilého reportingu a správy | Není k dispozici | dostupný | Ve verzi 1 je atribut AdditionalContext typem souboru, který je uložen jako objekt blob v Dataverse, takže je náročné analyzovat pro ovládání sestav a řízení. Protokoly jsou ve V2 mnohem dostupnější. |
| Podpora pro integraci Azure Synapse Link for Dataverse | Není k dispozici | dostupný | Ve verzi 1 je atributem AdditionalContext typ souboru uložený jako objekt blob v Dataverse, který není podporován pro synchronizaci s Azure Synapse. |
| Podpora auditování Dataverse | Není k dispozici | dostupný | Ve verzi 1 je atributem AdditionalContext typ souboru uložený jako objekt blob v Dataverse, který není podporován v auditování Dataverse. |
| Podpora pro dlouhodobé uchování Dataverse | Není k dispozici | Naplánováno | Ve verzi 1 je atributem AdditionalContext typ souboru uložený jako objekt blob v Dataverse, který není podporován v dlouhodobé uchovávání Dataverse. |
| Na základě Řízení přístupu na základě rolí (RBAC) Dataverse | dostupný | dostupný | Obě verze používají Dataverse RBAC, dědí oprávnění protokolu akcí z jejich nadřazeného záznamu relace toku. |
Protokoly V2 nabízí významná vylepšení oproti předchozí verzi V1. V2 používá funkci elastických tabule, která je skvělá pro práci s velkými objemy dat, jako jsou scénáře protokolu akcí, a má vestavěné uchovávání dat (TTL). Ideální pro organizace, které potřebují přístup ke značnému množství dat pro vytváření sestav, řízení a integraci s automatickým řízením uchovávání dat.
Výpočty poptávky kapacity Dataverse pro protokoly V2
Následující tabulka ukazuje ukázkové odhady spotřeby úložiště databáze Dataverse na spuštění desktopového toku při použití protokolů V2. Nastiňuje přibližnou poptávku po úložišti pro různé počty akcí, za předpokladu průměrně 3 KB úložiště na akci.
| Počet akcí | Poptávka po úložišti na akci (KB) | Celková spotřeba úložiště (MB) |
|---|---|---|
| 1000 | 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 |
Důležité
Údaje uvedené ve výše uvedené tabulce jsou pouze odhady a skutečná spotřeba úložiště se může výrazně lišit. Přesná potřeba úložiště bude záviset na konkrétních detailech a složitosti každého protokolu akcí. Tato čísla by proto měla být používána jako hrubé vodítko pro pochopení potenciální poptávky po úložišti a odpovídající plánování vašich požadavků na úložiště.
Dotazování na data protokolů V2
Přístup k datům protokolů akcí desktopových toků lze dosáhnout voláním rozhraní API na Dataverse backend, buď pomocí tradiční syntaxe volání API nebo pomocí nové metody ExecuteCosmosSqlQuery. Tato metoda umožňuje provádět dotaz SQL proti Dataverse umožňující vyhledávání a filtrování dat.
Datový model protokolů V2 je založen na vztahu nadřízená-podřízený mezi tabulkami Relace toků a Protokol toků. Každý záznam zdědí oprávnění záznamu relace nadřazeného toku. Chcete-li se dotazovat na protokoly akcí konkrétního běhu desktopového toku, můžete použít následující syntaxi dotazu.
Tradiční syntaxe volání rozhraní API Dataverse
Následující volání API načte konkrétní relaci toku podle jejího ID (9d51aa1f-315e-43ab-894f-bc445dfb049b) a poté přistupuje k přidruženým protokolům akcí pomocí vztahu flowsession_flowlog_parentobjectid.
[Organization URI]/api/data/v9.0/flowsessions(9d51aa1f-315e-43ab-894f-bc445dfb049b)/flowsession_flowlog_parentobjectid
Nová syntaxe volání API ExecuteCosmosSqlQuery pomocí tabulky 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
Další informace o dotazování JSON sloupců v elastických tabulkách.
Rozdělení volání na jednotlivé části
- Základní URL (https://[my org].api.crm[my region].dynamics.com/api/data/v9.2/) je koncový bod pro webové rozhraní API Dataverse.
- ExecuteCosmosSqlQuery je volaná metoda. Tato metoda umožňuje provedení SQL dotazu proti Dataverse.
- Parametry pro metodu ExecuteCosmosSqlQuery jsou uvedeny v závorkách za názvem metody:
QueryText=@p1: SQL dotaz, který se má provést. V tomto případě dotaz vybere různé vlastnosti z tabulky, kde typ je 100000001 (typ protokolu akcí toku na ploše) a seřadí výsledky podle vlastnosti startTime v sestupném pořadí.EntityLogicalName=@p2: Tato část je logický název tabulky (flowlog), který ukládá protokoly akcí.QueryParameters=@p3: Tato část je objekt JSON určující parametry pro dotaz. V předchozím příkladu určuje pár klíč-hodnota, kde klíče jsou@referencingParentIda@referencingParentLogicalNames hodnotamiflowsessionid(GUID) a typem tabulkyflowsession.PageSize=p4: Tato část představuje velikost stránky dotazu.
Známá omezení
- Protokoly V2 jsou k dispozici pouze pro spuštění desktopových toků, které jsou spouštěny z cloudového toku prostřednictvím akce konektoru desktopových toků.
- Úlohy hromadného odstranění nejsou v současné době pro tabulku Protokol toku podporovány.
- Záznamy protokolu toku zatím nelze zobrazit v části Tabulka na Maker Portal (make.powerapps.com).
- Změna verze protokolu akcí nemigruje předchozí protokoly akcí desktopových toků do nového typu úložiště protokolu.