Log exporting (add-on)
Log exporting ships your Nakama instance logs to an S3 bucket in real time for external consumption.
Overview #
Heroic Labs delivers logs continuously to a dedicated S3 bucket in near real-time with approximately a 20-30 second delay. The format is JSON, with each log entry enriched with additional fields including the instance ID and accurate timestamps for when the log was emitted and when the exporter consumed it.
Logs exported through this add-on aren’t sampled. The built-in dashboard log view applies sampling to manage volume. The export add-on bypasses this and delivers raw, unsampled log data—it includes every log line your Nakama server produces.
The S3 bucket retains exported logs for a rolling 7-day window. Heroic Labs automatically removes logs older than 7 days.
How it works #
Heroic Labs provisions a dedicated S3 bucket and provides you with credentials (a URL and access keys) to pull from it. You don’t manage the bucket or its configuration—you receive the connection details and read from it using any S3-compatible client.
Each deployment has one log export. You can’t configure multiple export destinations for the same deployment. The export is continuous for the lifetime of the add-on.
When to use it #
Log exporting is useful when you need to ingest logs into your own observability platform (for example, Elasticsearch, Splunk, Datadog, Grafana Loki) for centralized logging, compliance auditing, long-term retention, or custom analysis beyond the 7-day window.
Enabling log exporting #
Contact Heroic Labs (support@heroiclabs.com) to enable this add-on.
Log exporting is a separate, paid add-on to your Heroic Cloud subscription.
