Suivre ses Blueprints
L'accueil
La page d'accueil d'un serveur résume son état en une phrase (« Café Pixel tourne bien, à deux détails près. ») et sa semaine en une autre. Dessous, chaque bloc mène à sa page :
- À regarder : une ligne par point, les demandes d'accès (pour le propriétaire et les gestionnaires), un Blueprint suspendu, une permission qui manque au bot pour un Blueprint en ligne, des exécutions abandonnées, des modifications pas encore déployées ;
- la semaine : les exécutions des 7 derniers jours et l'écart avec la semaine d'avant ;
- les crédits, partagés entre les Blueprints en ligne ;
- les Blueprints par statut, et les plus actifs (ou, sans les analytics, les derniers modifiés) ;
- l'équipe et les dernières activités, pour le propriétaire et les gestionnaires.
Chacun ne voit que ce que ses permissions lui ouvrent : sans les analytics, pas de semaine ; avec les analytics seulement, la semaine en grand. Avec l'accès au dashboard seul, l'accueil dit qu'aucune permission n'est encore donnée, et qu'il faut en demander à un gestionnaire sur Discord.
Un serveur qui n'a encore rien mis en ligne affiche plutôt ses premiers pas, selon tes droits : créer, tester, mettre en ligne (ou le faire mettre en ligne par qui peut déployer), donner des droits à l'équipe.
Analytics
La page Analytics montre le serveur sur 7, 14 ou 30 jours, chaque fois face à la période d'avant : les exécutions, les membres différents qui en ont causé, la part des réussies et la durée moyenne, chacun avec sa petite courbe. Clique sur l'un d'eux pour le voir jour par jour en grand, la période d'avant en pointillés. Pour les réussies, chaque jour est une barre découpée en trois résultats, les mêmes que dans le journal :
- Réussie : chaque node a suivi son chemin de succès ;
- Un node a échoué : l'exécution est allée au bout, mais une Action a pris sa sortie Échec. Le « Non » d'une Condition n'est pas un échec : le détail de l'exécution dit en une phrase comment elle a répondu ;
- Arrêtée : l'exécution s'est interrompue (délai dépassé, boucle…).
Dans le détail d'une exécution, une Action en échec dont la sortie Échec mène à la suite est dite rattrapée : le Blueprint a géré, mais ça reste un échec, compté comme tel.
Quand une commande, un bouton ou un menu finit en échec sans avoir répondu, le membre lit « Une erreur est survenue : la commande n'a pas pu aller au bout. », que lui seul voit ; le détail de l'exécution le rappelle. Pour lui dire autre chose, mets un Répondre à l'interaction sur le chemin d'échec. Une commande que le bot refuse parce qu'il est trop sollicité lui répond « Le bot est très sollicité, réessaie dans un instant. ».
Dessous : quand ton serveur est actif (chaque jour de la semaine par tranches de 4 heures, à ton heure), la part de chaque Blueprint, les exécutions par Event et les erreurs les plus fréquentes, chacune avec son Blueprint et un lien vers les exécutions où elle est arrivée.
Un clic sur un Blueprint ouvre ses propres analytics, aussi dans l'éditeur (menu du logo, Blueprint ▸ Analytics) : les mêmes quatre chiffres et leurs jours, les exécutions par Event et les erreurs les plus fréquentes, avec leur explication et un lien vers les exécutions où elles sont arrivées. Seules les exécutions du Blueprint déployé comptent, pas les tests ; une suite reprise après une attente compte comme une exécution.
Sur le canvas
Dans l'éditeur, Affichage ▸ Statistiques sur le canvas met sous chaque node combien de fois il a tourné et échoué sur les 7 derniers jours. Une pastille en pointillés dit « Jamais exécuté » ; une pastille rouge, plus de 1 % d'échecs. Les statistiques viennent du détail des exécutions, gardé 7 jours pour un succès et pour les 500 dernières exécutions au plus : pour un Blueprint très actif, le bandeau dit sur combien d'exécutions elles portent. Les préférences du compte peuvent les afficher dès l'ouverture.
Le journal
Le journal demande la permission Voir les exécutions : il contient les données traitées, comme les messages des membres.
La page Exécutions du serveur liste les exécutions de tous tes Blueprints, filtrables par résultat, Blueprint, membre, erreur, source et période : c'est là qu'on cherche ce qui est arrivé à un membre, ou toutes les erreurs du serveur. Une exécution s'ouvre dans l'éditeur de son Blueprint. Allume « Suivre en direct » pour y voir en haut les exécutions en cours, puis chacune une fois terminée, tant que la page reste ouverte. Sur un serveur très actif, les nombres s'arrêtent à « 10 000+ », et les filtres proposent ce qu'on trouve dans les 10 000 exécutions les plus récentes ; la liste, elle, les montre toutes.
La section Exécutions de l'éditeur liste celles d'un Blueprint, en direct puis dans le journal, filtrable par résultat, par source (déployé ou test), et par erreur depuis les analytics. Clique sur une exécution : sa trace, node par node, se lit à droite, et Montrer l'affiche sur le canvas. Le résumé d'une exécution est gardé 90 jours ; son détail 7 jours pour un succès, 30 jours sinon.
Les notifications
La cloche, à côté de ton compte en bas de la barre latérale (en haut à droite sur la liste des serveurs), te prévient de ce qui t'attend ou casse sur tes serveurs, tous ensemble :
- une demande d'accès à un serveur dont tu gères l'équipe ;
- un Blueprint suspendu par Discord, des exécutions abandonnées (une notification par heure), le bot qui a perdu une permission dont un Blueprint en ligne a besoin, si tu gères l'équipe du serveur ou peux modifier ses Blueprints ;
- ta demande d'accès acceptée ou refusée, et la réponse de l'équipe Tsuaa à tes demandes.
Un clic mène à la page qui y répond. Dans Paramètres ▸ Notifications, choisis pour chacune si tu la veux dans la cloche, par e-mail, ou les deux. Par défaut, l'e-mail ne part que pour ce qui t'attend : une demande d'accès, sa réponse, la réponse de l'équipe. Les notifications sont gardées 90 jours.