Spec-Zone.ru › AWS CLI v2

[ aws . elasticbeanstalk ]

describe-instances-health

Описание

Получает подробную информацию о состоянии экземпляров в вашем AWS Elastic Beanstalk. Для этой операции требуется расширенное отчётное представление о состоянии.

См. также: Документация API AWS

Синтаксис

  describe-instances-health
[--environment-name <value>]
[--environment-id <value>]
[--attribute-names <value>]
[--next-token <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--environment-name (строка)

Указывает среду AWS Elastic Beanstalk по имени.

--environment-id (строка)

Указывает среду AWS Elastic Beanstalk по идентификатору.

--attribute-names (список)

Указывает элементы ответа, которые вы хотите получить. Для получения всех атрибутов установите значение All. Если имена атрибутов не указаны, возвращается список экземпляров.

(строка)

Синтаксис:

"string" "string" ...

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

--next-token (строка)

Указывает токен постраничной навигации, возвращённый предыдущим вызовом.

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределят значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного значения JSON, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено без значения или со значением input, выводит пример JSON-ввода, который может использоваться как аргумент для --cli-input-json. Аналогично, если предоставлено yaml-input, это выведет пример YAML-ввода, который можно использовать с --cli-input-yaml. Если предоставлено значение output, это валидирует входные данные команд и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет нестабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (логическое значение)

Включить отладку.

--endpoint-url (строка)

Переопределить URL по умолчанию команды указанным URL.

--no-verify-ssl (логическое значение)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение по умолчанию по проверке сертификатов SSL.

--no-paginate (логическое значение)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования для вывода команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из вашего файла с данными учётных записей.

--region (строка)

Регион для использования. Переопределяет настройки config/env.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

  • on
  • off
  • auto

--no-sign-request (логическое значение)

Не подписывать запросы. Учётные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Файл с сертификатами CA для проверки сертификатов SSL. Переопределяет настройки config/env.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения к сокету в секундах. Если значение установлено в 0, подключение к сокету будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования для использования с двоичными блоками. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной в base64 строки. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, fileb:// всегда будет рассматриваться как двоичный и будет использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла необходимо правильно отформатировать для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (логическое значение)

Отключить вывод с использованием кли-пейджера.

--cli-auto-prompt (логическое значение)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматическое запросы параметров ввода CLI.

Примеры

Примечание

Чтобы использовать следующие примеры, вы должны иметь установленный и настроенный AWS CLI. Подробности см. в руководстве по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования, аналогичные Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки терминала. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

Для просмотра состояния среды

Следующая команда получает информацию о состоянии экземпляров в среде с именем my-env:

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

Вывод:

{
    "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"
}

Информация о состоянии доступна только для сред с включённым расширенным отчётом о состоянии. Подробнее см. в Руководстве разработчика AWS Elastic Beanstalk в разделе Расширенный отчёт о состоянии и мониторинг.

Вывод

InstanceHealthList -> (список)

Подробная информация о состоянии каждого экземпляра.

Вывод немного отличается в средах Linux и Windows. Есть разница в поддерживаемых членах типа <CPUUtilization>.

(структура)

Подробная информация о состоянии экземпляра Amazon EC2 в вашем окружении Elastic Beanstalk.

InstanceId -> (строка)

Идентификатор экземпляра Amazon EC2.

HealthStatus -> (строка)

Возвращает состояние работоспособности указанного экземпляра. Для получения дополнительной информации см. Цвета и состояния работоспособности .

Color -> (строка)

Представляет индикатор цвета, предоставляющий информацию о состоянии работоспособности экземпляра EC2. Для получения дополнительной информации см. Цвета и состояния работоспособности .

Causes -> (список)

Представляет причины, которые предоставляют дополнительную информацию о текущем состоянии работоспособности.

(строка)

LaunchedAt -> (метка времени)

Время запуска экземпляра EC2.

ApplicationMetrics -> (структура)

Метрики запросов из вашего приложения.

Duration -> (целое число)

Продолжительность периода, охватываемого метриками (обычно 10 секунд). Например, у вас может быть 5 запросов (request_count ) в течение последнего 10-секундного временного интервала (duration ).

RequestCount -> (целое число)

Среднее количество запросов, обрабатываемых веб-сервером в секунду за последние 10 секунд.

StatusCodes -> (структура)

Представляет процент запросов за последние 10 секунд, которые привели к каждому типу кода состояния ответа.

Status2xx -> (целое число)

Процент запросов за последние 10 секунд, которые привели к коду состояния 2xx (200, 201 и т. д.).

Status3xx -> (целое число)

Процент запросов за последние 10 секунд, которые привели к коду состояния 3xx (300, 301 и т. д.).

Status4xx -> (целое число)

Процент запросов за последние 10 секунд, которые привели к коду состояния 4xx (400, 401 и т. д.).

Status5xx -> (целое число)

Процент запросов за последние 10 секунд, которые привели к коду состояния 5xx (500, 501 и т. д.).

Latency -> (структура)

Представляет среднюю задержку для самых медленных X процентов запросов за последние 10 секунд. Задержки указаны в секундах с разрешением в одну миллисекунду.

P999 -> (двойное)

Средняя задержка для самых медленных 0,1 процента запросов за последние 10 секунд.

P99 -> (двойное)

Средняя задержка для самых медленных 1 процента запросов за последние 10 секунд.

P95 -> (двойное)

Средняя задержка для самых медленных 5 процентов запросов за последние 10 секунд.

P90 -> (двойное)

Средняя задержка для самых медленных 10 процентов запросов за последние 10 секунд.

P85 -> (двойное)

Средняя задержка для самых медленных 15 процентов запросов за последние 10 секунд.

P75 -> (двойное)

Средняя задержка для самых медленных 25 процентов запросов за последние 10 секунд.

P50 -> (двойное)

Средняя задержка для самых медленных 50 процентов запросов за последние 10 секунд.

P10 -> (двойное)

Средняя задержка для самых медленных 90 процентов запросов за последние 10 секунд.

System -> (структура)

Метрики операционной системы из экземпляра.

CPUUtilization -> (структура)

Метрики использования процессора для экземпляра.

User -> (двойное)

Процент времени, которое процессор провел в состоянии User за последние 10 секунд.

Nice -> (двойное)

Доступно только в средах Linux.

Процент времени, которое процессор провел в состоянии Nice за последние 10 секунд.

System -> (двойное)

Доступно только в средах Linux.

Процент времени, которое процессор провел в состоянии System за последние 10 секунд.

Idle -> (двойное)

Процент времени, которое процессор провел в состоянии Idle за последние 10 секунд.

IOWait -> (двойное)

Доступно только в средах Linux.

Процент времени, которое процессор провел в состоянии I/O Wait за последние 10 секунд.

IRQ -> (двойное)

Доступно только в средах Linux.

Процент времени, которое процессор провел в состоянии IRQ за последние 10 секунд.

SoftIRQ -> (двойное)

Доступно только в средах Linux.

Процент времени, которое процессор провел в состоянии SoftIRQ за последние 10 секунд.

Privileged -> (двойное)

Доступно только в средах Windows.

Процент времени, которое процессор провел в состоянии Privileged за последние 10 секунд.

LoadAverage -> (список)

Средняя нагрузка за последние 1, 5 и 15 минут. Для получения дополнительной информации см. Метрики операционной системы .

(двойное)

Deployment -> (структура)

Информация о последнем развертывании в экземпляре.

VersionLabel -> (строка)

Метка версии приложения в развертывании.

DeploymentId -> (длинное целое число)

Идентификатор развертывания. Это число увеличивается на единицу каждый раз, когда вы развертываете исходный код или изменяете настройки экземпляра.

Status -> (строка)

Состояние развертывания:

  • In Progress : Развертывание выполняется.
  • Deployed : Развертывание завершилось успешно.
  • Failed : Развертывание завершилось неудачно.

DeploymentTime -> (метка времени)

Для выполняемых развертываний — время начала развертывания.

Для завершенных развертываний — время окончания развертывания.

AvailabilityZone -> (строка)

Зона доступности, в которой работает экземпляр.

InstanceType -> (строка)

Тип экземпляра.

RefreshedAt -> (метка времени)

Дата и время получения информации о состоянии.

NextToken -> (строка)

Токен постраничной навигации для следующей страницы результатов, если доступен.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API