Конфігурація журналів дій настільного циклу

Стаття
08/05/2024

На цій сторінці наведено вказівки щодо конфігурації журналів настільного циклу, розташованих у розділі функцій середовища в Power Platform центрі адміністрування.

Важливо

Ця функція застосовна лише до потоків робочого столу, які запускаються з хмарного циклу і поки що недоступні для локальних ручних запусків із Power Automate комп’ютера.
Хоча конфігурація журналів настільного циклу тепер загальнодоступна, певні конфігурації, позначені як «підготовча версія», як-от тип журналу дій Logs V2, все ще перебувають у підготовчі версії та стають доступними до офіційного випуску, щоб користувачі могли отримати ранній доступ і надати відгук. Підготовча версія не призначена для промислового використання та може мати обмежену функціональність.

Параметр Статус активації журналів дій запуску визначає, коли слід записувати журнали дій настільного циклу запуску, і навіть дозволяє повністю їх вимкнути.

Стан активації	Докладні відомості
Увімкнено (за замовчуванням)	Цей параметр є стандартним як для існуючих, так і для нових середовищ, де журнали записуються як зазвичай.
Під час помилки під час бігу	Цей параметр фіксує журнали дій настільного циклу дій desktop лише у разі помилки виконання. Це означає, що журнали доступні не для кожного окремого запуску, а лише в разі виникнення помилки. Однак, якщо помилка все ж виникає, доступні всі журнали для цього конкретного запуску, включаючи як успішні, так і невдалі дії.
Вимкнуто	Цей параметр ефективно повністю вимикає настільний цикл запуску журналів дій.

Увага!

Зміна будь-якого з цих налаштувань може мати значний вплив на такі функції, як усунення збоїв запуску та аудит. Розгляньте наслідки зміни цих параметрів, перш ніж продовжити.

Налаштування версії журналу дій настільного циклу (підготовча версія)

Версія журналу дій дає змогу вибрати V1, 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 у хвилинах (підготовча версія) визначає, як довго журнали дій повинні зберігатися в еластичній таблиці Flow Logs. 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 використовує Elastic Tables, які працюють на базі Azure Cosmos DB і поставляються з вбудованою функцією time-to-live для автоматичного збереження даних.
Підтримка великих розмірів колод	Приблизно до 50 000–80 000 журналів дій (максимум)	Приблизно вдвічі більше, ніж кількість журналів дій V1 (спочатку)	У майбутньому V2 теоретично може масштабуватися до гігабайт журналів дій за прогін, тоді як V1 може масштабуватися лише до обсягу, зазначеного в цій таблиці.
Підтримка розширеної звітності та керування	Недоступно	Доступний	У версії 1 атрибут AdditionalContext — це тип файлу, який зберігається у вигляді ляпки Dataverse, що ускладнює аналіз для звітності та керування керуванням. Логи набагато доступніші у V2.
Підтримка інтеграції Azure Synapse Link for Dataverse	Недоступно	Доступний	У версії 1 атрибут AdditionalContext — це тип файлу, який зберігається як блоб, Dataverse який не підтримується для синхронізації з Azure Synapse.
Підтримка в проведенні Dataverse аудиту	Недоступно	Доступний	У версії 1 атрибут AdditionalContext — це тип файлу, який зберігається як блоб, Dataverse який не підтримується під час Dataverse аудиту.
Підтримка для Dataverse довгострокового утримання	Недоступно	Заплановано	У версії 1 атрибут AdditionalContext — це тип файлу, який зберігається як блоб, Dataverse який не підтримується при Dataverse тривалому зберіганні.
На основі Dataverse контролю доступу на основі ролей (RBAC)	Доступний	Доступний	Обидві версії використовують Dataverse RBAC, успадковуючи дозволи на ведення журналу дій від запису сеансу батьківського циклу.

Logs V2 пропонує значні покращення порівняно з попередньою версією, V1. V2 використовує функцію еластичних таблиць , яка чудово підходить для обробки великих обсягів даних, як-от сценарії журналу дій, і має вбудоване збереження даних (TTL). Ідеально підходить для організацій, яким потрібен доступ до значних обсягів даних для звітності, управління та інтеграції з автоматичним контролем зберігання даних.

Dataverse Розрахунки потреби в потужності для колод V2 (підготовча версія)

У наведеній нижче таблиці наведено приклади Dataverse оцінок споживання сховища бази даних за настільний цикл запуск при використанні журналів V2. У ньому вказано приблизну потребу в сховищі для різної кількості дій, припускаючи, що в середньому 3 КБ пам’яті на одну дію.

Кількість дій	Вимога до сховища за дію (КБ)	Загальний обсяг дискового простору (МБ)
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[мій регіон].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 (підготовча версія) доступні лише для настільний цикл прогонів, які запускаються з хмарний цикл через дію настільний цикл з’єднувача.
Зміна версії журналу дій не призводить до перенесення попередніх журналів дій настільного циклу на новий тип зберігання журналів.

Поділитися через