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.

Importante

• Este recurso só é aplicável a fluxos de desktop que são iniciados de um fluxo da nuvem e ainda não está disponível para execuções de assistido no local de Power Automate desktop.
• Embora a configuração de logs fluxo da área de trabalho esteja agora disponível para o público em geral, certas configurações rotuladas como "versão preliminar", como o tipo de log de ação Logs V2, ainda estão em versão preliminar e são disponibilizadas antes de um lançamento oficial para que os clientes possam obter acesso antecipado e fornecer feedback. Os recursos de versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita.

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 (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.

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.

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. Este recurso está disponível ao público em geral (GA).
V2 - Armazenado na entidade FlowLogs (Versão Preliminar)	Esta nova opção versão preliminar permite que você armazene logs na tabela Flow Logs, que é armazenada em Elastic Tables . Os logs V2 consomem a Capacidade do banco de dados do Dataverse. Este recurso está atualmente em visualização pública.
Ambos (Versão Preliminar)	Esta configuração versão preliminar permite que os logs sejam armazenados no campo AdditionalContext tradicional da tabela Flow Session e na tabela Flow Logs. Esse recurso está em versão preliminar e consome a capacidade do arquivo e do banco de dados do Dataverse. Esta configuração é destinada a fins de depuração ou teste, pois consome capacidade de banco de dados e de arquivo Dataverse . Este recurso está atualmente em visualização pública.

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.

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 (versão preliminar), certifique-se de ter capacidade de banco de dados suficiente Dataverse para suportar as configurações de retenção de dados e se alinhar ao seu planejamento de capacidade, direitos e ajustes conforme necessário. Veja a seção Exemplo Dataverse de cálculos de demanda de capacidade para logs V2 a seguir para 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.

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.

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.

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.