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.
{
"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": "*"
}
]
}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)
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.
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.