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 → API Manager → Library → Private APIs → click external.endpoints.cloudaware-vm.cloud.goog → Enable
4) Go back to API Manager → Credentials → Create credentials → API Key. Copy the API Key to the clipboard
Incident Webhook Configuration in Cloudaware
1) Log in to Cloudaware and go to Admin
2) Scroll down to Other integrations and select Cloudaware Incident Webhook
3) Select Add Integration
4) 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
5) 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 https://external-dot-cloudaware-vm.appspot.com/_ah/api/explorer and select Set API key / OAuth 2.0 Client ID
2) Select Custom credentials and insert the API key generated before. Click Save
3) Select one of the available APIs
4) Insert the parameters and the Request body (the subject can be “CPUUtilization is too high on eoduat-eu-central-db.RDS.eu-central (instance name)”, 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
Webhook key is generated in Cloudaware:
4. Execute a request without OAuth (or Authorize and execute if it is required by your API method)
5. Check the incident created in Cloudaware
