# Logs y auditoría


> Canales de logs, modlog, historial de infracciones y alertas por mensaje directo.


- URL: https://nearsecurity.citymoon.org/docs/seguridad/logs
- Sección: Seguridad
- Idioma: Español
- Palabras clave: logs, auditoría, modlog, securitylogs, alertas, dm, eventos

NearSecurity registra eventos del servidor, acciones de moderación y violaciones de seguridad. Hay tres destinos distintos y conviene no mezclarlos: logs de auditoría, canal de moderación e historial interno de infracciones.


### Tipos de registro


| Registro | Dónde se configura | Qué contiene |
| --- | --- | --- |
| Logs de auditoría | **Logs → Canal de Logs** o `/setup logs` | Eventos de canales, roles, miembros, mensajes, webhooks, servidor y modo pánico. |
| Modlog | **Moderación → Canal de Moderadores** | Sanciones y acciones automáticas con contexto para el staff. |
| Historial de infracciones | Interno del bot | Metadatos de violaciones: usuario, tipo, severidad, fecha y canal. |
| Alertas por MD | **Logs → Alertas por DM al Fundador** | Avisos directos al propietario ante intrusiones críticas. |


### Eventos de logs


| Evento | Valor inicial |
| --- | --- |
| Canal creado | Activado |
| Canal eliminado | Activado |
| Canal editado | Activado |
| Rol creado | Activado |
| Rol eliminado | Activado |
| Rol editado | Activado |
| Usuario entra | Activado |
| Usuario sale | Activado |
| Usuario editado | Activado |
| Mensaje eliminado | Activado |
| Mensaje editado | Activado |
| Webhook editado | Activado |
| Servidor editado | Activado |
| Modo Pánico | Activado |
| Sanciones | Activado |


### Historial de infracciones


El historial interno se consulta con `/securitylogs`. Permite ver las violaciones de un usuario, las estadísticas del servidor y limpiar registros por tipo. A diferencia del modlog, no se publica en un canal: se muestra bajo demanda a quienes tienen `Gestionar mensajes`.


| Comando | Función |
| --- | --- |
| `/securitylogs usuario` | Historial de un usuario, agrupado por tipo. |
| `/securitylogs servidor` | Totales, últimos siete días, tipos, severidades y usuarios con más registros. |
| `/securitylogs limpiar` | Elimina registros por usuario o tipo. |


### Buenas prácticas


- Usá un canal privado solo para el staff; los logs pueden contener IDs y datos sensibles.
- Separar logs de auditoría y modlog facilita la búsqueda durante un incidente.
- Verificá que el bot pueda escribir en ambos canales antes de activar sanciones automáticas.
- Revisá el historial de infracciones antes de aplicar una sanción larga.
- No compartas capturas de logs con datos personales fuera del equipo.


> **Retención**
> El historial de infracciones se guarda en la base de datos del bot y puede limpiarse con `/securitylogs limpiar`. Los mensajes de Discord se conservan según la configuración del servidor, no del bot.
