Configuración de registros de acciones de flujo de escritorio
Esta página proporciona orientación de configuración para los registros de flujo de escritorio, ubicados en la sección de funciones del entorno en el centro de administración de Power Platform.
Importante
- Esta característica solo se aplica a los flujos de escritorio que se inician desde un flujo de nube y aún no está disponible para las ejecuciones asistidas locales desde Power Automate para escritorio.
La configuración Estado de activación de los registros de acciones de ejecución define cuándo se deben capturar los registros de acciones de ejecución del flujo de escritorio e incluso le permite desactivarlos por completo.
| Estado de activación | Detalles |
|---|---|
| Habilitado (predeterminado) | Esta opción es la predeterminada tanto para entornos nuevos como existentes donde los registros se capturan como de costumbre. |
| Error en ejecución | Esta opción solo captura registros de acciones de flujo de escritorio cuando hay un error de tiempo de ejecución. Esto significa que los registros no están disponibles para cada ejecución, sino solo cuando ocurre un error. Sin embargo, si se produce un error, todos los registros de esa ejecución en particular están disponibles, incluidas las acciones correctas y las incorrectas. |
| Deshabilitados | Esta opción efectivamente deshabilita los registros de acciones de ejecución de flujo de escritorio completamente. |
Precaución
Cambiar cualquiera de estas configuraciones puede tener un impacto significativo en funciones como la auditoría y la resolución de problemas de errores de ejecución. Considere las implicaciones de cambiar estas configuraciones antes de continuar.
Requisitos previos
- Licencia premium de Power Automate y privilegios administrativos para configurar los ajustes de registro
- Configuración de la dirección IP y URL de Power Automate
Configurar la versión del registro de acciones del flujo de escritorio
La Versión de registros de acciones le permite elegir V1, V2 o ambas.
| Versión de registros | Explicación |
|---|---|
| V1: almacenado en el campo AdditionalContext de la entidad FlowSession | Esta es la opción predeterminada. Los registros se almacenan en el campo AdditionalContext de la tabla de sesión de flujo, que es un atributo de archivo almacenado como un blob en Microsoft Dataverse. Los registros V1 consumen la capacidad de archivos de Dataverse. |
| V2: almacenado en la entidad FlowLogs | Esta opción le permite almacenar registros en la tabla Registros de flujo, que se almacena en Tablas elásticas. Los registros V2 consumen la capacidad de la base de datos de Dataverse. |
| Ambos | Esta configuración permite que los registros se almacenen tanto en el campo adicional tradicional de la tabla de sesión de flujo como en la tabla de registros de flujo. Esta característica consume capacidad tanto de archivos como Dataverse de base de datos. Esta configuración está pensada para fines de depuración o prueba, ya que consume capacidad de la base de datos y de archivos de Dataverse. |
El valor Tiempo de vida de la entidad FlowLogs en minutos determina durante cuánto tiempo se deben conservar los registros de acciones en la tabla elástica Registros de flujo. Dataverse elimina automáticamente los registros que son más antiguos que el período de tiempo especificado. Aquí tiene algunos valores de ejemplo para su comodidad.
| días | Minutos |
|---|---|
| Un día | 1,440 minutos |
| Tres días | 4,320 minutos |
| Siete días | 10,080 minutos |
| 14 días | 20,160 minutos |
| 28 días | 40,320 minutos |
| 60 días | 86,400 minutos |
| 90 días | 129,600 minutos |
| 180 días | 259,200 minutos |
| 365 días | 525,600 minutos |
| Siempre | Inferior o igual a 0 (cero) minutos |
Nota
Antes de habilitar los registros V2, asegúrese de tener suficiente capacidad de base de datos de Dataverse que admita la configuración de retención de datos y se alinee con su planificación de capacidad, derechos y ajuste según sea necesario. Consulte la siguiente sección Cálculos de demanda de capacidad de muestra de Dataverse para registros V2 para ver algunos ejemplos de dimensionamiento.
Diferencias clave de los registros de flujo de escritorio V1 y V2
La siguiente tabla describe las diferencias entre los registros de flujo de escritorio V1 y V2:
| Característica | Registros V1 | Registros V2 | Detalles |
|---|---|---|---|
| Retención de datos automática | No disponible | Disponibles | V2 utiliza Tablas elásticas, que funcionan con Azure Cosmos DB y vienen con una función de tiempo de vida incorporada para la retención automática de datos. |
| Soporte para registros de gran tamaño | Aproximadamente entre 50.000 y 80.000 registros de acciones (máximo) | Aproximadamente el doble de registros de acciones V1 (inicialmente) | En teoría, V2 podría escalar hasta gigabytes de registros de acciones por ejecución en el futuro, mientras que V1 solo puede escalar al volumen especificado en esta tabla. |
| Soporte para informes y gobernanza avanzados | No disponible | Disponibles | En V1, el atributo AdditionalContext es un tipo de archivo, almacenado como un blob en Dataverse, lo que dificulta su análisis para informes y controles de gobernanza. Los registros son mucho más accesibles en V2. |
| Compatibilidad con la integración de Azure Synapse Link for Dataverse | No disponible | Disponibles | En la versión 1, el atributo AdditionalContext es un tipo de archivo, almacenado como un blob en Dataverse, que no se admite para la sincronización con Azure Synapse. |
| Compatibilidad con la auditoría de Dataverse | No disponible | Disponibles | En la versión 1, el atributo AdditionalContext es un tipo de archivo, almacenado como un blob en Dataverse, que no se admite para la auditoría de Dataverse. |
| Compatibilidad con la retención a largo plazo de Dataverse | No disponible | Planeado | En la versión 1, el atributo AdditionalContext es un tipo de archivo, almacenado como un blob en Dataverse, que no se admite para la retención a largo plazo de Dataverse. |
| Basándose en el control de acceso basado en rol (RBAC) de Dataverse | Disponibles | Disponibles | Ambas versiones usan RBAC de Dataverse, heredando los permisos de registro de acciones de su registro de sesión de flujo principal. |
Registros V2 ofrece mejoras significativas con respecto a la versión anterior, V1. V2 utiliza la característica tablas elásticas, que es excelente para manejar grandes volúmenes de datos, como escenarios de registro de acciones, y tiene retención de datos (TTL) incorporada. Ideal para organizaciones que necesitan tener acceso a una cantidad significativa de datos para informes, gobernanza e integración con control automático de retención de datos.
Cálculos de demanda de capacidad de Dataverse para registros V2
La siguiente tabla muestra ejemplos de estimaciones de consumo de almacenamiento de bases de datos de Dataverse por ejecución de flujo de escritorio cuando se utilizan registros V2. Describe la demanda de almacenamiento aproximada para diferentes números de acciones, suponiendo un promedio de 3 KB de almacenamiento por acción.
| Número de acciones | Demanda de almacenamiento por acción (KB) | Consumo total de almacenamiento (MB) |
|---|---|---|
| 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 |
Importante
Las cifras que se muestran en la tabla anterior son solo estimaciones y el consumo de almacenamiento real puede variar significativamente. La demanda exacta de almacenamiento dependerá de los detalles específicos y la complejidad de cada registro de acción. Por lo tanto, estos números deben usarse como una guía aproximada para comprender la demanda potencial de almacenamiento y planificar sus requisitos de almacenamiento en consecuencia.
Consulta de datos de registros V2
El acceso a los datos de los registros de acciones de flujo de escritorio se puede lograr realizando una llamada API al backend de Dataverse, ya sea usando la sintaxis de llamada API tradicional o usando el nuevo método ExecuteCosmosSqlQuery. Este método le permite ejecutar una consulta SQL contra Dataverse, permitiendo la recuperación y filtrado de datos.
El modelo de datos de los registros V2 se basa en una relación elemento primario-elemento secundario entre las tablas de sesión de flujo y de flujo de registro. Cada registro hereda permisos de su registro de sesión de flujo principal. Para consultar los registros de acciones de una ejecución de flujo de escritorio específica, puede utilizar la siguiente sintaxis de consulta.
Sintaxis de llamada API de Dataverse tradicional
La siguiente llamada API recupera una sesión de flujo específica por su ID (9d51aa1f-315e-43ab-894f-bc445dfb049b) y luego tiene acceso a los registros de acciones asociados utilizando la relación flowsession_flowlog_parentobjectid.
[Organization URI]/api/data/v9.0/flowsessions(9d51aa1f-315e-43ab-894f-bc445dfb049b)/flowsession_flowlog_parentobjectid
Nueva sintaxis de llamada API ExecuteCosmosSqlQuery usando la tabla 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
Más información acerca de consultar columnas JSON en tablas elásticas.
División de la llamada en partes individuales
- La URL base (https://[my org].api.crm[my region].dynamics.com/api/data/v9.2/) es el punto de conexión para la API web de Dataverse.
- ExecuteCosmosSqlQuery es el método al que se llama. Este método permite la ejecución de una consulta SQL contra Dataverse.
- Los parámetros para el método ExecuteCosmosSqlQuery se proporcionan entre paréntesis después del nombre del método:
QueryText=@p1: La consulta de SQL que se ejecutará. En este caso, la consulta selecciona varias propiedades de una tabla donde tipo es 100000001 (tipo de registro de acciones de flujo de escritorio) y ordena los resultados por la propiedad startTime en orden descendente.EntityLogicalName=@p2: Esta sección es el nombre lógico de la tabla (flowlog) que almacena los registros de acciones.QueryParameters=@p3: esta sección es un objeto JSON que especifica parámetros para la consulta. En el ejemplo anterior, se especifica un par clave-valor donde las claves son@referencingParentIdy@referencingParentLogicalNamecon valores deflowsessionid(GUID) y el tipo de tablaflowsession.PageSize=p4: Esta sección es el tamaño de la página de consulta.
Limitaciones conocidas
- Los registros V2 solo están disponibles para ejecuciones de flujo de escritorio que se inician desde un flujo de nube a través de la acción del conector de flujo de escritorio.
- Actualmente, no se admiten trabajos de eliminación masiva para la tabla Flow Log .
- Los registros de Flow log aún no se pueden ver en la sección Tabla del Maker Portal (make.powerapps.com).
- El cambio de la versión del registro de acciones no migra los registros de acciones de flujo de escritorio anteriores al nuevo tipo de almacenamiento de registros.