Perl error tracking
Know when your Perl app breaks, before your users do
A PSGI middleware or a Dancer2 plugin reports anything that escapes a route, no further wiring needed. Self-hosted, so nothing about a Perl app's errors or its users' data ever leaves infrastructure you control.
Install
cpanm --installdeps /path/to/forge_ops/sdks/perl # then add sdks/perl/lib to @INC (PERL5LIB, `use lib`, or your own cpanfile) use ForgeOps::Tracker; ForgeOps::Tracker::init(dsn => 'https://<api_key>@your-forgeops-host/api/v1/events');
A PSGI middleware or a Dancer2 plugin reports anything that escapes a route, no further wiring needed.
Every client reports the same shape
Wherever it comes from, an event arrives with an exception class, a message, and a backtrace, plus whatever environment/release/server context that client can gather on its own. ForgeOps fingerprints and groups on the first three, so a Perl app's issues list works exactly the same way every other language's does: report the same bug a thousand times and it's still one row, not a thousand.
No agent, no sidecar: it's a plain HTTPS POST to your own ForgeOps instance's ingestion API, so nothing about a Perl app's traffic ever leaves infrastructure you control.
Works with your framework
The Perl client hooks in at the framework level, not by wrapping individual calls, so nothing about how you already write Perl code has to change.
PSGI / Plack
enable '+ForgeOps::Tracker::Integrations::PSGI' wraps any PSGI-speaking app, framework or not.
Dancer2
A plugin hooks Dancer2's own on_route_exception, before Dancer2 renders its own error page.
Plain scripts
Report explicitly at the catch site: ForgeOps::Tracker::report($@, context) after an eval block.
What it looks like
The issue list
Every Perl issue reported into a project shows up here: title, status, assignee, event count, and when it was last seen, the same columns as any other language's project.
The issue detail
Every occurrence keeps its own timestamp, environment, release, and server, plus the backtrace exactly as Perl reported it, expandable per occurrence rather than flattened into one generic stack.
Alerting
A new Perl issue, a regression, or a spike past a threshold you set can reach Slack, email, SMS, a voice call, or a generic webhook, configured per project, per trigger.
Heartbeats
For the failure mode error tracking can't see on its own: a Perl cron job or recurring task that's supposed to run but silently stopped. Each heartbeat gets its own ping URL and its own grace period before it alerts.
Questions
Do I need to change how I already handle errors?
No. Every client hooks the framework's own exception handling directly, the same way the install snippet above shows -- your own logs, error pages, and rescue blocks keep working exactly as they did before. ForgeOps just also finds out about it.
Where does the data actually go?
Straight to your own ForgeOps instance over plain HTTPS. No agent, no sidecar, no third-party ingestion service in between -- nothing about your app's traffic or its users' data ever leaves infrastructure you control.
What happens if the same bug fires a thousand times?
It's fingerprinted from its exception class, message, and backtrace, so a thousand reports of the same bug still show up as one issue with an event count of 1,000, not a thousand separate rows to dig through.
Is anything scrubbed before it's stored?
Yes. Emails, credit card numbers, and known API key/token formats are redacted out of every event before it's even written, on every plan, with room for per-project custom field names on top of the defaults.