Configurações de administrador – Execuções de fluxo de trabalho

A página Execuções de fluxo de trabalho na seção Alertas e programações do menu Administrador mostra o histórico recente de atividade do fluxo de trabalho. Para acessar a página Execuções de fluxo de trabalho, você precisa ter um papel que contenha as permissões see_schedules e chat_with_agent.

É possível conferir os fluxos de trabalho na página Configurações de administrador – Fluxos de trabalho. O fluxo de trabalho especifica quando o conteúdo deve ser enviado para endereços específicos.

Um novo fluxo de trabalho é criado sempre que esse conteúdo é enviado. Por exemplo, se um fluxo de trabalho especificar o envio de conteúdo específico para determinados endereços todas as segundas-feiras, o Looker vai criar um novo fluxo de trabalho a cada segunda-feira para enviar esse conteúdo aos endereços especificados.

Filtrar fluxos de trabalho por status de execução

Na parte de cima da página Execuções de fluxo de trabalho, é possível filtrar os fluxos de trabalho por status do job:

  • Todos: todos os fluxos de trabalho recentes
  • Em execução: apenas fluxos de trabalho em execução
  • Concluídos: apenas fluxos de trabalho que foram concluídos
  • Com falha: apenas fluxos de trabalho que não foram concluídos

Informações incluídas

As seguintes informações estão incluídas para cada execução de fluxo de trabalho ou job:

Coluna Definição
Hora Quando a execução do fluxo de trabalho começou
Status Se a execução do fluxo de trabalho foi concluída (marca de seleção verde) ou retornou um erro (ícone de alerta vermelho)
Fase A fase atual de uma execução de fluxo de trabalho em andamento
Usuário O usuário que criou o fluxo de trabalho
Origem O tipo de conteúdo, exibido como Workflow
Nome O nome do fluxo de trabalho, que também serve como um link para o conteúdo dele.
Tipo O destino da entrega, como Email ou Slack
Mensagem Para uma execução com falha, a mensagem de erro. Para uma execução bem-sucedida, success
Ambiente de execução Por quanto tempo a execução do fluxo de trabalho foi ou está sendo executada

Resolver problemas de mensagens de erro de execução do fluxo de trabalho

Use as mensagens de erro exibidas na coluna Mensagem para diagnosticar e resolver falhas na execução do fluxo de trabalho. Estas são algumas mensagens de erro comuns:

Erros de destinatário e lista de permissões

  • Unauthorized emails in plan: ["<email_address>"]:
    • Causa: um ou mais endereços de e-mail do destinatário pertencem a um domínio que não está incluído na lista de permissões de domínio de e-mail da sua instância do Looker.
    • Resolução: adicione o domínio do destinatário à lista de permissões de e-mail do administrador ou edite o fluxo de trabalho para remover endereços de e-mail não autorizados.

Erros de agente e entidade

  • Agent execution failed: unexpected message received:
    • Causa: o Gemini Data Agent encontrou um erro de tempo de execução ou uma resposta inesperada ao interpretar diretivas ou gerar o resumo de insights em linguagem natural.
    • Resolução: revise e refine as diretivas de linguagem natural na configuração do fluxo de trabalho para garantir que as instruções sejam claras e específicas.
  • entity WorkflowAgent missing:
    • Causa: o agente de dados principal, o painel ou a análise detalhada associada ao fluxo de trabalho foi excluída, renomeada ou modificada.
    • Resolução: recrie ou atualize o fluxo de trabalho com um agente de dados ativo ou o recurso Detalhar acessível.

Erros de permissão do usuário e da conta

  • Falhas de permissão do usuário ou acesso ao modelo:
    • Causa: o usuário que criou o fluxo de trabalho não tem acesso aos modelos que sustentam a análise detalhada ou o painel.
    • Resolução: verifique se o proprietário do fluxo de trabalho tem as permissões necessárias em Administrador > Usuários / Funções ou recrie o fluxo de trabalho com um usuário ativo e autorizado.
  • Conta de usuário desativada:
    • Causa: a conta de usuário do Looker do proprietário do fluxo de trabalho foi desativada.
    • Resolução: reative a conta de usuário ou recrie o fluxo de trabalho em um usuário ativo.

Erros de tempo limite e fila do programador

  • Job is no longer processing @<state> (em que <state> é execute ou deliver) ou Job was expected to dequeue by @<time>:
    • Causa: o fluxo de trabalho permaneceu na fila do programador por uma hora ou mais sem ser concluído, geralmente devido a tempos limite temporários de conexão com o banco de dados ou restrições de recursos do sistema.
    • Resolução: o fluxo de trabalho vai tentar ser executado novamente no próximo intervalo programado. Também é possível tentar novamente as execuções com falha de maneira programática usando a API Looker (run_scheduled_plan_once).