Compartir a través de

Configuración de registros de acciones de flujo de escritorio

  • Artículo

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 función solo se aplica a los flujos Escritorio que se lanzan desde un flujo de nube y aún no está disponible para las ejecuciones asistido local desde Power Automate Escritorio.
  • Si bien la configuración de registros flujo de escritorio ahora está disponible de forma general, ciertas configuraciones etiquetadas como "versión preliminar", como el tipo de registro de acción Logs V2, todavía están en versión preliminar y están disponibles antes de un lanzamiento oficial para que los clientes puedan obtener acceso temprano y brindar comentarios. Las características en vista previa no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida.

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.

Configuración de captura de pantalla y nivel de entorno que le permite configurar cuándo se deben capturar los registros de flujo del escritorio.

Estado de activación Details
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.
Deshabilitado 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.

Configurar la versión del registro de acciones del flujo de escritorio (versión preliminar)

La Versión de registros de acciones le permite elegir V1, V2 o ambas.

Configuración de captura de pantalla y nivel de entorno que le permite configurar los registros de flujo del escritorio V2.

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. Esta función está disponible de forma general (GA).
V2: almacenado en la entidad FlowLogs (versión preliminar) Esta nueva opción versión preliminar 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. Esta característica está actualmente en la versión preliminar pública.
Ambos (versión preliminar) Esta configuración versión preliminar permite que los registros se almacenen tanto en el campo FurtherContext tradicional de la tabla de sesión de flujo como en la tabla de registros de flujo. Esta característica está en versión preliminar y consume capacidad de archivos y bases de datos de Dataverse. Esta configuración está destinada a fines de depuración o prueba, ya que consume tanto la capacidad de la base de datos como la del archivo Dataverse . Esta característica está actualmente en la versión preliminar pública.

El valor Tiempo de vida de la entidad FlowLogs en minutos (versión preliminar) 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 (versión preliminar), asegúrese de tener suficiente capacidad de base de datos que admita las configuraciones de retención de datos y se alinee con su planificación de capacidad, derechos y Ajustar según sea necesario. Dataverse Consulte los cálculos de demanda de capacidad de muestra para registros V2 en la siguiente sección para ver algunos ejemplos de dimensionamiento. Dataverse

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 Details
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.

Dataverse Cálculos de demanda de capacidad para registros V2 (versión preliminar)

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 (versión preliminar)

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,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

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. Son:
    • 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: este es el nombre lógico de la tabla (flowlog) que almacena los registros de acciones.
    • PartitionId=@p3: este parámetro se usa para identificar la partición dentro de Azure Cosmos DB donde se va a ejecutar la consulta. Está configurado en flowsession_[flowsessionid].
    • QueryParameters=@p4: este 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 @referencingParentId y @referencingParentLogicalName con valores de flowsessionid (GUID) y tipo de tabla flowsession.
    • PageSize=p5:Este es el tamaño de la página de consulta.

Limitaciones conocidas

  • Los registros V2 (versión preliminar) solo están disponibles para las ejecuciones flujo de escritorio que se inician desde un flujo de nube a través de la acción del conector flujo de escritorio.
  • 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.