Configuració de registres d'accions de flux d'escriptori (vista prèvia)

Article
05/20/2024

[Aquest tema és documentació prèvia a la publicació i està subjecte a canvis.]

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

Important

Aquesta és una característica de visualització prèvia.
Les característiques de visualització prèvia no estan dissenyades per a un ús de producció i poden tenir una funcionalitat restringida.
Aquesta funció encara no està disponible per a les carreres locals assistides des de Power Automate l'escriptori.
Aquestes característiques estan disponibles abans d’un llançament oficial de producte per tal que els clients el puguin utilitzar abans i enviar-nos els seus comentaris.
Algunes de les funcions que s'enumeren en aquesta pàgina encara s'estan implementant gradualment i és possible que encara no estiguin disponibles a la vostra regió.

L'estat d'activació dels registres d'acció 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 a entorns existents com nous on els registres es capturen com de costum.
Fallada en execució	Aquesta opció només captura els registres d'accions de flux d'escriptori quan hi ha un error en temps d'execució. Això significa 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 reeixides i fallides.
Discapacitat	Aquesta opció desactiva eficaçment els registres d'accions d'execució del flux d'escriptori.

Atenció

Canviar qualsevol d'aquestes opcions de configuració pot tenir un impacte significatiu en funcions com ara executar errors, resolució de problemes i auditoria. Penseu en les implicacions de canviar aquesta configuració abans de continuar.

Configurar la versió del registre d'accions de flux d'escriptori (vista prèvia)

La versió de registres d'acció us permet triar V1, V2 o tots dos.

Versió dels registres	Explicació
V1 - Emmagatzemat al camp AddicionalalContext de l'entitat FlowSession	Aquesta opció és la predeterminada. Els registres s'emmagatzemen al camp AddicionalContext de la taula Sessió de flux, que és un atribut de fitxer emmagatzemat com a blob. Microsoft Dataverse Logs V1 consumeix capacitat Dataverse d'arxiu.
V2 - Emmagatzemat a l'entitat FlowLogs (vista prèvia)	Aquesta nova opció us permet emmagatzemar registres a la taula Registres de flux, que s'emmagatzema a les taules elàstiques. Logs V2 consumeix capacitat Dataverse debase de dades.
Tots dos (vista prèvia)	Aquest paràmetre permet emmagatzemar registres tant al camp AddicionalContext tradicional de la taula Sessió de flux com a la taula Registres de flux. Aquesta característica està en previsualització i consumeix tant Dataverse la capacitat de fitxer com de base de dades. Això està pensat per a propòsits de depuració o prova, ja que consumeix tant la capacitat de base de dades com Dataverse la de fitxers.

El valor temps de vida de l'entitat FlowLogs en minuts (visualització prèvia) determina quant de temps s'han de conservar els registres d'acció a la taula elàstica Registres de flux. Dataverse Suprimeix automàticament els registres que són més antics que el període de temps especificat. Aquests són alguns valors d'exemple 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
Sempre	Menys o igual a 0 (zero) minuts

Nota

Abans d'habilitar els registres V2, assegureu-vos que teniu prou Dataverse capacitat de base de dades que admeti la configuració de retenció de dades i s'alineï amb la vostra planificació de capacitat, dret i ajust segons sigui necessari. Vegeu la secció Càlculs de demanda de capacitat mostral Dataverse per als registres V2 per obtenir alguns exemples de mida.

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

La taula següent descriu les diferències entre els registres de flux d'escriptori V1 i V2:

Característica	Registres V1	Registres V2	Detalles
Retenció automàtica de dades	No està disponible	Disponible	La V2 utilitza taules elàstiques, que funcionen amb l'Azure Cosmos DB i inclou una característica integrada de temps de vida per a la retenció automàtica de dades.
Suport per a mides de registre grans	Aproximadament fins a 50.000 a 80.000 registres d'accions (màxim)	Aproximadament el doble del nombre de registres d'acció V1 (inicialment)	V2 teòricament podria escalar fins a gigabytes de registres d'acció per execució en el futur, mentre que V1 només pot escalar al volum especificat en aquesta taula.
Suport per a informes avançats i governança	No està disponible	Disponible	A la V1, l'atribut AdditionalContext és un tipus de fitxer, emmagatzemat com a blob Dataverse, cosa que fa que sigui difícil analitzar els informes i els controls de governança. Els registres són molt més accessibles a la V2.
Suport a la Azure Synapse Link for Dataverse integració	No està disponible	Planejat	A la V1, l'atribut AdditionalContext és un tipus de fitxer, emmagatzemat com a blob in Dataverse, que no s'admet per a la sincronització Azure Synapse.
Suport a l'auditoria Dataverse	No està disponible	Planejat	A la V1, l'atribut AdditionalContext és un tipus de fitxer, emmagatzemat com a blob in Dataverse, que no s'admet en Dataverse auditoria.
Suport a Dataverse la retenció a llarg termini	No està disponible	Planejat	A la 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 el control d'accés basat en Dataverse rols (RBAC)	Disponible	Disponible	Les dues versions utilitzen RBAC i hereten Dataverse 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é una retenció de dades integrada (TTL). Ideal per a organitzacions que necessiten accedir a una quantitat significativa de dades per a informes, govern i integració amb control automàtic de retenció de dades.

Nota

Els canvis d'auditoria a la seva propietat de dades sota les propietats avançades de la taula Registre de flux s'han de desseleccionar fins que s'admeti l'auditoria per als registres V2. Obteniu més informació sobre aquesta i altres opcions de configuració avançades de la taula aquí.

Dataverse Càlculs de demanda de capacitat per a registres V2

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 registres V2. Descriu la demanda aproximada d'emmagatzematge per a diferents nombre 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 la complexitat de cada registre d'accions. Per tant, aquests números s'han d'utilitzar com una guia aproximada per entendre la demanda potencial d'emmagatzematge i planificar els vostres requisits d'emmagatzematge en conseqüència.

Registres de consulta de dades V2

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

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

Sintaxi de crides API tradicional Dataverse

La crida API següent recupera una sessió de flux específica pel seu identificador (9d51aa1f-315e-43ab-894f-bc445dfb049b) i, a continuació, accedeix als registres d'acció 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 crides a l'API d'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_9d51aa1f-315e-43ab-894f-bc445dfb049b'&
    @p4={"Keys":["@referencingParentId"],"Values":[{"Type":"System.Guid","Value":"9d51aa1f-315e-43ab-894f-bc445dfb049b"}]}&@p5=50

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

Descompondre la crida en peces individuals

L'URL base (https://[my org].api.crm[my region].dynamics.com/api/data/v9.2/) és el punt final de l'API Dataverse web.
ExecuteCosmosSqlQuery és el mètode que s'anomena. Aquest mètode permet l'execució d'una consulta SQL en contra Dataverse.
Els paràmetres del mètode ExecuteCosmosSqlQuery es proporcionen entre parèntesis seguint el nom del mètode. Aquests són:
- QueryText=@p1: La consulta SQL a executar. En aquest cas, la consulta selecciona diverses propietats d'una taula on el tipus és 100000001 (tipus de registre d'accions de flux d'escriptori) 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à configurat flowsession_[flowsessionid].
- QueryParameters=@p4: Es tracta d'un objecte JSON que especifica paràmetres per a la consulta. En l'exemple anterior, especifica un parell clau-valor on es troba @referencingParentId la clau i el valor és el flowsessionid (GUID).

Limitacions conegudes

Els registres V2 només estan disponibles per a les execucions del flux d'escriptori que s'inicien des d'un flux de núvol a través de l'acció del connector de flux de l'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.
Actualment, la supressió en cascada no és compatible. Quan suprimiu un registre de sessió de flux, els registres subjacents no se suprimeixen automàticament.

Comparteix a través de