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

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

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

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

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

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

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

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

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

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

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

Запрос данных журналов V2 (предварительная версия)

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

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

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

Следующий вызов 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:// [моя организация].api.crm[мой регион].dynamics.com/api/data/v9.2/) — это конечная точка для веб-API в Dataverse.
• 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 (предварительная версия) доступны только для запусков классический поток, которые запущены из облачный поток через действие коннектора классический поток.
• Изменение версии журнала действий не приведет к переносу предыдущих журналов действий классических потоков в новый тип хранилища журналов.