AWS ELB (Classic) monitoring integration

Important

Enable the AWS CloudWatch Metric Streams integration to monitor all CloudWatch metrics from your AWS services, including custom namespaces. Individual integrations are no longer our recommended option.

New Relic infrastructure integrations include an Amazon Elastic Classic Load Balancing (ELB) integration for reporting Classic ELB data to New Relic. This document explains the integration's features, how to activate it, and what data can be reported.

Features

New Relic's integration for Amazon Elastic Classic Load Balancing (ELB) reports ELB data, including HTTP code message counts, healthy and unhealthy host counts, latency times, and ELB configuration states. AWS integration data is also available for querying and chart creation in New Relic One.

Amazon offers three types of load balancers: Classic Load Balancer, Application Load Balancer (ALB), and Network Load Balancer (NLB). New Relic also offers an ALB/NLB integration to monitor the last two types of load balancers.

Activate integration

To enable this integration, follow standard procedures to connect AWS services to New Relic.

Configuration and polling

You can change the polling frequency and filter data using configuration options.

Default polling information for the AWS ELB integration:

New Relic polling interval: 5 minutes
Amazon CloudWatch data interval: 1 minute

View and use data

To view and use this integration's data, go to one.newrelic.com > Infrastructure > AWS and select one of the ELB integration links.

You can query and explore your data using the LoadBalancerSample event type, with a provider value of Elb.

Metric data

The integration collects the following metrics. For additional details about these metrics, see Amazon's ELB Classic Load Balancer metrics documentation.

Name	Description
`backendConnectionErrors.Sum`	Rate of the number of connections per second that were not successfully established between the load balancer and the registered instances. The load balancer retries the connection when there are errors, so this count may exceed the request rate. This count also includes any connection errors related to health checks.
`healthyHostCount` `unHealthyHostCount`	The number of healthy or unhealthy instances registered with your load balancer. A newly registered instance is considered healthy after it passes the first health check. If cross-zone load balancing is enabled, the number of healthy instances for the `LoadBalancerName` dimension is calculated across all availability zones. Otherwise, it is calculated per availability zone.
`httpCodeBackend2XX` `httpCodeBackend3XX` `httpCodeBackend4XX` `httpCodeBackend5XX`	[HTTP listener] The number of HTTP response codes generated per second by registered instances. This count does not include any response codes generated by the load balancer.
`httpCodeElb4XX`	[HTTP listener] The number of HTTP `4XX` client error codes generated by the load balancer per minute. Client errors are generated when a request is malformed or incomplete.
`httpCodeElb5XX`	[HTTP listener] The number of HTTP `5XX` server error codes generated by the load balancer per minute. This count does not include any response codes generated by the registered instances. The metric is reported if there are no healthy instances registered to the load balancer, or if the request rate exceeds the capacity of the instances (spillover) or the load balancer.
`latency.Average` `latency.Maximum`	[HTTP listener] The total time elapsed, in seconds, from the time the load balancer sent the request to a registered instance until the instance started to send the response headers. [TCP listener] The total time elapsed, in seconds, for the load balancer to successfully establish a connection to a registered instance. Available statistics: aws.elb.latency.p90 aws.elb.latency.p95 aws.elb.latency.p99
`requestCount`	The number of requests completed or connections made per second during the specified interval (1 or 5 minutes).
`spilloverCount`	The total number of requests that were rejected per second, due to the surge queue being full.
`surgeQueueLength.Average, Maximum, Minimum`	The total number of requests that are pending routing. The load balancer queues a request if it is unable to establish a connection with a healthy instance in order to route the request. The maximum size of the queue is 1,024. Additional requests are rejected when the queue is full. For more information, see `SpilloverCount`.
`estimatedAlbActiveConnectionCount.Average, Maximum, Minimum`	The estimated number of concurrent TCP connections active from clients to the load balancer and from the load balancer to targets.
`estimatedAlbConsumedLcus.Average, Maximum, Minimum`	The estimated number of load balancer capacity units (LCU) used by an application load balancer.
`estimatedAlbNewConnectionCount.Average, Maximum, Minimum`	The estimated number of new TCP connections established from clients to the load balancer and from the load balancer to targets.
`estimatedProcessedBytes.Average, Maximum, Minimum`	The estimated number of bytes processed by an application load balancer.

Inventory data

EOL NOTICE

After March 2022, we're discontinuing support for several capabilities, including inventory data for cloud integrations. For more details, including how you can easily prepare for this transition, see our Explorers Hub post.

The following configuration options are available with the New Relic Amazon ELB integration.

Name	Description
`availabilityZone`	Lists one or more availability zones from the same region as the load balancer.
`awsRegion`	The AWS region that the load balancer runs in.
`canonicalHostedZoneNameId`	The ID of the Amazon Route 53 hosted zone name associated with the load balancer.
`canonicalHostedZoneName`	The name of the Amazon Route 53 hosted zone that is associated with the load balancer. If you specify `internal` for the Elastic Load Balancing scheme, use `DNSNameinstead`. For an internal scheme, the load balancer doesn't have a `CanonicalHostedZoneName` value.
`createdTime`	Timestamp with the date and time the load balancer was created.
`dnsName`	The public DNS name of the load balancer.
`instances`	A JSON string representing the list of IDs of EC2 instances associated with the load balancer.
`listeners`	A JSON string representing the list of Listeners associated with the load balancer.
`loadBalancerName`	The name of the load balancer.
`scheme`	For load balancers attached to an Amazon VPC, this parameter can be used to specify the type of load balancer to use. For more information, see the AWS ElasticLoadBalancing documentation about LoadBalancer properties.
`securityGroups`	A JSON string representing the list of security groups assigned to your load balancer within your virtual private cloud (VPC).
`sourceSecurityGroup`	The security group that you can use as part of your inbound rules for your load balancer's back-end Amazon EC2 application instances.
`subnets`	A JSON string representing the list of subnet IDs in your virtual private cloud (VPC) to attach to your load balancer. Do not specify multiple subnets that are in the same Availability Zone. You can specify the `AvailabilityZones` or `Subnets` property, but not both.
`vpcId`	The ID of the VPC that the load balancer has been configured in.

Child inventory data

Tip

Data indicated with an asterisk * is only fetched if extended inventory collection is on.

Name	Description
`accessLog/enabled` *	A boolean. If `true`, access logs are enabled for this load balancer.
`connectionDraining/enabled` *	A boolean. Use connection draining to ensure that a Classic Load Balancer does not send requests to unhealthy instances. For more information, see the AWS documentation to configure connection draining for your Classic Load Balancer.
`connectionDraining/timeout` *	The number of seconds the load balancer waits before forcibly closing connections to the de-registering instance. Valid values are `1` to `3600`.
`connectionSettings/idleTimeout` *	For more information, see the AWS documentation to configure the idle connection timeout for your Classic Load Balancer.
`crossZoneLoadBalancing/enabled` *	A boolean. For more information, see the AWS documentation to configure cross-zone load balancing for your Classic Load Balancer.
`healthCheck/healthyThreshold`	The number of consecutive successful health checks that must occur before declaring an EC2 instance healthy. Valid values: `2` to `10`.
`healthCheck/interval`	The amount of time in seconds between health checks of an individual instance. Valid values: `5` to `300`.
`healthCheck/target`	Combination of three properties: The protocol to use to connect with the instance. Valid values: `TCP`, `HTTP`, `HTTPS`, and `SSL`. The port to use to connect with the instance, as a `protocol:port` pair. If the load balancer fails to connect with the instance at the specified port within the configured response timeout period, the instance is considered unhealthy. The destination for the HTTP or HTTPS request.
`healthCheck/timeout`	The amount of time in seconds to wait when receiving a response from the health check. Valid values: `2` to `60`.
`healthCheck/unhealthyThreshold`	The number of consecutive failed health checks that must occur before declaring an EC2 instance unhealthy. Valid values: `2` to `10`.
`policies/otherPolicies`	JSON string representing security policies associated with this load balancer.