Bots de DiscordTu bot se cayó a las cuatro de la mañana y la consola ya se ha ido scrolleando. Registrar es la diferencia entre «se volvió a romper» y «se rompió a las 04:12 en el comando de tickets, con esta entrada», y son unos diez minutos de trabajo, una vez.
Pasar de nada a algo útil
- Captura lo que ahora muere en silencio
En Node,
process.on("unhandledRejection", console.error)yprocess.on("uncaughtException", console.error). En Python, envuelve tu punto de entrada y registra la excepción. Las muertes silenciosas se convierten en motivos. - Escribe a un archivo, no solo a la consola
La consola es una vista en vivo que se esfuma. Un archivo en el directorio de tu bot sigue ahí mañana, que es cuando de verdad vas a mirar.
- Ponle marca de tiempo a cada línea
«Un error» no sirve. «Un error a las 04:12» se puede cruzar con un reinicio, una caída de Discord o el momento en que alguien ejecutó un comando.
- Registra en los bordes
Cuando empieza un comando, cuando vuelve una llamada externa, cuando se escribe algo. El medio de tu código rara vez necesita una línea; los bordes siempre.
Una línea de depuración que imprime tu configuración imprime tu token, y ese archivo de registro puede acabar en un ticket de soporte o en una captura. Lo mismo vale para el contenido de los mensajes y los identificadores de usuario: registra lo que necesites para depurar, no todo lo que resulte que tenías en una variable.
Qué merece la pena registrar
| Evento | ¿Registrarlo? |
|---|---|
| Arranque e inicio de sesión correcto | Sí. Le pone hora a cada sesión. |
| Cada ejecución de comando | En un bot pequeño sí; en uno concurrido se vuelve ruido. |
| Cada error, con su traza | Siempre. |
| Llamadas a APIs externas que fallaron | Sí, con el código de estado. |
| El contenido de cada mensaje que ve | No. El volumen y la privacidad están los dos en contra. |
Un bot que registra cada evento escribe sin parar. O usas una librería de registro que rote a diario, o vacías el archivo con una tarea programada. Descubrir que un archivo de registro te ha llenado el disco es una forma evitable de perder una tarde.
Provoca un error a propósito, reinicia el bot, y comprueba que el archivo de registro sigue conteniéndolo con su marca de tiempo.