Споделяне чрез

Конфигурация на регистрационните файлове за действията за потоци за работен плот

  • Статия

Тази страница предоставя указания за конфигуриране на регистрационни файлове на поток за работен плот, намиращи се в раздела за функции на средата в центъра за Power Platform администриране.

Важно

  • Тази функция е приложима само за потоци на работния плот, които се стартират от поток за облак и все още не е налична за локална наблюдавана работа от Power Automate настолен компютър.
  • Въпреки че конфигурацията на регистрационните файлове на потока за работен плот вече е общодостъпна, някои конфигурации, обозначени като "преглед", като например типа дневник на действията Logs V2, все още са в преглед и са достъпни преди официалното издание, така че клиентите да могат да получат ранен достъп и да предоставят обратна връзка. Функциите за преглед не са предназначени за производствена употреба и може да имат ограничена функционалност.

Настройката Състояние на активиране на регистрационните файлове за изпълнение на действия определя кога трябва да бъдат заснети регистрационните файлове за изпълнение на поток за работен плот и дори ви позволява да ги изключите напълно.

Екранна снимка и настройка на ниво среда, която ви позволява да конфигурирате кога трябва да се заснемат регистрационни файлове на поток за работен плот.

Състояние на активиране Подробни данни
Активирано (по подразбиране) Тази опция е по подразбиране както за съществуващи, така и за нови среди, където регистрационните файлове се записват както обикновено.
Неуспех при работа Тази опция улавя регистрационните файлове за действия на работен плот само когато има грешка по време на изпълнение. Това означава, че регистрационните файлове не са налични за всяко едно изпълнение, а само когато възникне грешка. Ако обаче възникне грешка, всички регистрационни файлове за това конкретно изпълнение са налични, включително успешни и неуспешни действия.
Дезактивирано Тази опция ефективно деактивира напълно поток за работен плот стартира регистрационни файлове на действията.

Внимание

Промяната на някоя от тези настройки може да окаже значително влияние върху функции като отстраняване на неизправности при изпълнение и проверка. Помислете за последиците от промяната на тези настройки, преди да продължите.

Конфигуриране на версията на регистрационния файл на потока за работен плот (преглед)

Версията Action logs ви позволява да изберете V1, V2 или и двете.

Екранна снимка и настройка на ниво среда, която ви позволява да конфигурирате регистрационни файлове на работен плот V2.

Версия на регистрационните файлове Обяснение
V1 - Съхранява се в полето AdditionalContext на обекта FlowSession Тази опция е по подразбиране. Регистрационните файлове се съхраняват в полето AdditionalContext на таблицата Flow Session, която е файлов атрибут, съхраняван като blob. Microsoft Dataverse Logs V1 консумира Dataverse файловия капацитет. Тази функция е общодостъпна (GA).
V2 - Съхранява се в обекта FlowLogs (преглед) Тази нова опция за преглед ви позволява да съхранявате регистрационни файлове в таблицата Flow Logs, която се съхранява в Elastic Tables. Logs V2 консумира Dataverse капацитета на базата данни. Тази функция в момента е в публичен преглед.
И двете (преглед) Тази настройка за преглед позволява регистрационните файлове да се съхраняват както в традиционното поле AdditionalContext на таблицата Flow Session, така и в таблицата Flow Logs. Тази функция е в преглед и консумира както Dataverse файлов, така и капацитет на база данни. Тази настройка е предназначена за отстраняване на грешки или тестване, тъй като консумира както Dataverse база данни, така и капацитет на файлове. Тази функция в момента е в публичен преглед.

Стойността на обекта FlowLogs time to live в минути (преглед) определя колко дълго трябва да се съхраняват регистрационните файлове на действията в еластичната таблица на регистрационните файлове на потока. Dataverse автоматично изтрива записи, които са по-стари от посочения период от време. Ето няколко примерни стойности за ваше удобство.

Дни Минути
Един ден 1,440 минути
Три дни 4,320 минути
Седем дни 10,080 минути
14 дни 20,160 минути
28 дни 40,320 минути
60 дни 86,400 минути
90 дни 129,600 минути
180 дни 259,200 минути
365 дни 525,600 минути
Завинаги По-малко или равно на 0 (нула) минути

Бележка

Преди да разрешите регистрационни файлове V2 (преглед), уверете се, че имате достатъчен Dataverse капацитет на базата данни, който да поддържа настройките за съхранение на данни и да е в съответствие с планирането на капацитета, правомощията и коригирането, ако е необходимо. Вижте раздела Изчисления на търсенето на капацитет на примера Dataverse за регистрационни файлове V2 по-долу за някои примери за оразмеряване.

Основни разлики в дневниците на поток за работен плот V1 и V2

Следващата таблица описва разликите между регистрационните файлове на поток за работен плот V1 и V2:

Характеристика Дневници V1 Дневници V2 Подробни данни
Автоматично запазване на данни Не е налице На разположение V2 използва еластични таблици, които се захранват от Azure Cosmos DB и се предлагат с вградена функция за време на живот за автоматично запазване на данни.
Поддръжка за големи размери на трупите Приблизително до 50 000 до 80 000 регистрационни файлове за действие (максимум) Приблизително два пъти повече от броя на V1 дневниците за действие (първоначално) V2 теоретично може да мащабира до гигабайти дневници на действие на изпълнение в бъдеще, докато V1 може да се мащабира само до обема, посочен в тази таблица.
Поддръжка за разширено отчитане и управление Не е налице На разположение Във V1 атрибутът AdditionalContext е файлов тип, съхраняван като BLOB, което Dataverse го прави предизвикателство за анализиране за контроли за отчитане и управление. Регистрационните файлове са много по-достъпни във V2.
Поддръжка за Azure Synapse Link for Dataverse интеграция Не е налице На разположение Във V1 атрибутът AdditionalContext е файлов тип, съхраняван като blob в Dataverse, който не се поддържа за синхронизиране Azure Synapse.
Подкрепа за Dataverse одит Не е налице На разположение Във V1 атрибутът AdditionalContext е файлов тип, съхраняван като blob в Dataverse, който не се поддържа при Dataverse проверка.
Подкрепа за Dataverse дългосрочно задържане Не е налице Планирано Във V1 атрибутът AdditionalContext е файлов тип, съхраняван като blob в Dataverse, който не се поддържа при Dataverse дългосрочно съхранение.
Въз основа на Dataverse контрол на достъпа, базиран на роли (RBAC) На разположение На разположение И двете версии използват Dataverse RBAC, наследявайки разрешения за регистър на действията от записа на сесията на родителски поток.

Logs V2 предлага значителни подобрения в сравнение с предишната версия, V1. V2 използва функцията за еластични таблици , която е чудесна за обработка на големи обеми данни, като сценарии за регистър на действията, и има вградено запазване на данни (TTL). Идеален за организации, които се нуждаят от достъп до значително количество данни за отчитане, управление и интеграция с автоматичен контрол на съхранението на данни.

Dataverse изчисления на търсенето на капацитет за регистрационни файлове V2 (преглед)

Таблицата по-долу показва примерни Dataverse оценки на потреблението на място за съхранение на база данни за поток за работен плот при използване на регистрационни файлове V2. Той очертава приблизителното търсене на съхранение за различен брой действия, като се приема, че средно 3 KB място за съхранение на действие.

Брой действия Търсене на място за съхранение на действие (КБ) Общо потребление на място за съхранение (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

Важно

Цифрите, показани в горната таблица, са само приблизителни и действителното потребление на съхранение може да варира значително. Точното търсене на съхранение ще зависи от специфичните детайли и сложността на всеки регистър на действието. Следователно тези числа трябва да се използват като грубо ръководство за разбиране на потенциалното търсене на съхранение и съответно планиране на вашите изисквания за съхранение.

Заявки към данни от регистрационни файлове V2 (преглед)

Достъпът до данните от регистрационните файлове на потока за работен плот може да бъде постигнат чрез извикване на API към Dataverse бекенда, или с помощта на традиционния синтаксис на извикване на API, или с помощта на новия метод ExecuteCosmosSqlQuery . Този метод ви позволява да изпълните SQL заявка срещу Dataverse, позволявайки извличането и филтрирането на данни.

Моделът на данни на регистрационните файлове V2 се основава на релация родител-дете между таблиците Flow Session и Flow Log. Всеки запис наследява разрешения от записа на сесията на родителски поток. За да заявите регистрационни файлове за действия на конкретно изпълнение на поток за работен плот, можете да използвате следния синтаксис на заявката.

Традиционен Dataverse синтаксис на извикване на API

Следващото извикване на API извлича конкретна сесия на поток по нейния ИД (9d51aa1f-315e-43ab-894f-bc445dfb049b) и след това осъществява достъп до свързаните регистрационни файлове на действията с помощта на flowsession_flowlog_parentobjectid релацията.

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

Нов синтаксис на извикване на API ExecuteCosmosSqlQuery с помощта на таблица 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

Научете повече за заявките за JSON колони в еластични таблици.

Разбиване на повикването на отделни части

  • Основният URL адрес (https://[my org].api.crm[my region].dynamics.com/api/data/v9.2/) е крайната точка за Dataverse уеб API.
  • ExecuteCosmosSqlQuery е методът, който се извиква. Този метод позволява изпълнението на SQL заявка срещу Dataverse.
  • Параметрите за метода ExecuteCosmosSqlQuery са предоставени в скоби след името на метода. Това са:
    • QueryText=@p1: SQL заявката, която трябва да се изпълни. В този случай заявката избира различни свойства от таблица, където типът е 100000001 (поток за работен плот тип дневник на действията) и подрежда резултатите по свойството startTime в низходящ ред.
    • EntityLogicalName=@p2: Това е логическото име на таблицата (flowlog), която съхранява регистрационните файлове на действията.
    • PartitionId=@p3: Този параметър се използва за идентифициране на дяла в Azure Cosmos DB , където трябва да се изпълни заявката. Готово е. flowsession_[flowsessionid]
    • QueryParameters=@p4: Това е JSON обект, определящ параметри за заявката. В предишния пример се посочва двойка ключ-стойност, където са @referencingParentId ключовете и @referencingParentLogicalName със стойности на flowsessionid (GUID) и тип на таблицата flowsession.
    • PageSize=p5: Това е размерът на страницата на заявката.

Известни ограничения

  • Регистрационните файлове V2 (преглед) са налични само за поток за работен плот, които се стартират от поток за облак чрез действието на конектора на поток за работен плот.
  • Промяната на версията на регистрационния файл на действията не мигрира предишните регистрационни файлове на действията на работния поток за работен плот към новия тип съхранение на регистрационни файлове.