обновить-цель-уровня-обслуживания

Описание

Обновляет существующую цель уровня обслуживания (SLO). Если вы опустите параметры, предыдущие значения этих параметров сохранятся.

Вы не можете изменить SLO на основе периода на SLO на основе запросов или изменить SLO на основе запросов на SLO на основе периода.

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

Синтаксис

  update-service-level-objective
--id <value>
[--description <value>]
[--sli-config <value>]
[--request-based-sli-config <value>]
[--goal <value>]
[--burn-rate-configurations <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]

Параметры

--id (строка)

Amazon Resource Name (ARN) или имя цели уровня обслуживания, которую вы хотите обновить.

--description (строка)

Необязательное описание для SLO.

--sli-config (структура)

Если данная ЦУ — ЦУ на основе периода, эта структура определяет информацию о том, какой показатель производительности эта ЦУ будет отслеживать.

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

Используйте эту структуру для указания метрики, которая должна использоваться для ЦУ.

KeyAttributes -> (карта)

Если эта ЦУ связана с метрикой, собранной с помощью Сигналов приложения, вы должны использовать это поле для указания службы, к которой относится метрика ЦУ. Для этого вы должны указать как минимум атрибуты Type , Name , и Environment .

Это карта «строка-строка». Она может включать следующие поля.

Type обозначает тип объекта.
ResourceType определяет тип ресурса. Это поле используется только тогда, когда значение поля Type равно Resource или AWS::Resource .
Name указывает имя объекта. Это используется только в том случае, если значение поля Type равно Service , RemoteService , или AWS::Service .
Identifier идентифицирует объекты ресурсов данного ресурса. Это используется только в том случае, если значение поля Type равно Resource или AWS::Resource .
Environment указывает место размещения этого объекта или к чему он относится.

key -> (строка)

value -> (строка)

OperationName -> (строка)

Если ЦУ должна отслеживать определённую операцию службы, используйте это поле для указания имени этой операции.

MetricType -> (строка)

Если ЦУ должна отслеживать либо метрику LATENCY , либо метрику AVAILABILITY , собираемую Сигналы приложения, используйте это поле для указания, какая из этих метрик используется.

Statistic -> (строка)

Статистика для сравнения с пороговым значением. Она может быть любой статистикой CloudWatch или расширенной статистикой. Дополнительную информацию о статистике см. в определениях статистики CloudWatch .

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

Количество секунд, используемых в качестве периода для оценки ЦУ. Производительность вашего приложения сравнивается со SLI в течение каждого периода. Для каждого периода определяется, достигнута ли необходимая производительность или нет.

MetricDataQueries -> (список)

Если эта ЦУ отслеживает метрику CloudWatch или результат математического выражения метрики CloudWatch, используйте эту структуру для указания этой метрики или выражения.

(структура)

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

Каждый элемент MetricDataQuery в массиве MetricDataQueries указывает либо метрику для извлечения, либо математическое выражение метрики для выполнения над извлечёнными метриками. Один массив MetricDataQueries может содержать до 20 структур MetricDataQuery в массиве. Эти 20 структур могут содержать до 10 структур с параметром MetricStat для извлечения метрики и до 10 структур с параметром Expression для выполнения математического выражения. Из этих структур Expression ровно одна должна иметь значение true для параметра ReturnData . Результат этого выражения используется для ЦУ.

Дополнительную информацию о математических выражениях метрик см. в CloudWatchUse metric math .

В каждом объекте MetricDataQuery вы должны указать либо Expression , либо MetricStat , но не оба.

Id -> (строка)

Короткое имя, используемое для привязки этого объекта к результатам в ответе. Это Id должно быть уникальным в массиве MetricDataQueries . Если вы выполняете математические выражения над этим набором данных, это имя представляет эти данные и может служить переменной в математическом выражении метрики. Допустимые символы — буквы, цифры и знак подчёркивания. Первый символ должен быть строчной буквой.

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

Метрика, которая будет использоваться непосредственно для ЦУ или которая будет использоваться в математическом выражении, используемом для ЦУ.

В одном объекте MetricDataQuery вы должны указать либо Expression , либо MetricStat , но не оба.

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

Метрика, используемая в качестве показателя уровня обслуживания, включая имя метрики, пространство имён и измерения.

Namespace -> (строка)

Пространство имён метрики. Дополнительную информацию см. в разделе Пространства имён .

MetricName -> (строка)

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

Dimensions -> (список)

Массив одного или более измерений для определения метрики, которую вы хотите использовать. Дополнительную информацию см. в разделе Измерения .

(структура)

Измерение — это пара «имя/значение», являющаяся частью идентификатора метрики. Поскольку измерения являются частью уникального идентификатора метрики, каждый раз, когда вы добавляете уникальную пару «имя/значение» в одну из ваших метрик, вы создаёте новую разновидность этой метрики. Например, многие метрики Amazon EC2 публикуют InstanceId в качестве имени измерения, а фактический идентификатор экземпляра — в качестве значения этого измерения.

Вы можете назначить до 30 измерений метрике.

Name -> (строка)

Имя измерения. Имена измерений должны содержать только символы ASCII, включать по крайней мере один символ, не являющийся пробелом, и не начинаться с двоеточия (: ). ASCII-управляющие символы не поддерживаются в качестве части имён измерений.

Value -> (строка)

Значение измерения. Значения измерений должны содержать только символы ASCII и включать по крайней мере один символ, не являющийся пробелом. ASCII-управляющие символы не поддерживаются в качестве части значений измерений.

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

Разрешение в секундах для метрики. Для метрик с обычным разрешением период может быть не короче одной минуты (60 секунд) и должен быть кратен 60. Для метрик с высоким разрешением, которые собираются с интервалами менее одной минуты, период может быть 1, 5, 10, 30, 60 или любым кратным 60. Метрики с высоким разрешением — это метрики, сохранённые с помощью вызова PutMetricData, который включает в себя StorageResolution в 1 секунду.

Stat -> (строка)

Unit -> (строка)

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

Expression -> (строка)

Это поле может содержать математическое выражение метрики, которое будет выполняться над другими метриками, которые вы извлекаете в этой структуре MetricDataQueries .

Математическое выражение может использовать Id других метрик или запросов для ссылки на эти метрики, а также может использовать Id других выражений для использования результата этих выражений. Дополнительную информацию о математических выражениях метрик см. в разделе Синтаксис и функции математических выражений метрик в руководстве пользователя Amazon CloudWatch .

В каждом объекте MetricDataQuery вы должны указать либо Expression , либо MetricStat , но не оба.

Label -> (строка)

Читаемое человеком метка для этой метрики или выражения. Это особенно полезно, если это выражение, чтобы вы знали, что представляет значение. Если метрика или выражение отображаются в виджете панели мониторинга CloudWatch, отображается метка. Если Label опущена, CloudWatch генерирует значение по умолчанию.

Вы можете вставить динамические выражения в метку, чтобы сделать её более описательной. Дополнительную информацию см. в разделе Использование динамических меток .

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

Используйте это только в том случае, если вы используете математическое выражение метрики для ЦУ. Укажите true для ReturnData, чтобы использовать только результат одного выражения в качестве сигнала тревоги. Для всех других метрик и выражений в той же операции CreateServiceLevelObjective укажите ReturnData в качестве false .

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

Разрешение в секундах возвращаемых точек данных для этой метрики. Для метрик с обычным разрешением период может быть не короче одной минуты (60 секунд) и должен быть кратен 60. Для метрик с высоким разрешением, которые собираются с интервалами менее одной минуты, период может быть 1, 5, 10, 30, 60 или любым кратным 60. Метрики с высоким разрешением — это метрики, сохранённые с помощью вызова PutMetricData, который включает в себя StorageResolution в 1 секунду.

Если параметр StartTime указывает отметку времени, которая больше чем на 3 часа назад, вы должны указать период следующим образом, иначе точки данных в этом временном интервале не будут возвращены:

Время начала от 3 часов до 15 дней назад — используйте кратное 60 секунд (1 минута).
Время начала от 15 до 63 дней назад — используйте кратное 300 секунд (5 минут).
Время начала больше 63 дней назад — используйте кратное 3600 секунд (1 час).

AccountId -> (строка)

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

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

Идентифицирует зависимость с помощью DependencyKeyAttributes и DependencyOperationName .

DependencyKeyAttributes -> (карта)

Это карта «строка-строка». Она может включать следующие поля.

Type обозначает тип объекта.
ResourceType определяет тип ресурса. Это поле используется только тогда, когда значение поля Type равно Resource или AWS::Resource .
Name указывает имя объекта. Это используется только в том случае, если значение поля Type равно Service , RemoteService или AWS::Service .
Identifier идентифицирует объекты ресурсов данного ресурса. Это используется только в том случае, если значение поля Type равно Resource или AWS::Resource .
Environment указывает место размещения этого объекта или к чему он относится.

key -> (строка)

value -> (строка)

DependencyOperationName -> (строка)

Имя вызываемой операции в зависимости.

MetricThreshold -> (двойное значение)

Этот параметр используется только тогда, когда ЦУ на основе запроса отслеживает метрику Latency . Укажите пороговое значение, к которому должны сравниваться наблюдаемые значения метрики Latency .

ComparisonOperator -> (строка)

Арифметическая операция, используемая при сравнении указанного показателя с пороговым значением.

Синтаксис JSON:

{
  "SliMetricConfig": {
    "KeyAttributes": {"string": "string"
      ...},
    "OperationName": "string",
    "MetricType": "LATENCY"|"AVAILABILITY",
    "Statistic": "string",
    "PeriodSeconds": integer,
    "MetricDataQueries": [
      {
        "Id": "string",
        "MetricStat": {
          "Metric": {
            "Namespace": "string",
            "MetricName": "string",
            "Dimensions": [
              {
                "Name": "string",
                "Value": "string"
              }
              ...
            ]
          },
          "Period": integer,
          "Stat": "string",
          "Unit": "Microseconds"|"Milliseconds"|"Seconds"|"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"
        },
        "Expression": "string",
        "Label": "string",
        "ReturnData": true|false,
        "Period": integer,
        "AccountId": "string"
      }
      ...
    ],
    "DependencyConfig": {
      "DependencyKeyAttributes": {"string": "string"
        ...},
      "DependencyOperationName": "string"
    }
  },
  "MetricThreshold": double,
  "ComparisonOperator": "GreaterThanOrEqualTo"|"GreaterThan"|"LessThan"|"LessThanOrEqualTo"
}

--request-based-sli-config (структура)

Если этот показатель уровня обслуживания (SLO) основан на запросах, эта структура определяет информацию о показателе производительности, за которым будет следить этот SLO.

Вы не можете указать и SliConfig, и RequestBasedSliConfig в одной операции.

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

Используйте эту структуру для указания показателя, который будет использоваться для SLO.

KeyAttributes -> (карта)

Если этот SLO связан с показателем, собираемым Application Signals, вы должны использовать это поле для указания сервиса, к которому относится показатель SLO. Для этого необходимо указать как минимум атрибуты Type, Name и Environment.

Это карта «строка-строка». Она может включать следующие поля.

Type обозначает тип объекта.
ResourceType указывает тип ресурса. Это поле используется только в том случае, когда значение поля Type равно Resource или AWS::Resource.
Name указывает имя объекта. Используется только в том случае, если значение поля Type равно Service, RemoteService или AWS::Service.
Identifier идентифицирует объекты ресурсов данного ресурса. Используется только в том случае, если значение поля Type равно Resource или AWS::Resource.
Environment указывает место размещения этого объекта или к чему он относится.

ключ -> (строка)

значение -> (строка)

OperationName -> (строка)

Если SLO отслеживает конкретную операцию сервиса, используйте это поле для указания имени этой операции.

MetricType -> (строка)

Если SLO отслеживает либо показатель LATENCY, либо AVAILABILITY, собираемый Application Signals, используйте это поле для указания используемого показателя.

TotalRequestCountMetric -> (список)

Используйте эту структуру для определения показателя, который вы хотите использовать в качестве количества «всех запросов» для SLO, основанного на запросах. Этот результат будет разделен на значение «хороших запросов» или «плохих запросов», определённое в MonitoredRequestCountMetric.

(структура)

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

Каждый MetricDataQuery в массиве MetricDataQueries указывает либо показатель для получения, либо выражение математической обработки для показателей. Один массив MetricDataQueries может включать до 20 структур MetricDataQuery в массиве. Эти 20 структур могут включать до 10 структур, содержащих параметр MetricStat для получения показателя, и до 10 структур, содержащих параметр Expression для выполнения математической обработки. Из этих структур Expression ровно одна должна иметь значение true для ReturnData. Результат этого выражения используется для SLO.

Дополнительную информацию о выражениях математической обработки показателей см. в CloudWatchUse metric math.

В каждом объекте MetricDataQuery необходимо указать либо Expression, либо MetricStat, но не оба.

Id -> (строка)

Короткое имя, используемое для привязки этого объекта к результатам в ответе. Этот Id должен быть уникальным в пределах массива MetricDataQueries. Если вы выполняете математическую обработку над этим набором данных, это имя представляет эти данные и может служить переменной в выражении математической обработки показателей. Допустимые символы — буквы, цифры и символ подчеркивания. Первый символ должен быть строчной буквой.

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

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

В одном объекте MetricDataQuery необходимо указать либо Expression, либо MetricStat, но не оба.

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

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

Namespace -> (строка)

Пространство имен показателя. Дополнительную информацию см. в Разделы.

MetricName -> (строка)

Имя показателя, используемого в качестве индикатора.

Dimensions -> (список)

Массив из одного или нескольких измерений для определения показателя, который требуется использовать. Дополнительную информацию см. в Размеры.

(структура)

Измерение — это пара «имя/значение», являющаяся частью идентификатора показателя. Поскольку измерения являются частью уникального идентификатора показателя, каждый раз, когда вы добавляете уникальную пару «имя/значение» в один из ваших показателей, вы создаёте новую разновидность этого показателя. Например, многие метрики Amazon EC2 публикуют InstanceId в качестве имени измерения, а фактический идентификатор экземпляра — в качестве значения этого измерения.

Вы можете назначить до 30 измерений показателю.

Name -> (строка)

Имя измерения. Имена измерений должны содержать только символы ASCII, содержать хотя бы один не-пробельный символ и не начинаться с двоеточия (:). ASCII-управляющие символы не поддерживаются в именах измерений.

Value -> (строка)

Значение измерения. Значения измерений должны содержать только символы ASCII и должны содержать хотя бы один не-пробельный символ. ASCII-управляющие символы не поддерживаются в значениях измерений.

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

Грань, в секундах, используемая для метрики. Для метрик с регулярным разрешением период может быть как минимум одной минутой (60 секунд) и должен быть кратен 60. Для метрик с высоким разрешением, собираемых через интервалы менее одной минуты, период может быть 1, 5, 10, 30, 60 или любым кратным 60. Метрики с высоким разрешением — это метрики, хранимые вызовом PutMetricData, который включает StorageResolution в 1 секунду.

Stat -> (строка)

Статистика, используемая для сравнения с пороговым значением. Она может быть любой статистикой или расширенной статистикой CloudWatch. Дополнительную информацию о статистике см. в определениях статистики CloudWatch.

Unit -> (строка)

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

Expression -> (строка)

Это поле может содержать выражение математической обработки показателей, выполняемое над другими показателями, которые вы получаете в этой структуре MetricDataQueries.

Выражение математической обработки может использовать Id других показателей или запросов для ссылки на эти показатели, а также может использовать Id других выражений для использования результата этих выражений. Дополнительную информацию об выражениях математической обработки показателей см. в руководстве пользователя Amazon CloudWatch.

В каждом объекте MetricDataQuery необходимо указать либо Expression, либо MetricStat, но не оба.

Label -> (строка)

Человекопонятное имя метрики или выражения. Это особенно полезно, если это выражение, чтобы вы знали, что представляет значение. Если метрика или выражение отображаются в виджете панели CloudWatch, имя отображается. Если Label опущено, CloudWatch генерирует значение по умолчанию.

Вы можете вставить динамические выражения в имя, чтобы сделать его более описательным. Дополнительную информацию см. в Использование динамических имён.

ReturnData -> (булево)

Используйте это только в случае использования выражения математической обработки показателей для SLO. Укажите true для ReturnData, чтобы получить только один результат выражения для использования в тревоге. Для всех других метрик и выражений в той же операции CreateServiceLevelObjective укажите ReturnData как false.

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

Грань, в секундах, возвращаемых точек данных для данной метрики. Для метрик с регулярным разрешением период может быть как минимум одной минутой (60 секунд) и должен быть кратен 60. Для метрик с высоким разрешением, собираемых через интервалы менее одной минуты, период может быть 1, 5, 10, 30, 60 или любым кратным 60. Метрики с высоким разрешением — это метрики, хранимые вызовом PutMetricData, который включает StorageResolution в 1 секунду.

Если параметр StartTime указывает отметку времени более чем за 3 часа, необходимо указать период следующим образом, иначе точки данных в этом диапазоне времени не будут возвращены:

Время начала между 3 часами и 15 днями назад — Используйте кратное 60 секундам (1 минута).
Время начала между 15 и 63 днями назад — Используйте кратное 300 секундам (5 минут).
Время начала более 63 днями назад — Используйте кратное 3600 секундам (1 час).

AccountId -> (строка)

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

MonitoredRequestCountMetric -> (структура объединения тегов)

Используйте эту структуру для определения метрики, которую вы хотите использовать в качестве значения «хороший запрос» или «плохой запрос» для SLO на основе запросов. Это значение, наблюдаемое для метрики, определенной в TotalRequestCountMetric, будет разделено на число, найденное для MonitoredRequestCountMetric, чтобы определить процент успешных запросов, отслеживаемых этим SLO.

Примечание

Это структура помеченного объединения. Можно установить только один из следующих ключей верхнего уровня: GoodCountMetric, BadCountMetric.

GoodCountMetric -> (список)

Если вы хотите посчитать «хорошие запросы», чтобы определить процент успешных запросов для этого SLO на основе запросов, укажите метрику, которую следует использовать как «хорошие запросы», в этой структуре.

(структура)

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

Каждый MetricDataQuery в массиве MetricDataQueries указывает либо метрику для извлечения, либо математическое выражение метрики, которое должно быть выполнено над извлеченными метриками. Один массив MetricDataQueries может содержать до 20 структур MetricDataQuery в массиве. 20 структур могут включать до 10 структур, содержащих параметр MetricStat для извлечения метрики, и до 10 структур, содержащих параметр Expression для выполнения математического выражения. Из этих структур Expression ровно одна должна иметь значение true для ReturnData. Результат этого выражения используется для SLO.

Дополнительную информацию о математических выражениях метрик см. в CloudWatchUse metric math.

В каждом объекте MetricDataQuery вы должны указать либо Expression, либо MetricStat, но не оба.

Id -> (строка)

Короткое имя, используемое для связывания этого объекта с результатами в ответе. Это Id должно быть уникальным в массиве MetricDataQueries. Если вы выполняете математические выражения над этим набором данных, это имя представляет эти данные и может служить переменной в математическом выражении метрики. Допустимые символы — буквы, цифры и знак подчеркивания. Первый символ должен быть строчной буквой.

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

Метрика, которая будет использоваться непосредственно для SLO или будет использоваться в математическом выражении, которое будет использоваться для SLO.

В одном объекте MetricDataQuery вы должны указать либо Expression, либо MetricStat, но не оба.

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

Метрика, используемая в качестве индикатора уровня обслуживания, включая имя метрики, пространство имен и измерения.

Namespace -> (строка)

Пространство имен метрики. Дополнительную информацию см. в Namespaces.

MetricName -> (строка)

Имя метрики, используемой для измерения.

Dimensions -> (список)

Массив одного или нескольких измерений, используемых для определения метрики, которую вы хотите использовать. Дополнительную информацию см. в Dimensions.

(структура)

Измерение — это пара «имя/значение», являющаяся частью идентификатора метрики. Поскольку измерения являются частью уникального идентификатора метрики, каждый раз, когда вы добавляете уникальную пару «имя/значение» в одну из своих метрик, вы создаете новую вариацию этой метрики. Например, многие метрики Amazon EC2 публикуют InstanceId в качестве имени измерения, а фактический идентификатор экземпляра в качестве значения этого измерения.

Вы можете назначить до 30 измерений метрике.

Name -> (строка)

Имя измерения. Имена измерений должны содержать только символы ASCII, должны включать по крайней мере один символ, отличный от пробела, и не должны начинаться с двоеточия (:). ASCII-управляющие символы не поддерживаются в качестве части имен измерений.

Value -> (строка)

Значение измерения. Значения измерений должны содержать только символы ASCII и должны включать по крайней мере один символ, отличный от пробела. ASCII-управляющие символы не поддерживаются в качестве части значений измерений.

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

Детализация в секундах, которая должна использоваться для метрики. Для метрик с регулярным разрешением период может составлять всего одну минуту (60 секунд) и должен быть кратен 60. Для метрик с высоким разрешением, которые собираются с интервалами менее одной минуты, период может составлять 1, 5, 10, 30, 60 или любое кратное 60. Метрики с высоким разрешением — это те метрики, которые сохраняются вызовом PutMetricData, включающим StorageResolution 1 секунды.

Stat -> (строка)

Статистика, используемая для сравнения с пороговым значением. Это может быть любая статистика CloudWatch или расширенная статистика. Дополнительную информацию о статистике см. в определениях статистики CloudWatch.

Unit -> (строка)

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

Expression -> (строка)

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

Математическое выражение может использовать Id других метрик или запросов для ссылки на эти метрики, а также может использовать Id других выражений для использования результата этих выражений. Дополнительную информацию о математических выражениях метрик см. в «Синтаксис и функции математических выражений метрик» в Руководстве пользователя Amazon CloudWatch.

В каждом объекте MetricDataQuery вы должны указать либо Expression, либо MetricStat, но не оба.

Label -> (строка)

Человекочитаемый ярлык для этой метрики или выражения. Это особенно полезно, если это выражение, чтобы вы знали, что представляет значение. Если метрика или выражение показаны в виджете панели мониторинга CloudWatch, отображается метка. Если Label опущено, CloudWatch генерирует значение по умолчанию.

Вы можете вставить динамические выражения в метку, чтобы сделать ее более описательной. Дополнительную информацию см. в Using Dynamic Labels.

ReturnData -> (булево)

Используйте это только в том случае, если вы используете математическое выражение метрики для SLO. Укажите true для ReturnData, чтобы использовать только результат одного выражения в качестве сигнала тревоги. Для всех других метрик и выражений в той же операции CreateServiceLevelObjective укажите ReturnData как false.

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

Детализация, в секундах, возвращаемых точек данных для этой метрики. Для метрик с регулярным разрешением период может составлять всего одну минуту (60 секунд) и должен быть кратен 60. Для метрик с высоким разрешением, которые собираются с интервалами менее одной минуты, период может составлять 1, 5, 10, 30, 60 или любое кратное 60. Метрики с высоким разрешением — это те метрики, которые сохраняются вызовом PutMetricData, включающим StorageResolution 1 секунды.

Если параметр StartTime указывает отметку времени, которая больше чем 3 часа назад, вы должны указать период следующим образом, иначе точки данных в этом диапазоне времени не возвращаются:

Время начала между 3 часами и 15 днями назад — Используйте кратное 60 секундам (1 минута).
Время начала между 15 и 63 днями назад — Используйте кратное 300 секундам (5 минут).
Время начала более 63 дней назад — Используйте кратное 3600 секундам (1 час).

AccountId -> (строка)

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

BadCountMetric -> (список)

Если вы хотите посчитать «плохие запросы» для определения процента успешных запросов для этого SLO на основе запросов, укажите метрику, используемую как «плохие запросы» в этой структуре.

(структура)

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

Каждый MetricDataQuery в массиве MetricDataQueries указывает либо метрику для получения, либо выражение математической операции над полученными метриками. Один массив MetricDataQueries может включать до 20 структур MetricDataQuery. Эти 20 структур могут содержать до 10 структур с параметром MetricStat для получения метрики и до 10 структур с параметром Expression для выполнения математического выражения. Из этих структур Expression ровно одна должна иметь значение true для параметра ReturnData. Результат этого выражения используется для SLO.

Дополнительную информацию об выражениях математической операции над метриками см. в CloudWatchUse metric math.

В каждом объекте MetricDataQuery вы должны указать либо Expression, либо MetricStat, но не оба.

Id -> (строка)

Короткое имя, используемое для связи этого объекта с результатами в ответе. Это Id должно быть уникальным в массиве MetricDataQueries. Если вы выполняете математические выражения над этим набором данных, это имя представляет эти данные и может служить переменной в выражении математической операции над метриками. Допустимые символы — буквы, цифры и символ подчеркивания. Первый символ должен быть строчной буквой.

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

Метрика, которая будет использоваться непосредственно для SLO или в математическом выражении, которое будет использоваться для SLO.

В одном объекте MetricDataQuery вы должны указать либо Expression, либо MetricStat, но не оба.

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

Namespace -> (строка)

Пространство имен метрики. Дополнительную информацию см. в Namespaces.

MetricName -> (строка)

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

Dimensions -> (список)

Массив одного или нескольких измерений для определения метрики, которую вы хотите использовать. Дополнительную информацию см. в Dimensions.

(структура)

Измерение — это пара «имя/значение», являющаяся частью идентификатора метрики. Поскольку измерения являются частью уникального идентификатора метрики, всякий раз, когда вы добавляете уникальную пару «имя/значение» в одну из ваших метрик, вы создаете новую разновидность этой метрики. Например, многие метрики Amazon EC2 публикуют InstanceId в качестве имени измерения, а фактический идентификатор экземпляра — в качестве значения для этого измерения.

Вы можете назначить до 30 измерений метрике.

Name -> (строка)

Имя измерения. Имена измерений должны содержать только символы ASCII, содержать хотя бы один символ, отличный от пробела, и не начинаться с двоеточия (:). ASCII-управляющие символы не поддерживаются в качестве части имен измерений.

Value -> (строка)

Значение измерения. Значения измерений должны содержать только символы ASCII и содержать по крайней мере один символ, отличный от пробела. ASCII-управляющие символы не поддерживаются в качестве части значений измерений.

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

Гранность в секундах, которая будет использоваться для метрики. Для метрик с регулярным разрешением период может быть как минимум одной минутой (60 секунд) и должен быть кратен 60. Для метрик с высоким разрешением, которые собираются с интервалами менее одной минуты, период может быть 1, 5, 10, 30, 60 или любым кратным 60. Метрики с высоким разрешением — это метрики, сохраненные вызовом PutMetricData, который включает StorageResolution 1 секунды.

Stat -> (строка)

Статистика, используемая для сравнения с пороговым значением. Она может быть любой статистикой CloudWatch или расширенной статистикой. Дополнительную информацию о статистике см. в CloudWatch statistics definitions.

Unit -> (строка)

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

Expression -> (строка)

Это поле может содержать выражение математической операции над метриками, которые вы получаете в этой структуре MetricDataQueries.

Выражение математической операции может использовать Id других метрик или запросов, чтобы сослаться на эти метрики, а также может использовать Id других выражений, чтобы использовать результаты этих выражений. Дополнительную информацию об выражениях математической операции над метриками см. в разделе Синтаксис и функции математических выражений над метриками в руководстве пользователя Amazon CloudWatch.

В каждом объекте MetricDataQuery вы должны указать либо Expression, либо MetricStat, но не оба.

Label -> (строка)

Человекопонятное описание метрики или выражения. Это особенно полезно, если это выражение, чтобы вы знали, что представляет значение. Если метрика или выражение отображаются в виджете панели мониторинга CloudWatch, отображается метка. Если Label опущено, CloudWatch генерирует значение по умолчанию.

Вы можете вставлять динамические выражения в метку, чтобы сделать ее более информативной. Дополнительную информацию см. в разделе Использование динамических меток.

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

Используйте это только в том случае, если вы используете выражение математической операции над метриками для SLO. Укажите true для ReturnData только результата одного выражения для использования в качестве сигнала тревоги. Для всех других метрик и выражений в той же операции CreateServiceLevelObjective укажите ReturnData как false.

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

Гранность в секундах возвращаемых точек данных для этой метрики. Для метрик с регулярным разрешением период может быть как минимум одной минутой (60 секунд) и должен быть кратен 60. Для метрик с высоким разрешением, которые собираются с интервалами менее одной минуты, период может быть 1, 5, 10, 30, 60 или любым кратным 60. Метрики с высоким разрешением — это метрики, сохраненные вызовом PutMetricData, который включает StorageResolution 1 секунды.

Время начала между 3 часами и 15 днями назад — используйте кратное 60 секундам (1 минута).
Время начала между 15 и 63 днями назад — используйте кратное 300 секундам (5 минут).
Время начала более 63 дней назад — используйте кратное 3600 секундам (1 час).

AccountId -> (строка)

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

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

Определяет зависимость с помощью DependencyKeyAttributes и DependencyOperationName.

DependencyKeyAttributes -> (отображение)

Это отображение строка-строка. Оно может включать следующие поля.

Type обозначает тип объекта.
ResourceType определяет тип ресурса. Это поле используется только при значении поля Type Resource или AWS::Resource.
Name определяет имя объекта. Это используется только в случае значения поля Type Service, RemoteService или AWS::Service.
Identifier определяет объекты ресурсов этого ресурса. Это используется только при значении поля Type Resource или AWS::Resource.
Environment указывает расположение размещения этого объекта или к чему он относится.

key -> (строка)

value -> (строка)

DependencyOperationName -> (строка)

Имя вызываемой операции в зависимости.

MetricThreshold -> (двойное значение)

Значение, к которому сравнивается метрика SLI. Этот параметр требуется, если это SLO отслеживает метрику Latency.

ComparisonOperator -> (строка)

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

Синтаксис JSON:

{
  "RequestBasedSliMetricConfig": {
    "KeyAttributes": {"string": "string"
      ...},
    "OperationName": "string",
    "MetricType": "LATENCY"|"AVAILABILITY",
    "TotalRequestCountMetric": [
      {
        "Id": "string",
        "MetricStat": {
          "Metric": {
            "Namespace": "string",
            "MetricName": "string",
            "Dimensions": [
              {
                "Name": "string",
                "Value": "string"
              }
              ...
            ]
          },
          "Period": integer,
          "Stat": "string",
          "Unit": "Microseconds"|"Milliseconds"|"Seconds"|"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"
        },
        "Expression": "string",
        "Label": "string",
        "ReturnData": true|false,
        "Period": integer,
        "AccountId": "string"
      }
      ...
    ],
    "MonitoredRequestCountMetric": {
      "GoodCountMetric": [
        {
          "Id": "string",
          "MetricStat": {
            "Metric": {
              "Namespace": "string",
              "MetricName": "string",
              "Dimensions": [
                {
                  "Name": "string",
                  "Value": "string"
                }
                ...
              ]
            },
            "Period": integer,
            "Stat": "string",
            "Unit": "Microseconds"|"Milliseconds"|"Seconds"|"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"
          },
          "Expression": "string",
          "Label": "string",
          "ReturnData": true|false,
          "Period": integer,
          "AccountId": "string"
        }
        ...
      ],
      "BadCountMetric": [
        {
          "Id": "string",
          "MetricStat": {
            "Metric": {
              "Namespace": "string",
              "MetricName": "string",
              "Dimensions": [
                {
                  "Name": "string",
                  "Value": "string"
                }
                ...
              ]
            },
            "Period": integer,
            "Stat": "string",
            "Unit": "Microseconds"|"Milliseconds"|"Seconds"|"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"
          },
          "Expression": "string",
          "Label": "string",
          "ReturnData": true|false,
          "Period": integer,
          "AccountId": "string"
        }
        ...
      ]
    },
    "DependencyConfig": {
      "DependencyKeyAttributes": {"string": "string"
        ...},
      "DependencyOperationName": "string"
    }
  },
  "MetricThreshold": double,
  "ComparisonOperator": "GreaterThanOrEqualTo"|"GreaterThan"|"LessThan"|"LessThanOrEqualTo"
}

--goal (структура)

Структура, содержащая атрибуты, определяющие цель SLO. Включает период оценки и порог достижения.

Interval -> (структура помеченного объединения)

Период времени, используемый для оценки SLO. Может быть календарным интервалом или скользящим интервалом.

Если этот параметр опущен, используется скользящий интервал в 7 дней.

Примечание

Это структура помеченного объединения. Только один из следующих ключей верхнего уровня может быть задан: RollingInterval, CalendarInterval.

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

Если интервал является скользящим, эта структура содержит спецификации интервала.

DurationUnit -> (строка)

Указывает единицу измерения скользящего интервала.

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

Указывает длительность каждого скользящего интервала. Например, если Duration является 7, а DurationUnit является DAY, каждый скользящий интервал составляет семь дней.

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

Если интервал является календарным, эта структура содержит спецификации интервала.

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

Дата и время начала первого интервала. Убедитесь, что выбрано время, которое настраивает интервалы так, как вам нужно. Например, если вам нужны еженедельные интервалы, начинающиеся по понедельникам в 6:00, убедитесь, что вы указали время начала, которое является понедельником в 6:00.

При использовании в API HTTP запроса в сыром виде оно отформатировано как время эпохи во секундах. Например: 1698778057

Как только один календарный интервал заканчивается, автоматически начинается другой.

DurationUnit -> (строка)

Указывает единицу измерения календарного интервала.

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

Указывает длительность каждого календарного интервала. Например, если Duration является 1, а DurationUnit является MONTH, каждый интервал составляет один месяц, согласованный с календарем.

AttainmentGoal -> (двойное число)

Порог, определяющий, достигнута ли цель.

Если это SLO на основе периода, цель достижения — процент хороших периодов, которые удовлетворяют требованиям порога по отношению к общему количеству периодов в интервале. Например, цель достижения 99,9% означает, что в вашем интервале вы нацелены на то, чтобы 99,9% периодов находились в здоровом состоянии.

Если это SLO на основе запросов, цель достижения — процент запросов, которые должны быть успешными, чтобы достичь цели достижения.

Если этот параметр опущен, используется 99 для представления 99% как цели достижения.

WarningThreshold -> (двойное число)

Процент оставшегося бюджета от общего бюджета, для которого вы хотите получать предупреждения. Если этот параметр опущен, используется значение по умолчанию 50,0.

Сокращенная синтаксическая запись:

Interval={RollingInterval={DurationUnit=string,Duration=integer},CalendarInterval={StartTime=timestamp,DurationUnit=string,Duration=integer}},AttainmentGoal=double,WarningThreshold=double

Синтаксис JSON:

{
  "Interval": {
    "RollingInterval": {
      "DurationUnit": "MINUTE"|"HOUR"|"DAY"|"MONTH",
      "Duration": integer
    },
    "CalendarInterval": {
      "StartTime": timestamp,
      "DurationUnit": "MINUTE"|"HOUR"|"DAY"|"MONTH",
      "Duration": integer
    }
  },
  "AttainmentGoal": double,
  "WarningThreshold": double
}

--burn-rate-configurations (список)

Используйте этот массив для создания скоростей израсходования для этого SLO. Каждая скорость израсходования — это метрика, которая показывает, насколько быстро служба потребляет бюджет ошибок, относительно цели достижения SLO.

(структура)

Этот объект определяет длительность временного окна обратного отсчёта, используемого для расчёта одной метрики скорости израсходования для этого SLO. Скорость израсходования измеряет, насколько быстро служба потребляет бюджет ошибок, относительно цели достижения SLO. Скорость израсходования, равная 1, означает, что цель SLO будет достигнута ровно.

Например, если вы укажете 60 как количество минут в окне обратного отсчёта, скорость израсходования рассчитывается следующим образом:

скорость израсходования = скорость ошибок за окно обратного отсчёта / (100% - процент цели достижения)

Дополнительную информацию о скоростях израсходования см. в Calculate burn rates.

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

Количество минут для использования в качестве окна обратного отсчёта.

Сокращенная синтаксическая запись:

LookBackWindowMinutes=integer ...

Синтаксис JSON:

[
  {
    "LookBackWindowMinutes": integer
  }
  ...
]

--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 (строка)

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

--version (строка)

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

--color (строка)

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

on
off
auto

--no-sign-request (булево)

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

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

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

--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 для вывода.

--cli-auto-prompt (булево)

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

--no-cli-auto-prompt (булево)

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

Вывод

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

Структура, содержащая информацию об обновленном SLO.

Arn -> (строка)

ARN этого SLO.

Name -> (строка)

Имя этого SLO.

Description -> (строка)

Описание, созданное для этого SLO.

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

Дата и время создания этого SLO. При использовании в сыром API HTTP запроса, оно отформатировано как yyyy-MM-dd'T'HH:mm:ss. Например, 2019-07-01T23:59:59.

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

Время последнего обновления этого SLO. При использовании в сыром API HTTP запроса, оно отформатировано как yyyy-MM-dd'T'HH:mm:ss. Например, 2019-07-01T23:59:59.

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

Структура, содержащая информацию о метрике производительности, отслеживаемой этим целевым показателем уровня обслуживания (SLO), если это SLO, основанный на периоде.

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

Структура, содержащая информацию о метрике, отслеживаемой SLO.

KeyAttributes -> (карта)

Это карта «строка-строка», содержащая информацию о типе объекта, к которому относится данный SLO. Она может включать следующие поля.

Type обозначает тип объекта, к которому относится этот SLO.
ResourceType указывает тип ресурса. Это поле используется только тогда, когда значение поля Type равно Resource или AWS::Resource .
Name указывает имя объекта. Это используется только в том случае, если значение поля Type равно Service, RemoteService или AWS::Service.
Identifier идентифицирует объекты ресурсов данного ресурса. Это используется только в том случае, если значение поля Type равно Resource или AWS::Resource.
Environment указывает место размещения этого объекта или к чему он относится.

ключ -> (строка)

значение -> (строка)

OperationName -> (строка)

Если SLO отслеживает конкретную операцию сервиса, это поле отображает имя этой операции.

MetricType -> (строка)

Если SLO отслеживает метрику LATENCY или AVAILABILITY, которую собирают Application Signals, это поле отображает, какая из этих метрик используется.

MetricDataQueries -> (список)

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

(структура)

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

Каждая MetricDataQuery в массиве MetricDataQueries указывает либо метрику для извлечения, либо математическое выражение метрики для выполнения над извлечёнными метриками. Один массив MetricDataQueries может содержать до 20 структур MetricDataQuery. Эти 20 структур могут содержать до 10 структур, содержащих параметр MetricStat для извлечения метрики, и до 10 структур, содержащих параметр Expression для выполнения математического выражения. Из этих структур Expression ровно одна должна иметь значение «истина» для ReturnData. Результат этого выражения используется для SLO.

Дополнительную информацию о математических выражениях метрик см. в CloudWatchUse metric math.

В каждом объекте MetricDataQuery необходимо указать либо Expression, либо MetricStat, но не оба.

Id -> (строка)

Короткое имя, используемое для привязки этого объекта к результатам в ответе. Это Id должно быть уникальным в массиве MetricDataQueries. Если вы выполняете математические выражения над этим набором данных, это имя представляет эти данные и может использоваться в качестве переменной в математическом выражении метрики. Допустимые символы — буквы, цифры и знак нижнего подчеркивания. Первый символ должен быть строчной буквой.

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

Метрика, используемая непосредственно для SLO или в математическом выражении, используемом для SLO.

В одном объекте MetricDataQuery необходимо указать либо Expression, либо MetricStat, но не оба.

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

Namespace -> (строка)

Пространство имён метрики. Дополнительную информацию см. в Namespaces.

MetricName -> (строка)

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

Dimensions -> (список)

(структура)

Измерение — это пара «имя/значение», которая является частью идентификатора метрики. Поскольку измерения являются частью уникального идентификатора метрики, каждый раз, когда вы добавляете уникальную пару «имя/значение» к одной из своих метрик, вы создаёте новую вариацию этой метрики. Например, многие метрики Amazon EC2 публикуют InstanceId в качестве имени измерения, а фактический идентификатор экземпляра — в качестве значения этого измерения.

Вы можете назначить до 30 измерений метрике.

Name -> (строка)

Имя измерения. Имена измерений должны содержать только символы ASCII, содержать как минимум один символ, отличный от пробела, и не начинаться с двоеточия (:). ASCII-управляющие символы не поддерживаются в качестве части имён измерений.

Value -> (строка)

Значение измерения. Значения измерений должны содержать только символы ASCII и содержать как минимум один символ, отличный от пробела. ASCII-управляющие символы не поддерживаются в качестве части значений измерений.

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

Разрешение в секундах, используемое для метрики. Для метрик с регулярным разрешением период может быть как минимум одной минутой (60 секунд) и должен быть кратен 60. Для метрик с высоким разрешением, которые собираются с интервалами менее одной минуты, период может составлять 1, 5, 10, 30, 60 или любое кратное 60. Метрики с высоким разрешением — это метрики, хранящиеся вызовом PutMetricData, который включает в себя StorageResolution в 1 секунду.

Stat -> (строка)

Статистика для сравнения с пороговым значением. Это может быть любая статистика CloudWatch или расширенная статистика. Дополнительную информацию о статистике см. в определениях статистики CloudWatch.

Unit -> (строка)

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

Expression -> (строка)

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

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

В каждом объекте MetricDataQuery необходимо указать либо Expression, либо MetricStat, но не оба.

Label -> (строка)

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

Вы можете вставить динамические выражения в метку, чтобы она была более описательной. Дополнительную информацию см. в разделе Использование динамических меток.

ReturnData -> (булево)

Используйте это только в том случае, если вы используете математическое выражение метрики для SLO. Укажите true для ReturnData, чтобы использовать только результат одного выражения как значение сигнализации. Для всех других метрик и выражений в той же операции CreateServiceLevelObjective укажите ReturnData как false.

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

Разрешение в секундах возвращаемых точек данных для этой метрики. Для метрик с регулярным разрешением период может быть как минимум одной минутой (60 секунд) и должен быть кратен 60. Для метрик с высоким разрешением, которые собираются с интервалами менее одной минуты, период может составлять 1, 5, 10, 30, 60 или любое кратное 60. Метрики с высоким разрешением — это метрики, хранящиеся вызовом PutMetricData, который включает в себя StorageResolution в 1 секунду.

Если параметр StartTime задаёт отметку времени, которая больше чем 3 часа назад, необходимо указать период следующим образом, иначе точки данных в этом диапазоне времени не возвращаются:

Начальное время между 3 часами и 15 днями назад — используйте кратное 60 секундам (1 минута).
Начальное время между 15 и 63 днями назад — используйте кратное 300 секундам (5 минут).
Начальное время более 63 дней назад — используйте кратное 3600 секундам (1 час).

AccountId -> (строка)

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

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

Идентифицирует зависимость, используя DependencyKeyAttributes и DependencyOperationName.

DependencyKeyAttributes -> (карта)

Это карта «строка-строка». Она может включать следующие поля.

Type обозначает тип объекта.
ResourceType указывает тип ресурса. Это поле используется только тогда, когда значение поля Type равно Resource или AWS::Resource.
Name указывает имя объекта. Это используется только в том случае, если значение поля Type равно Service, RemoteService или AWS::Service.
Identifier идентифицирует объекты ресурсов этого ресурса. Это используется только в том случае, если значение поля Type равно Resource или AWS::Resource.
Environment указывает место размещения этого объекта или к чему он относится.

ключ -> (строка)

значение -> (строка)

DependencyOperationName -> (строка)

Имя вызываемой операции в зависимости.

MetricThreshold -> (двойное число)

Значение, с которым сравнивается метрика SLI.

ComparisonOperator -> (строка)

Арифметическая операция, используемая при сравнении указанной метрики с пороговым значением.

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

Структура, содержащая информацию о метрике производительности, за которой следит данный SLO, если это SLO на основе запросов.

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

Структура, содержащая информацию о метрике, за которой следит SLO.

KeyAttributes -> (отображение)

Это отображение строка-строка, содержащее информацию о типе объекта, к которому относится данный SLO. Оно может включать следующие поля.

Type обозначает тип объекта, к которому относится данный SLO.
ResourceType указывает тип ресурса. Это поле используется только тогда, когда значение поля Type равно Resource или AWS::Resource.
Name указывает имя объекта. Это используется только если значение поля Type равно Service, RemoteService или AWS::Service.
Identifier идентифицирует объекты ресурсов этого ресурса. Это используется только если значение поля Type равно Resource или AWS::Resource.
Environment указывает расположение, где размещён этот объект, или к чему он относится.

ключ -> (строка)

значение -> (строка)

OperationName -> (строка)

Если SLO отслеживает конкретную операцию службы, в этом поле отображается имя этой операции.

MetricType -> (строка)

Если SLO отслеживает метрику LATENCY или AVAILABILITY, которые собирает Application Signals, в этом поле отображается используемая метрика.

TotalRequestCountMetric -> (список)

Эта структура определяет метрику, используемую в качестве значения «общее количество запросов» для SLO на основе запросов. Значение, наблюдаемое для этой метрики, делится на количество «хороших запросов» или «плохих запросов», наблюдаемых для метрики, определённой в MonitoredRequestCountMetric.

(структура)

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

Каждый MetricDataQuery в массиве MetricDataQueries указывает либо метрику для извлечения, либо выражение вычисления метрики, которое необходимо выполнить над извлечёнными метриками. Один массив MetricDataQueries может включать до 20 структур MetricDataQuery в массиве. Эти 20 структур могут включать до 10 структур, содержащих параметр MetricStat для извлечения метрики, и до 10 структур, содержащих параметр Expression для выполнения математического выражения. Из этих структур Expression ровно одна должна иметь значение true для ReturnData. Результат этого выражения используется для SLO.

Дополнительную информацию о выражениях вычисления метрик см. в CloudWatchUse metric math.

В каждом объекте MetricDataQuery необходимо указать либо Expression, либо MetricStat, но не оба.

Id -> (строка)

Короткое имя, используемое для связи этого объекта с результатами в ответе. Это Id должно быть уникальным в массиве MetricDataQueries. Если вы выполняете вычисления над этим набором данных, это имя представляет эти данные и может служить переменной в выражении вычисления метрик. Допустимые символы — буквы, цифры и знак подчёркивания. Первый символ должен быть строчной буквой.

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

Метрика, которая должна использоваться непосредственно для SLO или для использования в выражении вычисления метрик, которое будет использоваться для SLO.

В одном объекте MetricDataQuery необходимо указать либо Expression, либо MetricStat, но не оба.

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

Namespace -> (строка)

Пространство имён метрики. Дополнительную информацию см. в Namespaces.

MetricName -> (строка)

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

Dimensions -> (список)

(структура)

Измерение — это пара «имя/значение», являющаяся частью идентификатора метрики. Поскольку измерения являются частью уникального идентификатора метрики, каждый раз, когда вы добавляете уникальную пару «имя/значение» к одной из своих метрик, вы создаёте новую вариацию этой метрики. Например, многие метрики Amazon EC2 публикуют InstanceId в качестве имени измерения, а фактический идентификатор экземпляра — в качестве значения этого измерения.

Вы можете назначить до 30 измерений метрике.

Name -> (строка)

Value -> (строка)

Значение измерения. Значения измерений должны содержать только символы ASCII и включать как минимум один символ, отличный от пробела. ASCII-управляющие символы не поддерживаются в значениях измерений.

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

Точность в секундах, используемая для метрики. Для метрик с регулярным разрешением период может быть как минимум одной минутой (60 секунд) и должен быть кратен 60. Для метрик с высоким разрешением, которые собираются через интервалы менее одной минуты, период может составлять 1, 5, 10, 30, 60 или любое кратное 60. Метрики с высоким разрешением — это метрики, хранящиеся вызовом PutMetricData, включающим StorageResolution в 1 секунду.

Stat -> (строка)

Статистика, используемая для сравнения с порогом. Это может быть любая статистика CloudWatch или расширенная статистика. Дополнительную информацию о статистике см. в CloudWatch statistics definitions.

Unit -> (строка)

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

Expression -> (строка)

Это поле может содержать выражение вычисления метрик, выполняемое над другими метриками, которые вы получаете в этой структуре MetricDataQueries.

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

В каждом объекте MetricDataQuery необходимо указать либо Expression, либо MetricStat, но не оба.

Label -> (строка)

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

Вы можете поместить динамические выражения в метку, чтобы сделать её более описательной. Дополнительную информацию см. в Using Dynamic Labels.

ReturnData -> (булево)

Используйте это только если вы используете выражение вычисления метрик для SLO. Укажите true для ReturnData, чтобы использовать только один результат выражения в качестве сигнала тревоги. Для всех остальных метрик и выражений в той же операции CreateServiceLevelObjective укажите ReturnData как false.

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

Точность в секундах возвращаемых точек данных для этой метрики. Для метрик с регулярным разрешением период может быть как минимум одной минутой (60 секунд) и должен быть кратен 60. Для метрик с высоким разрешением, которые собираются через интервалы менее одной минуты, период может составлять 1, 5, 10, 30, 60 или любое кратное 60. Метрики с высоким разрешением — это метрики, хранящиеся вызовом PutMetricData, включающим StorageResolution в 1 секунду.

Если параметр StartTime указывает отметку времени, которая превышает 3 часа назад, необходимо указать период следующим образом, иначе точки данных в этом диапазоне времени не будут возвращены:

Начальное время между 3 часами и 15 днями назад — используйте кратное 60 секундам (1 минуте).
Начальное время между 15 и 63 днями назад — используйте кратное 300 секундам (5 минутам).
Начальное время больше 63 дней назад — используйте кратное 3600 секундам (1 часу).

AccountId -> (строка)

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

MonitoredRequestCountMetric -> (меченый объединённый тип структуры)

Эта структура определяет метрику, используемую в качестве значения «хороший запрос» или «плохой запрос» для SLO, основанного на запросах. Это значение, наблюдаемое для метрики, определенной в TotalRequestCountMetric, делится на число, найденное для MonitoredRequestCountMetric, чтобы определить процент успешных запросов, отслеживаемых этим SLO.

Примечание

Это структура помеченных союзов. Только один из следующих ключей верхнего уровня может быть задан: GoodCountMetric, BadCountMetric.

GoodCountMetric -> (список)

Если вы хотите подсчитать «хорошие запросы», чтобы определить процент успешных запросов для этого SLO, основанного на запросах, укажите метрику, используемую в качестве «хороших запросов» в этой структуре.

(структура)

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

Каждый MetricDataQuery в массиве MetricDataQueries указывает либо метрику для извлечения, либо выражение математической метрики, которое нужно выполнить над извлечёнными метриками. Один массив MetricDataQueries может содержать до 20 структур MetricDataQuery в массиве. 20 структур могут содержать до 10 структур, содержащих параметр MetricStat для извлечения метрики, и до 10 структур, содержащих параметр Expression для выполнения математического выражения. Из этих структур Expression ровно одна должна иметь значение true для ReturnData. Результат этого выражения используется для SLO.

Дополнительную информацию о выражениях математической метрики см. в CloudWatchИспользование математических выражений над метриками.

В каждом объекте MetricDataQuery вы должны указать либо Expression, либо MetricStat, но не оба.

Id -> (строка)

Короткое имя, используемое для привязки этого объекта к результатам в ответе. Это Id должно быть уникальным в массиве MetricDataQueries. Если вы выполняете математические выражения над этим набором данных, это имя представляет эти данные и может служить переменной в выражении математической метрики. Допустимые символы — буквы, цифры и символ нижнего подчеркивания. Первый символ должен быть строчной буквой.

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

Метрика, которая будет использоваться непосредственно для SLO или для использования в математическом выражении, которое будет использоваться для SLO.

В одном объекте MetricDataQuery вы должны указать либо Expression, либо MetricStat, но не оба.

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

Namespace -> (строка)

Пространство имён метрики. Дополнительную информацию см. в Разделы.

MetricName -> (строка)

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

Dimensions -> (список)

Массив одного или нескольких измерений, которые используются для определения метрики, которую вы хотите использовать. Дополнительную информацию см. в Измерения.

(структура)

Измерение — это пара «имя/значение», являющаяся частью идентификатора метрики. Поскольку измерения являются частью уникального идентификатора метрики, каждый раз, когда вы добавляете уникальную пару «имя/значение» в одну из своих метрик, вы создаёте новую разновидность этой метрики. Например, многие метрики Amazon EC2 публикуют InstanceId в качестве имени измерения, а фактический идентификатор экземпляра в качестве значения для этого измерения.

Вы можете назначить до 30 измерений метрике.

Name -> (строка)

Имя измерения. Имена измерений должны содержать только символы ASCII, содержать по крайней мере один символ, отличный от пробела, и не начинаться с двоеточия (:). ASCII-управляющие символы не поддерживаются в качестве части имён измерений.

Value -> (строка)

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

Периодичность, в секундах, которая будет использоваться для метрики. Для метрик с регулярным разрешением период может быть настолько коротким, как одна минута (60 секунд), и должен быть кратен 60. Для высокоразрешающих метрик, которые собираются с интервалами менее одной минуты, период может быть 1, 5, 10, 30, 60 или любым кратным 60. Высокоразрешающие метрики — это метрики, хранящиеся вызовом PutMetricData, который включает StorageResolution в 1 секунду.

Stat -> (строка)

Статистика для сравнения с порогом. Она может быть любой статистикой CloudWatch или расширенной статистикой. Дополнительную информацию о статистике см. в Определения статистики CloudWatch.

Unit -> (строка)

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

Expression -> (строка)

Это поле может содержать выражение математической метрики, которое выполняется над другими метриками, которые вы извлекаете в структуре MetricDataQueries.

Выражение математической метрики может использовать Id других метрик или запросов для ссылки на эти метрики, а также может использовать Id других выражений для использования результатов этих выражений. Дополнительную информацию о выражениях математической метрики см. в Синтаксисе и функциях математических выражений над метриками в Руководстве пользователя Amazon CloudWatch.

В каждом объекте MetricDataQuery вы должны указать либо Expression, либо MetricStat, но не оба.

Label -> (строка)

Человекочитаемый ярлык для этой метрики или выражения. Это особенно полезно, если это выражение, чтобы вы знали, что представляет значение. Если метрика или выражение отображается в виджете панели мониторинга CloudWatch, отображается ярлык. Если Label опущено, CloudWatch генерирует значение по умолчанию.

Вы можете вставлять динамические выражения в метку, чтобы она была более описательной. Дополнительную информацию см. в Использование динамических меток.

ReturnData -> (булево)

Используйте это только в том случае, если вы используете выражение математической метрики для SLO. Укажите true для ReturnData, чтобы получить только один результат выражения для использования в качестве сигнала тревоги. Для всех других метрик и выражений в той же операции CreateServiceLevelObjective укажите ReturnData как false.

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

Периодичность, в секундах, возвращаемых точек данных для этой метрики. Для метрик с регулярным разрешением период может быть настолько коротким, как одна минута (60 секунд), и должен быть кратен 60. Для высокоразрешающих метрик, которые собираются с интервалами менее одной минуты, период может быть 1, 5, 10, 30, 60 или любым кратным 60. Высокоразрешающие метрики — это метрики, хранящиеся вызовом PutMetricData, который включает StorageResolution в 1 секунду.

Если параметр StartTime указывает временную метку, которая старше 3 часов, вы должны указать период следующим образом, иначе точки данных в этом диапазоне времени не будут возвращены:

Время начала от 3 часов до 15 дней назад — используйте кратное 60 секунд (1 минута).
Время начала от 15 до 63 дней назад — используйте кратное 300 секунд (5 минут).
Время начала более чем 63 дня назад — используйте кратное 3600 секунд (1 час).

AccountId -> (строка)

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

BadCountMetric -> (список)

Если вы хотите подсчитать «плохие запросы» для определения процента успешных запросов для данного SLO, основанного на запросах, укажите метрику, используемую в качестве «плохих запросов» в этой структуре.

(структура)

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

Каждый MetricDataQuery в массиве MetricDataQueries указывает либо метрику для извлечения, либо выражение вычисления метрик, которое должно быть выполнено над извлечёнными метриками. Один массив MetricDataQueries может включать до 20 структур MetricDataQuery в массиве. 20 структур могут включать до 10 структур, содержащих параметр MetricStat для извлечения метрики, и до 10 структур, содержащих параметр Expression для выполнения математического выражения. Из этих структур Expression ровно одна должна иметь значение true для параметра ReturnData. Результат этого выражения используется для SLO.

Дополнительную информацию о выражениях вычисления метрик см. в разделе CloudWatchUse metric math.

В каждом объекте MetricDataQuery вы должны указать либо Expression, либо MetricStat, но не оба.

Id -> (строка)

Короткое имя, используемое для привязки этого объекта к результатам в ответе. Это Id должно быть уникальным внутри массива MetricDataQueries. Если вы выполняете математические выражения над этим набором данных, это имя представляет эти данные и может служить переменной в выражении вычисления метрик. Допустимые символы: буквы, цифры и знак подчёркивания. Первый символ должен быть строчной буквой.

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

Метрика, используемая непосредственно для SLO или используемая в математическом выражении, которое будет использовано для SLO.

В одном объекте MetricDataQuery вы должны указать либо Expression, либо MetricStat, но не оба.

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

Метрика, используемая в качестве индикатора уровня обслуживания, включая имя метрики, пространство имён и измерения.

Namespace -> (строка)

Пространство имён метрики. Дополнительную информацию см. в разделе Namespaces.

MetricName -> (строка)

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

Dimensions -> (список)

Массив одного или нескольких измерений для определения метрики, которую вы хотите использовать. Дополнительную информацию см. в разделе Dimensions.

(структура)

Измерение — это пара «имя/значение», являющаяся частью идентификатора метрики. Поскольку измерения являются частью уникального идентификатора метрики, каждый раз, когда вы добавляете уникальную пару «имя/значение» к одной из ваших метрик, вы создаёте новую разновидность этой метрики. Например, многие метрики Amazon EC2 публикуют InstanceId в качестве имени измерения, а фактический идентификатор экземпляра — в качестве значения этого измерения.

Вы можете назначить до 30 измерений метрике.

Name -> (строка)

Имя измерения. Имена измерений должны содержать только символы ASCII, содержать по крайней мере один символ, не являющийся пробелом, и не начинаться с двоеточия (:). Символы управления ASCII не поддерживаются в именах измерений.

Value -> (строка)

Значение измерения. Значения измерений должны содержать только символы ASCII и содержать по крайней мере один символ, не являющийся пробелом. Символы управления ASCII не поддерживаются в значениях измерений.

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

Гранность в секундах, используемая для метрики. Для метрик с регулярным разрешением период может быть не менее одной минуты (60 секунд) и должен быть кратен 60. Для высокоразрешающих метрик, собираемых с интервалами менее одной минуты, период может составлять 1, 5, 10, 30, 60 или любое кратное 60. Высокоразрешающие метрики — это метрики, хранящиеся вызовом PutMetricData, который включает StorageResolution 1 секунды.

Stat -> (строка)

Статистика для сравнения с пороговым значением. Это может быть любая статистика CloudWatch или расширенная статистика. Дополнительную информацию о статистике см. в CloudWatch statistics definitions.

Unit -> (строка)

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

Expression -> (строка)

Это поле может содержать выражение вычисления метрик, которое должно быть выполнено над другими метриками, которые вы извлекаете в этой структуре MetricDataQueries.

Выражение вычисления метрик может использовать Id других метрик или запросов для ссылки на эти метрики, а также может использовать Id других выражений для использования результата этих выражений. Дополнительную информацию об выражениях вычисления метрик см. в разделе Синтаксис и функции вычисления метрик в Руководстве пользователя Amazon CloudWatch.

В каждом объекте MetricDataQuery вы должны указать либо Expression, либо MetricStat, но не оба.

Label -> (строка)

Ясночитаемая метка для этой метрики или выражения. Это особенно полезно, если это выражение, чтобы вы знали, что представляет значение. Если метрика или выражение отображаются в виджете панели мониторинга CloudWatch, отображается метка. Если Label опущено, CloudWatch генерирует значение по умолчанию.

Вы можете вставлять динамические выражения в метку, чтобы она была более описательной. Дополнительную информацию см. в разделе Использование динамических меток.

ReturnData -> (булево)

Используйте это только в том случае, если вы используете выражение вычисления метрик для SLO. Укажите true для ReturnData только для одного результата выражения, который следует использовать в качестве сигнала тревоги. Для всех других метрик и выражений в той же операции CreateServiceLevelObjective укажите ReturnData как false.

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

Гранность в секундах возвращаемых точек данных для этой метрики. Для метрик с регулярным разрешением период может быть не менее одной минуты (60 секунд) и должен быть кратен 60. Для высокоразрешающих метрик, собираемых с интервалами менее одной минуты, период может составлять 1, 5, 10, 30, 60 или любое кратное 60. Высокоразрешающие метрики — это метрики, хранящиеся вызовом PutMetricData, который включает StorageResolution 1 секунды.

Если параметр StartTime указывает временную метку, превышающую 3 часа назад, вы должны указать период следующим образом, иначе точки данных в этом временном интервале не возвращаются:

Начальное время между 3 часами и 15 днями назад — используйте кратное 60 секунд (1 минута).
Начальное время между 15 и 63 днями назад — используйте кратное 300 секунд (5 минут).
Начальное время более 63 дней назад — используйте кратное 3600 секунд (1 час).

AccountId -> (строка)

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

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

Определяет зависимость, используя DependencyKeyAttributes и DependencyOperationName.

DependencyKeyAttributes -> (словарь)

Это словарь «строка-строка». Он может включать следующие поля.

Type определяет тип объекта.
ResourceType указывает тип ресурса. Это поле используется только тогда, когда значение поля Type равно Resource или AWS::Resource.
Name указывает имя объекта. Используется только если значение поля Type равно Service, RemoteService или AWS::Service.
Identifier определяет объекты ресурсов этого ресурса. Используется только если значение поля Type равно Resource или AWS::Resource.
Environment указывает расположение, в котором размещён этот объект, или к чему он относится.

key -> (строка)

value -> (строка)

DependencyOperationName -> (строка)

Имя вызываемой операции в зависимости.

MetricThreshold -> (двойное число)

Это значение — порог, с которым сравниваются наблюдаемые значения метрики метрики SLI.

ComparisonOperator -> (строка)

Арифметическая операция, используемая при сравнении указанной метрики с пороговым значением.

EvaluationType -> (строка)

Отображает, является ли это SLO на основе периода или SLO на основе запроса.

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

Данная структура содержит атрибуты, определяющие цель SLO. Включает период для оценки и порог достижения.

Interval -> (структура помеченных союзов)

Период времени, используемый для оценки SLO. Может быть либо календарным интервалом, либо скользящим интервалом.

Если этот параметр опущен, используется скользящий интервал в 7 дней.

Примечание

Это структура помеченных союзов. Только один из следующих ключей верхнего уровня может быть установлен: RollingInterval, CalendarInterval.

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

Если интервал скользящий, эта структура содержит спецификации интервала.

DurationUnit -> (строка)

Указывает единицу скользящего интервала.

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

Указывает продолжительность каждого скользящего интервала. Например, если Duration равно 7, а DurationUnit равно DAY, каждый скользящий интервал составляет семь дней.

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

Если интервал календарный, эта структура содержит спецификации интервала.

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

Дата и время начала первого интервала. Убедитесь, что выбранное время соответствует желаемой настройке интервалов. Например, если вам нужны еженедельные интервалы, начинающиеся в понедельник в 6:00, убедитесь, что указано время понедельника в 6:00.

При использовании в API сырых HTTP-запросов оно отформатировано как время в эпохе в секундах. Например: 1698778057

Как только один календарный интервал заканчивается, автоматически начинается другой.

DurationUnit -> (строка)

Указывает единицу календарного интервала.

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

Указывает продолжительность каждого календарного интервала. Например, если Duration равно 1, а DurationUnit равно MONTH, каждый интервал составляет один месяц, выровненный с календарем.

AttainmentGoal -> (вещественное число)

Порог, определяющий достижение цели.

Если это SLO, основанный на периодах, цель достижения — процент хороших периодов, удовлетворяющих требованиям порога, по отношению ко всем периодам в интервале. Например, цель достижения 99,9% означает, что в вашем интервале 99,9% периодов находятся в здоровом состоянии.

Если это SLO, основанный на запросах, цель достижения — процент успешных запросов, необходимых для достижения цели.

Если этот параметр опущен, используется 99 для представления 99% как цели достижения.

WarningThreshold -> (вещественное число)

Процент оставшегося бюджета по отношению к общему бюджету, для которого требуется предупреждение. Если этот параметр опущен, используется значение по умолчанию 50.0.

BurnRateConfigurations -> (список)

Каждый объект в этом массиве определяет длину окна обратного отсчёта, используемого для расчёта одной метрики скорости выгорания для этого SLO. Скорость выгорания показывает, насколько быстро служба потребляет бюджет ошибок относительно цели достижения SLO.

(структура)

Этот объект определяет длину окна обратного отсчёта, используемого для расчёта одной метрики скорости выгорания для этого SLO. Скорость выгорания показывает, насколько быстро служба потребляет бюджет ошибок относительно цели достижения SLO. Скорость выгорания ровно 1 указывает, что цель SLO будет достигнута точно.

Например, если вы укажете 60 минут как длину окна обратного отсчёта, скорость выгорания рассчитывается следующим образом:

скорость выгорания = частота ошибок за окно обратного отсчёта / (100% - процент цели достижения)

Дополнительную информацию о скоростях выгорания см. в разделе Рассчитать скорости выгорания.

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

Количество минут для использования в качестве окна обратного отсчёта.

MetricSourceType -> (строка)

Отображает тип источника метрики SLI для данного SLO. Поддерживаемые типы:

Операция службы
Зависимость службы
Метрика CloudWatch