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

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

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

Предварительные условия

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

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

Версия журнала действий позволяет выбрать V1, V2 или обе версии.

Значение Срок действия сущности FlowLogs в минутах определяет, как долго журналы действий должны храниться в эластичной таблице журналов потоков. Dataverse автоматически удаляет записи старше указанного периода времени. Вот несколько примеров значений для вашего удобства.

Ключевые различия журналов классических потоков V1 и V2

В следующей таблице описаны различия между журналами классических потоков V1 и V2:

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

Расчеты требуемой емкости Dataverse для журналов V2

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

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

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

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

Доступ к данным журналов действий классических потоков можно получить, выполнив вызов API к серверу Dataverse, используя традиционный синтаксис вызовов API или новый метод ExecuteCosmosSqlQuery. Этот метод позволяет выполнить SQL-запрос к Dataverse с извлечением и фильтрацией данных.

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

Традиционный синтаксис вызовов 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: этот раздел представляет собой размер страницы запроса.

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

• Журналы версии 2 доступны только для выполнений классических потоков, которые запускаются из облачного потока с помощью действия соединителя классического потока.
• Задания массового удаления в настоящее время не поддерживаются для таблицы Журнал потоков.
• Записи журнала потоков пока нельзя просмотреть в разделе "Таблица" на портале создателя Maker Portal (make.powerapps.com).
• Изменение версии журнала действий не приведет к переносу предыдущих журналов действий классических потоков в новый тип хранилища журналов.