Amazon Web Services Integration

Bleemeo can also fetch metrics from CloudWatch and let you build dashboards with CloudWatch metrics and other Bleemeo metrics.

Configuration

To configure AWS integration, you have in settings to go on the “AWS” tab and enter your AWS Access Key ID and AWS Secret Access Key. You can refer to AWS IAM documentation to create those API keys and configure the appropriate permissions to those keys. Permission needed are detailed below and depends on which metrics are activated.

Those API keys will allow Bleemeo to query your AWS infrastructure.

You can use toggle to choose with CloudWatch metrics you want to activate.

Warning

The AWS API calls done to fetch metrics may have a cost on your AWS bills. Estimated cost provided in this page are valid for all region but South America and GovCloud.

AWS CloudWatch have a free tier equivalent to $10 per month.

AWS Integration configuration in Bleemeo

When configured, you will get additional metrics on your account that you can graph on Custom Dashboard.

Metrics

We will detail here the permission needed and all metrics that are fetched from AWS CloudWatch and that you can use in your dashboard.

List of supported services:

DynamoDB

Amazon description of the service is available at: https://aws.amazon.com/dynamodb/

Metrics available:

  • dynamodb_consumed_read_capacity: Number of read unit consumed per second
  • dynamodb_consumed_write_capacity: Number write unit consumed per second
  • dynamodb_read_capacity_perc: Read capacity used in percent
  • dynamodb_write_capacity_perc: Write capacity used in percent
  • dynamodb_read_requests: Number read requests per second
  • dynamodb_write_requests: Number write requests per second
  • dynamodb_read_throttled_requests: Number read request throttled per second
  • dynamodb_write_throttled_requests: Number write request throttled per second

IAM Permissions needed:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": "cloudwatch:GetMetricStatistics",
            "Effect": "Allow",
            "Resource": "*"
        },
        {
            "Action": "dynamodb:ListTables",
            "Effect": "Allow",
            "Resource": "*"
        }
    ]
}

Estimated AWS cost:

  • For each DynamoDB tables, every minutes Bleemeo will do 4 cloudwatch API call: $1.76 / month / table

EC2

Amazon description of the service is available at: https://aws.amazon.com/ec2/

Note

If you have Bleemeo agent running on your EC2 instance, Bleemeo agent will already sent all those metrics.

In such case, if you enable AWS EC2 integration those metrics will be sent twice: once from bleemeo-agent and once from AWS EC2 integration. We recommend only using Bleemeo agent.

Metrics available:

  • ec2_cpu_used: CPU used in percent
  • ec2_net_bits_recv: Network traffic received in bits per second
  • ec2_net_bits_sent: Network traffic sent in bits per second.
  • ec2_io_read_bytes: Disk read throughput in bytes per second.
  • ec2_io_reads: Number of reads completed per second.
  • ec2_io_time: Time spent doing I/O in milliseconds per second.
  • ec2_io_utilization: Disk IO utilization in percent.
  • ec2_io_write_bytes: Disk write throughput in bytes per second.
  • ec2_io_writes: Number of writes completed per second.

IAM Permissions needed:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": "cloudwatch:GetMetricStatistics",
            "Effect": "Allow",
            "Resource": "*"
        },
        {
            "Action": "ec2:DescribeInstances",
            "Effect": "Allow",
            "Resource": "*"
        },
        {
            "Action": "ec2:DescribeVolumes",
            "Effect": "Allow",
            "Resource": "*"
        }
    ]
}

Estimated AWS cost:

  • For each EC2 with one EBS attached, every 5 minutes Bleemeo will do 8 CloudWatch API call: $0.7 / month / ec2
  • For each additional EBS attached, every 5 minutes Bleemeo will do 5 additional CloudWatch API call: $0.44 / month / additional attached EBS
  • For example, each EC2 with 2 EBS attached, every 5 minutes Bleemeo will do 13 CloudWatch API call: $1.14 / month / ec2

ELB

Amazon description of the service is available at: https://aws.amazon.com/elasticloadbalancing/

Metrics available:

  • elb_request: Number of requests per second
  • elb_unhealthy_host: Number of backend unhealthy
  • elb_healthy_host: Number of backend healthy
  • elb_backend_errors: Number of backend connection errors per second

IAM Permissions needed:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": "cloudwatch:GetMetricStatistics",
            "Effect": "Allow",
            "Resource": "*"
        },
        {
            "Action": "elasticloadbalancing:DescribeLoadBalancers",
            "Effect": "Allow",
            "Resource": "*"
        }
    ]
}

Estimated AWS cost:

  • For each ELB, every minutes Bleemeo will do 4 cloudwatch API call: $1.76 / month / elb

RDS

Amazon description of the service is available at: https://aws.amazon.com/rds/

Metrics available:

  • rds_cpu_used: CPU used in percent
  • rds_mem_used: Memory used in percent
  • rds_mem_used_perc: Memory used in bytes
  • rds_mem_free: Memory available in bytes
  • rds_disk_used: Filesystem space used in bytes
  • rds_disk_used_perc: Filesystem space used in percent
  • rds_disk_free: Filesystem space available in bytes
  • rds_io_reads: Number of reads completed per second
  • rds_io_writes: Number of writes completed per second
  • rds_connection: Number of DB connections

IAM Permissions needed:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": "cloudwatch:GetMetricStatistics",
            "Effect": "Allow",
            "Resource": "*"
        },
        {
            "Action": "rds:DescribeDBInstances",
            "Effect": "Allow",
            "Resource": "*"
        }
    ]
}

Estimated AWS cost:

  • For each RDS instance, every minutes Bleemeo will do 6 cloudwatch API call: $2.64 / month / db instance

S3

Amazon description of the service is available at: https://aws.amazon.com/s3/

Metrics available:

  • s3_objects_count: Number of objects in the bucket
  • s3_bucket_size: Bucket size in bytes

IAM Permissions needed:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": "cloudwatch:GetMetricStatistics",
            "Effect": "Allow",
            "Resource": "*"
        },
        {
            "Action": "s3:ListBucket",
            "Effect": "Allow",
            "Resource": "*"
        },
        {
            "Action": "s3:GetBucketLocation",
            "Effect": "Allow",
            "Resource": "*"
        }
    ]
}

Estimated AWS cost:

  • For each S3 buckets, few times a day (up to 3) Bleemeo will do 4 cloudwatch API call: less than $0.01 / month / buckets