La page Serveur concerne Asterobot lui-même plutôt que vos bots. Son onglet État vous indique si Asteroboard est connecté et à quel Asterobot il parle, et son onglet Console affiche le journal d'Asterobot en direct. Le terminal dans lequel tourne Asterobot affiche le même journal, avec un peu plus de détails.
L'onglet État
Dans la barre latérale, cliquez sur Serveur : l'onglet État s'ouvre en premier. Il comporte quatre parties, de haut en bas.
État de la connexion
Un gros point accompagné d'un mot indique où en est la connexion d'Asteroboard à Asterobot :
| État | Point | Ce que cela signifie |
|---|---|---|
| Connecté | Vert, pulsant | Asteroboard est connecté et reçoit tout en direct. |
| Connexion en cours… | Ambre | Asteroboard essaie de se connecter. |
| Déconnecté | Rouge | Asteroboard ne parvient pas à joindre Asterobot. Il réessaie toutes les secondes. |
Si Asteroboard reste Déconnecté, consultez Asteroboard ne se connecte pas.
La carte Connexion
| Ligne | Ce qu'elle affiche |
|---|---|
| URL du serveur | L'adresse qu'utilise Asteroboard pour joindre Asterobot, définie dans Préférences. |
| Version | La version d'Asterobot, pas celle d'Asteroboard. |
| Transport | Chiffré (HTTPS) quand l'URL du serveur commence par https://, sinon Non chiffré (HTTP). |
| Authentification | Protégé par mot de passe quand server.basicAuth contient au moins un identifiant, sinon Sans mot de passe. |
Transport est déduit de l'adresse qu'utilise Asteroboard, et Authentification du réglage enregistré. Comme server.basicAuth ne prend effet qu'après un redémarrage, Protégé par mot de passe peut s'afficher avant que le mot de passe soit réellement exigé. Asteroboard sur un autre appareil explique HTTPS et les mots de passe.
La carte Débogage
La carte Débogage donne des chiffres techniques sur l'Asterobot en cours d'exécution. Vous n'en avez pas besoin au quotidien, mais quelqu'un qui vous aide peut vous en demander quelques-uns.
| Valeur | Ce que c'est |
|---|---|
| CPU | Le nombre de cœurs de processeur qu'Asterobot peut utiliser. |
| Goroutines | Le nombre de tâches en cours dans Asterobot à cet instant. |
| Appels Cgo | Un compteur technique, utile seulement pour le dépannage. |
| Version de Go | La version de Go, le langage de programmation avec lequel Asterobot est construit. |
| OS | Le système pour lequel cet Asterobot a été compilé : windows, darwin pour macOS, ou linux. |
| Architecture | Le type de processeur pour lequel il a été compilé : amd64 ou arm64. |
| Compilateur | Le compilateur utilisé pour le construire. |
| Alloué et Tas alloué | La mémoire qu'Asterobot utilise pour ses données en ce moment. |
| Total alloué | Toute la mémoire qu'Asterobot a utilisée pour ses données depuis son démarrage, cumulée, y compris celle qu'il a déjà libérée. |
| Mémoire système | La mémoire qu'Asterobot a réservée auprès de votre système. |
Les chiffres sont lus au chargement de la carte, puis de nouveau après Libérer la mémoire maintenant. Ils ne se mettent pas à jour d'eux-mêmes.
Libérer la mémoire maintenant demande à Asterobot de rendre tout de suite la mémoire dont il ne se sert plus, au lieu d'attendre qu'il le fasse de lui-même. Comme l'indique la carte, cela ne devrait normalement pas être nécessaire. Asteroboard confirme avec Collecte des déchets déclenchée, ou affiche Impossible de déclencher la collecte des déchets.
Éteindre Asterobot
La carte Extinction arrête Asterobot : « Arrête le serveur Asterobot. Ne faites cela que si vous savez comment le redémarrer. »
- Cliquez sur Éteindre le serveur.
- La fenêtre Éteindre le serveur ? vous rappelle qu'Asteroboard ne peut pas redémarrer Asterobot : à moins qu'il soit configuré pour redémarrer tout seul, quelqu'un doit avoir accès à l'ordinateur sur lequel il tourne. Cliquez sur Oui, éteindre, ou sur Annuler.
Asteroboard affiche Extinction demandée, et Asterobot s'arrête environ deux secondes plus tard, en fermant tout proprement comme avec Ctrl+C dans son terminal. Asteroboard affiche ensuite Déconnecté. Si la demande n'arrive pas jusqu'à Asterobot, Asteroboard affiche Impossible d'éteindre le serveur et rien ne s'arrête.
Arrêter Asterobot déconnecte tous les bots, y compris un bot qui relaie le jeu auquel vous jouez. Premier lancement explique comment le relancer.
L'onglet Console
Serveur > Console affiche le journal d'Asterobot en direct : ce qu'il fait, les avertissements et les erreurs qu'il rencontre, et les lignes que les scripts écrivent avec asterobot:console.
Ce qu'il affiche
Chaque ligne affiche l'heure, dans le fuseau horaire de votre navigateur, le niveau (DEBUG, INFO, WARN ou ERROR) et le texte. Seulement le texte : les détails que le terminal affiche après un message, comme l'adresse dans Server listening, n'apparaissent pas ici. Les lignes écrites par un script avec asterobot:console n'indiquent pas quel bot les a écrites. Les lignes propres à un bot se trouvent dans son propre onglet Console (Console).
L'onglet Console ne contient que ce qui est arrivé pendant qu'Asteroboard était ouvert. Asterobot ne lui garde aucun historique, donc les lignes antérieures à l'ouverture d'Asteroboard n'y figurent pas : cherchez-les dans le terminal. Asteroboard garde les 500 dernières lignes, les oublie quand vous rechargez ou fermez la page, et les efface quand vous changez son URL du serveur. Tant que rien n'est arrivé, la console indique « Aucun message pour le moment. »
L'extrémité droite de la barre du haut indique si Asteroboard est connecté : Connecté, Connexion en cours… ou Déconnecté.
Afficher et masquer des niveaux
Les quatre boutons du haut, Debug, Info, Avertissement et Erreur, affichent ou masquent les lignes de chaque niveau. Un bouton plein signifie que ses lignes sont affichées. Asteroboard retient votre choix dans ce navigateur.
Ces boutons ne filtrent que les lignes qu'Asteroboard a déjà reçues. Les lignes sous le niveau serveur n'arrivent jamais jusqu'à lui.
Niveau serveur
La liste Niveau serveur, à côté des boutons, définit logger.webLevel : le niveau le plus bas qu'Asterobot envoie à la console. Comme le précise son infobulle, tout ce qui est en dessous n'arrive jamais ici, quels que soient les boutons.
Il vaut INFO par défaut : les lignes de débogage n'arrivent donc pas dans la console tant que vous ne choisissez pas DEBUG. Le changement s'applique immédiatement, pour tous les Asteroboard, et reste valable après un redémarrage d'Asterobot, puisque c'est un réglage enregistré. S'il ne peut pas être enregistré, Asteroboard affiche Impossible de mettre à jour le niveau de journalisation du serveur.
Envoyer un message
La zone du bas, « Envoyer un message à la console du serveur... », écrit une ligne dans le journal d'Asterobot lui-même.
- Tapez votre texte.
- Choisissez son niveau dans la liste sous la zone : Info par défaut.
- Appuyez sur Entrée, ou cliquez sur le bouton d'envoi.
Asterobot journalise votre texte comme l'une de ses propres lignes. Il apparaît dans le terminal si son niveau est supérieur ou égal à celui du terminal, et dans tous les onglets Console ouverts s'il est supérieur ou égal au niveau serveur : un message Debug ne s'affiche jamais tant que le niveau serveur est INFO. Si le message ne peut pas être envoyé, Asteroboard affiche Impossible d'envoyer le message.
Un message permet de marquer un moment dans le journal, par exemple juste avant de reproduire un problème pour un rapport de bug.
Le terminal
Le terminal dans lequel tourne Asterobot affiche son journal dès la toute première ligne, y compris tout ce qui précède l'ouverture d'Asteroboard. Chaque ligne commence par la date et l'heure, puis le niveau et le message, suivis de ses détails sous forme de paires name=value, en couleur.
La quantité de lignes affichées dépend de logger.cliLevel, dans Serveur > Config. Le changement s'applique immédiatement, et il est indépendant du niveau de la console : vous pouvez garder un terminal discret et une console détaillée, ou l'inverse.
Certains éléments du terminal ne sont pas des lignes de journal et s'affichent toujours, quel que soit le niveau : le QR code d'un lien de connexion, les barres de progression des commandes, et ce qu'affichent des commandes comme gamemanager list.
Asterobot n'écrit aucun fichier de journal. Quand vous fermez la fenêtre du terminal, ses lignes sont perdues.
Choisir un niveau de journalisation
logger.cliLevel et logger.webLevel prennent les mêmes quatre valeurs. Chaque niveau affiche ses propres lignes et celles de tous les niveaux au-dessus :
| Niveau | Ce que vous voyez |
|---|---|
DEBUG |
Tout, y compris des lignes détaillées destinées au dépannage. |
INFO |
L'activité normale. C'est la valeur par défaut des deux réglages. |
WARN |
Les avertissements et les erreurs uniquement. |
ERROR |
Les erreurs uniquement. |
Passez à DEBUG quand vous cherchez la cause d'un problème ou que quelqu'un qui vous aide demande un journal détaillé, puis revenez à INFO : les lignes de débogage sont nombreuses et noient les lignes utiles.