An EC2 (Elastic Compute Cloud) instance is a virtual server and a web service. As a web service, an AWS subscriber can request and provision a compute server in the AWS cloud.
External reference
Setup
To set up the AWS integration and discover the AWS service, go to AWS Integration Discovery Profile and select EC2 Instances.
Event support
CloudTrail event support
- Supported: CloudTrail events (ModifyInstanceAttribute, RebootInstances, ResetInstanceAttribute, RunInstances, StartInstances, StopInstances, TerminateInstances)
- Configurable in OpsRamp AWS Integration Discovery Profile.
CloudWatch alarm support
- Supported
- Configurable in OpsRamp AWS Integration Discovery Profile.
Supported metrics
| OpsRamp Metric | Metric Display Name | Unit | Aggregation Type |
|---|---|---|---|
| aws_ec2_CPUUtilization Percentage of allocated EC2 compute units that are currently in use on the instance. This metric identifies the processing power required to run an application On a selected instance. | CPU utilization | Percent | Average |
| aws_ec2_DiskReadBytes Bytes read from all instance store volumes available to the instance. This metric is used to determine the volume of the data the application reads from the hard disk of the instance. This can be used to determine the speed of the application. | Disk Read Bytes | Disk Reads | Average |
| aws_ec2_NetworkOut Number of bytes sent out on all network interfaces by the instance. This metric identifies the volume of outgoing network traffic to an application on a single instance. | Network Out | Network Out | Sum |
| aws_ec2_StatusCheckFailed A combination of StatusCheckFailed_Instance and StatusCheckFailed_System that reports if one of the status checks has failed. Values for this metric are 0 (zero) or 1 (one.) A zero indicates that the status check passed. A one indicates a status check failure. | Status Check Failed(Any) | Count | Sum |
| aws_ec2_StatusCheckFailed_Instance Reports whether the instance has passed the EC2 instance status check in the last minute. Values for this metric are 0 (zero) or 1 (one.) A zero indicates that the status check passed. A one indicates a status check failure. | Status Check Failed(Instance) | Count | Sum |
| aws_ec2_DiskReadOps Completed read operations from all instance store volumes available to the instance in a specified period of time. If the instance uses Amazon EBS volumes. | Disk Read Operations | Disk Reads | Average |
| aws_ec2_DiskWriteBytes Bytes written to all instance store volumes available to the instance. This metric is used to determine the volume of the data the application writes onto the hard disk of the instance. This can be used to determine the speed of the application. | Disk Write Bytes | Disk Writes | Average |
| aws_ec2_DiskWriteOps Completed write operations to all instance store volumes available to the instance in a specified period of time. If the instance uses Amazon EBS volumes. | Disk Write Operations | Disk Writes | Average |
| aws_ec2_NetworkIn Number of bytes received on all network interfaces by the instance. This metric identifies the volume of incoming network traffic to an application on a single instance. | Network In | Network In | Sum |
| aws_ec2_CPUCreditBalance [T2 instances] Number of CPU credits available for the instance to burst beyond its base CPU utilization. Credits are stored in the credit balance after they are earned and removed from the credit balance after they expire. Credits expire 24 hours after they are earned. CPU credit metrics are available only at a 5 minute frequency. | CPUCreditBalance | Count | Average |
| aws_ec2_CPUCreditUsage [T2 instances] Number of CPU credits available for the instance to burst beyond its base CPU utilization. Credits are stored in the credit balance after they are earned and removed from the credit balance after they expire. Credits expire 24 hours after they are earned. CPU credit metrics are available only at a 5 minute frequency. | CPUCreditUsage | Count | Sum |
| aws_ec2_StatusCheckFailed_System Reports whether the instance has passed the system status check in the last minute. | Status Check Failed System | Count | Average |
| aws_ec2_CPUSurplusCreditsCharged Number of spent surplus credits that are not paid down by earned CPU credits and that incur an additional charge. | CPU Surplus Credits Charged | Count | Average |
| aws_ec2_CPUSurplusCreditBalance Number of surplus credits spent by an unlimited instance when its CPUCreditBalance value is zero. | CPU Surplus Credit Balance | Count | Average |
| aws_ec2_NetworkPacketsIn Number of packets received on all network interfaces by the instance. This metric identifies the volume of incoming traffic in terms of the number of packets on a single instance. This metric is available for basic monitoring only. | Number of packets received | Count | Sum |
| aws_ec2_NetworkPacketsOut Number of packets sent out on all network interfaces by the instance. This metric identifies the volume of outgoing traffic in terms of the number of packets on a single instance. This metric is available for basic monitoring only. | Number of packets sent | Count | Sum |
| aws_ec2_MetadataNoToken Number of times the instance metadata service was succesfully accessed using a method that does not use a token. | Number of times Metadata is accessed | Count | Average |