Contenido generado con IA — puede contener errores.

ExyliaAnalytics/Cómo funcionaActualizada en v1.3.0

Qué recoge el agente

Cada evento que envía el agente, qué lado lo envía, cuándo y los campos que lleva — y cómo se encolan, guardan y entregan los eventos.

Página 16 de 2810 min de lectura

El agente envía hechos en bruto y deja la interpretación al ingest: los hostnames se normalizan, los países se consultan y las sesiones se cosen con la presencia al otro lado, así que un arreglo nunca espera a que todos los servidores se actualicen. Esta página lista todo lo que envía. Lo que no envía nunca está en Privacidad.

Lo envía usa P para un proxy, B para un backend y S para un servidor independiente. Cada evento lleva además el momento en que ocurrió y, si trata de un jugador, su UUID.

Ciclo de vida del servidor#

Se envían digan lo que digan los módulos, siempre que el servidor esté vinculado y no esté pausado.

EventoLo envíaCuándoDatos
server.startP B SCuando el agente empieza a recoger: al arrancar si está vinculado, justo tras vincularse y tras ser reanudado.Plataforma y su versión, versión de Minecraft (ninguna en un proxy), versión de Java, versión del agente, papel, modo online, puerto, jugadores máximos.
server.stopP B SEn un apagado limpio, después de cerrar cada sesión y estancia abiertas.—
server.heartbeatP B SCada intervalo de latido (60 s por defecto).Jugadores en línea.
proxy.serversPAl arrancar y cada vez que cambia la lista de servidores del proxy (se comprueba en cada latido).El nombre y la dirección host:puerto de cada servidor registrado.

Sesiones de red#

Las envía el proxy, o un servidor independiente. Un backend no abre sesiones. Módulo: Sesiones.

EventoCuándoDatos
session.startUn jugador se conecta (en Velocity tras el login, en Paper al entrar).Un id de sesión, nombre de usuario, dirección IP, el hostname tal cual lo escribió el cliente, versión del protocolo, si es un jugador de Bedrock, y su grupo principal de LuckPerms.
session.clientCuando la marca o el idioma del cliente se conocen por primera vez o cambian.Marca del cliente (Velocity; Paper 1.19.4 y posteriores) y/o idioma, como es_es.
session.switchUn jugador pasa a otro backend. Solo el proxy.El servidor que dejó (ninguno en la primera conexión) y al que entró, con los nombres del proxy.
session.endUn jugador se desconecta, o el servidor se apaga.Cómo terminó: quit, kick o shutdown.
  • Versión del protocolo. En Velocity, la del propio cliente. En un servidor Paper independiente, la respuesta de ViaVersion cuando está instalado (Paper daría su propia versión para todos los clientes); si no, la de Paper.
  • Bedrock. Se pregunta a Floodgate cuando está instalado; si no, un UUID de la forma 00000000-0000-0000-… cuenta como Bedrock.
  • Expulsión. Una expulsión por un plugin o el staff y, en Velocity, un inicio de sesión de la misma cuenta en otro lugar.
  • Los jugadores ya conectados cuando el agente empieza a recoger — tras vincularse o reanudarse — abren su sesión en ese momento.

Presencia en un servidor#

La envían los backends y los servidores independientes. Módulos: Sesiones para entradas y salidas, AFK para el AFK.

EventoCuándoDatos
server.joinUn jugador entra en este servidor.—
server.leaveUn jugador sale de él, o se apaga.Cómo terminó (quit, kick, shutdown) y la actividad de la estancia: mensajes de chat, comandos, muertes, asesinatos de jugadores y logros conseguidos (sin recetas ni logros ocultos), más los segundos desde la entrada hasta el primer mensaje de chat y hasta el primer comando. Los comandos de login (/login, /register, /2fa…) cuentan como comandos, pero nunca como el primero. En un servidor Paper o Spigot lleva además el mundo y la posición de bloque (x, z) donde salió el jugador; los proxies no envían ninguna. Nuevo en v1.3.0
afk.startUn jugador no ha hecho nada durante el tiempo AFK (300 s por defecto).—
afk.endSe mueve, mira alrededor, escribe, ejecuta un comando o interactúa de nuevo — o sale estando AFK.—

Los contadores de actividad son solo recuentos. Un mensaje de chat cancelado por otro plugin no cuenta; una baja solo cuenta cuando quien mata es otro jugador.

Historial de jugadores#

EventoLo envíaMóduloDatos
player.historyB SSesionesLa primera y la última vez que una cuenta jugó en este servidor, su último nombre conocido y su tiempo de juego total.

Un servidor que llevaba tiempo funcionando antes de vincularse ya conoce a sus jugadores, así que el panel nunca cuenta a un veterano como nuevo:

  • Una vez por id de servidor vinculado, justo después de vincular o en el primer arranque con esta versión, se leen todos los <world>/playerdata/*.dat y <world>/stats/<uuid>.json del mundo principal en un hilo propio de baja prioridad, a unos 100 jugadores por segundo, con pausa mientras más de 2.000 eventos esperan para enviarse. No toca el hilo principal. Una importación terminada escribe data/history-imported; una interrumpida vuelve a empezar en el siguiente arranque.
  • En la primera entrada de un jugador que vuelve tras cada arranque, desde el jugador en línea.

import-history: false en config.yml desactiva ambas cosas.

Rendimiento#

EventoLo envíaCuándoDatos
server.metricsP B SCada intervalo de métricas (60 s por defecto). Módulo: Rendimiento.TPS (medio y mínimo), MSPT (medio, p95 y máximo), CPU del proceso y de la máquina, heap usado y máximo, jugadores, entidades, chunks cargados.

Un proxy envía solo CPU, heap y jugadores. Lo que puede medir cada plataforma está en Servidores y rendimiento.

Integraciones#

Cada una se usa solo si su plugin está instalado. Ver Integraciones.

EventoLo envíaMóduloDatos
punishment.issueP B SSancionesEl jugador sancionado, el plugin, su id de entrada, el tipo (ban, mute, kick, warn), el UUID del miembro del staff (ninguno para la consola), el motivo, la duración (ninguna si es permanente) y si es un baneo de IP.
punishment.revokeP B SSancionesEl jugador, el plugin, el id de entrada, el tipo y quién la levantó.
vote.castQuien ejecute NuVotifierVotosLa web de votación tal como la nombra Votifier, el nombre de usuario que votó, y el UUID del jugador cuando está conectado a ese servidor.
rank.addP B SRangosEl grupo y cuándo caduca (ninguno si es permanente). También se envía cuando cambia la caducidad de un grupo temporal.
rank.removeP B SRangosEl grupo.
anticheat.flagB SAnticheatUna vez por minuto por jugador, anticheat y check: cuántos avisos, el nombre y el tipo del check y el nivel de violación más alto de ese minuto. Ver Integraciones.
player.discordB SSesionesLa cuenta de Discord vinculada mediante DiscordSRV o EssentialsX Discord Link: su id, nombre y avatar. Se lee al entrar y al salir; solo se envía un cambio.
player.placeholdersB SPlaceholdersLos valores de los placeholders indicados en config.yml, justo antes del server.leave del jugador.

Economía#

Solo Paper y Spigot. Módulo: Economía. Cómo se encuentran las fuentes y por qué cada cambio se cuenta una vez está en Economía.

EventoLo envíaCuándoDatos
economy.flowB SUna vez por minuto, uno por jugador, moneda y motivo que se movió.Moneda, motivo, número de cambios, total ganado, total gastado, el saldo tras el último cambio (cuando la fuente lo sabe) y la duración de la ventana.
economy.balanceB SAl entrar y al salir, y cada 10 minutos para las monedas de ExyliaLib.El saldo de un jugador en una moneda.
economy.supplyB SCuando un plugin lo envía a través de la API.Moneda, ámbito de almacenamiento, la suma de todos los saldos y cuántas cuentas tienen dinero.

Mercado#

EventoLo envíaCuándoDatos
market.tradeB SAl completarse cada operación que un plugin de mercado envía por la API. Por encima de 5.000 operaciones por minuto el resto se descarta y se registra cuántas.Mercado, acción, canal, comprador y vendedor (ninguno si es el servidor), id y nombre del ítem, cantidad, moneda, precio total, impuesto y comisión.
market.stateB SCuando un plugin de mercado envía una instantánea: una por ítem y moneda, como mucho 500 por instantánea y una instantánea por mercado y minuto.Mercado, ítem, moneda, anuncios, unidades y valor total y, en libros de órdenes, la mejor oferta de compra y de venta con su profundidad.

Ambos se descartan en el agente cuando el módulo Mercado está apagado.

Eventos personalizados#

EventoLo envíaMóduloDatos
customDonde un plugin llame a la APIEventos personalizadosEl nombre del evento y hasta 16 propiedades. Ver la API.

Cómo viajan los eventos#

En cola en memoria

Registrar un evento solo lo mete en una cola; el hilo del juego nunca espera al disco ni a la red. Un evento cuyo módulo está desactivado, o cualquier evento mientras el servidor está sin vincular o pausado, se descarta aquí. Por encima de 100.000 eventos en espera, los nuevos se descartan, con un aviso, hasta que la cola se vacía.

Escritos en el spool

Cada intervalo de envío (10 s por defecto), o en cuanto hay 500 eventos esperando, la cola se convierte en uno o más lotes de como mucho 5.000 eventos y 1 MiB, comprimidos y escritos en data/spool/<batchId>.json.gz antes del primer intento.

Entregados, del más antiguo al más nuevo

Un hilo en segundo plano envía el spool en orden y borra cada lote cuando el ingest lo acepta. Un lote reintentado es idéntico byte a byte y se guarda una sola vez.

Qué pasa con cada respuesta:

RespuestaQué hace el agente
AceptadoBorra el lote. Si cambiaron los ajustes del panel, los descarga.
Mal formadoLo registra y borra el lote: nunca podrá salir bien.
Token revocadoBorra sus credenciales, su cola y su spool, y vuelve a estar sin vincular.
Espacio de trabajo suspendidoLo guarda todo y reintenta cada 15 minutos.
Otro servidor tiene el tokenLo guarda todo, lo registra una vez y reintenta cada minuto.
Lote demasiado grandeLo parte en dos y envía cada mitad.
Límite de peticiones, error del servidor, inalcanzableLo guarda todo y espera: 5 segundos, doblando hasta 5 minutos, ±20%, y nunca menos de lo que pida el ingest.

El spool tiene un límite de 50 MiB. Cuando se llena se descarta el lote más antiguo con un aviso — solo ocurre tras mucho tiempo sin poder llegar al ingest.

Al apagarse, el agente cierra cada sesión y estancia abiertas, envía server.stop e intenta durante 3 segundos como máximo entregar lo que queda. Lo que no sale se queda en el spool y se envía en el siguiente arranque.

El ingest también corrige relojes: cuando la hora de envío de un lote difiere de la del ingest en más de dos segundos, todas sus marcas de tiempo se desplazan esa diferencia. Descarta, uno a uno, los eventos que no puede usar: un tipo desconocido, un evento de jugador sin jugador, una hora anterior a 2025 o más de una hora en el futuro, o datos que rompen los límites de arriba.

¿Falta algo en esta página? Dínoslo en Discord