Configuración remota
Los ajustes que cada agente toma del panel: intervalos de envío, latido, métricas y AFK, los nueve módulos, la pausa, y cómo y cuándo recoge un agente un cambio.
Casi todo lo que recoge el agente se decide en el panel, en Ajustes → Agente, para todo el espacio de trabajo a la vez. Los agentes aplican un cambio sin reiniciar.
Los intervalos
| Ajuste | Por defecto | Permitido | Qué hace |
|---|---|---|---|
| Enviar cada | 10 s | 5–300 s | Cada cuánto se vuelca la cola y se envía. Un lote también sale en cuanto hay 500 eventos esperando. |
| Latido cada | 60 s | 15–600 s | Cada cuánto informa cada servidor de que sigue vivo y de cuántos jugadores tiene. Tres latidos perdidos marcan un servidor como sin señal y cierran sus sesiones abiertas. |
| Métricas cada | 60 s | 10–600 s | Cada cuánto se resumen TPS, MSPT, CPU y memoria en una fila. |
| AFK tras | 300 s | 30–3.600 s | Cuánto tiempo sin hacer nada necesita un jugador para contar como AFK: sin moverse, sin mirar alrededor, sin chat, sin comandos, sin interactuar. |
Los intervalos de latido y de métricas se cuentan en las muestras de un segundo del propio agente. En un servidor Paper esas se toman cada 20 ticks, así que un servidor con mucho lag informa con menos frecuencia de lo que dice el ajuste.
Los módulos
Cada módulo está activado por defecto. Desactivar uno hace que cada agente descarte esos datos antes de encolarlos: no se guarda, no se vuelca al spool y no se envía nada de ellos.
| Módulo | Qué cubre |
|---|---|
| Sesiones | Sesiones de red (conexión, cliente, cambio de servidor, desconexión) y las entradas y salidas de cada servidor, con sus contadores de actividad. |
| AFK | Inicio y fin del AFK. |
| Rendimiento | Las métricas periódicas: TPS, MSPT, CPU, memoria, entidades, chunks. |
| Sanciones | LiteBans, LibertyBans y AdvancedBan. |
| Votos | Votos de NuVotifier. |
| Rangos | Cambios de rango de LuckPerms. |
| Placeholders | Valores de PlaceholderAPI indicados en el config.yml de cada servidor. |
| Economía | Dinero creado, destruido y en manos de los jugadores, por moneda — flujos, saldos y masa monetaria. |
| Eventos personalizados | Eventos que otros plugins envían a través de la API. |
Los arranques y paradas de los servidores, los latidos y la lista de servidores del proxy se envían siempre: el panel los necesita para saber que un servidor existe.
Sin Sesiones no hay sesiones de red, así que casi todas las páginas de analítica se quedan vacías: jugadores activos, retención, adquisición y tiempo de juego se construyen a partir de ellas.
Pausar un servidor
Los ajustes del espacio se aplican a todos los servidores. Para parar uno, usa Servidores →
Pausar: el agente deja de recoger y de enviar del todo hasta que se reanude. Ver
Servidores — incluido por qué un servidor reanudado
necesita /analytics reload o un reinicio.
Cómo recoge un agente un cambio
El panel sube una revisión
Guardar los ajustes del agente, o pausar un servidor, sube la revisión de configuración de ese servidor.
El agente se entera
Cada lote que acepta el ingest se responde con la revisión actual. Cuando difiere de la del agente, el agente vuelve a descargar los ajustes en el acto.
Y guarda una copia
Los ajustes descargados se guardan en data/remote-config.json, así que tras reiniciar el agente
recoge con ellos antes de poder llegar al ingest.
Un agente también descarga sus ajustes en cada arranque, justo después de vincularse y con
/analytics reload. Si la descarga falla lo vuelve a intentar cada minuto. Un valor que el panel no envía
conserva el valor por defecto del agente, que es el mismo que el del panel.
El propio ingest tarda hasta 30 segundos en ver un cambio, así que cuenta con eso más un intervalo de envío.
¿Falta algo en esta página? Dínoslo en Discord