Skip to main content
Skip table of contents

Generic Webhook Configuration for Pushing Incidents To Cloudaware

Cloudaware supports integration with such monitoring services as Pingdom, Sumo Logic, Zabbix, etc. These services collect and analyze data from different resources (AWS S3 Bucket, CloudTrail, URLs, etc) and may send notifications or alerts of different types to provide the information about current state of a resource. Through the use of webhook integration (a special link should be generated for a monitoring service), this information can be transformed and utilized in CloudAware Incidents. 

CloudAware Incident is a custom object with fields containing the required data (e.g: Incident Source Provider, Duration, Severity, etc) received from the customer's resources. If fields are not populated with data, there may be few reasons:

  • There are no issues detected

  • Mal-configuration

API Key Generation

1. Create a Google Cloud Project account.

2. Submit an access request to support@cloudaware.com providing the full email address of the associated Google Cloud Project account.

3. Activate access to CloudAware REST API using API Manager: go to Google Console → APIs & Services → Library → filter by Private:

4. Click external.endpoints.cloudaware-vm.cloud.googEnable.

5. Generate API key. Go back to APIs & Services → Credentials → +Create credentials → API Key. 

6. Copy the API Key to the clipboard.


Incident Webhook Configuration in Cloudaware

1. Log in to your Cloudaware account → Admin.

2. Scroll down to Other integrations and select CloudAware Incident Webhook. Click +Add.

3. Type the Name of a new integration. This name will be populated to Incident Source Provider field on the CloudAware Incident object. It will also help you to find the source provider of each created incident, if you have several accounts. Click Save.

4. Replace {API_KEY} part from URL with the API Key generated for the instance you would like to monitor. This will be the URL for the HTTP requests.

Webhook Key Generation

1. Go to Google API ExplorerSet API key / OAuth 2.0 Client ID.

2. Select Custom credentials and insert the API key generated before. Click Save.

3. Services → External API v1 → external.incidents.create.

4. Insert the parameters and the Request body (the subject can be CPUUtilization is too high on {InstanceName}, for example). You can also see the tips under the question mark on every field from the Request body helping you to insert the right values

5. Webhook key is generated in Cloudaware:

6. Select Execute without OAuth or Authorize and execute depending on your API method.

7. Check a new incident created in Cloudaware.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.