Incoming webhooks
Incoming webhooks allow external systems to send event data into Grafana IRM, triggering alerts in OnCall or incidents in Incident. They enable seamless integration between your monitoring tools, ticketing systems, and automation platforms with Grafana IRM’s incident management capabilities.
Available webhook types
Grafana IRM offers two distinct incoming webhook types:
OnCall incoming webhooks
OnCall incoming webhooks enable alert ingestion with:
- Dedicated endpoints for various monitoring systems
- Template-based alert parsing for custom data sources
- Automatic routing to appropriate escalation policies
- Configurable alert grouping and deduplication
- Inbound routing for different alert sources
Best for: Routing alerts from monitoring systems into your on-call workflow.
Incident incoming webhooks
Incident incoming webhooks enable external systems to:
- Create new incidents with customizable details
- Update existing incidents programmatically
- Specify incident attributes like severity, title, and labels
- Integrate with automation workflows and CI/CD pipelines
- Secure connections with optional authentication mechanisms
Best for: Automating incident creation and updates from external tools and custom applications.
Key use cases
- Monitoring integration: Ingest alerts from third-party monitoring tools
- Automation: Create incidents based on CI/CD pipeline failures
- Custom applications: Connect internal tools to your incident response
- System integration: Link ticketing systems with incident management
- Event-driven response: Trigger incidents based on business events
Best practices
- Authentication: Enable security for sensitive webhook endpoints
- Parsing: Use appropriate templates for consistent data extraction
- Testing: Validate webhook configurations with test payloads
- Routing: Ensure alerts reach the correct escalation policies
- Documentation: Maintain records of webhook sources and configurations
Next steps
Configure incoming webhooks in Grafana IRM:
Follow the specific setup instructions for either Incident incoming webhooks or OnCall incoming webhooks
Was this page helpful?
Related resources from Grafana Labs
