Configurazione dei log delle azioni del flusso desktop

Questa pagina fornisce indicazioni sulla configurazione per i log dei flussi desktop, situati nella sezione delle funzionalità dell'ambiente nell'interfaccia di amministrazione di Power Platform.

L'impostazione Stato di attivazione dei log delle azioni di esecuzione definisce quando i log delle azioni di esecuzione del flusso desktop devono essere acquisiti e consente anche di disattivarli completamente.

Prerequisiti

• Licenza Power Automate Premium e privilegi amministrativi per configurare le impostazioni del log
• Configurazioni indirizzi IP e URL di Power Automate
  • Cloud pubblico
  • Cloud per enti pubblici

Configurazione della versione dei log delle azioni del flusso desktop

La versione dei log delle azioni ti consente di scegliere V1, V2 o entrambi.

Il valore Ora per il passaggio allo stato live dell'entità FlowLogs in minuti determina per quanto tempo i log delle azioni devono essere conservati nella tabella elastica Log di flusso. Dataverse elimina automaticamente i record precedenti all'intervallo di tempo specificato. Di seguito sono riportati alcuni valori di esempio per comodità.

Differenze principali dei log di flusso desktop V1 e V2

La tabella seguente descrive le differenze tra i log di flusso desktop V1 e V2:

I log della V2 offrono miglioramenti significativi rispetto alla versione precedente, V1. La V2 utilizza la funzionalità Tabelle elastiche, ottima per gestire grandi volumi di dati, come gli scenari di log delle azioni e dispone di conservazione dei dati incorporata (TTL). Ideale per le organizzazioni che necessitano di accedere a quantità significative di dati per reporting, governance e integrazione con il controllo automatico della conservazione dei dati.

Calcoli della domanda di capacità Dataverse per i log V2

La tabella seguente mostra le stime di esempio del consumo di spazio di archiviazione del database Dataverse per esecuzione del flusso desktop quando si utilizzano i log V2. Delinea la richiesta di spazio di archiviazione approssimativa per diversi numeri di azioni, presupponendo una media di 3 KB di spazio di archiviazione per azione.

Esecuzione di query sui dati dei log della V2

L'accesso ai dati dei log delle azioni del flusso desktop può essere ottenuto effettuando una chiamata API al backend Dataverse, utilizzando la tradizionale sintassi delle chiamate API o utilizzando il nuovo metodo EseguiCosmosSqlQuery. Questo metodo consente di eseguire una query SQL su Dataverse, consentendo il recupero e il filtraggio dei dati.

Il modello dati dei log V2 si basa su una relazione padre-figlio tra le tabelle Sessione di flusso e Log di flusso. Ogni record eredita le autorizzazioni dal record della sessione del flusso principale. Per eseguire query sui log delle azioni di un'esecuzione del flusso desktop specifica, è possibile utilizzare la seguente sintassi della query.

Sintassi della chiamata API Dataverse tradizionale

La seguente chiamata API recupera una sessione di flusso specifica in base al relativo ID (9d51aa1f-315e-43ab-894f-bc445dfb049b) e quindi accede ai log delle azioni associati utilizzando la relazione flowsession_flowlog_parentobjectid.

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

Nuova sintassi della chiamata API ExecuteCosmosSqlQuery utilizzando la tabella 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

Altre informazioni sull'esecuzione di query per colonne JSON in tabelle elastiche.

Suddividere la chiamata in singoli pezzi

• L'URL di base (https://[my org].api.crm[my region].dynamics.com/api/data/v9.2/) è l'endpoint per l'API Web Dataverse.
• ExecuteCosmosSqlQuery è il metodo chiamato. Questo metodo consente l'esecuzione di una query SQL su Dataverse.
• I parametri per il metodo ExecuteCosmosSqlQuery vengono forniti tra parentesi dopo il nome del metodo:
  • QueryText=@p1: la query SQL da eseguire. In questo caso, la query seleziona varie proprietà da una tabella in cui tipo è 100000001 (tipo di log delle azioni del flusso desktop) e ordina i risultati in base alla proprietà startTime in ordine decrescente.
  • EntityLogicalName=@p2: questa sezione è il nome logico della tabella (flowlog) in cui sono archiviati i log delle azioni.
  • QueryParameters=@p3: questa sezione è un oggetto JSON che specifica i parametri per la query. Nell'esempio precedente, si specifica un coppia chiave-valore dove le chiavi sono @referencingParentId e @referencingParentLogicalName con valori di flowsessionid (GUID) e tipo di tabella flowsession.
  • PageSize=p4: questa sezione è la dimensione della pagina di query.

Limitazioni note

• I log V2 sono disponibili solo per le esecuzioni del flusso desktop avviate da un flusso cloud tramite l'azione del connettore del flusso desktop.
• I processi di eliminazione in blocco non sono attualmente supportati per la tabella Log dei flussi .
• I record del log dei flussi non possono ancora essere visualizzati nella sezione Tabella di Maker Portal (make.powerapps.com).
• La modifica della versione del log azioni non esegue la migrazione dei log azioni del flusso desktop precedenti al nuovo tipo di archiviazione log.