get-metric-statistics

Описание

Получает статистику для указанного метрики.

Максимальное количество точек данных, возвращаемых за один вызов, составляет 1440. Если вы запросите больше 1440 точек данных, CloudWatch вернёт ошибку. Чтобы уменьшить количество точек данных, вы можете сузить заданный интервал времени и выполнить несколько запросов для смежных интервалов времени или увеличить указанный период. Точки данных не возвращаются в хронологическом порядке.

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

CloudWatch нуждается в исходных точках данных для расчёта статистических данных по перцентилям. Если вы публикуете данные, используя набор статистических данных вместо этого, вы можете получить статистику по перцентилям только для этих данных, если выполняется одно из следующих условий:

• Значение SampleCount набора статистических данных равно 1.
• Значения Min и Max набора статистических данных равны.

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

Amazon CloudWatch сохраняет данные метрик следующим образом:

• Точки данных с периодом менее 60 секунд доступны в течение 3 часов. Эти точки данных являются метриками высокой точности и доступны только для пользовательских метрик, которые были определены с StorageResolution 1.
• Точки данных с периодом 60 секунд (1 минута) доступны в течение 15 дней.
• Точки данных с периодом 300 секунд (5 минут) доступны в течение 63 дней.
• Точки данных с периодом 3600 секунд (1 час) доступны в течение 455 дней (15 месяцев).

Точки данных, которые изначально публикуются с более коротким периодом, агрегируются вместе для долгосрочного хранения. Например, если вы собираете данные с периодом в 1 минуту, данные остаются доступными в течение 15 дней с разрешением в 1 минуту. По истечении 15 дней эти данные всё ещё доступны, но агрегированы и доступны только с разрешением в 5 минут. По истечении 63 дней данные ещё больше агрегируются и доступны с разрешением в 1 час.

CloudWatch начал сохранять данные метрик с периодами в 5 минут и 1 час начиная с 9 июля 2016 года.

Дополнительную информацию о метриках и измерениях, поддерживаемых службами Amazon Web Services, см. в разделе «Справочник по метрикам и измерениям Amazon CloudWatch» в руководстве пользователя Amazon CloudWatch.

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

Синтаксис

  get-metric-statistics
--namespace <value>
--metric-name <value>
[--dimensions <value>]
--start-time <value>
--end-time <value>
--period <value>
[--statistics <value>]
[--extended-statistics <value>]
[--unit <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]

Параметры

--namespace (строка)

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

--dimensions (список)

Сокращённый синтаксис:

Name=string,Value=string ...

Синтаксис JSON:

[
  {
    "Name": "string",
    "Value": "string"
  }
  ...
]

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

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

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

--statistics (список)

Синтаксис:

"string" "string" ...

Where valid values are:
  SampleCount
  Average
  Sum
  Minimum
  Maximum

--extended-statistics (список)

Синтаксис:

"string" "string" ...

--unit (строка)

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

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если предоставлено значение null или 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 V1, а двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, 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.

Примеры

Получение использования ЦП на каждый экземпляр EC2

В следующем примере используется команда get-metric-statistics для получения использования ЦП для экземпляра EC2 с идентификатором i-abcdef.

aws cloudwatch get-metric-statistics --metric-name CPUUtilization --start-time 2014-04-08T23:18:00Z --end-time 2014-04-09T23:18:00Z --period 3600 --namespace AWS/EC2 --statistics Maximum --dimensions Name=InstanceId,Value=i-abcdef

Вывод:

{
    "Datapoints": [
        {
            "Timestamp": "2014-04-09T11:18:00Z",
            "Maximum": 44.79,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T20:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T19:18:00Z",
            "Maximum": 50.85,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T09:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T03:18:00Z",
            "Maximum": 76.84,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T21:18:00Z",
            "Maximum": 48.96,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T14:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T08:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T16:18:00Z",
            "Maximum": 45.55,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T06:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T13:18:00Z",
            "Maximum": 45.08,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T05:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T18:18:00Z",
            "Maximum": 46.88,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T17:18:00Z",
            "Maximum": 52.08,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T07:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T02:18:00Z",
            "Maximum": 51.23,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T12:18:00Z",
            "Maximum": 47.67,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-08T23:18:00Z",
            "Maximum": 46.88,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T10:18:00Z",
            "Maximum": 51.91,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T04:18:00Z",
            "Maximum": 47.13,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T15:18:00Z",
            "Maximum": 48.96,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T00:18:00Z",
            "Maximum": 48.16,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T01:18:00Z",
            "Maximum": 49.18,
            "Unit": "Percent"
        }
    ],
    "Label": "CPUUtilization"
}

Указание нескольких измерений

Следующий пример демонстрирует, как указать несколько измерений. Каждое измерение указывается как пара Имя/Значение, разделенная запятой. Несколько измерений разделяются пробелом. Если один метрика включает несколько измерений, вы должны указать значение для каждого определенного измерения.

Дополнительные примеры использования команды get-metric-statistics см. в разделе `Получение статистики для метрики`__ в Руководстве разработчика Amazon CloudWatch.

aws cloudwatch get-metric-statistics --metric-name Buffers --namespace MyNameSpace --dimensions Name=InstanceID,Value=i-abcdef Name=InstanceType,Value=m1.small --start-time 2016-10-15T04:00:00Z --end-time 2016-10-19T07:00:00Z --statistics Average --period 60

Вывод

Метка -> (строка)

Точки данных -> (список)