Sistema de Registro
Rastrea todo lo que sucede en tu servidor con 55 tipos de eventos organizados en 18 categorías, enrutamiento de canales por categoría y colores de incrustación personalizados, todo configurado desde el panel de control.
Topics: logs, logging, audit, events, tracking
Rastrea todo lo que sucede en tu servidor con 55 tipos de eventos organizados en 18 categorías, enrutamiento de canales por categoría y colores de incrustación personalizados, todo configurado desde el panel de control.
Resumen
El sistema de registro registra eventos del servidor y publica incrustaciones detalladas en los canales que elijas. Es la columna vertebral de la responsabilidad de moderación y la visibilidad general: quién se unió, qué se eliminó, qué roles cambiaron, quién fue baneado y mucho más.
Todo se configura desde Panel de control → Registros. Nada está habilitado por defecto: decides exactamente qué categorías rastrear y a dónde se envía cada una. Para un acceso directo de un solo comando que activa todo en un solo canal, consulta los comandos de registros.
Habilitación y configuración básica
- Abre Panel de control → Registros para tu servidor.
- Activa Activo en el encabezado de la página para encender el sistema.
- Utiliza el selector de Canal de registro general en el encabezado para enviar *todas* las categorías a un canal, la forma más rápida de comenzar.
- O expande cualquier categoría a continuación para darle su propio canal y activarlo.
Consejo: Netrcol necesita Ver Canal, Enviar Mensajes, Incrustar Enlaces y Leer Historial de Mensajes en cada canal al que registres. La verificación de salud de configuración en la página te advertirá si falta algún permiso.
Canales por categoría
Cada categoría es una fila expandible con su propio selector de canal y interruptor de encendido/apagado. Esto te permite dividir tus registros entre canales: por ejemplo, registros de moderación en un canal privado para el personal y registros de uniones/salidas en uno público.
Si cada categoría apunta al mismo canal, el selector de encabezado Canal de registro general muestra ese canal; si son diferentes, muestra *“Los canales son diferentes.”* Configurarlo nuevamente vuelve a apuntar todo a un solo canal.
Colores de incrustación
Cada evento tiene una franja de color que puedes personalizar. Abre una categoría, y cada fila de evento tiene una muestra de color, útil para distinguir las categorías de un vistazo (por ejemplo, rojo para moderación, verde para uniones).
Categorías de registro
Netrcol agrupa sus 55 tipos de eventos en estas 18 categorías:
| Categoría | Lo que registra |
|---|---|
| Bot | Registros de interacción del bot y ciclo de vida del gremio |
| Moderación | Registros de baneo, desbaneo, automod y acciones del personal |
| Mensaje | Registros de eliminación, edición y eliminación masiva de mensajes legibles |
| Reacción | Actividad de añadir y eliminar emojis |
| Miembro | Uniones, salidas, actualizaciones de roles, cambios de apodo y tiempos de espera |
| Canal | Creación, eliminación, renombrado, cambios de tema y categoría de canal |
| Rol | Registros de creación, actualización y eliminación de roles |
| Voz | Cambios en el estado de voz (los eventos de voz de depuración requieren una bandera de opt-in) |
| Invitación | Registros de creación y eliminación de invitaciones |
| Servidor | Cambios en la configuración, nombre y estructura del servidor |
| Activo | Registros de actualización de emojis y stickers |
| Webhook | Eventos de actualización de webhook |
| Seguridad | Actividad riesgosa y registros del sistema de protección |
| Integración | Eventos de actualización de integración del gremio |
| Evento Programado | Registros de creación, actualización y eliminación de eventos programados |
| Mensaje Anclado | Registros de actualización de anclaje de canal |
| Presencia | Registros de escritura y presencia (opt-in, alto volumen) |
| Usuario | Cambios en el perfil del usuario, mostrados una vez por gremio afectado |
Títulos inteligentes
Algunas categorías utilizan títulos más limpios y específicos en lugar de un genérico “Actualizado”. Las salidas de miembros, por ejemplo, intentan separar salió, expulsado y baneado; los cambios de canal de un solo campo utilizan un título preciso como “Tema del Canal Cambiado” en lugar de “Canal Actualizado”.
Enriquecimiento consciente de auditoría
Cuando los registros de auditoría del servidor están disponibles, los registros de Moderación y Miembros se enriquecen con el actor y la razón de auditoría, por lo que un registro de baneo puede mostrar *quién* lo emitió y *por qué*, no solo que ocurrió.
Configuración rápida desde el chat
Si solo quieres todo en un canal sin abrir el panel de control:
!logs-setup 123456789012345678Esto habilita las 18 categorías y las apunta a ese canal. Apaga todo el sistema con:
!logs-disableLos detalles completos están en la página de comandos de registros.
Notas y consejos
- Nada está activado por defecto. Tú eliges qué categorías rastrear: comienza con poco y añade más según sea necesario.
- Categorías de alto volumen. *Presencia* (escritura/presencia) está desactivado por defecto y es mejor dejarlo apagado a menos que estés depurando; también requiere una bandera de entorno de bot para emitir algo.
- Eventos de voz de depuración permanecen en silencio a menos que se habilite una bandera de opt-in global en el entorno del bot.
- Registros de usuario deduplicados. Un solo cambio de perfil se agrupa por gremio, incluso si varios mensajes en caché coinciden con ese usuario, por lo que no obtendrás entradas duplicadas.
- Caché de mensajes. Para mostrar contenido eliminado/editado, Netrcol mantiene una corta caché en memoria de mensajes recientes por servidor. Nunca se escribe en almacenamiento permanente; consulta la Política de Privacidad.
Próximos pasos
- Configúralo en Panel de control → Registros
- Revisa los comandos de registros
- Asegúrate de que Netrcol tenga los permisos correctos