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

Статья
11/19/2024

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

Важно

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

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

Состояние активации	Details
Включено (по умолчанию)	Этот параметр используется по умолчанию как для существующих, так и для новых сред, где журналы записываются как обычно.
При сбое выполнения	Этот параметр записывает журналы действий классического потока только в случае возникновения ошибки во время выполнения. Это означает, что журналы доступны не для каждого отдельного выполнения, а только при возникновении ошибки. Однако если ошибка все же произойдет, будут доступны все журналы для этого конкретного выполнения, включая успешные и неудачные действия.
Disabled	Этот параметр эффективно отключает журналы действий запуска классических потоков полностью.

Внимание

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

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

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

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

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

Версия журнала	Пояснение
V1 — сохранение в поле AdditionalContext сущности FlowSession	Это параметр по умолчанию. Журналы хранятся в поле AdditionalContext таблицы сеанса потока, которое представляет собой атрибут файла, хранящийся в виде BLOB-объекта Microsoft Dataverse. Журналы V1 потребляют емкость файла Dataverse .
V2 — хранится в сущности FlowLogs	Этот параметр позволяет хранить журналы в таблице журналов потоков, которая хранится в эластичных таблицах. Журналы V2 потребляют емкость базы данных Dataverse.
И то и другое	Этот параметр позволяет хранить журналы как в традиционном поле AdditionalContext таблицы сеанса потока, так и в таблице журналов потоков. Эта функция использует как емкость файла Dataverse, так и емкость базы данных. Эта настройка предназначена для целей отладки или тестирования, поскольку она потребляет как емкость базы данных Dataverse, так и емкость файла.

Значение Срок действия сущности FlowLogs в минутах определяет, как долго журналы действий должны храниться в эластичной таблице журналов потоков. 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 (ноль) минут

Заметка

Прежде чем включать журналы версии 2, убедитесь, что у вас достаточно емкости базы данных Dataverse, которая будет поддерживать настройки хранения данных и соответствует вашему планированию емкости, объем обслуживания и выполните корректировку при необходимости. Некоторые примеры определения размеров см. в разделе Примеры расчетов требуемой емкости Dataverse для журналов V2.

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

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

Функция	Журналы V1	Журналы V2	Details
Автоматическое сохранение данных	Недоступно	На месте	Версия 2 использует эластичные таблицы на базе Azure Cosmos DB и имеет встроенную функцию определения срока действия для автоматического сохранения данных.
Поддержка больших размеров журналов	Примерно от 50 000 до 80 000 журналов действий (максимум)	Примерно в два раза больше журналов действий версии 1 (изначально)	Версия 2 теоретически может масштабироваться в будущем до журналов действий объемом в несколько гигабайт за одно выполнение, тогда как версия 1 может масштабироваться только до объема, указанного в этой таблице.
Поддержка расширенной отчетности и системы управления	Недоступно	На месте	В версии 1 атрибут AdditionalContext представляет собой тип файла, хранящийся в виде BLOB-объекта в Dataverse, что усложняет его анализ для создания отчетов и элементов системы управления. Журналы гораздо более доступны в версии 2.
Поддержка интеграции Azure Synapse Link for Dataverse	Недоступно	На месте	В версии 1 атрибут AdditionalContext представляет собой тип файла, хранящийся в виде BLOB-объекта в Dataverse, который не поддерживается для синхронизации с Azure Synapse.
Поддержка аудита в Dataverse	Недоступно	На месте	В версии 1 атрибут AdditionalContext представляет собой тип файла, хранящийся в виде BLOB-объекта в Dataverse, который не поддерживается в аудите Dataverse.
Поддержка долгосрочного хранения Dataverse	Недоступно	Плановое	В версии 1 атрибут AdditionalContext представляет собой тип файла, хранящийся в виде BLOB-объекта в Dataverse, который не поддерживается в долгосрочном хранении Dataverse.
На основе управления доступом на основе ролей (RBAC) Dataverse	На месте	На месте	Обе версии используют Dataverse RBAC, наследуя разрешения журнала действий от записи сеанса родительского потока.

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

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

В следующей таблице показаны примерные оценки потребления хранилища базы данных Dataverse для каждого выполнения классического потока при использовании журналов версии 2. В ней указана приблизительная потребность в хранилище для различного количества действий, исходя из предположения, что на каждое действие требуется в среднем 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

Важно

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

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

Доступ к данным журналов действий классических потоков можно получить, выполнив вызов 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,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).
Изменение версии журнала действий не приведет к переносу предыдущих журналов действий классических потоков в новый тип хранилища журналов.

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