Configuração de logs de ação do fluxo da área de trabalho

Esta página fornece orientação de configuração para logs de fluxo da área de trabalho, localizados na seção de recursos do ambiente no Centro de administração do Power Platform.

A configuração Status de ativação dos logs de ação de execução define quando os logs de ação de execução de fluxo da área de trabalho devem ser capturados e até permite desativá-los completamente.

Configurar logs de ação de fluxo da área de trabalho (versão preliminar)

A Versão dos logs de ação permite escolher V1, V2 ou ambos.

O valor Vida útil da entidade FlowLogs em minutos (Versão preliminar) determina por quanto tempo os logs de ação devem ser retidos na tabela elástica Logs de Fluxo. O Dataverse exclui automaticamente os registros mais antigos que o do período especificado. Veja alguns exemplos de valores para sua conveniência.

Principais diferenças dos logs de fluxo da área de trabalho V1 e V2

A seguinte tabela descreve as diferenças entre os logs de fluxo da área de trabalho V1 e V2:

O Log V2 oferece aprimoramentos significativos em relação à versão anterior, V1. A V2 usa o recurso de tabelas elásticas, que é ótimo para lidar com grandes volumes de dados, como cenários de log de ação, e tem retenção de dados (TTL) integrada. Ideal para organizações que precisam acessar uma quantidade significativa de dados para geração de relatórios, governança e integração com controle de retenção de dados automática.

Dataverse cálculos de demanda de capacidade para logs V2 (versão preliminar)

A tabela a seguir mostra estimativas de consumo de armazenamento de banco de dados de amostra do Dataverse por execução de fluxo da área de trabalho ao usar logs V2. Ele descreve a demanda de armazenamento aproximada para números diferentes de ações, assumindo uma média de 3 KB de armazenamento por ação.

Consultando dados de logs V2 (versão preliminar)

O acesso aos dados dos logs de ação de fluxo da área de trabalho pode ser obtido fazendo uma chamada de API para o back-end do Dataverse, usando a sintaxe de chamada de API tradicional ou usando o novo método ExecuteCosmosSqlQuery. Esse método permite executar uma consulta SQL com o Dataverse, habilitando a recuperação e a filtragem de dados.

O modelo de dados de logs V2 é baseado em um relacionamento pai-filho entre as tabelas Sessão de Fluxo e Log de Fluxo. Cada registro herda permissões de seu registro de sessão de fluxo pai. Para consultar os logs de ação de uma execução de fluxo da área de trabalho específica, você pode usar a sintaxe de consulta a seguir.

Sintaxe de chamada de API do Dataverse tradicional

A chamada à API a seguir recupera uma sessão de fluxo específica por sua ID (9d51aa1f-315e-43ab-894f-bc445dfb049b) e, em seguida, acessa os logs de ação associados usando o relacionamento flowsession_flowlog_parentobjectid.

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

Nova sintaxe de chamada à API ExecuteCosmosSqlQuery usando a tabela 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

Saiba mais sobre como consultar colunas JSON em tabelas elásticas.

Dividindo a chamada em partes individuais

• A URL base (https://[my org].api.crm[my region].dynamics.com/api/data/v9.2/) é o ponto de extremidade da API Web do Dataverse.
• ExecuteCosmosSqlQuery é o método que está sendo chamado. Esse método permite a execução de uma consulta SQL com o Dataverse.
• Os parâmetros para o método ExecuteCosmosSqlQuery são fornecidos entre parênteses após o nome do método. Elas são:
  • QueryText=@p1: A consulta SQL a ser executada. Nesse caso, a consulta seleciona várias propriedades de uma tabela onde o tipo é 100000001 (tipo de log de ação de fluxo da área de trabalho) e ordena os resultados pela propriedade startTime em ordem decrescente.
  • EntityLogicalName=@p2: este é o nome lógico da tabela (flowlog) que armazena os logs de ação.
  • PartitionId=@p3: esse parâmetro é usado para identificar a partição no Azure Cosmos DB onde a consulta deve ser executada. É definido como flowsession_[flowsessionid].
  • QueryParameters=@p4: este é um objeto JSON que especifica parâmetros para a consulta. No exemplo anterior, ele está especificando um par chave-valor onde as chaves são @referencingParentId e @referencingParentLogicalName com valores de flowsessionid (GUID) e tipo da tabela flowsession.
  • PageSize=p5: Este é o tamanho da página de consulta.

Limitações conhecidas

• Os logs V2 (versão preliminar) estão disponíveis somente para execuções de fluxo da área de trabalho que são iniciadas de um fluxo da nuvem por meio da ação do conector fluxo da área de trabalho.
• Alterar a versão do log de ação não migra os logs de ação de fluxo da área de trabalho anteriores para o novo tipo de armazenamento de log.