Troubleshooting

If your Minecraft server is not reporting metrics or events to ShardAnalytics, use this guide to identify and resolve the issue.

Common Ingestion Issues

1. No Data Appearing in Dashboard

If the server console reports no errors but the dashboard is empty:

Verify Organization Scope: Ensure you have selected the correct Organization and Instance in the top-left dropdown of the dashboard.
Check Plugin Load State: Type /plugins in your server console. Ensure ShardAnalytics appears in green (enabled).

2. Invalid API Key (HTTP 401)

If you see unauthorized errors:

Reset Key: Generate a new server API key from the Settings panel.
Re-run Setup Command: Set it on the server using:
Terminal window
```
/shardanalytics setapikey {newApiKey} confirm
```
Do Not Share Keys: Server keys are unique to each instance. Do not reuse the same API key across multiple servers.

3. Connection Issues

ShardAnalytics uses Cloudflare to manage traffic and secure connections.

Ensure your server host has outgoing network access and can establish outbound HTTPS connections (port 443) to reach Cloudflare. No inbound ports need to be opened.

Plugin Compatibility & Versions

Platform Compatibility

Supported Platforms: Paper, Spigot, and Folia.

Version Check

You can check the plugin version currently running on your instance by visiting the Server Overview page or the Plugins section in the ShardAnalytics dashboard. If you need to update, replace the plugin jar file in your plugins/ directory and restart the server.