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

Artigo
11/19/2024

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.

Importante

Esse recurso só se aplica a fluxos da área de trabalho iniciados a partir de um fluxo da nuvem e ainda não está disponível para execuções assistidas locais da área de trabalho do Power Automate.

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.

Status da ativação	Details
Habilitado(a) (padrão)	Essa opção é o padrão para ambientes novos e existentes, nos quais os logs são capturados normalmente.
Falha ao executar	Essa opção captura apenas logs de ações do fluxo da área de trabalho quando há um erro de runtime. Isso significa que os logs não estão disponíveis para todas as execuções, mas apenas quando ocorre um erro. No entanto, se ocorrer um erro, todos os logs dessa execução específica estarão disponíveis, incluindo ações com êxito e com falha.
Desabilitado	Esta opção desabilita os logs de ação de execução do fluxo da área de trabalho completamente.

Cuidado

A alteração de qualquer uma dessas configurações pode ter um impacto significativo em recursos como execução, falha, solução de problemas e auditoria. Considere as implicações da alteração dessas configurações antes de continuar.

Pré-requisitos

Licença Premium do Power Automate e privilégios administrativos para definir configurações de log
Configurações de endereço IP e URL do Power Automate
- Nuvem pública
- Nuvem governamental

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

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

Versão dos logs	Explicação
V1 - Armazenado no campo AdditionalContext da entidade FlowSession	Esta opção é o padrão. Os logs são armazenados no campo AdditionalContext da tabela Sessão de Fluxo, que é um atributo de arquivo armazenado como um blob no Microsoft Dataverse. Os logs V1 consomem a Capacidade do arquivo do Dataverse.
V2 – Armazenado na entidade FlowLogs	Essa opção permite armazenar logs na tabela Logs de fluxo, que é armazenada nas Tabelas Elásticas. Os logs V2 consomem a Capacidade do banco de dados do Dataverse.
Ambos	Essa configuração permite que os logs sejam armazenados no campo AdditionalContext tradicional da tabela Sessão de Fluxo e na tabela Logs de Fluxo. Esse recurso consome a capacidade do arquivo e do banco de dados do Dataverse. Esta configuração destina-se para fins de depuração ou teste, pois consome a capacidade do arquivo e do banco de dados do Dataverse.

O valor Vida útil da entidade FlowLogs em minutos 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.

dias	Minutos
Um dia	1,440 minutos
Três dias	4,320 minutos
Sete dias	10,080 minutos
14 dias	20,160 minutos
28 dias	40,320 minutos
60 dias	86,400 minutos
90 dias	129,600 minutos
180 dias	259,200 minutos
365 dias	525,600 minutos
Sempre	Menor ou igual a 0 (zero) minutos

Observação

Antes de habilitar os logs V2, verifique se você tem capacidade de banco de dados do Dataverse suficiente que suportaria as configurações de retenção de dados e se alinharia com seu planejamento de capacidade, direito e ajuste, conforme necessário. Consulte a seção a seguir Cálculos de demanda de capacidade de amostra do Dataverse para logs V2 para obter alguns exemplos de dimensionamento.

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:

Recurso	Logs V1	Logs V2	Details
Retenção de Dados Automática	Não Disponível	Disponível	A V2 usa Tabelas Elásticas, que são fornecidas pelo Azure Cosmos DB e acompanham um recurso interno de vida útil para retenção de dados automática.
Suporte para grandes tamanhos de log	Cerca de 50.000 a 80.000 logs de ação (máximo)	Aproximadamente o dobro do número de logs de ação V1 (inicialmente)	A V2 pode, teoricamente, escalar até gigabytes de logs de ação por execução no futuro, enquanto a V1 só pode escalar para o volume especificado nesta tabela.
Suporte para relatórios e governança avançados	Não Disponível	Disponível	Na V1, o atributo AdditionalContext é um tipo de arquivo armazenado como um blob in Dataverse, o que dificulta a análise de relatórios e controles de governança. Os logs são muito mais acessíveis na V2.
Suporte para integração do Azure Synapse Link for Dataverse	Não Disponível	Disponível	Na V1, o atributo AdditionalContext é um tipo de arquivo, armazenado como um blob no Dataverse, que não tem suporte para sincronização para o Azure Synapse.
Suporte para auditoria do Dataverse	Não Disponível	Disponível	Na V1, o atributo AdditionalContext é um tipo de arquivo, armazenado como um blob no Dataverse, que não tem suporte na auditoria do Dataverse.
Suporte para retenção de longo prazo do Dataverse	Não Disponível	Planejado	Na V1, o atributo AdditionalContext é um tipo de arquivo, armazenado como um blob no Dataverse, que não tem suporte na retenção de longo prazo do Dataverse.
Com base no RBAC (Controle de Acesso Baseado em Função) do Dataverse	Disponível	Disponível	Ambas as versões usam o RBAC do Dataverse, herdando as permissões do log de ação do registro de sessão do fluxo pai.

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.

Cálculos de demanda de capacidade do Dataverse para logs V2

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.

Número de ações	Demanda de armazenamento por ação (KB)	Consumo total de armazenamento (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

Os números mostrados na tabela acima são apenas estimativas e o consumo real de armazenamento pode variar significativamente. A demanda exata de armazenamento dependerá dos detalhes específicos e da complexidade de cada log de ação. Portanto, esses números devem ser usados como um guia aproximado para entender a demanda potencial de armazenamento e planejar seus requisitos de armazenamento adequadamente.

Consultar dados de logs V2

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

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:
- 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: esta seção é o nome lógico da tabela (flowlog) que armazena os logs de ação.
- QueryParameters=@p3: esta seção é um objeto JSON que especifica parâmetros para a consulta. No exemplo anterior, está sendo especificado um par chave-valor onde as chaves são @referencingParentId e @referencingParentLogicalName com valores de flowsessionid (GUID) e o tipo de tabela flowsession.
- PageSize=p4: esta seção é o tamanho da página de consulta.

Limitações conhecidas

Os logs V2 estão disponíveis apenas para execuções de fluxo da área de trabalho que são iniciadas a partir de um fluxo de nuvem por meio da ação do conector de fluxo da área de trabalho.
No momento, os trabalhos de exclusão em massa não têm suporte para a tabela Log de Fluxo.
Os registros de log de fluxo ainda não podem ser exibidos na seção Tabela do maker portal (make.powerapps.com).
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.

Compartilhar via