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.
Resource Information:
- Type of Resource: Generic monitorable resource
- Discovery type: AWS SDK discovery type
- Discovery profile selection: Resource can be discovered by “EC2 Instance” in the profiler
- ResourceTag: DEVICE
- Resource Unique Identification: InstanceId (instance.instanceId())
- Dependencies: EC2 Instance runs on VPC, subnets, and may have attached EBS volumes, security groups, and key pairs
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 | AWS Metric | Metric Display Name | Unit | Aggregation Type | Description |
|---|---|---|---|---|---|
| aws_ec2_CPUCreditBalance | CPUCreditBalance | CPU Credit Balance | Count | Average | The number of earned CPU credits that an instance has accrued since it was launched or started. For T2 Standard, theCPUCreditBalancealso includes the number of launch credits that have been accrued. |
| aws_ec2_CPUCreditUsage | CPUCreditUsage | CPU Credit Usage | Count | Average | The number of CPU credits spent by the instance for CPU utilization. One CPU credit equals one vCPU running at 100% utilization for one minute or an equivalent combination of vCPUs, utilization, and time |
| aws_ec2_CPUSurplusCreditBalance | CPUSurplusCreditBalance | CPU Surplus Credit Balance | Count | Average | The number of surplus credits that have been spent by anunlimitedinstance when itsCPUCreditBalancevalue is zero. |
| aws_ec2_CPUSurplusCreditsCharged | CPUSurplusCreditsCharged | CPU Surplus Credits Charged | Count | Average | The number of spent surplus credits that are not paid down by earned CPU credits, and which thus incur an additional charge. |
| aws_ec2_CPUUtilization | CPUUtilization | CPU Utilization | Percent | Average | The percentage of physical CPU time that Amazon EC2 uses to run the EC2 instance, which includes time spent to run both the user code and the Amazon EC2 code. |
| aws_ec2_DedicatedHostCPUUtilization | DedicatedHostCPUUtilization | Dedicated Host CPU Utilization | Percent | Average | The percentage of allocated compute capacity that is currently in use by the instances running on the Dedicated Host. |
| aws_ec2_DiskReadBytes | DiskReadBytes | Disk Read Bytes | Bytes | Average | 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. |
| aws_ec2_DiskReadOps | DiskReadOps | Disk Read Ops | Count | Average | Completed read operations from all instance store volumes available to the instance in a specified period of time. |
| aws_ec2_DiskWriteBytes | DiskWriteBytes | Disk Write Bytes | Bytes | Average | 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. |
| aws_ec2_DiskWriteOps | DiskWriteOps | Disk Write Ops | Count | Average | Completed write operations to all instance store volumes available to the instance in a specified period of time. |
| aws_ec2_EBSByteBalancePercent | EBSByteBalance% | EBS Byte Balance% | Percent | Maximum | Provides information about the percentage of throughput credits remaining in the burst bucket. |
| aws_ec2_EBSIOBalancePercent | EBSIOBalance% | EBSIO Balance% | Percent | Maximum | Provides information about the percentage of I/O credits remaining in the burst bucket. This metric is available for basic monitoring only. |
| aws_ec2_EBSReadBytes | EBSReadBytes | EBS Read Bytes | Bytes | Average | Bytes read from all EBS volumes attached to the instance in a specified period of time.The number reported is the number of bytes read during the period. |
| aws_ec2_EBSReadOps | EBSReadOps | EBS Read Ops | Count | Average | Completed read operations from all Amazon EBS volumes attached to the instance in a specified period of time. |
| aws_ec2_EBSWriteBytes | EBSWriteBytes | EBS Write Bytes | Bytes | Average | Bytes written to all EBS volumes attached to the instance in a specified period of time.The number reported is the number of bytes written during the period. |
| aws_ec2_EBSWriteOps | EBSWriteOps | EBS Write Ops | Count | Average | Completed write operations to all EBS volumes attached to the instance in a specified period of time. |
| aws_ec2_GPUPowerUtilization | GPUPowerUtilization | GPU Power Utilization | Percent | Average | Active power usage as a percentage of maximum active power. |
| aws_ec2_InstanceEBSIOPSExceededCheck | InstanceEBSIOPSExceededCheck | Instance EBSIOPS Exceeded Check | None | Average | Reports whether an application attempted to drive IOPS that exceeds the maximum EBS IOPS limits for the instance within the last minute. |
| aws_ec2_InstanceEBSThroughputExceededCheck | InstanceEBSThroughputExceededCheck | Instance EBS Throughput Exceeded Check | None | Average | Reports whether an application attempted to drive throughput that exceeds the maximum EBS throughput limits for the instance within the last minute. |
| aws_ec2_MetadataNoToken | MetadataNoToken | Metadata No Token | Count | Sum | The number of times the Instance Metadata Service (IMDS) was successfully accessed using a method that does not use a token. |
| aws_ec2_MetadataNoTokenRejected | MetadataNoTokenRejected | Metadata No Token Rejected | Count | Sum | The number of times an IMDSv1 call was attempted after IMDSv1 was disabled. |
| aws_ec2_NetworkIn | NetworkIn | Network In | Bytes | Sum | The number of bytes received by the instance on all network interfaces. |
| aws_ec2_NetworkOut | NetworkOut | Network Out | Bytes | Sum | The number of bytes sent out by the instance on all network interfaces. |
| aws_ec2_NetworkPacketsIn | NetworkPacketsIn | Network Packets In | Count | Sum | The number of packets received by the instance on all network interfaces. |
| aws_ec2_NetworkPacketsOut | NetworkPacketsOut | Network Packets Out | Count | Sum | The number of packets sent out by the instance on all network interfaces. |
| aws_ec2_StatusCheckFailed | StatusCheckFailed | Status Check Failed | Count | Average | Reports whether the instance has passed all status checks in the last minute.This metric can be either0(passed) or1(failed). |
| aws_ec2_StatusCheckFailed_AttachedEBS | StatusCheckFailed_AttachedEBS | Status Check Failed_Attached EBS | Count | Average | Reports whether the instance has passed the attached EBS status check in the last minute.This metric can be either0(passed) or1(failed). |
| aws_ec2_StatusCheckFailed_Instance | StatusCheckFailed_Instance | Status Check Failed_Instance | Count | Average | Reports whether the instance has passed the instance status check in the last minute.This metric can be either0(passed) or1(failed). |
| aws_ec2_StatusCheckFailed_System | StatusCheckFailed_System | Status Check Failed_System | Count | Average | Reports whether the instance has passed the system status check in the last minute.This metric can be either0(passed) or1(failed). |