Integrations

What are Integrations?

Integrations connect NearIRM to external systems in two directions:

1. Inbound - Receive alerts from monitoring tools via webhooks
2. Outbound - Send notifications through various channels

Inbound Integrations

Grafana Alertmanager

Native support for Grafana's alerting format:

1. Create a "Grafana Alertmanager" integration
2. Copy the webhook URL
3. Configure as a contact point in Grafana

Supported features:

• Alert grouping
• Severity mapping
• Label extraction
• Resolved events

SigNoz

Native support for SigNoz's Prometheus Alertmanager format:

1. Create a "SigNoz" integration in Settings > Integrations
2. Copy the webhook URL and API key
3. In SigNoz, go to Settings > Alert Channels > New Channel
4. Select "Webhook" as channel type
5. Paste the webhook URL
6. Add the API key as a header: Authorization: Bearer <your-api-key>

Supported features:

• Prometheus Alertmanager format
• Bearer token authentication
• Severity mapping (critical, error, warning, info, p1-p5)
• Alert grouping and deduplication
• Resolved events

Generic Webhook

For any tool that can send HTTP webhooks:

1. Create a "Generic" integration
2. Copy the webhook URL
3. Configure your tool to POST JSON

Payload format:

{
  "title": "Alert title",
  "description": "Alert description",
  "severity": "critical|high|medium|low|info",
  "source": "your-tool-name",
  "status": "firing|resolved",
  "labels": {
    "key": "value"
  }
}

See Webhook API Reference for full details.

Outbound Channels

Configure how you receive notifications in Settings > Preferences.

Email

Enabled by default for all users. Notifications sent to your account email.

Web Push

Browser notifications for real-time alerts:

1. Enable push notifications in Preferences
2. Allow browser notification permission
3. Receive alerts even when not on the site

Slack

Send alerts to Slack channels:

1. Create a Slack incoming webhook
2. Add as a notification target in NearIRM
3. Assign to policies or preferences

WhatsApp

Receive important alerts via WhatsApp:

1. Go to Settings > Preferences
2. Enter your WhatsApp number
3. Verify with the code sent to WhatsApp
4. Configure which alerts use WhatsApp

Note: WhatsApp is recommended for critical escalations, not all alerts.

Notification Preferences

Users configure which channel to use per urgency tier:

Adjust in Settings > Preferences to route important alerts to WhatsApp or other channels.

Managing Integrations

Viewing Activity

Each integration shows:

• Total alerts received
• Last alert timestamp
• Success/failure rate

Rotating Webhook URLs

If a webhook URL is compromised:

1. Go to Settings > Integrations
2. Find the integration
3. Click Regenerate URL
4. Update your monitoring tool configuration

Warning: The old URL stops working immediately.

Best Practices

1. One integration per source - Easier to track and manage
2. Name descriptively - "Prod Grafana" not "Integration 1"
3. Monitor activity - Check for unexpected drops in alerts
4. Use appropriate channels - Don't WhatsApp every alert