prometheus / prometheus/alertmanager

Add SIGNL4 Receiver for mobile alerting

Open
#5,003 7 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

component/notify
Dominant language
Go
Stars
8.6k
Forks
2.5k
Avg merge
2d 6h
Merged PRs (30d)
61

Description

Proposal
Summary

We would like to propose adding a native SIGNL4 receiver to Alertmanager, similar to existing integrations such as PagerDuty, OpsGenie, and VictorOps.

SIGNL4 provides mobile alerting via app push notifications, SMS, and voice calls, including on-call scheduling, escalation, and collaboration capabilities.

While it is already possible to integrate SIGNL4 with Prometheus / Alertmanager using webhooks:
https://docs.signl4.com/integrations/prometheus/prometheus.html
the current approach has functional limitations compared to a native receiver implementation.

Motication

A native SIGNL4 receiver would provide improved functionality, flexibility, and a better user experience, including:

  • Improved alert formatting
    • More advanced control over subject, message body, and parameters
    • Structured field mapping
  • Category / Service support
    • Control over alert color, icon, and behavior
    • Better alignment with service-based routing
  • Location support
    • Native support for longitude/latitude
    • Map rendering within mobile alerts
  • Full alert lifecycle support
    • Easily trigger alerts
    • Properly close/resolve alerts
  • Bi-directional context
    • Ability to attach additional information to enable meaningful acknowledgements from SIGNL4 back to Alertmanager
Existing Work

There has already been a previous pull request implementing this functionality, meaning that a code base for such a receiver already exists and could potentially be reused or updated.

Expected Outcome

Adding a native SIGNL4 receiver would:

  • Provide feature parity with other major alerting platforms
  • Improve formatting and lifecycle handling
  • Reduce custom webhook configuration effort
  • Deliver a better operational experience for joint Prometheus / Alertmanager / SIGNL4 users

We would be happy to support testing, feedback, or further refinement if needed.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the existing PagerDuty, OpsGenie, and VictorOps receiver integrations and the previous implementation mentioned in the issue. Use the listed formatting, category, location, lifecycle, and acknowledgement requirements to define the native SIGNL4 receiver; done means those capabilities are covered without relying on the current webhook approach.

Written by the indexing model from the issue text.

Assessment

Tech stack
go, prometheus
Domain
api, backend
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.