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

Artigo
05/21/2024

[Este tópico faz parte da documentação de pré-lançamento e está sujeito a alterações.]

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 é um recurso em versão preliminar.
Os recursos de versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita.
Esse recurso ainda não está disponível para execuções assistidas no local a partir da área de trabalho do Power Automate.
Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.
Alguns dos recursos listados nesta página ainda estão sendo implementados gradualmente e podem ainda não estar disponíveis em sua região.

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.
V2 - Armazenado na entidade FlowLogs (Versão Preliminar)	Essa nova 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 (Versão Preliminar)	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 está em versão preliminar e consome a capacidade do arquivo e do banco de dados do Dataverse. Isso 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 (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, 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	Planejado	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	Planejado	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.

Observação

A propriedade Auditar alterações em seus dados nas propriedades avançadas da tabela Log de Fluxo devem ser desmarcadas até que a auditoria seja compatível com os logs V2. Saiba mais sobre essa e outras configurações avançadas da tabela aqui.

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

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 em que a chave é @referencingParentId e o valor é o flowsessionid (GUID).

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.
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.
Não há suporte para exclusão em cascata. Quando você exclui um registro de sessão de fluxo, os logs subjacentes não são excluídos automaticamente.

Compartilhar via