# Logs

## ¿Qué son los Logs?

Los Logs son un **registro detallado de todo lo que sucede** en tu servidor. Es como tener una cámara de seguridad, pero para eventos digitales. Todo se guarda en un canal especial que solo los admins pueden ver.

### Casos de Uso

* ✅ Auditar acciones de miembros
* ✅ Detectar comportamiento sospechoso
* ✅ Investigar problemas
* ✅ Mantener seguridad del servidor
* ✅ Ver quién hizo qué y cuándo

***

## 🚀 Configuración Básica (Para Usuarios Nuevos)

{% stepper %}
{% step %}

#### Crear un Canal de Logs

1. Abre Configuración del Servidor → Canales
2. Crea un nuevo canal: `#logs` o `#auditoria`
3. **Privado:** Solo admins deben verlo
   {% endstep %}

{% step %}

#### Activar Logs

Usa este comando:

```bash
/logs setup #logs
```

**Explicación:**

* `/logs` = comando principal
* `setup` = activar
* `#logs` = canal donde guardar registros
  {% endstep %}

{% step %}

#### ¡Listo!

El bot ahora registrará:

* ✅ Mensajes eliminados
* ✅ Mensajes editados
* ✅ Miembros que se unen/salen
* ✅ Cambios de roles
* ✅ Cambios de canales
* ✅ Bans/Kicks
* ✅ Y mucho más...

#### Desactivar (si lo necesitas)

```bash
/logs disable
```

{% endstep %}
{% endstepper %}

***

## 📊 ¿Qué se Registra?

### Acciones de Miembros

* ✅ Se unió al servidor
* ✅ Se fue del servidor
* ✅ Cambio de rol
* ✅ Cambio de nombre (en el servidor)
* ✅ Cambio de avatar
* ✅ Fue silenciado/muteado
* ✅ Fue expulsado/baneado

### Cambios en Canales

* ✅ Canal creado
* ✅ Canal eliminado
* ✅ Canal renombrado
* ✅ Cambios de permisos
* ✅ Tópico cambiado

### Cambios en Roles

* ✅ Rol creado
* ✅ Rol eliminado
* ✅ Rol renombrado
* ✅ Cambios de permisos

### Acciones de Mensajes

* ✅ Mensaje eliminado
* ✅ Mensaje editado
* ✅ Reacciones añadidas

### Cambios del Servidor

* ✅ Cambio de nombre
* ✅ Cambio de icono
* ✅ Cambios de configuración
* ✅ Cambios de regiones

***

## ⚙️ Opciones Avanzadas

### Ver Logs Existentes

```bash
/logs setup #nuevo-canal
```

Cambiará el canal donde se guardan futuros logs.

### Ver Información de Logs

```bash
/logs status
```

Muestra:

* ✅ Canal activo
* ✅ Fecha de activación
* ✅ Cantidad de registros

***

## 📝 Ejemplo de Registro

Cuando alguien es baneado, verás algo como:

```
⛔ USUARIO BANEADO
Autor: Admin#1234
Usuario: Troll#5678
Razón: Spam masivo
Timestamp: 15/03/2024 14:32 UTC
```

***

## 🔍 Solución de Problemas

| Problema                   | Solución                                       |
| -------------------------- | ---------------------------------------------- |
| **No aparecen logs**       | Verifica permisos en el canal                  |
| **Faltan eventos**         | Algunos eventos requieren permisos adicionales |
| **Canal lleno**            | Considera archivar logs antiguos               |
| **No veo ciertos cambios** | El bot necesita permisos de "Ver Auditoría"    |

***

## 🔐 Seguridad & Privacidad

⚠️ **Importante:**

* Los logs contienen información sensible
* Solo admins deben acceder a este canal
* Los logs NO incluyen contenido privado de DMs
* Se almacenan localmente en tu servidor

***

## 💡 Mejores Prácticas

### ✅ Haz

* Revisa logs regularmente
* Invita a mods a ver logs
* Usa logs para decisiones administrativas
* Investiga comportamientos sospechosos

### ❌ No hagas

* Mostrar logs públicamente
* Borrar logs importantes
* Ignorar actividad sospechosa
* Confiar solo en logs (verifica siempre)

***

## 📝 Ejemplo Práctico

**Escenario:** Investigar spam en el servidor

1. Abre #logs
2. Busca mensajes del usuario sospechoso
3. Revisa timestamps (¿spam repetido?)
4. Verifica si fue silenciado/baneado
5. Toma decisión (kick/ban/advertencia)

***

## 🎯 Combina con Otros Sistemas

* **+ Moderación:** Registra warns, bans, kicks
* **+ AutoReply:** Registra cambios
* **+ Anti-Raid:** Detecta intentos de ataque

***

## 📞 ¿Problemas?

1. Asegúrate que el bot tiene permisos de **"Ver Auditoría"**
2. Verifica que puede **"Enviar Mensajes"** en el canal
3. Comprueba que el canal es privado
4. Pide ayuda en [soporte](https://discord.gg/2ZKdT6SRsZ)

***

## 🔗 Relacionado

* [Moderación](broken://pages/fe18b6ecfe25b249f232e3c0c2e73e5b5da6e14a)
* [Anti-Raid](broken://pages/6d2b194374fcda230c134a25a1076fb36e2583a8)
* [Tickets](broken://pages/539f603b2f90536fb03455efed81847ff5488fbc)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://okaa.gitbook.io/okaa-wiki/configuracion/logs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.