EventBridge — Cloudron events, wherever you need them

[timconsidine]

EventBridge monitors one or more Cloudron instances through the Cloudron REST API and relays what happens on them to your own webhook endpoints — so you can pipe Cloudron activity into any webhook gateway or automation which receives webhooks.

EventBridge could be seen as a sister to my AppsMonitor app. I might fold them together, but currently I see them as serving different purposes. AppsMonitor : visual. EventBridge : automation.

What it detects

• App lifecycle: installs, uninstalls, updates, health/state changes, relocations, memory changes
• Tasks: app updates, installs, restarts, and backups (success and failure)
• Notifications: new and acknowledged
• Platform: Cloudron version changes and available updates
• Monitor health: disconnected/reconnected, gaps, pauses

How it delivers

• Signed webhooks (HMAC-SHA256) with retries, exponential backoff, and jitter
• Global or per-monitor destinations with custom headers and timeouts
• Optional email notifications via Cloudron's built-in mail

Also included

• Multi-instance monitoring from a single dashboard
• Server-rendered UI: dashboard, monitors, destinations, event history with filtering and export
• First-run baseline (no event flood on setup), deduplication, and self-monitoring awareness
• All state in SQLite under /app/data, fully covered by Cloudron backups

Built as a single static Go binary on cloudron-minibase — lightweight (250 MB image, 512 MB RAM app ).

Install :
https://communityapps.appx.uk/cloudron-eventbridge/CloudronVersions.json

[robi]

Ooh nice Tim, can you add disk tracking?

Would be nice to get something like a Telegram notification when something needs attention.

[timconsidine]

@robi will look into it

[timconsidine]

@robi I checked up on how low disk notification has so far been implemented :

• EventBridge app does not monitor disk directly itself
• But EventBridge app does forward Cloudron platform notiifcations which can include low disk warning PROVIDING in Settings the user ticks for notifications to be actioned : see screenshot below
• EventBridge does not itself send a Telegram alert, it sends webhooks to your chosen webhook servicing system : it does not force you to use a specific one (user may have different preferences or existing system)
• But EventBridge can be easily paired with my community app Podii, which allows fan out of received webhooks to chosen destinations
• Podii is coded with Telegram support, although I have not tested this end to end : will get on to this

Question for you : are you happy with Cloudron's low disk warnings ? Or you think an independent check is warranted ?

Original design of EventBridge was to be a "collector and despatcher" of Cloudron notifications to a chosen receiver / fan-out, hence Podii. Some love 'n8n' but I have gone off it, so that's the motivation of Podii, which is a broad receiver of webhooks, not just from Cloudron, but from Stripe, Github etc and a broad onwards deliverer

[robi]

@timconsidine said:

Question for you : are you happy with Cloudron's low disk warnings ? Or you think an independent check is warranted ?

Happy? No.
Another check? Yes.

Low disk is fine but too late IMO for a systemic problem of something consuming disk at a runaway rate.

Hence a rate of change calculation is useful. If I install a big app and it alerts that disk usage jumped 1-5%, that's fine. But if I didn't, I need to know.

Same goes for the disk speed. Now I have to wait 50s+ to find out from Cloudron what that is and the sizes of all containers. It should just be visible at a glance IMO, even if it's a daily notification.

As for notifications, I get it, this may not be the right layer in your stack, but you know where it is, podii.

Even if this kind of stat is a webpage where changedetection can monitor it and it has its own alerting system. Might be a decent status page combo concept.

[timconsidine]

Nice clean vulnerability report on EventBridge.
courtesy of added container inspection tools trivy and grype in the updated AppInspector site.

Hardest thing was getting upstream CVE from base image solved, but because EventBridge is based on cloudron-minibase (0.0.7), the attack surface is much smaller.

[timconsidine]

@robi I have thought more about this.

Architecturally I'm not sure about EventBridge doing its own disk space check. The concept is minimalist : take Cloudron output and send it somewhere.

But sideways thinking, my AppsMonitor app is certainly the right place for in-app disk space checks (if I can do them), 'pace' checks for fast changes, and alerting, AppsMonitor could be enhanced to be more proactive and less background-only checks.

Let me plan adding the functionality you're seeking to AppsMonitor.

[timconsidine]

@robi and others :

enhanced disk usage, free space reporting and velocity check with alerts are now in AppsMonitor :
https://forum.cloudron.io/post/129932