AWS elb metricset

edit

Elastic Load Balancing publishes data points to Amazon CloudWatch for your load balancers and your back-end instances. This aws elb metricset collects these Cloudwatch metrics for monitoring purposes.

AWS Permissions

edit

Some specific AWS permissions are required for IAM user to collect AWS ELB metrics.

ec2:DescribeRegions
cloudwatch:GetMetricData
cloudwatch:ListMetrics
tag:getResources
sts:GetCallerIdentity
iam:ListAccountAliases

Dashboard

edit

The aws elb metricset comes with a predefined dashboard for classic ELB. For example:

metricbeat aws elb overview

Configuration example

edit
- module: aws
  period: 300s
  metricsets:
    - elb
  access_key_id: '${AWS_ACCESS_KEY_ID:""}'
  secret_access_key: '${AWS_SECRET_ACCESS_KEY:""}'
  session_token: '${AWS_SESSION_TOKEN:""}'
  default_region: '${AWS_REGION:us-west-1}'
  # This module uses the aws cloudwatch metricset, all
  # the options for this metricset are also available here.

Metrics

edit

elb metricset collects Cloudwatch metrics from classic ELB, application ELB and network ELB.

Metrics for Classic ELB

edit

Metric Name

Statistic Method

BackendConnectionErrors

Sum

HealthyHostCount

Maximum

HTTPCode_Backend_2XX

Sum

HTTPCode_Backend_3XX

Sum

HTTPCode_Backend_4XX

Sum

HTTPCode_Backend_5XX

Sum

HTTPCode_ELB_4XX

Sum

HTTPCode_ELB_5XX

Sum

Latency

Average

RequestCount

Sum

SpilloverCount

Sum

SurgeQueueLength

Maximum

UnHealthyHostCount

Maximum

EstimatedALBActiveConnectionCount

Average

EstimatedALBConsumedLCUs

Average

EstimatedALBNewConnectionCount

Average

EstimatedProcessedBytes

Average

Metrics for Application ELB

edit

Metric Name

Statistic Method

ActiveConnectionCount

Sum

ClientTLSNegotiationErrorCount

Sum

ConsumedLCUs

Average

HTTP_Fixed_Response_Count

Sum

HTTP_Redirect_Count

Sum

HTTP_Redirect_Url_Limit_Exceeded_Count

Sum

HTTPCode_ELB_3XX_Count

Sum

HTTPCode_ELB_4XX_Count

Sum

HTTPCode_ELB_5XX_Count

Sum

HTTPCode_ELB_500_Count

Sum

HTTPCode_ELB_502_Count

Sum

HTTPCode_ELB_503_Count

Sum

HTTPCode_ELB_504_Count

Sum

IPv6ProcessedBytes

Sum

IPv6RequestCount

Sum

NewConnectionCount

Sum

ProcessedBytes

Sum

RejectedConnectionCount

Sum

RequestCount

Sum

RuleEvaluations

Sum

Metrics for Network ELB

edit

Metric Name

Statistic Method

ActiveFlowCount

Average

ActiveFlowCount_TLS

Average

ClientTLSNegotiationErrorCount

Sum

ConsumedLCUs

Average

HealthyHostCount

Maximum

NewFlowCount

Sum

NewFlowCount_TLS

Sum

ProcessedBytes

Sum

ProcessedBytes_TLS

Sum

TargetTLSNegotiationErrorCount

Sum

TCP_Client_Reset_Count

Sum

TCP_ELB_Reset_Count

Sum

TCP_Target_Reset_Count

Sum

UnHealthyHostCount

Average

EstimatedALBConsumedLCUs

Maximum

This is a default metricset. If the host module is unconfigured, this metricset is enabled by default.

Fields

edit

For a description of each field in the metricset, see the exported fields section.

Here is an example document generated by this metricset:

{
    "@timestamp": "2017-10-12T08:05:34.853Z",
    "aws": {
        "cloudwatch": {
            "namespace": "AWS/ELB"
        },
        "dimensions": {
            "Namespace": "AWS"
        },
        "elb": {
            "metrics": {
                "HealthyHostCount": {
                    "max": 2
                },
                "Latency": {
                    "avg": 0.000005960464477539062
                },
                "RequestCount": {
                    "sum": 1
                },
                "SurgeQueueLength": {
                    "max": 1
                },
                "UnHealthyHostCount": {
                    "max": 0
                }
            }
        }
    },
    "cloud": {
        "account": {
            "id": "428152502467",
            "name": "elastic-beats"
        },
        "provider": "aws",
        "region": "us-east-1"
    },
    "event": {
        "dataset": "aws.elb",
        "duration": 115000,
        "module": "aws"
    },
    "metricset": {
        "name": "elb",
        "period": 10000
    },
    "service": {
        "type": "aws"
    }
}