Настройка журналов действий для настольного потока

В этой статье приведены инструкции по настройке журналов настольных потоков, расположенных в разделе функций среды в центре администрирования Power Platform и в Power Automate для настройки уровня подробности конкретных потоков.

Настройка состояния активации журналов действий выполнения потоков рабочего стола определяет, когда должны записываться эти журналы, и позволяет полностью отключить их.

Необходимые условия

• Лицензия premium Power Automate и административные привилегии для настройки параметров журнала
• URL-адрес Power Automate и конфигурации IP-адресов
  • Общедоступное облако
  • Облако для государственных организаций

Настройте версию журнала действий для рабочего стола

Используйте параметр версии журналов действий для выбора версии 1, версии 2 или обоих.

Параметр времени жизни сущности FlowLogs в минутах определяет, как долго журналы действий хранятся в таблице Flow Logs. Dataverse автоматически удаляет записи, которые старше указанного интервала времени. Ниже приведены некоторые примеры значений для удобства.

Основные различия между журналами потока рабочего стола версии 1 и V2

В следующей таблице описаны различия между журналами потока рабочего стола версии 1 и 2.

Журналы версии 2 предлагает значительные улучшения по сравнению с предыдущей версией 1. Версия 2 использует функцию эластичных таблиц , которая отлично подходит для обработки больших объемов данных, таких как сценарии журнала действий, и имеет встроенное хранение данных (TTL). Это идеально подходит для организаций, которым требуется доступ к значительным объемам данных для создания отчетов, управления и интеграции с автоматическим контролем хранения данных.

Вычисления спроса на емкость Dataverse для журналов версии 2

В следующей таблице показаны примеры расчета использования хранилища журналов Dataverse на один запуск десктопного потока при использовании журналов в версии 2. В нем описываются приблизительные потребности в месте на хранилище для разного количества действий, при условии, что в среднем требуется 3 КБ хранилища на одно действие.

Детализация журналов действий

Журналы классических потоков V2 позволяют задать уровни детализации для балансировки наблюдаемости и эффективности хранилища. Каждый уровень управляет тем, насколько подробно отображаются логи в ходе выполнения потока. В этом разделе описаны доступные уровни детализации для журналов действий потока рабочего стола, как настроить их на уровне среды в Power Platform Admin Center (только администраторы) и как настроить их для отдельных потоков рабочего стола.

Уровни детализации в журналах действий классического потока

Настройка детализации журнала действий в Центре администрирования Power Platform (только администратор)

Администраторы могут задать уровень детализации по умолчанию для всей среды. Этот параметр применяется ко всем процессам на рабочем столе, если не переопределен на уровне самого процесса.

1. Войдите в Центр администрирования Power Platform.

2. В области навигации выберите Управление.

3. В разделе "Управление" выберите "Среды ", а затем выберите среду, в которой выполняются потоки рабочего стола.

4. Выберите Параметры.

5. Разверните продукт и выберите "Компоненты".

6. Найдите параметр Детализация журналов действий в разделе Конфигурация журналов действий выполнения классического потока.

7. Выберите уровень по умолчанию: "Ошибка", "Предупреждение", "Пользовательский", "Отладка" или "Полный".

8. Нажмите кнопку "Сохранить", чтобы применить конфигурацию.

   

Настройка детализации журнала действий для конкретного рабочего потока на рабочем столе

Создатели могут настроить уровень детализации для каждого классического потока на портале Power Automate. Этот локальный параметр переопределяет значение администратора по умолчанию.

Переопределите параметр среды при необходимости:

• Отладка определенного классического потока без увеличения количества журналов для всей среды.
• Временно увеличьте уровень детализации во время тестирования или устранения неполадок.

Выполните следующие действия, чтобы настроить детализацию журнала действий для определенного рабочего потока:

1. Войдите в Power Automate.
2. Откройте страницу сведений о потоке рабочего стола, который вы хотите настроить.
3. Выберите „Изменить” и найдите раздел "Уровень детализации журналов действий".
4. Выберите нужный уровень детализации для этого конкретного потока.

1. Сохраните свои изменения.

Запрос журналов данных второй версии

Доступ к данным журналов действий потока рабочего стола можно получить путем вызова API серверной части Dataverse. Вы можете использовать традиционный синтаксис вызова API или новый метод ExecuteCosmosSqlQuery . С помощью этого метода можно выполнить SQL-запрос к Dataverse, что позволяет извлекать и фильтровать данные.

Модель журналов данных V2 основана на иерархической связи "родитель-потомок" между сеансом потока и таблицами журналов потоков. Каждая запись наследует разрешения от записи сеанса родительского потока. Чтобы запросить журналы действий определенного потока рабочего стола, используйте следующий синтаксис запроса.

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

Следующий вызов API извлекает определенный сеанс потока по его идентификатору (aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb) и получает доступ к связанным журналам действий через связь flowsession_flowlog_parentobjectid.

[Organization URI]/api/data/v9.0/flowsessions(aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb)/flowsession_flowlog_parentobjectid  

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

Дополнительные сведения о запросе столбцов JSON в эластичных таблицах.

Разбиение вызова на отдельные части

• Базовый URL-адрес (https://[моя организация].api.crm[мой регион].dynamics.com/api/data/v9.2/) — это конечная точка веб-API Dataverse.
• ExecuteCosmosSqlQuery — это метод, который вы вызываете. Этот метод запускает SQL-запрос к Dataverse.
• Параметры для ExecuteCosmosSqlQuery метода предоставляются в скобках после имени метода:
  • QueryText=@p1: SQL-запрос для выполнения. Этот запрос выбирает различные свойства из таблицы, где тип равен 100000001 (тип журнала действий потока рабочего стола) и упорядочивает результаты по свойству startTime в порядке убывания.
  • EntityLogicalName=@p2: логическое имя таблицы (flowlog), в которой хранятся журналы действий.
  • QueryParameters=@p3: объект JSON, указывающий параметры для запроса. В предыдущем примере указана пара «ключ — значение», где ключами являются @referencingParentId и @referencingParentLogicalName, значениями — flowsessionid (GUID) и тип таблицы flowsession.
  • PageSize=p4: размер страницы запроса.

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

• Журналы V2 доступны только для выполнений классических потоков, которые пользователь запускает из облачного потока с помощью действия соединителя классического потока.
• Задания массового удаления в настоящее время не поддерживаются для таблицы журнала потоков .
• Вы еще не можете просматривать записи журнала потоков в разделе Table на портале Power Apps maker.
• Изменение версии журнала действий не переносит предыдущие журналы действий потока рабочего стола в новый тип хранилища журналов.
• Не используйте сущности FlowRun и FlowLog в качестве целевых сущностей для триггера потока При добавлении, изменении или удалении строки. Использование этих сущностей в качестве целевых объектов может привести к бесконечному циклу, так как система создает записи в этих таблицах при каждом запуске потока.