Installation

Create Your First Integration

Integrations are the connection points between your monitoring tools and NearIRM. Each integration provides a unique webhook URL that accepts alerts.

Step 1: Navigate to Integrations

1. Log in to your NearIRM dashboard
2. Go to Settings in the sidebar
3. Click Integrations

Step 2: Create a Grafana Integration

Click Create Integration and fill in:

• Name: Give it a descriptive name (e.g., "Production Grafana")
• Type: Select "Grafana Alertmanager"
• Description: Optional notes about this integration

Click Create to generate your webhook URL.

Step 3: Copy Your Webhook URL

After creation, you'll see your integration with a webhook URL like:

https://irm.nearlunar.com/api/webhooks/grafana/abc123def456

Click the copy button to copy this URL to your clipboard.

Step 4: Configure Grafana

In your Grafana instance:

1. Go to Alerting > Contact points
2. Click Add contact point
3. Select Webhook as the integration type
4. Paste your NearIRM webhook URL
5. Set HTTP method to POST
6. Save the contact point

Using Generic Webhooks

If you're not using Grafana, create a "Generic" integration instead. The webhook accepts any JSON payload with these fields:

{
  "title": "High CPU Usage",
  "description": "Server cpu-01 CPU at 95%",
  "severity": "critical",
  "source": "custom-monitor",
  "labels": {
    "host": "cpu-01",
    "env": "production"
  }
}

See the Webhook API Reference for full format details.

Next Steps

Now that you have an integration, let's set up a policy and send a test alert.

Continue to Quick Start