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

Amazon EC2 instances

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 MetricMetric Display NameUnitAggregation 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 utilizationPercentMaximum
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 BytesDisk ReadsAverage
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 OutNetwork OutAverage
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)CountAverage
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)CountAverage
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 OperationsDisk ReadsAverage
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 BytesDisk WritesAverage
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 OperationsDisk WritesAverage
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 InNetwork InAverage
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.
CPUCreditBalanceCountAverage
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.
CPUCreditUsageCountAverage
aws_ec2_StatusCheckFailed_System

Reports whether the instance has passed the system status check in the last minute.
Status Check Failed SystemCountAverage
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 ChargedCountAverage
aws_ec2_CPUSurplusCreditBalance

Number of surplus credits spent by an unlimited instance when its CPUCreditBalance value is zero.
CPU Surplus Credit BalanceCountAverage
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 receivedCountAverage
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 sentCountAverage
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 accessedCountAverage