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.
| Command | What it does | Permission |
|---|---|---|
/analytics status | Show 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 link | Ask 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 unlink | Forget 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 reload | Re-read config.yml and fetch the dashboard's settings again. Mode changes still need a restart. | exyliaanalytics.admin |
/analyticsv status | Velocity version of /analytics status. Plain /analyticsv does the same. | exyliaanalytics.admin |
/analyticsv link | Velocity version of /analytics link. | exyliaanalytics.admin |
/analyticsv unlink | Velocity version of /analytics unlink. | exyliaanalytics.admin |
/analyticsv reload | Velocity 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| Line | Values |
|---|---|
| State | Active; Not linked — run the link command; Waiting — another server holds this token; Disabled from the dashboard — the server is paused. |
| Workspace | The workspace it is linked to. Absent when not linked. |
| Mode | proxy, backend or standalone. |
| Waiting | Events in memory and batches in the spool, not yet delivered. |
| Last send | ok 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. |
| Economy | Paper 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, VaultUnlocked | Paper 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#
| Message | Meaning |
|---|---|
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