Prometheus

Prometheus Integration

Alertmanager SMS notifications for cloud-native monitoring

What is Prometheus?

Prometheus is the leading open-source monitoring and alerting toolkit designed for reliability and scalability. Originally developed at SoundCloud, it has become the de facto standard for cloud-native monitoring and is a graduated project of the Cloud Native Computing Foundation (CNCF).

With its powerful query language (PromQL), multi-dimensional data model, and seamless integration with Kubernetes and containerised workloads, Prometheus excels at monitoring modern infrastructure. Alertmanager handles alert deduplication, grouping, silencing, and routing to notification channels.

SMS Alerts with Alertmanager

When critical services fail in production, your on-call team needs to know immediately. Alertmanager's SMS integration with WebSMS ensures your DevOps team receives critical notifications instantly, even when Slack is down or email is delayed.

SMS alerts provide a reliable out-of-band notification channel that doesn't depend on the same infrastructure you're monitoring. Whether it's a container crash, high latency, or service degradation, your team will be notified via text message within seconds.

Key Benefits

Cloud-Native Ready

Built for Kubernetes and containerised environments. Monitor your entire cloud infrastructure with ease.

Instant Delivery

SMS alerts arrive within seconds. Critical for reducing mean time to response (MTTR) during incidents.

Webhook Integration

Configure Alertmanager's webhook receiver to send alerts directly to WebSMS. No plugins required.

Smart Grouping

Alertmanager groups related alerts together, so you receive one SMS summary instead of alert storms.

Flexible Routing

Route different alert severities to different teams. Critical alerts go to SMS, warnings to Slack.

NZ Network

Direct connections to New Zealand mobile networks for reliable, fast delivery.

Setup Instructions

Step 1: Get Your WebSMS Credentials

You'll need your WebSMS account email and password for Basic Authentication. If you don't have an account yet, sign up for free.

Step 2: Configure Alertmanager Webhook Receiver

Add a webhook receiver to your Alertmanager configuration that sends alerts to the WebSMS API. Download our example configuration file:

Download Config Example (YAML)

Step 3: Example Alertmanager Configuration

Add this receiver to your alertmanager.yml:

receivers:
  - name: 'websms-critical'
    webhook_configs:
      - url: 'https://websms.co.nz/api/connexus/sms.php'
        http_config:
          basic_auth:
            username: 'your-email@example.com'
            password: 'your-password'
        send_resolved: true

route:
  receiver: 'default'
  routes:
    - match:
        severity: critical
      receiver: 'websms-critical'

Step 4: Configure Your Alert Rules

Ensure your Prometheus alert rules include the severity: critical label for alerts you want sent via SMS:

groups:
  - name: critical-alerts
    rules:
      - alert: ServiceDown
        expr: up == 0
        for: 1m
        labels:
          severity: critical
        annotations:
          summary: "Service {{ $labels.instance }} is down"

Step 5: Test the Integration

  1. Reload your Alertmanager configuration: curl -X POST http://localhost:9093/-/reload
  2. Trigger a test alert using Prometheus Alertmanager API
  3. Verify you receive an SMS notification
  4. Check Alertmanager logs for any webhook errors

Common Use Cases

Container Failures

Get alerted immediately when pods crash, containers restart, or deployments fail in Kubernetes.

High Latency

Receive SMS when API response times exceed SLA thresholds, before customers notice.

Service Degradation

Alert when error rates spike or success rates drop below acceptable levels.

Resource Exhaustion

Get notified when CPU, memory, or disk usage hits critical levels before systems fail.

Certificate Expiry

Alert before SSL/TLS certificates expire and cause service outages.

Database Issues

Monitor connection pools, replication lag, and query performance with instant SMS alerts.

Ready to Add SMS Alerts to Prometheus?

Sign up for a WebSMS account and start receiving Alertmanager notifications via SMS. Pay only for the messages you send.