Content generated with AI — it may contain mistakes.

ExyliaAnalytics/ReferenceUpdated in v1.2.0

Commands

The /analytics and /analyticsv commands: link a server, check its status, unlink it or reload its settings.

Page 18 of 283 min read

One command checks and links the agent, with a different name on each platform so the proxy's never hides the backends'. /analytics runs on Paper, Spigot and Folia; /analyticsv runs on Velocity. Both take the same four subcommands and tab-complete them. Every one needs the permission in Permissions.

CommandWhat it doesPermission
/analytics statusShow the agent's state: linked or not, workspace, role, what is waiting to be sent and how the last send went. Plain /analytics and any unknown subcommand do the same.exyliaanalytics.admin
/analytics linkAsk for a link code and show it to you and in the console. Refused, naming the workspace, when the server is already linked.exyliaanalytics.admin
/analytics unlinkForget the token and throw away the queue and the spool. Nothing more is sent. The token keeps working until you revoke the server in the dashboard.exyliaanalytics.admin
/analytics reloadRe-read config.yml and fetch the dashboard's settings again. Mode changes still need a restart.exyliaanalytics.admin
/analyticsv statusVelocity version of /analytics status. Plain /analyticsv does the same.exyliaanalytics.admin
/analyticsv linkVelocity version of /analytics link.exyliaanalytics.admin
/analyticsv unlinkVelocity version of /analytics unlink.exyliaanalytics.admin
/analyticsv reloadVelocity version of /analytics reload.exyliaanalytics.admin

See Connect your server for the link code and Troubleshooting when a message below shows up and you do not know why.

The status readout#

EXYLIA ANALYTICS v1.1.0
 ▎ State » Active
 ▎ Workspace » ExyliaMC
 ▎ Mode » standalone
 ▎ Waiting » 12 events · 0 batches
 ▎ Last send » ok at 18:42:07
 ▎ Economy » ExyliaLib, PlayerPoints
LineValues
StateActive; Not linked — run the link command; Waiting — another server holds this token; Disabled from the dashboard — the server is paused.
WorkspaceThe workspace it is linked to. Absent when not linked.
Modeproxy, backend or standalone.
WaitingEvents in memory and batches in the spool, not yet delivered.
Last sendok at a time; retrying in Ns: and why; paused: workspace suspended or over quota; waiting: another server holds this token; not linked; or nothing sent yet.
EconomyPaper and Spigot. The economy sources hooked: ExyliaLib (or ExyliaLib (flows only) when it is too old to count holdings), Vault, VaultUnlocked, PlayerPoints, ExcellentEconomy — or no sources.
Vault, VaultUnlockedPaper and Spigot, when that economy is installed: watching the plugin behind it, or why it is not watched (off in config.yml, the economy reports through ExyliaLib, or the economy holds the highest priority).

Console messages worth knowing#

MessageMeaning
Link this server at https://analytics.exylia.net/link — code …Not linked; enter the code.
The link code expired. Run /analytics link for a new one.The ten minutes ran out.
Linked to the workspace ….The code was approved.
Could not reach Exylia Analytics (…); events are kept and retried.The ingest is unreachable. Logged once per outage.
This server's token was revoked. Run /analytics link to link it again.Revoked in the dashboard.
The workspace is suspended or over its plan quota; events are kept and retried every 15 minutes.The workspace is suspended.
Another running server holds this token (a copied plugin folder?)…Two processes share one token. See Installation.
The spool is full (50 MiB); dropped the N oldest batch(es).The ingest has been unreachable for a long time.
The installed loader is outdated: the economy API is disabled until it is updated.Replace the loader jar. Custom events keep working.
More than 100000 events are waiting; new events are dropped until the queue drains.Something floods the agent faster than it can send.

Something missing on this page? Tell us on Discord