Paramètres d'administration – Exécutions de workflow

La page Exécutions de workflow de la section Alertes et planifications du menu Admin affiche l'historique récent de l'activité des workflows. Pour afficher la page Exécutions de workflow, vous devez disposer d'un rôle contenant les autorisations see_schedules et chat_with_agent.

Vous pouvez afficher les workflows sur la page Paramètres d'administration > Workflows. Le workflow indique quand le contenu doit être envoyé à des adresses spécifiques.

Un workflow est créé chaque fois qu'un contenu est envoyé. Par exemple, si un workflow spécifie l'envoi d'un contenu spécifique à certaines adresses tous les lundis, Looker créera un workflow chaque lundi pour envoyer ce contenu aux adresses spécifiées.

Filtrer les workflows par état d'exécution

En haut de la page Exécutions de workflow, vous pouvez filtrer les workflows par état du job :

  • Tous : tous les workflows récents
  • En cours d'exécution : seuls les workflows en cours d'exécution
  • Réussis : seuls les workflows qui ont été exécutés avec succès
  • Échec : seuls les workflows qui n'ont pas pu être exécutés

Informations incluses

Les informations suivantes sont incluses pour chaque exécution de workflow ou job :

Colonne Définition
Heure Heure de début de l'exécution du workflow
État Indique si l'exécution du workflow est terminée (coche verte) ou a renvoyé une erreur (icône d'alerte rouge).
Étape Étape actuelle d'une exécution de workflow en cours
Utilisateur L'utilisateur qui a créé le workflow
Source Type de contenu, affiché sous la forme Workflow
Nom Nom du workflow, qui sert également de lien vers le contenu du workflow
Type Destination de la diffusion, telle que Email ou Slack
Message Message d'erreur en cas d'échec de l'exécution. Pour une exécution réussie, success
Environnement d'exécution Durée d'exécution du workflow

Résoudre les messages d'erreur d'exécution de workflows

Vous pouvez utiliser les messages d'erreur affichés dans la colonne Message pour diagnostiquer et résoudre les échecs d'exécution des workflows. Voici quelques messages d'erreur courants :

Erreurs liées aux destinataires et à la liste d'autorisation

  • Unauthorized emails in plan: ["<email_address>"] :
    • Cause : une ou plusieurs adresses e-mail de destinataires appartiennent à un domaine qui ne figure pas dans la liste d'autorisation des domaines de messagerie de votre instance Looker.
    • Résolution : Ajoutez le domaine du destinataire à la liste d'autorisation des adresses e-mail d'administrateur ou modifiez le workflow pour supprimer les adresses e-mail non autorisées.

Erreurs liées aux agents et aux entités

  • Agent execution failed: unexpected message received :
    • Cause : L'agent de données Gemini a rencontré une erreur d'exécution ou une réponse inattendue lors de l'interprétation des directives ou de la génération du résumé des insights en langage naturel.
    • Solution : Examinez et affinez les directives en langage naturel dans la configuration du workflow pour vous assurer que les instructions sont claires et spécifiques.
  • entity WorkflowAgent missing :
    • Cause : L'agent de données principal, le tableau de bord ou l'exploration associés au workflow ont été supprimés, renommés ou modifiés.
    • Solution : Recréez ou mettez à jour le workflow avec un agent de données actif ou un accès à Explore.

Erreurs liées aux autorisations utilisateur et au compte

  • Échecs d'autorisation utilisateur ou d'accès au modèle :
    • Cause : L'utilisateur qui a créé le workflow n'a pas accès aux modèles sous-jacents à l'exploration ou au tableau de bord.
    • Solution : Assurez-vous que le propriétaire du workflow dispose des autorisations requises dans Admin > Utilisateurs / Rôles, ou recréez le workflow sous un utilisateur actif et autorisé.
  • Compte utilisateur désactivé :
    • Cause : Le compte utilisateur Looker du propriétaire du workflow a été désactivé.
    • Solution : Réactivez le compte utilisateur ou recréez le workflow sous un utilisateur actif.

Erreurs liées à la file d'attente et au délai d'inactivité du planificateur

  • Job is no longer processing @<state> (où <state> est execute ou deliver) ou Job was expected to dequeue by @<time> :
    • Cause : le workflow est resté dans la file d'attente du programmateur pendant une heure ou plus sans être terminé, généralement en raison de délais avant expiration temporaires de la connexion à la base de données ou de contraintes liées aux ressources système.
    • Résolution : Le workflow tentera de s'exécuter à nouveau lors de son prochain intervalle planifié. Vous pouvez également relancer les exécutions ayant échoué de manière programmatique à l'aide de l'API Looker (run_scheduled_plan_once).