get-load-balancer-metric-data

Описание

Возвращает информацию о показателях работоспособности вашего балансировщика нагрузки Lightsail.

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

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

Синтаксис

  get-load-balancer-metric-data
--load-balancer-name <value>
--metric-name <value>
--period <value>
--start-time <value>
--end-time <value>
--unit <value>
--statistics <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]

Параметры

--load-balancer-name (строка)

Имя балансировщика нагрузки.

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

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

Допустимые имена показателей балансировщика нагрузки перечислены ниже, вместе с наиболее полезными statistics для включения в запрос, и опубликованными unit значениями.

**ClientTLSNegotiationErrorCount ** - Количество TLS-соединений, инициированных клиентом, которые не установили сеанс с балансировщиком нагрузки из-за TLS-ошибки, сгенерированной балансировщиком. Возможные причины включают несовпадение шифров или протоколов. Statistics : Наиболее полезная статистика - Sum . Unit : Опубликованная единица измерения - Count .
**HealthyHostCount ** - Количество целевых экземпляров, которые считаются работоспособными. Statistics : Наиболее полезные статистические данные - Average , Minimum и Maximum . Unit : Опубликованная единица измерения - Count .
**HTTPCode_Instance_2XX_Count ** - Количество HTTP-кодов ответа 2XX, сгенерированных целевыми экземплярами. Это не включает коды ответа, сгенерированные балансировщиком. Statistics : Наиболее полезная статистика - Sum . Обратите внимание, что Minimum , Maximum и Average все возвращают 1 . Unit : Опубликованная единица измерения - Count .
**HTTPCode_Instance_3XX_Count ** - Количество HTTP-кодов ответа 3XX, сгенерированных целевыми экземплярами. Это не включает коды ответа, сгенерированные балансировщиком. Statistics : Наиболее полезная статистика - Sum . Обратите внимание, что Minimum , Maximum и Average все возвращают 1 . Unit : Опубликованная единица измерения - Count .
**HTTPCode_Instance_4XX_Count ** - Количество HTTP-кодов ответа 4XX, сгенерированных целевыми экземплярами. Это не включает коды ответа, сгенерированные балансировщиком. Statistics : Наиболее полезная статистика - Sum . Обратите внимание, что Minimum , Maximum и Average все возвращают 1 . Unit : Опубликованная единица измерения - Count .
**HTTPCode_Instance_5XX_Count ** - Количество HTTP-кодов ответа 5XX, сгенерированных целевыми экземплярами. Это не включает коды ответа, сгенерированные балансировщиком. Statistics : Наиболее полезная статистика - Sum . Обратите внимание, что Minimum , Maximum и Average все возвращают 1 . Unit : Опубликованная единица измерения - Count .
**HTTPCode_LB_4XX_Count ** - Количество HTTP-кодов ошибки клиента 4XX, исходящих от балансировщика нагрузки. Ошибки клиента генерируются, когда запросы имеют неправильный формат или неполные. Эти запросы не были получены целевым экземпляром. Это количество не включает коды ответа, сгенерированные целевыми экземплярами. Statistics : Наиболее полезная статистика - Sum . Обратите внимание, что Minimum , Maximum и Average все возвращают 1 . Unit : Опубликованная единица измерения - Count .
**HTTPCode_LB_5XX_Count ** - Количество HTTP-кодов ошибки сервера 5XX, исходящих от балансировщика нагрузки. Это не включает коды ответа, сгенерированные целевым экземпляром. Этот показатель сообщается, если к балансировщику нагрузки нет подключенных работоспособных экземпляров, или если скорость запросов превышает емкость экземпляров (переполнение) или балансировщика. Statistics : Наиболее полезная статистика - Sum . Обратите внимание, что Minimum , Maximum и Average все возвращают 1 . Unit : Опубликованная единица измерения - Count .
**InstanceResponseTime ** - Время в секундах, прошедшее после того, как запрос покинул балансировщик нагрузки, до получения ответа от целевого экземпляра. Statistics : Наиболее полезная статистика - Average . Unit : Опубликованная единица измерения - Seconds .
**RejectedConnectionCount ** - Количество подключений, которые были отклонены, так как балансировщик нагрузки достиг максимального числа подключений. Statistics : Наиболее полезная статистика - Sum . Unit : Опубликованная единица измерения - Count .
**RequestCount ** - Количество обработаных запросов по протоколу IPv4. Это количество включает только запросы с ответом, сгенерированным целевым экземпляром балансировщика. Statistics : Наиболее полезная статистика - Sum . Обратите внимание, что Minimum , Maximum и Average все возвращают 1 . Unit : Опубликованная единица измерения - Count .
**UnhealthyHostCount ** - Количество целевых экземпляров, которые считаются неработоспособными. Statistics : Наиболее полезные статистические данные - Average , Minimum и Maximum . Unit : Опубликованная единица измерения - Count .

Возможные значения:

ClientTLSNegotiationErrorCount
HealthyHostCount
UnhealthyHostCount
HTTPCode_LB_4XX_Count
HTTPCode_LB_5XX_Count
HTTPCode_Instance_2XX_Count
HTTPCode_Instance_3XX_Count
HTTPCode_Instance_4XX_Count
HTTPCode_Instance_5XX_Count
InstanceResponseTime
RejectedConnectionCount
RequestCount

--period (целое число)

Гранность возвращаемых точек данных в секундах.

--start-time (метка времени)

Начальное время периода.

--end-time (метка времени)

Конечное время периода.

--unit (строка)

Единица измерения для запроса данных показателя. Допустимые единицы измерения зависят от запрашиваемых данных показателя. Для получения допустимых единиц измерения для каждого доступного показателя см. параметр metricName.

Возможные значения:

Seconds
Microseconds
Milliseconds
Bytes
Kilobytes
Megabytes
Gigabytes
Terabytes
Bits
Kilobits
Megabits
Gigabits
Terabits
Percent
Count
Bytes/Second
Kilobytes/Second
Megabytes/Second
Gigabytes/Second
Terabytes/Second
Bits/Second
Kilobits/Second
Megabits/Second
Gigabits/Second
Terabits/Second
Count/Second
None

--statistics (список)

Статистика для показателя.

Доступны следующие статистические данные:

Minimum - Минимальное значение, наблюдаемое за указанный период. Используйте это значение, чтобы определить низкий объем активности вашего приложения.
Maximum - Максимальное значение, наблюдаемое за указанный период. Используйте это значение, чтобы определить высокий объем активности вашего приложения.
Sum - Все значения, предоставленные для соответствующего показателя, сложенные вместе. Вы можете использовать эту статистику, чтобы определить общий объем показателя.
Average - Значение Sum / SampleCount за указанный период. Сравнивая эту статистику с минимальными и максимальными значениями, вы можете определить полный охват показателя и насколько близко среднее использование находится к минимальному и максимальному значениям. Это сравнение поможет вам понять, когда необходимо увеличить или уменьшить ваши ресурсы.
SampleCount - Количество точек данных, используемых для статистического расчета.

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  Minimum
  Maximum
  Sum
  Average
  SampleCount

--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 (boolean)

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

--endpoint-url (string)

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (string)

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

json
text
table
yaml
yaml-stream

--query (string)

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

--profile (string)

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

--region (string)

Регион для использования. Переопределяет настройки из конфигурации/окружения.

--version (string)

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

--color (string)

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

on
off
auto

--no-sign-request (boolean)

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

--ca-bundle (string)

Файл с сертификатами CA для проверки SSL-сертификатов. Переопределяет настройки из конфигурации/окружения.

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

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

--cli-binary-format (string)

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

base64
raw-in-base64-out

--no-cli-pager (boolean)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Вывод

metricName -> (string)

Имя метрики, возвращенной.

metricData -> (list)

Массив объектов, описывающих возвращенные данные метрики.

(структура)

Описание точки данных метрики.

average -> (double)

Среднее значение.

maximum -> (double)

Максимальное значение.

minimum -> (double)

Минимальное значение.

sampleCount -> (double)

Количество выборок.

sum -> (double)

Сумма.

timestamp -> (timestamp)

Отметка времени (1479816991.349).

unit -> (string)

Единица измерения.