Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

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. 

Image RemovedImage Added

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

Table of Contents

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:

Image RemovedImage Added

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

Image RemovedImage Added

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

Image RemovedImage RemovedImage AddedImage Added

6. Copy the API Key to the clipboard.

Image RemovedImage Added


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.

Image RemovedImage Added

3. Type the Name of a new integration. This name will be populated to Incident Source Providerfield 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.

Image RemovedImage RemovedImage AddedImage Added

Webhook Key Generation

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

Image RemovedImage Added

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

Image RemovedImage Added

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

Image RemovedImage RemovedImage AddedImage Added

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

Image RemovedImage Added

5. Webhook key is generated in Cloudaware:

Image RemovedImage Added

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

7. Check a new incident created in Cloudaware.

Image RemovedImage Added