# Log exporting (add-on)

**URL:** https://heroiclabs.com/docs/heroic-cloud/operations/log-exporting/
**Summary:** Log exporting ships your Nakama instance logs to an S3 bucket for external consumption in your own observability platform.
**Keywords:** log exporting (add-on), heroic cloud
**Categories:** heroic-cloud, log-exporting, operations

---


<!-- TODO: re-add when feature is ready -->

# Log exporting (add-on)

If your studio runs its own observability platform (Elasticsearch, Splunk, Datadog, Grafana, or similar), log exporting lets you ingest Nakama logs directly into it. Logs are shipped to a dedicated S3 bucket in near real-time, in JSON format. Each entry is enriched with the instance ID and accurate timestamps for when the log was emitted and when the exporter consumed it.

Unlike the built-in dashboard logs, which are truncated and rate-limited to manage volume, the export add-on delivers raw, unsampled log data — 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) 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](mailto:support@heroiclabs.com)) to enable this add-on.

Log exporting is a **separate, paid add-on** to your Heroic Cloud subscription.
