Amazon EC2
Least Privileged User
Navigate to the AWS console and create an IAM user with programmatic access. The user will need the following permissions. You can create a policy specifically for these permissions and apply the permissions to the user.
For more information, see: High Level AWS Source Configuration
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": [
"elasticloadbalancing:DescribeLoadBalancers",
"ec2:DescribeInstances",
"ec2:DescribeAddresses",
"elasticloadbalancing:DescribeListeners",
"ec2:DescribeVolumes",
"cloudwatch:GetMetricStatistics",
"cloudwatch:ListMetrics",
"ec2:DescribeInstanceStatus"
],
"Resource": "*"
}
]
}
Connection Parameters
| Name | Required? | Description |
|---|---|---|
| Region | ||
| Access Key ID | Required | |
| Secret Access Key | Required | |
| Additional Threads | The number of additional threads allowed to be utilized during collection. | |
| Request Timeout (seconds) | The number of seconds to allow for the API to return a response. | |
| Collect CloudWatch Metrics | ||
| CloudWatch Historic Mode | If enabled, retrieves a history of data points from CloudWatch. Otherwise, collects only the most recent data point for each metric. | |
| Include Images | Whether or not to collect information about Amazon Machine Images (AMIs) |
Metrics
Image
| Name | Description |
|---|---|
| Disk Reads | Completed read operations from all instance store volumes available to the instance in a specified period of time. |
| Disk Writes | Completed write operations to all instance store volumes available to the instance in a specified period of time. |
| Image Id | This dimension filters the data you request for all instances running this Amazon EC2 Amazon Machine Image (AMI). Available for instances with Detailed Monitoring enabled. |
| Instance Id | This dimension filters the data you request for the identified instance only. This helps you pinpoint an exact instance from which to monitor data. |
| Region | The AWS Region this object belongs to. |
Instance
| Name | Description |
|---|---|
| AMI ID | AMI ID of related AMI of the instance. |
| Architecture | Architecture of the instance. |
| Auto Scaling Group Name | This dimension filters the data you request for all instances in a specified capacity group. An Auto Scaling group is a collection of instances you define if you're using Auto Scaling. This dimension is available only for Amazon EC2 metrics when the instances are in such an Auto Scaling group. Available for instances with Detailed or Basic Monitoring enabled. |
| Average Network Packets In | The average 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. |
| Average Network Packets Out | The average 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. |
| CPU Credit Balance | The number of earned CPU credits accumulated since the instance was launched, less the credits used, up to a maximum number based on the instance size. |
| CPU Credit Usage | The number of CPU credits used 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. |
| CPU Surplus Credit Balance | The number of surplus credits that have been used by a T2 Unlimited instance when its CPUCreditBalance is zero. |
| CPU Surplus Credits Charged | The number of surplus credits that have been used by a T2 Unlimited instance that are not offset by earned CPU credits. CPUSurplusCreditsCharged tracks the surplus credits that incur an additional charge, and represents the difference between CPUSurplusCreditBalance and CPUCreditBalance. |
| CPU Utilization (%) | The 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 upon a selected instance. |
| Disk Read Data (Bytes) | Bytes read from all instance store volumes available to the instance. |
| Disk Reads | Completed read operations from all instance store volumes available to the instance in a specified period of time. |
| Disk Write Data (Bytes) | Bytes read from all instance store volumes available to the instance. |
| Disk Writes | Completed write operations to all instance store volumes available to the instance in a specified period of time. |
| Domain | Domain of the instance. |
| EBS Data Balance (%) | Available only for the smaller C5 and M5 instance sizes. Provides information about the percentage of throughput credits remaining in the burst bucket. This metric is available for basic monitoring only. |
| EBS ID | EBS used for data storage for this instance. |
| EBS Optimized | Whether or not the instance is EBS optimized. |
| EBS Read Data (Bytes) | Bytes read from all EBS volumes attached to the instance in a specified period of time. |
| EBS Reads | Completed read operations from all Amazon EBS volumes attached to the instance in a specified period of time. |
| EBS Write Data (Bytes) | Bytes written to all EBS volumes attached to the instance in a specified period of time. |
| EBS Writes | Completed write operations to all EBS volumes attached to the instance in a specified period of time. |
| EBSIO Balance (%) | Available only for the smaller C5 and M5 instance sizes. Provides information about the percentage of I/O credits remaining in the burst bucket. This metric is available for basic monitoring only. |
| ELB DNS Name | Elastic Load Balancer the instance is on. |
| Hypervisor | Hypervisor of the instance. |
| Image ID | Image ID of the instance. |
| Instance Id | This dimension filters the data you request for the identified instance only. This helps you pinpoint an exact instance from which to monitor data. |
| Instance Type | This dimension filters the data you request for all instances running with this specified instance type. This helps you categorize your data by the type of instance running. For example, you might compare data from an m1.small instance and an m1.large instance to determine which has the better business value for your application. Available for instances with Detailed Monitoring enabled. |
| IP Address | Public IP Address of the instance. |
| Kernel ID | Kernel ID of the instance. |
| Lifecycle | Lifecycle of the instance. |
| Maximum Network Packets In | The maximum 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. |
| Maximum Network Packets Out | The maximum 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. |
| Minimum Network Packets In | The minimum 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. |
| Minimum Network Packets Out | The minimum 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. |
| Network In | The number of bytes received on all network interfaces by the instance. This metric identifies the volume of incoming network traffic to a single instance. |
| Network Interface ID | Network Interface ID of the instance. |
| Network Out (Bytes) | The number of bytes sent out on all network interfaces by the instance. This metric identifies the volume of outgoing network traffic from a single instance. |
| Platform | Platform of the instance. |
| Public DNS Name | Public DNS name of the instance. |
| Region | The AWS Region this object belongs to. |
| Root Device Name | Root device of the instance. |
| Root Device Type | Root device type of the instance. |
| State | Instance status name of the instance. |
| Status | Instance status of the instance. |
| Status Check Failed | Reports whether the instance has passed both the instance status check and the system status check in the last minute. |
| Status Check Failed Instance | Reports whether the instance has passed the instance status check in the last minute. |
| Status Check Failed System | Reports whether the instance has passed the system status check in the last minute. |
| Subnet ID | Subnet type of the instance. |
| System Status | System status of the instance. |
| Tags | The tags attached to this object. |
| Type | Type of the instance. |
| Virtualization Type | Virtualization type of the instance. |
| VPC ID | VCP on which the instance is running. |
Updated over 4 years ago