Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . elasticbeanstalk ]

describe-instances-health

Description

Retrives detailed information about the health of instances in your AWS Elastic Beanstalk. This operation requires enhanced health reporting .

See also: AWS API Documentation

Synopsis

  describe-instances-health
[--environment-name <value>]
[--environment-id <value>]
[--attribute-names <value>]
[--next-token <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

Options

--environment-name (string)

Specify the AWS Elastic Beanstalk environment by name.

--environment-id (string)

Specify the AWS Elastic Beanstalk environment by ID.

--attribute-names (list)

Specifies the response elements you wish to receive. To retrieve all attributes, set to All . If no attribute names are specified, returns a list of instances.

Syntax:

"string" "string" ...

Where valid values are:
  HealthStatus
  Color
  Causes
  ApplicationMetrics
  RefreshedAt
  LaunchedAt
  System
  Deployment
  AvailabilityZone
  InstanceType
  All

--next-token (string)

Specify the pagination token returned by a previous call.

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

Examples

To view environment health

The following command retrieves health information for instances in an environment named my-env:

aws elasticbeanstalk describe-instances-health --environment-name my-env --attribute-names All

Output:

{
    "InstanceHealthList": [
        {
            "InstanceId": "i-08691cc7",
            "ApplicationMetrics": {
                "Duration": 10,
                "Latency": {
                    "P99": 0.006,
                    "P75": 0.002,
                    "P90": 0.004,
                    "P95": 0.005,
                    "P85": 0.003,
                    "P10": 0.0,
                    "P999": 0.006,
                    "P50": 0.001
                },
                "RequestCount": 48,
                "StatusCodes": {
                    "Status3xx": 0,
                    "Status2xx": 47,
                    "Status5xx": 0,
                    "Status4xx": 1
                }
            },
            "System": {
                "LoadAverage": [
                    0.0,
                    0.02,
                    0.05
                ],
                "CPUUtilization": {
                    "SoftIRQ": 0.1,
                    "IOWait": 0.2,
                    "System": 0.3,
                    "Idle": 97.8,
                    "User": 1.5,
                    "IRQ": 0.0,
                    "Nice": 0.1
                }
            },
            "Color": "Green",
            "HealthStatus": "Ok",
            "LaunchedAt": "2015-08-13T19:17:09Z",
            "Causes": []
        }
    ],
    "RefreshedAt": "2015-08-20T21:09:08Z"
}

Health information is only available for environments with enhanced health reporting enabled. For more information, see Enhanced Health Reporting and Monitoring in the AWS Elastic Beanstalk Developer Guide.

Output

InstanceHealthList -> (list)

Detailed health information about each instance.

(structure)

Detailed health information about an Amazon EC2 instance in your Elastic Beanstalk environment.

InstanceId -> (string)

The ID of the Amazon EC2 instance.

HealthStatus -> (string)

Returns the health status of the specified instance. For more information, see Health Colors and Statuses .

Color -> (string)

Represents the color indicator that gives you information about the health of the EC2 instance. For more information, see Health Colors and Statuses .

Causes -> (list)

Represents the causes, which provide more information about the current health status.

(string)

LaunchedAt -> (timestamp)

The time at which the EC2 instance was launched.

ApplicationMetrics -> (structure)

Request metrics from your application.

Duration -> (integer)

The amount of time that the metrics cover (usually 10 seconds). For example, you might have 5 requests (request_count ) within the most recent time slice of 10 seconds (duration ).

RequestCount -> (integer)

Average number of requests handled by the web server per second over the last 10 seconds.

StatusCodes -> (structure)

Represents the percentage of requests over the last 10 seconds that resulted in each type of status code response.

Status2xx -> (integer)

The percentage of requests over the last 10 seconds that resulted in a 2xx (200, 201, etc.) status code.

Status3xx -> (integer)

The percentage of requests over the last 10 seconds that resulted in a 3xx (300, 301, etc.) status code.

Status4xx -> (integer)

The percentage of requests over the last 10 seconds that resulted in a 4xx (400, 401, etc.) status code.

Status5xx -> (integer)

The percentage of requests over the last 10 seconds that resulted in a 5xx (500, 501, etc.) status code.

Latency -> (structure)

Represents the average latency for the slowest X percent of requests over the last 10 seconds. Latencies are in seconds with one millisecond resolution.

P999 -> (double)

The average latency for the slowest 0.1 percent of requests over the last 10 seconds.

P99 -> (double)

The average latency for the slowest 1 percent of requests over the last 10 seconds.

P95 -> (double)

The average latency for the slowest 5 percent of requests over the last 10 seconds.

P90 -> (double)

The average latency for the slowest 10 percent of requests over the last 10 seconds.

P85 -> (double)

The average latency for the slowest 15 percent of requests over the last 10 seconds.

P75 -> (double)

The average latency for the slowest 25 percent of requests over the last 10 seconds.

P50 -> (double)

The average latency for the slowest 50 percent of requests over the last 10 seconds.

P10 -> (double)

The average latency for the slowest 90 percent of requests over the last 10 seconds.

System -> (structure)

Operating system metrics from the instance.

CPUUtilization -> (structure)

CPU utilization metrics for the instance.

User -> (double)

Percentage of time that the CPU has spent in the User state over the last 10 seconds.

Nice -> (double)

Percentage of time that the CPU has spent in the Nice state over the last 10 seconds.

System -> (double)

Percentage of time that the CPU has spent in the System state over the last 10 seconds.

Idle -> (double)

Percentage of time that the CPU has spent in the Idle state over the last 10 seconds.

IOWait -> (double)

Percentage of time that the CPU has spent in the I/O Wait state over the last 10 seconds.

IRQ -> (double)

Percentage of time that the CPU has spent in the IRQ state over the last 10 seconds.

SoftIRQ -> (double)

Percentage of time that the CPU has spent in the SoftIRQ state over the last 10 seconds.

LoadAverage -> (list)

Load average in the last 1-minute, 5-minute, and 15-minute periods. For more information, see Operating System Metrics .

(double)

Deployment -> (structure)

Information about the most recent deployment to an instance.

VersionLabel -> (string)

The version label of the application version in the deployment.

DeploymentId -> (long)

The ID of the deployment. This number increases by one each time that you deploy source code or change instance configuration settings.

Status -> (string)

The status of the deployment:

  • In Progress : The deployment is in progress.
  • Deployed : The deployment succeeded.
  • Failed : The deployment failed.

DeploymentTime -> (timestamp)

For in-progress deployments, the time that the deployment started.

For completed deployments, the time that the deployment ended.

AvailabilityZone -> (string)

The availability zone in which the instance runs.

InstanceType -> (string)

The instance's type.

RefreshedAt -> (timestamp)

The date and time that the health information was retrieved.

NextToken -> (string)

Pagination token for the next page of results, if available.