Documentation is now available for the Fall 2020 Update release!

AWS EC2 Instance

Leave Feedback

Introduction

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.

Setup

To set up the OpsRamp AWS integration and discover the AWS service, go to AWS Integration Discovery Profile and select EC2 Instances.

Metrics

OpsRamp MetricMetric Display NameUnitAggregation TypeDescription
aws_ec2_CPUUtilizationCPU utilizationPercentMAXPercentage of allocated EC2 compute units that are currently in use on the instance. This metric identifies the processing power required to run an application upon a selected instance.
aws_ec2_DiskReadBytesDisk Read BytesDisk ReadsAVERAGEBytes 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.
aws_ec2_NetworkOutNetwork OutNetwork OutAVERAGENumber 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.
aws_ec2_StatusCheckFailedStatus Check Failed(Any)CountAVERAGEA combination of StatusCheckFailed_Instance and StatusCheckFailed_System that reports if either of the status checks has failed. Values for this metric are either 0 (zero) or 1 (one.) A zero indicates that the status check passed. A one indicates a status check failure.
aws_ec2_StatusCheckFailed_InstanceStatus Check Failed(Instance)CountAVERAGEReports whether the instance has passed the EC2 instance status check in the last minute. Values for this metric are either 0 (zero) or 1 (one.) A zero indicates that the status check passed. A one indicates a status check failure.
aws_ec2_DiskReadOpsDisk Read OperationsDisk ReadsAVERAGECompleted read operations from all instance store volumes available to the instance in a specified period of time. If the instance uses Amazon EBS volumes.
aws_ec2_DiskWriteBytesDisk Write BytesDisk WritesAVERAGEBytes 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.
aws_ec2_DiskWriteOpsDisk Write OperationsDisk WritesAVERAGECompleted write operations to all instance store volumes available to the instance in a specified period of time. If the instance uses Amazon EBS volumes.
aws_ec2_NetworkInNetwork InNetwork InAVERAGENumber 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.
aws_ec2_CPUCreditBalanceCPUCreditBalanceCountAVERAGE[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.
aws_ec2_CPUCreditUsageCPUCreditUsageCountAVERAGE[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.
aws_ec2_StatusCheckFailed_SystemStatus Check Failed SystemCountAverageReports whether the instance has passed the system status check in the last minute.
aws_ec2_CPUSurplusCreditsChargedCPU Surplus Credits ChargedCountAverageNumber of spent surplus credits that are not paid down by earned CPU credits and that incur an additional charge.
aws_ec2_CPUSurplusCreditBalanceCPU Surplus Credit BalanceCountAverageNumber of surplus credits that have been spent by an unlimited instance when its CPUCreditBalance value is zero.
aws_ec2_NetworkPacketsInNumber of packets receivedCountAverageNumber 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.
aws_ec2_NetworkPacketsOutNumber of packets sentCountAverageNumber 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.
aws_ec2_MetadataNoTokenNumber of times Metadata is accessedCountAverageNumber of times the instance metadata service was succesfully accessed using a method that does not use a token.

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.

External reference