[ aws . internetmonitor ]
create-monitor
Описание
Создаёт монитор в Amazon CloudWatch Internet Monitor. Монитор создаётся на основе информации из ресурсов приложения, которые вы добавляете: VPC, сетевые балансировщики (NLB), распределения Amazon CloudFront и каталоги Amazon WorkSpaces. Затем Internet Monitor публикует измерения интернет-трафика Amazon Web Services, которые специфичны для городских сетей. То есть, мест и ASNs (как правило, интернет-провайдеров или ISP), откуда клиенты обращаются к вашему приложению. Для получения дополнительной информации, см. Использование Amazon CloudWatch Internet Monitor в Руководстве пользователя Amazon CloudWatch.
При создании монитора вы выбираете процент трафика, который хотите мониторить. Вы также можете установить максимальное ограничение на количество городских сетей, где отслеживается трафик клиентов, что ограничивает общий мониторимый трафик Internet Monitor. Максимальное число городских сетей — это предел, но вы платите только за количество городских сетей, которые фактически отслеживаются. Вы можете обновить свой монитор в любое время, чтобы изменить процент отслеживаемого трафика или максимальное число городских сетей. Для получения дополнительной информации см. Выбор максимального значения городских сетей в Руководстве пользователя Amazon CloudWatch.
См. также: Документацию API AWS
Синтаксис
create-monitor
--monitor-name <value>
[--resources <value>]
[--client-token <value>]
[--tags <value>]
[--max-city-networks-to-monitor <value>]
[--internet-measurements-log-delivery <value>]
[--traffic-percentage-to-monitor <value>]
[--health-events-config <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]
Параметры
--monitor-name (строка)
--resources (список)
Ресурсы для включения в монитор, которые вы предоставляете в виде набора Amazon Resource Names (ARN). Ресурсы могут быть VPC, NLB, распределения Amazon CloudFront или каталоги Amazon WorkSpaces.
Вы можете добавить комбинацию VPC и распределений CloudFront, или каталоги WorkSpaces, или NLB. Вы не можете добавить NLB или каталоги WorkSpaces вместе с другими ресурсами.
Примечание
Если вы добавляете только ресурсы Amazon VPC, по крайней мере один VPC должен иметь подключенный к нему шлюз в Интернет, чтобы убедиться, что у него есть доступ в Интернет.(строка)
Синтаксис:
"string" "string" ...
--client-token (строка)
--tags (массив)
Теги для монитора. Вы можете добавить не более 50 тегов в Internet Monitor.
ключ -> (строка)
значение -> (строка)
Сокращённый синтаксис:
KeyName1=string,KeyName2=string
Синтаксис JSON:
{"string": "string"
...}
--max-city-networks-to-monitor (целое число)
Максимальное количество городских сетей для мониторинга ваших ресурсов. Городская сеть — это место (город), откуда клиенты обращаются к вашим ресурсам приложения, и ASN или поставщик сети, например, интернет-провайдер (ISP), через который клиенты получают доступ к ресурсам. Установка этого ограничения может помочь контролировать расходы на платёж.
Дополнительную информацию см. в разделе Выбор максимального значения городских сетей в разделе Amazon CloudWatch Internet Monitor Руководства по CloudWatch.
--internet-measurements-log-delivery (структура)
Опубликовать измерения интернет-трафика Internet Monitor в ведро Amazon S3 в дополнение к CloudWatch Logs.
S3Config -> (структура)
Конфигурационная информация для публикации измерений интернет-трафика Internet Monitor в Amazon S3. Конфигурация включает имя ведра и (необязательно) префикс для ведра S3 для хранения измерений, а также статус доставки. Статус доставки — ENABLED или DISABLED, в зависимости от того, хотите ли вы доставлять измерения интернет-трафика в журналы S3.
BucketName -> (строка)
BucketPrefix -> (строка)
LogDeliveryStatus -> (строка)
Сокращённый синтаксис:
S3Config={BucketName=string,BucketPrefix=string,LogDeliveryStatus=string}
Синтаксис JSON:
{
"S3Config": {
"BucketName": "string",
"BucketPrefix": "string",
"LogDeliveryStatus": "ENABLED"|"DISABLED"
}
}
--traffic-percentage-to-monitor (целое число)
Процент интернет-трафика вашего приложения, который вы хотите мониторить с этим монитором. Если вы установили максимальное значение городских сетей, это ограничение переопределяет процент трафика, который вы установили.
Дополнительную информацию см. в разделе Выбор процента трафика приложения для мониторинга в разделе Amazon CloudWatch Internet Monitor Руководства по CloudWatch.
--health-events-config (структура)
Определяет процентные пороги и другую конфигурационную информацию о том, когда Amazon CloudWatch Internet Monitor создаёт событие о состоянии здоровья. Internet Monitor создаёт событие о состоянии здоровья, когда проблема с интернетом, которая затрагивает конечных пользователей вашего приложения, имеет процентный балл состояния здоровья, равный или ниже определённого порога, и иногда, когда выполняются другие критерии.
Если вы не устанавливаете порог события о состоянии здоровья, значение по умолчанию составляет 95%.
Дополнительную информацию см. в разделе Изменение порогов событий о состоянии здоровья в разделе Монитор Internet в Руководстве пользователя CloudWatch.
AvailabilityScoreThreshold -> (вещественное число)
PerformanceScoreThreshold -> (вещественное число)
AvailabilityLocalHealthEventsConfig -> (структура)
Конфигурация, определяющая порог и другие условия, при которых Internet Monitor создаёт событие о состоянии здоровья для проблемы локальной доступности.
Status -> (строка)
ENABLED или DISABLED.HealthScoreThreshold -> (вещественное число)
MinTrafficImpact -> (вещественное число)
Минимальный процент общего трафика приложения, на который должна повлиять проблема, прежде чем Internet Monitor создаст событие, когда порог превышен для локального балла состояния здоровья.
Если вы не установили порог минимального воздействия на трафик, значение по умолчанию составляет 0,1%.
PerformanceLocalHealthEventsConfig -> (структура)
Конфигурация, определяющая порог и другие условия, при которых Internet Monitor создаёт событие о состоянии здоровья для проблемы локальной производительности.
Status -> (строка)
ENABLED или DISABLED.HealthScoreThreshold -> (вещественное число)
MinTrafficImpact -> (вещественное число)
Минимальный процент общего трафика приложения, на который должна повлиять проблема, прежде чем Internet Monitor создаст событие, когда порог превышен для локального балла состояния здоровья.
Если вы не установили порог минимального воздействия на трафик, значение по умолчанию составляет 0,1%.
Сокращённый синтаксис:
AvailabilityScoreThreshold=double,PerformanceScoreThreshold=double,AvailabilityLocalHealthEventsConfig={Status=string,HealthScoreThreshold=double,MinTrafficImpact=double},PerformanceLocalHealthEventsConfig={Status=string,HealthScoreThreshold=double,MinTrafficImpact=double}
Синтаксис JSON:
{
"AvailabilityScoreThreshold": double,
"PerformanceScoreThreshold": double,
"AvailabilityLocalHealthEventsConfig": {
"Status": "ENABLED"|"DISABLED",
"HealthScoreThreshold": double,
"MinTrafficImpact": double
},
"PerformanceLocalHealthEventsConfig": {
"Status": "ENABLED"|"DISABLED",
"HealthScoreThreshold": double,
"MinTrafficImpact": double
}
}
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределят значения, полученные из JSON. Невозможно передать произвольные двоичные значения с помощью значения, предоставленного JSON, так как строка будет взята буквально. Это может не быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если предоставлено значение без значения или значение input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, выводит пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, оно проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.
Общие параметры
--debug (boolean)
Включить отладку логирования.
--endpoint-url (string)
Переопределить адрес по умолчанию команды заданным адресом.
--no-verify-ssl (boolean)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять сертификаты SSL. Данный параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.
--no-paginate (boolean)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (string)
Стиль форматирования вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (string)
Запрос JMESPath для фильтрации данных ответа.
--profile (string)
Использовать определенный профиль из файла учетных данных.
--region (string)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (string)
Показать версию этого инструмента.
--color (string)
Включить/выключить цветной вывод.
- on
- off
- auto
--no-sign-request (boolean)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (string)
Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения к сокету в секундах. Если значение установлено в 0, подключение к сокету будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.
--cli-binary-format (string)
Стиль форматирования для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI версии 1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, которое сопоставляется с двоичным блоком fileb:// всегда будет обрабатываться как двоичное и будет использовать содержимое файла напрямую, независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (boolean)
Отключить пагинатор CLI для вывода.
--cli-auto-prompt (boolean)
Автоматически запросить параметры ввода CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическое запроса параметров ввода CLI.
Вывод
Arn -> (string)
Status -> (string)
© Copyright 2025, Amazon Web Services. Created using Sphinx.