Gerenciar histórico de execução do fluxo da nuvem no Dataverse (versão preliminar)
[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]
Com o histórico de execuções do fluxo da nuvem do Dataverse, você pode aplicar a extensibilidade do Dataverse para acompanhar os resultados das execuções do fluxo da nuvem em escala. Com esse recurso, você pode usar o poder da arquitetura de dados comuns do Dataverse, incluindo o RBAC (Controle de Acesso Baseado em Função), para gerenciar os dados de FlowRun. Somente fluxos da nuvem da solução, com as definições no Dataverse, podem ter seu histórico de execução armazenado no Dataverse.
Como parte desse recurso, cada execução de fluxo da nuvem possui uma entrada na tabela FlowRun. Este recurso está usando o banco de dados não relacional do Dataverse, tabelas elásticas, para armazenar o histórico de execuções do fluxo da nuvem.
O histórico de execução do fluxo da nuvem no Dataverse é usado pelo centro de automação para fornecer experiências abrangentes de monitoramento e solução de problemas para processos de automação no Power Automate.
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. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.
- Este recurso está no processo de implementação e ainda não está disponível na região de nuvens soberanas.
Elementos de execução de fluxo da nuvem
A tabela FlowRun contém elementos-chave de uma execução de fluxo da nuvem, incluindo o seguinte:
| Elemento | Description |
|---|---|
| Name | Chave primária e o ID do aplicativo lógico da execução do fluxo. |
| Hora de início | Quando a execução do fluxo da nuvem foi acionada. |
| Hora de término | Quando a execução do fluxo da nuvem foi finalizada. |
| Duração da execução | Tempo, em segundos, para o fluxo da nuvem para finalizar a execução. |
| Status | Resultado final da execução do fluxo (Sucesso, Falha ou Cancelado). |
| Tipo de gatilho | O tipo de gatilho dessa execução de fluxo (Automatizado, Programado ou Manual). |
| Código de erro | O código de erro retornado da execução do fluxo. |
| Error message | Mensagem de erro detalhada, se aplicável, retornada da execução do fluxo. |
| Proprietário | Proprietário do fluxo. |
| Nome do fluxo de trabalho | Nome de exibição do fluxo da nuvem. |
| ID do Fluxo de Trabalho | WorkflowID do fluxo da nuvem específico, |
| É Principal | Valor binário para indicar se esta execução de fluxo tem algum fluxo de nuvem pai que a aciona. |
| ID da Execução Principal | Nome da instância de execução do fluxo de nuvem pai, se esse registro for para um fluxo filho. |
| ID da Partição | ID de partição deste usuário na instância da tabela elástica. |
| Vida útil | Tempo em segundos a partir do qual esse registro de execução é excluído automaticamente. |
Você pode exibir e atualizar os detalhes por meio de APIs do Dataverse padrão, do conector do Dataverse ou diretamente da exibição Tabelas no Maker Portal.
Como esse recurso é baseado em tabelas elásticas, armazenamos os dados do histórico de execuções na nuvem em partições lógicas específicas para otimizar o desempenho. Os dados do histórico de execuções são particionados com base nos usuários, portanto, cada usuário em uma organização tem uma partição dedicada.
Os dados do FlowRun usam a capacidade de armazenamento do banco de dados do Dataverse. O uso de armazenamento entre ambientes pode ser monitorado no centro de administração do Power Platform.
Uso de armazenamento para registros FlowRun
Por padrão, os dados de execução de fluxo são armazenados por 28 dias (2.419.200 segundos). Se quiser modificar a duração de quanto tempo as execuções podem ser armazenadas, você pode atualizar a Vida útil (em segundos) para a execução do fluxo na tabela Organização em um ambiente com suporte do Dataverse. Dependendo da capacidade de armazenamento do seu ambiente, você pode ajustar a duração do armazenamento desses registros de execução.
O valor FlowRunTimeToLiveInSeconds na tabela Organização pode ser alterado no navegador da tabela do PowerApps ou usando a API Web do Dataverse.
Ativar ou reduzir o armazenamento do histórico de execuções do fluxo da nuvem
Se o valor de FlowRunTimeToLiveInSeconds na tabela Organização for alterado, o tempo de vida de qualquer novo registro de FlowRun será retido por esse período. Diminuir o valor pode reduzir o número de registros de FlowRun e o armazenamento usado ao longo do tempo.
Definir vida útil do FlowRun no Dataverse
A definição do valor de FlowRunTimeToLiveInSeconds na tabela Organização como zero interrompe toda a ingestão de novos registros de FlowRun .
Definir vida útil do FlowRun no centro de administração do Power Platform
O valor FlowRunTimeToLiveInSeconds na tabela Organização pode ser definido na Experiência de ambientes do centro de administração do Power Platform. Para escolher a vida útil da entidade FlowRun usada em um ambiente:
- Entre no centro de administração do Power Platform.
- Navegue até Ambientes.
- Para o ambiente desejado, abra a página Configurações.
- Selecione Produto>Recursos.
- Em Histórico de execuções de fluxo da nuvem no Dataverse, defina o valor de retenção de Tempo de vida da entidade FlowRun para 28 dias (o padrão), 14 dias, 7 dias ou Desabilitado.
Definir valores TTL personalizados para armazenar uma quantidade mais longa ou mais específica de histórico de execução de fluxo da nuvem
Se quiser um valor TTL (Vida Útil) específico que não esteja disponível por meio da experiência do Centro de administração do Power Platform, você poderá definir esse valor diretamente como o valor FlowRunTimeToLiveInSeconds na tabela Organização.
Reduzir o número de registros de FlowRun imediatamente
Se o ambiente estiver com pouco armazenamento, os clientes poderão optar por limpar o espaço do banco de dados definindo o valor TTLInSeconds para um conjunto de registro FlowRun. Os registros são então automaticamente limpos e excluídos permanentemente dentro de um ou dois minutos. Verifique se os registros não são mais necessários, pois eles não podem ser recuperados depois de excluídos.
Cálculos de Valor de Vida Útil (TTL)
Os Valores de Vida Útil (TTL) para Organization.FlowRunTimeToLiveInSeconds e FlowRun.TTLInSeconds são especificados em segundos. A tabela a seguir contém valores comuns que podem ser usados nas tabelas Organization e FlowRun.
| dias | Segundos |
|---|---|
| 1 dia | 86,400 segundos |
| 3 dias | 259,200 segundos |
| 7 dia | 604,800 segundos |
| 14 dias | 1,209,600 segundos |
| 28 dias | 2,419,200 segundos |
| 60 dias | 5,184,000 segundos |
Use os dados do FlowEvent para obter visibilidade da integridade dos dados FlowRun
Os registros de FlowRun podem estar incompletos por muitos motivos. A tabela FlowEvent é usada para fornecer sinais de que as execuções foram ignoradas e que o conjunto de dados está incompleto. A falta de sinais não significa que o conjunto de dados está completo.
Você pode exibir os registros FlowEvent do navegador da tabela do PowerApps ou usando a API Web do Dataverse. Todos os registros relevantes têm um valor FlowEvent.EventType de "FlowRunIngestion" e, em seguida, o valor FlowEvent.EventCode explica o evento.
A seguinte tabela contém uma lista de valores FlowEvent.EventCode que podem ser usados para sinalizar que os dados de FlowRun não estão completos:
| EventCode | Motivo |
|---|---|
| isFlowRunIngestionECSDisabled | O histórico de execução do fluxo da nuvem não está sendo no Dataverse devido à configuração do serviço, portanto, nenhum dado do fluxo da nuvem pode ser mostrado. A configuração do serviço ECS é definida automaticamente e não há como um administrador alterar o comportamento de ingestão nesse estado. |
| TtlSettingEqual0 | A configuração TTL (vida útil) do ambiente atual para execuções de fluxo da nuvem está definida para não reter dados. Como resultado, algum histórico de execução de fluxo da nuvem pode estar faltando. Este estado ocorre quando Organization.FlowRunTimeToLiveInSeconds está definido como zero. |
| IngestionDisabledByOrgSettings | O histórico de execuções do fluxo da nuvem não está sendo salvo no Dataverse devido às configurações dos ambientes, portanto, parte do histórico de execução dos fluxos da nuvem pode estar faltando. Esta ocorrência ocorreu quando Organization.FlowRunTimeToLiveInSeconds estava definido como zero no passado. |
| ElasticTableStorageCapacityReached | Você atingiu seu limite de capacidade de armazenamento do Dataverse, causando uma pausa na sincronização de dados de execução do fluxo da nuvem. |
| ElasticTablePartitionLimitReached | Você atingiu seu limite de partição de armazenamento do Dataverse, causando uma pausa na sincronização de dados de execução do fluxo da nuvem. |
| IngestionRateDataLoss | Parte do histórico de execução dos fluxos da nuvem pode estar faltando devido ao alto volume de execuções nesse ambiente durante a versão preliminar. |
| FlowRunsEventLoadingFailed | Não é possível carregar os eventos para execuções de fluxo de nuvem em seu ambiente atual. Como resultado, alguns dados históricos de execução do fluxo da nuvem talvez não estejam disponíveis. |
| FlowRunsTTlSettingFailedMessage | Não é possível recuperar a configuração TTL (vida útil) do seu ambiente para execuções de fluxo de nuvem. Como resultado, alguns dados históricos de execução do fluxo da nuvem talvez não estejam disponíveis. |
| ElasticTableNoRoleForUser | Um usuário que possui um ou mais fluxos não tem permissões de leitura para a tabela FlowRun no Dataverse, portanto, parte do histórico de execução do fluxo da nuvem não está sendo salvo no Dataverse. O motivo é porque esse usuário não pode ser definido como o proprietário. |
Limitações conhecidas
- Os registros FlowRun são atribuídos a um proprietário específico quando são gravados na tabela, portanto, o conceito de registros FlowRun compartilhados para fluxos compartilhados não tem suporte no momento.
- Os proprietários de fluxo precisam pelo menos de acesso de leitura à tabela FlowRun para armazenar seus registros de execução do Dataverse. O sistema grava registros FlowRun na tabela e, em seguida, a propriedade é atribuída ao proprietário principal do fluxo. Se o proprietário principal do fluxo não tiver permissão de leitura para a tabela FlowRun, o registro FlowRun não será armazenado e um FlowEvent.EventCode de ElasticTableNoRoleForUser será visto na tabela FlowEvent. Para corrigir essa situação, certifique-se de que os proprietários do fluxo tenham permissão de leitura da tabela FlowRun.
- Atualmente, há um limite de 20 GB por partição nas tabelas elásticas. Inserções de registros de execução adicionais, apenas para esse usuário específico, falhariam quando o limite fosse atingido.
- Os registros do FlowRun podem ser limitados e ignorados se um usuário tiver muitos fluxos com altas taxas de execução. Quando ocorre a limitação, uma entrada é criada na tabela FlowEvent para sinalizar que as execuções foram ignoradas e que o conjunto de dados está incompleto.
Observação
O fluxo de dados subjacente usado para alimentar as inserções de registros de execução do fluxo de nuvem não é transacional e, portanto, não é 100% sem perdas. Pequenas perdas de dados neste fluxo de dados podem ocorrer devido a problemas de serviço temporários e não repetitivos. Os registros ausentes não são representados por FlowEvent. O histórico de execução de fluxo nos detalhes do fluxo no portal do Power Automate é transacional e, portanto, fornece uma visão sem perdas das execuções.
Perguntas frequentes
Por que todos os meus ambientes têm um valor zero de FlowRunTimeToLiveInSeconds?
Se todos os seus ambientes tiverem um valor zero de FlowRunTimeToLiveInSeconds na tabela Organização, ele poderá ser uma destas situações:
- Se os dados de FlowRun nunca estiverem disponíveis, talvez seus ambientes não tenham sido habilitados automaticamente para ingestão do FlowRun porque não havia capacidade suficiente de armazenamento de banco de dados do Dataverse disponível.
- Se os dados de FlowRun estivessem disponíveis anteriormente, um administrador poderia ter desativado a ingestão de novos registros.
Quando isso estará disponível para o público geral (GA)?
No momento, não há um cronograma confirmado para a transição desse recurso de versão preliminar pública para a disponibilidade geral (GA). Devido a restrições de arquitetura e desempenho que exigem limitação, o histórico do FlowRun pode apresentar lacunas. No entanto, entendemos a importância de dados completos do histórico de execuções do fluxo. Estamos avaliando ativamente estratégias para sincronização sem perdas que nos permitam mover esse recurso para o GA no futuro.
Os dados do FlowRun são usados pelo Centro de automação (versão preliminar) no Power Automate maker portal. Embora os dados do FlowRun possam ter certas lacunas durante a fase de versão preliminar, há valor em tornar esses dados acessíveis para versão preliminar pública, tanto como um recurso autônomo quanto como parte do centro de automação.
A gravação do histórico de execuções do fluxo da nuvem no Dataverse usa a cota de solicitação do Power Platform?
A gravação do histórico de execuções do fluxo da nuvem do Dataverse, pois os dados do FlowRun não contam para os Limites da solicitação do Power Platform. APIs executadas para ler se os dados do FlowRun contam para os Limites da solicitação do Power Platform.
Como esses dados se comparam aos dados disponíveis no Application Insights?
Os administradores podem configurar o Application Insights para fornecer dados de monitoramento de execuções de fluxo do Power Automate. Os dados do Application Insights são:
- Mais completo devido a problemas de pipeline de dados para obter os dados do FlowRun.
- Mais profundo porque possui informações sobre gatilhos e ações executadas.
- Pode ser correlacionado com os dados do Power Apps e do Dataverse Application Insights através de identificadores de correlação.