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

Log in to your NearIRM dashboard
Go to Settings in the sidebar
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:

Go to Alerting > Contact points
Click Add contact point
Select Webhook as the integration type
Paste your NearIRM webhook URL
Set HTTP method to POST
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