Configuració dels registres d'acció de flux d'escriptori

Aquesta pàgina proporciona orientació de configuració per als registres de flux d'escriptori, que es troben a la secció de característiques de l'entorn al Power Platform centre d'administració.

Important

• Aquesta característica només s'aplica als fluxos d'escriptori que s'inicien des d'un flux de núvol i que encara no està disponible per a execucions atès en local des de Power Automate l'escriptori.
• Tot i que la configuració dels registres de flux d'escriptori ja està disponible amb caràcter general, algunes configuracions etiquetades com a "versió preliminar", com ara el tipus de registre d'accions Logs V2, encara estan en versió preliminar i estan disponibles abans d'un llançament oficial perquè els clients puguin obtenir accés anticipat i proporcionar comentaris. Les característiques de versió preliminar no estan pensades per a l'ús de producció i poden tenir una funcionalitat restringida.

La configuració Estat d'activació dels registres d'accions d'execució defineix quan s'han de capturar els registres d'accions d'execució del flux d'escriptori i fins i tot us permet desactivar-los completament.

Estat d'activació	Detalles
Activat (per defecte)	Aquesta opció és la predeterminada tant per als entorns existents com per als nous on els registres es capturen com de costum.
Error en funcionament	Aquesta opció només captura els registres d'accions de flux d'escriptori quan hi ha un error en temps d'execució. Això vol dir que els registres no estan disponibles per a cada execució, sinó només quan es produeix un error. Tanmateix, si es produeix un error, tots els registres d'aquesta execució en particular estan disponibles, incloses les accions correctes i fallides.
Discapacitat	Aquesta opció desactiva eficaçment els registres d'accions d'execució del flux d'escriptori completament.

Atenció

Canviar qualsevol d'aquests paràmetres pot tenir un impacte significatiu en funcions com ara la resolució de problemes d'error d'execució i l'auditoria. Considereu les implicacions de canviar aquesta configuració abans de continuar.

Configurar la versió del registre d'accions del flux d'escriptori (versió preliminar)

La versió dels registres d'accions us permet triar V1, V2 o ambdues.

Versió de registres	Explicació
V1: emmagatzemat al camp AdditionalContext de l'entitat FlowSession	Aquesta opció és la predeterminada. Els registres s'emmagatzemen al camp AdditionalContext de la taula Flow Session, que és un atribut de fitxer emmagatzemat com a blob Microsoft Dataverse. Els registres V1 consumeixen capacitat Dataverse defitxer. Aquesta característica està disponible generalment (GA).
V2: emmagatzemat a l'entitat FlowLogs (versió preliminar)	Aquesta nova opció de versió preliminar us permet emmagatzemar registres a la taula Registres de flux, que s'emmagatzema a Tables elàstiques. Els registres V2 consumeixen capacitat Dataverse de la base dedades Aquesta característica és actualment una visualització prèvia pública.
Tots dos (versió preliminar)	Aquesta configuració de versió preliminar permet emmagatzemar els registres tant al camp AdditionalContext tradicional de la taula Sessió de flux com a la taula Registres de flux. Aquesta característica està en versió preliminar i consumeix capacitat tant Dataverse de fitxers com de base de dades. Aquesta configuració està pensada per a la depuració o la prova, ja que consumeix tant la capacitat de la base de dades com Dataverse la de fitxers. Aquesta característica és actualment una visualització prèvia pública.

El valor del temps de vida de l'entitat FlowLogs en minuts (versió preliminar) determina quant de temps s'han de conservar els registres d'accions a la taula elàstica dels registres de flux. Dataverse suprimeix automàticament els registres més antics que el període de temps especificat. Aquí teniu alguns exemples de valors per a la vostra comoditat.

dies	Minuts
Un dia	1,440 minuts
Tres dies	4,320 minuts
Set dies	10,080 minuts
14 dies	20,160 minuts
28 dies	40,320 minuts
60 dies	86,400 minuts
90 dies	129,600 minuts
180 dies	259,200 minuts
365 dies	525,600 minuts
Per sempre	Menys o igual a 0 minuts (zero)

Nota

Abans d'habilitar els registres V2 (versió preliminar), assegureu-vos que teniu prou Dataverse capacitat de base de dades que admeti la configuració de retenció de dades i s'alineï amb la planificació de la capacitat, els drets i ajusteu-los segons sigui necessari. Vegeu la secció Càlculs de demanda de capacitat d'exemple Dataverse per als registres V2 per obtenir alguns exemples de mida.

Diferències clau dels registres de flux d'escriptori V1 i V2

A la taula següent es descriuen les diferències entre els registres de flux d'escriptori V1 i V2:

Característica	Registres V1	Troncs V2	Detalles
Retenció automàtica de dades	No disponible	Disponible	V2 utilitza taules elàstiques, que funcionen amb Azure Cosmos DB i inclouen una funció integrada de temps de vida per a la retenció automàtica de dades.
Suport per a grans mides de troncs	Aproximadament fins a 50.000 a 80.000 registres d'acció (màxim)	Aproximadament el doble del nombre de registres d'accions V1 (inicialment)	La V2 podria teòricament escalar fins a gigabytes de registres d'acció per execució en el futur, mentre que la V1 només pot escalar fins al volum especificat en aquesta taula.
Suport per a informes avançats i governança	No disponible	Disponible	A V1, l'atribut AdditionalContext és un tipus de fitxer, emmagatzemat com a blob Dataverse, cosa que dificulta l'anàlisi dels controls d'informes i governança. Els registres són molt més accessibles a la V2.
Suport per a la Azure Synapse Link for Dataverse integració	No disponible	Disponible	A la V1, l'atribut AdditionalContext és un tipus de fitxer, emmagatzemat com a blob Dataverse, que no s'admet per a la sincronització Azure Synapse.
Suport per a Dataverse l'auditoria	No disponible	Disponible	A V1, l'atribut AdditionalContext és un tipus de fitxer, emmagatzemat com a blob Dataverse, que no s'admet a l'auditoria Dataverse .
Suport per a la Dataverse retenció a llarg termini	No disponible	Planejat	A V1, l'atribut AdditionalContext és un tipus de fitxer, emmagatzemat com a blob in Dataverse, que no s'admet en Dataverse la retenció a llarg termini.
Basat en Dataverse el control d'accés basat en funcions (RBAC)	Disponible	Disponible	Ambdues versions utilitzen Dataverse RBAC, heretant els permisos de registre d'accions del registre de sessió de flux principal.

Logs V2 ofereix millores significatives respecte a la versió anterior, V1. V2 utilitza la funció de taules elàstiques, que és ideal per gestionar grans volums de dades, com ara escenaris de registre d'accions, i té retenció de dades (TTL) integrada. Ideal per a organitzacions que necessiten accedir a una quantitat important de dades per a informes, governança i integració amb control automàtic de retenció de dades.

Dataverse càlculs de demanda de capacitat per als registres V2 (versió preliminar)

La taula següent mostra estimacions de consum d'emmagatzematge de bases de dades d'exemple Dataverse per flux d'escriptori executat quan s'utilitzen els registres V2. Descriu la demanda aproximada d'emmagatzematge per a diferents nombres d'accions, suposant una mitjana de 3 KB d'emmagatzematge per acció.

Nombre d'accions	Demanda d'emmagatzematge per acció (KB)	Consum total d'emmagatzematge (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

Important

Les xifres que es mostren a la taula anterior són només estimacions i el consum real d'emmagatzematge pot variar significativament. La demanda exacta d'emmagatzematge dependrà dels detalls específics i de la complexitat de cada registre d'accions. Per tant, aquests números s'han d'utilitzar com a guia aproximada per entendre la demanda potencial d'emmagatzematge i planificar els vostres requisits d'emmagatzematge en conseqüència.

Consulta de dades de registres V2 (versió preliminar)

L'accés a les dades dels registres d'accions de flux d'escriptori es pot aconseguir fent una crida a l'API Dataverse al dorsal, ja sigui mitjançant la sintaxi de crida d'API tradicional o mitjançant el nou mètode ExecuteCosmosSqlQuery . Aquest mètode permet executar una consulta Dataverse SQL, permetent la recuperació i el filtratge de dades.

El model de dades dels registres V2 es basa en una relació pare-fill entre les taules Sessió de flux i Registre de flux. Cada registre hereta els permisos del seu registre de sessió de flux principal. Per consultar els registres d'acció d'una execució de flux d'escriptori específica, podeu utilitzar la sintaxi de consulta següent.

Sintaxi de crida a l'API tradicional Dataverse

La següent crida a l'API recupera una sessió de flux específica pel seu ID (9d51aa1f-315e-43ab-894f-bc445dfb049b) i, a continuació, accedeix als registres d'accions associats mitjançant la flowsession_flowlog_parentobjectid relació.

[Organization URI]/api/data/v9.0/flowsessions(9d51aa1f-315e-43ab-894f-bc445dfb049b)/flowsession_flowlog_parentobjectid  

Nova sintaxi de crida a l'API ExecuteCosmosSqlQuery mitjançant la taula 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

Obteniu més informació sobre com consultar columnes JSON a taules elàstiques.

Desglossament de la convocatòria en peces individuals

• L'adreça URL base (https://[my org].api.crm[my region].dynamics.com/api/data/v9.2/) és l'extrem de l'API Dataverse web.
• ExecuteCosmosSqlQuery és el mètode que s'està cridant. Aquest mètode permet l'execució d'una consulta SQL contra Dataverse.
• Els paràmetres per al mètode ExecuteCosmosSqlQuery es proporcionen entre parèntesis després del nom del mètode. Aquests són:
  • QueryText=@p1: La consulta SQL que s'ha d'executar. En aquest cas, la consulta selecciona diverses propietats d'una taula on el tipus és 100000001 (flux d'escriptori tipus de registre d'accions) i ordena els resultats per la propietat startTime en ordre descendent.
  • EntityLogicalName=@p2: Aquest és el nom lògic de la taula (flowlog) que emmagatzema els registres d'accions.
  • PartitionId=@p3: Aquest paràmetre s'utilitza per identificar la partició dins de l'Azure Cosmos DB on s'ha d'executar la consulta. Està preparat per fer-ho flowsession_[flowsessionid].
  • QueryParameters=@p4: Aquest és un objecte JSON que especifica paràmetres per a la consulta. A l'exemple anterior, s'especifica un parell clau-valor on es troben @referencingParentId les claus i @referencingParentLogicalName amb valors de flowsessionid (GUID) i tipus de la taula flowsession.
  • PageSize=p5: Aquesta és la mida de la pàgina de consulta.

Limitacions conegudes

• Els registres V2 (versió preliminar) només estan disponibles per a les execucions de flux d'escriptori que s'inicien des d'un flux de núvol mitjançant l'acció del connector de flux d'escriptori.
• El canvi de la versió del registre d'accions no migra els registres d'accions de flux d'escriptori anteriors al nou tipus d'emmagatzematge de registres.