Introduction
Webhook integration in OpsRamp enables continuous communication between external systems and the OpsRamp platform by sending real-time event notifications. This allows you to automate workflows, trigger alerts, and update IT operations based on incoming data from third-party applications, cloud services, and monitoring tools.
By configuring webhooks, OpsRamp can receive and process event-driven data, such as incident updates or custom alerts. Using Alerts streaming, you can subscribe to data streams of raw or deduplicated OpsRamp alerts and send them to your webhook. This allows you to receive real-time alerts directly in your system, enabling quick responses and better management of your IT operations by processing the alerts as they are generated.
This integration helps IT teams enhance observability, improve response times, and streamline incident management.
Key Benefits of webhook integration in OpsRamp
- Real-Time Event Processing – Webhooks provide instant event-driven notifications to OpsRamp, ensuring that alerts, incidents, and status updates are received and processed without delays. This is critical for proactive IT monitoring and automated remediation.
- Automated Incident Management – Integrating webhooks with OpsRamp allows external monitoring tools (e.g., AWS CloudWatch) to automatically create, update, or resolve incidents in OpsRamp based on predefined conditions. This reduces manual ticket creation and accelerates incident resolution.
- Customizable Workflows – Define specific event triggers and automate workflows based on IT operational needs, enhancing process efficiency.
- Secure and Reliable Data Transmission – Webhooks in OpsRamp can be configured with authentication mechanisms such as API keys and OAuth tokens to ensure secure event delivery and prevent unauthorized access.
Prerequisites
- Endpoint URL, Header, Payload of third-party integration.
- To push alerts, Streaming Export integration should be installed.
Install Webhook integration
Navigate to Setup → Account. The Account Details screen is displayed.
Select the Integrations tile. The Installed Integrations screen is displayed, with all the installed applications.
If you do not have any installed applications, you will be navigated to the Available Integrations screen. The Available Integrations screen displays all the available applications along with the newly created application with the version.
Note: Search for Webhook application using the search option available. Alternatively, search for Exports from All Categories option and select it.Click ADD in Webhook tile. The ADD WEBHOOK screen is displayed.
Enter the following basic details:
Field Name Field Type Description Name String Unique name for the integration. Webhook URL String Provide the client (INBOUND) webhook URL.
Example: `https://uat.opsramp.net/integrations/alertsWebhook/
{tenantId}/alerts?vtoken={vtoken}`HEADERS Dropdown Select values from Name and Value dropdowns. - Name: Select a Header name. Default header name is
Content-Type. - Value: Select a Header value. Default header value is application/json.
- Click +ADD to add more headers.
- OpsRamp supports only JSON content-type.
Payload String Enter a payload.
Give a space and enter $ to get a list of tokens.
Note: The following tokens do not work during the ingestion of raw alerts:repeatCount
,alertId
,technology
,healedTime
.
To validate the payload:- Click VALIDATE PAYLOAD.
- Hover over the icon for more information.
- Name: Select a Header name. Default header name is
Click FINISH. The integration is installed.
If the provided Information is correct, then the integration will be saved without any errors.
Next steps
The next step is to install the Streaming Export integration.