Skip to content

@backstage-community/plugin-healert #9206

@amgadmag

Description

@amgadmag

🔖 Summary

Healert is a Friction Intelligence Platform that surfaces Kubernetes audit log bypass events per Backstage catalog entity as real-time Friction Scores and Heatmaps. It detects when developers bypass the golden path; kubectl exec, direct deployments, pipeline skips, secret access, port-forwarding. It shows the cumulative impact per service using exponential time decay scoring.

🌐 Project website (if applicable)

https://github.com/healert-io

✌️ Context

Platform engineering teams invest significant effort building golden paths; GitOps pipelines, service templates, IaC workflows, admission policies.
Developers often bypass these controls during incidents or when under pressure, creating invisible drift between cluster state and git, compliance gaps, and accumulated technical debt.

The Healert plugin integrates with a self-hosted Go agent (DaemonSet) that tails the Kubernetes audit log and detects bypass events in real time. Events are scored using exponential time decay; recent bypasses weigh more than old ones, and scores heal automatically as teams improve their behavior.

The plugin adds a Healert Platform tab to every catalog entity showing:

  • Friction Score Board: A score from 0–100 with severity badge, overhead hours estimate, top friction workflow, and projected improvement after fixing the top event types.
Image
  • Friction Heatmap: An event type × workflow matrix showing where friction concentrates across the service lifecycle, with drill-down modal per cell.
Image Image
  • Card PDF Export: A full friction analysis report including score, decay formula, recent events.
Image

The plugin requires two self-hosted components: the Healert backend (FastAPI + SQLite) and the Healert agent (Go binary or Kubernetes DaemonSet). Both are open source under Apache-2.0 and can be deployed in under 10 minutes using the included healert.sh management script.

Agent Repository:
https://github.com/healert-io/agent

Backend Repository:
https://github.com/healert-io/backend

Healert OÜ is registered in Estonia under the EU e-Residency programme.
Apache-2.0 license.

👀 Have you spent some time to check if this plugin request has been raised before?

  • I checked and didn't find similar issue

✍️ Are you willing to maintain the plugin?

🏢 Have you read the Code of Conduct?

Are you willing to submit PR?

Yes I am willing to submit a PR!

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions