Forge Logger – Overview
Forge Logger is a platform for collecting bug reports, events, and runtime logs from games and applications. The system consists of a backend API, a frontend web dashboard, and a set of plugins for popular game engines (Godot, Unity, …).
Key Features
- Automatic session management – sessions start with the game and are linked to a specific build and platform.
- Programmatic and user-facing bug reporting – developers can trigger reports from code; players can submit reports via an in-game popup.
- Log and screenshot attachments – attach files to bug reports using pre-signed upload URLs.
- Offline retry queue – requests that fail due to network issues are retried automatically.
- Crash detection – the plugin detects abnormal termination and files a report on the next launch.
- Deduplication – the backend deduplicates identical reports so the issue tracker stays clean.
- Integrations – export bug reports to GitHub, GitLab, Jira, and Discord.
Architecture and Data Flow
Entity Lifecycle
| Entity | Description |
|---|---|
| Session | Created when the game starts. Contains build version, platform, optional player ID, and custom metadata. All events and reports belong to a session. |
| Event | Arbitrary telemetry event with a type, timestamp, and JSON payload. Events can be attached to a bug report for context. |
| Upload | Represents a file (log, screenshot) to be uploaded. The backend returns a pre-signed URL; the client then PUTs the binary directly to that URL. |
| Report | A bug report. References a session and optional events. Contains a title, description, severity, tags, and attached uploads. |
All endpoints are RESTful and communicate over JSON. See the API Reference for details.
Deduplication and Integrations
The backend deduplicates bug reports automatically—identical errors (matched by fingerprint or stack trace hash) are collapsed into a single issue. This prevents noise in the issue tracker when many players hit the same bug.
Forge Logger integrates with external services at the project level. Once an integration is configured (GitHub, GitLab, Jira, or Discord), approved bug reports can be automatically exported as issues or notifications.
Further Reading
- Getting Started – your first bug report in under 5 minutes.
- Ingest API – sessions, events, uploads, and reports endpoint reference.
- App Guide – dashboard, projects, integrations, and exports.
- Godot Plugin – installation, configuration, and GDScript examples.
- Plugins Overview – all available engine plugins.