Integrations

Connect a11ops with your existing monitoring, observability, and infrastructure tools. Our integrations ensure you can route alerts from any source to your team.

Integration Methods

Native SDKs

Use our official SDKs to send alerts directly from your applications with full type safety and error handling.

View SDK docs →

Webhook Receivers

Configure your monitoring tools to send webhooks to a11ops. We automatically parse and route alerts.

Webhook format →

Infrastructure as Code

Manage a11ops resources using Terraform or other IaC tools for version-controlled infrastructure.

Terraform docs →

Popular Integrations

Prometheus AlertManager

Route alerts from Prometheus to a11ops using our native webhook receiver. Supports full AlertManager payload with labels and annotations.

MetricsTime-seriesThresholds

Grafana

Send alerts from Grafana unified alerting to a11ops. Includes support for images, annotations, and multi-dimensional alerts.

DashboardsUnified AlertingVisualizations

Datadog

Forward Datadog monitors and alerts to a11ops using webhook notifications. Preserves tags, priority, and monitor metadata.

APMInfrastructureLogs

Terraform

Manage workspaces, API keys, and integrations as code using our official Terraform provider. Perfect for GitOps workflows.

IaCGitOpsAutomation

Other Integrations

AWS CloudWatch

Send CloudWatch alarms to a11ops using SNS webhook subscriptions.

PagerDuty

Migrate from or integrate with PagerDuty using our compatible API.

New Relic

Forward New Relic alerts using webhook notifications.

Elastic Stack

Send alerts from Elasticsearch Watcher or Kibana alerting.

Generic Webhook Format

For tools not listed above, you can send webhooks in our generic format:

POST https://api.a11ops.com/v1/webhooks/YOUR_INTEGRATION_ID
Content-Type: application/json

{
  "alert": "Database CPU Critical",          // Required
  "description": "CPU usage at 95%",         // Optional
  "severity": "critical",                    // Optional: critical|high|medium|low|info
  "source": "custom-monitoring",             // Optional
  "timestamp": "2024-01-15T10:30:00Z",      // Optional ISO 8601
  "labels": {                               // Optional metadata
    "service": "api-gateway",
    "environment": "production",
    "region": "us-east-1"
  },
  "annotations": {                          // Optional additional info
    "runbook": "https://wiki.example.com/runbooks/high-cpu",
    "dashboard": "https://grafana.example.com/d/abc123"
  }
}

Field Mappings

alert→ Maps to title
description→ Maps to message
severity→ Maps to priority
labels + annotations→ Combined into metadata

Setting Up an Integration

  1. Navigate to Workspace Settings

    Go to your workspace and click on “Integrations”

  2. Create New Integration

    Click “Add Integration” and select your tool

  3. Copy Webhook URL

    You'll receive a unique webhook URL for this integration

  4. Configure Your Tool

    Add the webhook URL to your monitoring tool's notification settings

  5. Test the Integration

    Send a test alert to verify the connection works

Integration Best Practices

Use Descriptive Names

Name integrations clearly (e.g., “Production Prometheus” vs just “Prometheus”) to easily identify the source of alerts.

Test Before Production

Always test integrations with sample alerts before routing production traffic to ensure proper formatting.

Include Metadata

Configure your tools to send rich metadata like environment, service, and region for better alert context.

Monitor Integration Health

Set up alerts for integration failures or webhook errors to ensure you don't miss critical notifications.

Building Custom Integrations

Need to integrate a tool that's not listed? You have several options:

Use the Generic Webhook

Most monitoring tools support webhook notifications. Configure them to send to our generic webhook endpoint with the format shown above.

Build a Webhook Transformer

Create a simple service that receives webhooks from your tool and transforms them to our format before forwarding.

Use Our SDK Directly

For maximum control, use our SDK to send alerts programmatically from your monitoring scripts or applications.

Ready to Connect?

Choose an integration guide to get started with your monitoring tools.

Prometheus GuideAPI Reference