Learn more about CloudWatch API
Amazon uses multiple APIs for polling, reporting, and managing cloud environments. Amazon EC2 sends metrics to Amazon CloudWatch. This data includes instance specific metrics and OS metrics depending on configurations. General monitoring of your AWS instances poll and display basic metrics for your instances and volumes, including the region, status and state, DNS information, and vCPU and disk data.
Amazon CloudWatch API enables you to monitor and manage various metrics through the AWS console and SAM and integrated VMAN. The Orion server collects data using publicly available AWS APIs (CloudWatch, EC2, and EBS) which are accessible HTTPS protocol. The Orion server must be able to communicate with these public services. For a full list, see the Cloud metric reference.
AWS CloudWatch provides 1 million free requests per month for your polling metrics per month. These requests may be consumed by third party products, custom code, and Cloud Infrastructure Monitoring through SAM and integrated VMAN. All monitored metrics count against the 1 million free requests provided per month by Amazon. Any requests beyond 1 million will incur additional costs. Other tools in your environment making CloudWatch API calls also count against your free requests limit.
- A single EC2 instance with a 5 minute polling interval uses approximately 60,000 requests per month.
- A single EBS volume with a 5 minute polling interval uses approximately 100,000 requests per month.
When you manage an instance as a node, data continues to poll using the CloudWatch APIs and counting against the free requests. SAM provides additional metrics for memory and features for cloud infrastructure management, usage, alerts, and more. To review the calculated amount of consumed free requests, see the cloud account properties by editing the cloud account properties.
For details on AWS throttling, see Learn more about AWS throttling.
If your polling exceeds the Amazon polling limit (for free requests), this alert triggers: Alert me when free CloudWatch polling limit was exceeded. This out-of-the-box alert checks the calculated current requests usage through the CloudWatch API. When triggered, the alert:
- Reports a warning alert to the Cloud Summary and Cloud Instance Details resources
- Sends emails regarding the issue to Orion accounts or specific emails as modified
- Resets if the condition is no longer true (CloudWatch Requests are less than 1 million)
Be advised, Amazon Web Services does not halt polling or CloudWatch metrics. They charge an additional cost for the month based on the exceeded polls for the remaining time frame.
The Orion Web Console displays your current CloudWatch polling usage through the account details per instance. To verify your monthly polling amount, edit the properties for your AWS account. Under the CloudWatch API polling section, review the calculated metric to determine usage for the month.
Disable CloudWatch API
You can disable AWS CloudWatch API at an account level in cloud infrastructure monitoring to not exceed the free limits provided by Amazon Web Services or if polling exceeds Amazon free limits. CloudWatch API polling must be enabled to continue polling and reporting cloud instance and volume metrics for AWS and the Orion Platform.
When disabled, metrics no longer poll through the CloudWatch API.
If you manage cloud instances as nodes, with CloudWatch disabled, you continue to poll application and OS metrics for assigned templates, component monitors, and application monitors.
When you disable CloudWatch API polling, metrics do not poll or display in the Orion Web Console. A message displays per Instance Details page detailing the reason. Only the status for Amazon EC2 instances displays in the Cloud Summary and Instance Details Pages.