Просмотр кода страницы Мониторы доступности сети в классическом режиме

= Мониторы доступности сети в классическом режиме =

Предварительный просмотр

Мониторинг доступности сети позволяет создавать синтетические мониторы доступности сети типов '''ICMP''', '''TCP''' или '''DNS'''.

API Synthetic - Network availability monitors является частью Environment API v2. Для получения дополнительной информации см. API Explorer.

== Ограничения ==

=== Количество запросов ===
Максимальное количество запросов, выполняемых одним монитором доступности сети, составляет 1000.

Если монитор использует целевой фильтр, может оказаться невозможным точно предсказать количество запросов до их выполнения (например, при мониторинге всей группы хостов или подсети с широким диапазоном IP-адресов). В таких случаях ограничение применяется, когда целевой фильтр преобразуется в фактический список адресов до выполнения монитором.

=== Операционная система ===
Мониторы доступности сети не поддерживаются на хостах '''Windows''' с включенным синтетическим режимом АктивногоШлюза.

=== Тип развертывания ===
Поддержка мониторов доступности сети доступна только в частных синтетических локациях.

=== Контейнерные площадки ===
Мониторы доступности сети поддерживаются в контейнеризированных развертываниях АктивногоШлюза с поддержкой Synthetic, но для этого требуются дополнительные разрешения.

Мониторы '''ICMP''' используют исполняемый файл <code>ping</code>, для работы которого требуется набор прав доступа <code>CAP_NET_RAW</code>, установленный для контейнера, выполняющего запросы (<code>synthetic-vuc</code>). Кроме того, свойство <code>allowPrivilegeEscalation</code> в <code>securityContext</code> для этого контейнера должно быть установлено в значение <code>true</code>, поскольку процесс, запускающий исполняемый файл <code>ping</code>, по умолчанию не имеет необходимых привилегий.

Полный код <code>securityContext</code> для контейнера <code>synthetic-vuc</code> с включенными мониторами доступности сети должен выглядеть следующим образом.

{| class="wikitable"
|<pre>
securityContext:
  readOnlyRootFilesystem: true
  privileged: false
  allowPrivilegeEscalation: true
  runAsNonRoot: true
  capabilities:
    drop: ["all"]
    add: ["NET_RAW"]
</pre>
|}

== POST создать многопротокольный монитор ==

=== Схема монитора SyntheticMultiProtocolMonitorUpdateDto ===
Необходимый

{| class="wikitable"
|-
! Параметр !! Тип !! Описание
|-
| <code>name</code>* || string || Название монитора
|-
| <code>type</code>* || string || Тип синтетического монитора. Эта конечная точка поддерживает только многопротокольные мониторы. Элемент может содержать значение <code>MULTI_PROTOCOL</code>.
|-
| <code>frequencyMin</code>* || integer || Частота работы монитора в минутах
|-
| <code>locations</code>* || list || Места, к которым прикреплен наблюдатель
|-
| <code>active</code> || boolean || Значение по умолчанию — <code>true</code>. Если <code>false</code>, монитор отключен.
|-
| <code>steps</code>* || list || Этапы мониторинга. См. схему <code>steps</code>.
|-
| <code>syntheticMonitorOutageHandlingSettings</code> || list || Конфигурация обработки сбоев мониторинга. См. схему <code>syntheticMonitorOutageHandlingSettings</code>.
|-
| <code>tags</code> || list || Набор меток, присваиваемых монитору вручную. Здесь можно указать только ключ (обязательно) и значение (необязательно) метки.
|}

=== steps схема SyntheticMultiProtocolMonitorStepDto ===
{| class="wikitable"
|-
! Параметр !! Тип !! Описание
|-
| <code>name</code>* || string || Название шага
|-
| <code>requestType</code>* || string || Тип запроса. Элемент может содержать значения <code>ICMP</code>, <code>TCP</code>, или <code>DNS</code>
|-
| <code>targetFilter</code> || string || Фильтр контролируемых хостов
|-
| <code>targetList</code>* || list || Список целевых объектов (адреса, IP-адреса)
|-
| <code>properties</code>* || map<string, string> || Свойства, применяемые ко всем запросам на данном этапе.
|-
| <code>constraints</code>* || list || Список ограничений, применяемых к данному шагу и всем запросам на этом шаге. См. схему <code>constraints</code>.
|-
| <code>requestConfigurations</code>* || list || Запрос конфигураций. См. схему <code>requestConfigurations</code>.
|}

=== requestConfigurations схема SyntheticMultiProtocolRequestConfigurationDto ===
{| class="wikitable"
|-
! Параметр !! Тип !! Описание
|-
| <code>constraints</code> || list || Список ограничений, применяемых ко всем запросам в схеме <code>constraints</code>.
|}

=== constraints схема SyntheticMultiProtocolMonitorConstraintDto ===
{| class="wikitable"
|-
! Параметр !! Тип !! Описание
|-
| <code>type</code>* || string || Тип ограничения
|-
| <code>properties</code>* || map<string, string> || Свойства ограничения. Примеры см. в разделе «Ограничения конфигурации скрипта».
|}

=== syntheticMonitorOutageHandlingSettings схема SyntheticMonitorOutageHandlingSettingsDto ===
{| class="wikitable"
|-
! Параметр !! Тип !! Описание
|-
| <code>globalConsecutiveOutageCountThreshold</code> || integer || Количество последовательных отказов для всех местоположений
|-
| <code>globalOutages</code>* || boolean || Сгенерируйте сообщение о проблеме и отправьте оповещение, если монитор недоступен в течение одного <code>globalConsecutiveOutageCountThreshold</code> или нескольких последовательных запусков во всех настроенных местах.
|-
| <code>localConsecutiveOutageCountThreshold</code> || integer || Количество последовательных отказов для любого местоположения
|-
| <code>localLocationOutageCountThreshold</code> || integer || Количество неисправных мест
|-
| <code>localOutages</code>* || boolean || Сгенерируйте сообщение о проблеме и отправьте оповещение, если монитор недоступен в течение <code>localConsecutiveOutageCountThreshold</code> или более последовательных выполнений в <code>localLocationOutageCountThreshold</code> или более местах.
|}

== Примеры ==

=== Пример монитора с ICMP-запросами ===
{| class="wikitable"
|<pre>
{
  "name": "Пример монитора NAM с шагом ICMP",
  "type": "MULTI_PROTOCOL",
  "frequencyMin": "1",
  "locations": [
    "SYNTHETIC_LOCATION-8A91FE7982E24C06"
  ],
  "active": "true",
  "steps": [
    {
      "name": "ICMP шаг 1",
      "requestType": "ICMP",
      "targetFilter": null,
      "targetList": [
        "127.0.0.1",
        "127.0.0.2",
        "127.0.0.3",
        "127.0.0.4"
      ],
      "constraints": [
        {
          "type": "SUCCESS_RATE_PERCENT",
          "properties": {
            "value": "49",
            "operator": ">"
          }
        }
      ],
      "properties": {
        "ICMP_NUMBER_OF_PACKETS": "3",
        "ICMP_TIMEOUT_FOR_REPLY": "PT1S"
      },
      "requestConfigurations": [
        {
          "constraints": [
            {
              "type": "ICMP_SUCCESS_RATE_PERCENT",
              "properties": {
                "value": "100"
              }
            }
          ]
        }
      ]
    }
  ],
  "syntheticMonitorOutageHandlingSettings": {
    "globalOutages": true,
    "localOutages": false,
    "globalConsecutiveOutageCountThreshold": 1,
    "localLocationOutageCountThreshold": null,
    "localConsecutiveOutageCountThreshold": null
  },
  "tags": [
    {
      "key": "my-icmp-monitor"
    },
    {
      "key": "environment",
      "value": "UAT"
    }
  ]
}
</pre>
|}

=== Пример монитора с TCP-запросами ===
{| class="wikitable"
|<pre>
{
  "name": "Пример монитора NAM с шагом TCP",
  "type": "MULTI_PROTOCOL",
  "frequencyMin": "1",
  "locations": [
    "SYNTHETIC_LOCATION-8A91FE7982E24C06"
  ],
  "active": "true",
  "steps": [
    {
      "name": "TCP шаг 1",
      "requestType": "TCP",
      "targetFilter": "hostGroup == my-host-group0 and ipRange == 45-55.*.*.*",
      "targetList": [],
      "constraints": [
        {
          "type": "SUCCESS_RATE_PERCENT",
          "properties": {
            "value": "66",
            "operator": ">="
          }
        }
      ],
      "properties": {
        "TCP_PORT_RANGES": "22,443,5501-5509"
      },
      "requestConfigurations": [
        {
          "constraints": []
        }
      ]
    }
  ],
  "syntheticMonitorOutageHandlingSettings": {
    "globalOutages": true,
    "localOutages": false,
    "globalConsecutiveOutageCountThreshold": 1,
    "localLocationOutageCountThreshold": null,
    "localConsecutiveOutageCountThreshold": null
  },
  "tags": [
    {
      "key": "my-tcp-monitor"
    },
    {
      "key": "environment",
      "value": "UAT"
    }
  ]
}
</pre>
|}

=== Пример монитора с DNS-запросами ===
{| class="wikitable"
|<pre>
{
  "name": "Пример монитора NAM с шагом DNS",
  "type": "MULTI_PROTOCOL",
  "frequencyMin": 1,
  "locations": [
    "SYNTHETIC_LOCATION-6F3084B1ECD81DE1"
  ],
  "active": true,
  "steps": [
    {
      "name": "Шаг DNS 1",
      "requestType": "DNS",
      "targetFilter": null,
      "targetList": [
        "astromkey.com"
      ],
      "constraints": [
        {
          "type": "SUCCESS_RATE_PERCENT",
          "properties": {
            "value": "90",
            "operator": ">="
          }
        }
      ],
      "properties": {
        "DNS_RECORD_TYPES": "A,AAAA",
        "DNS_SERVER": "10.102.40.11"
      },
      "requestConfigurations": [
        {
          "constraints": [
            {
              "type": "DNS_STATUS_CODE",
              "properties": {
                "status": "NOERROR",
                "operator": "="
              }
            }
          ]
        }
      ]
    }
  ],
  "syntheticMonitorOutageHandlingSettings": {
    "globalOutages": true,
    "localOutages": false,
    "globalConsecutiveOutageCountThreshold": 1,
    "localLocationOutageCountThreshold": null,
    "localConsecutiveOutageCountThreshold": null
  },
  "tags": [
    {
      "key": "my-dns-monitor"
    },
    {
      "key": "environment",
      "value": "UAT"
    }
  ]
}
</pre>
|}

== Доступные параметры конфигурации скрипта ==

=== Примеры форматов продолжительности ===
* 100 миллисекунд = <code>PT0.1S</code>
* 500 миллисекунд = <code>PT0.5S</code>
* 1 секунда = <code>PT1S</code>
* 10 секунд = <code>PT10S</code>
* 90 секунд = <code>PT1M30S</code>
* 1 минута = <code>PT1M</code>
* 2 минуты = <code>PT2M</code>
* 5 минут = <code>PT5M</code>

=== ICMP ===
{| class="wikitable"
|-
! Имя !! Тип !! Описание !! Значения
|-
| <code>EXECUTION_TIMEOUT</code> || string:duration || Истекло время ожидания выполнения одного запроса. || Допустимая продолжительность, например, <code>PT1S</code> значение по умолчанию = <code>ICMP_NUMBER_OF_PACKETS</code> × <code>ICMP_TIMEOUT_FOR_REPLY</code> + defaultTimeout (<code>defaultTimeout</code> = 1s) Диапазон = 0–PT2M
|-
| <code>ICMP_NUMBER_OF_PACKETS</code> || integer || Количество эхо-запросов. Эквивалентами процесса Ping являются параметры <code>-c</code> (Linux) и <code>-n</code> (Windows). || Значение по умолчанию = 1 Диапазон = 1–10
|-
| <code>ICMP_PACKET_SIZE</code> || integer || Эквивалентами параметров процесса Ping являются параметры <code>-s</code> (Linux) и <code>-l</code> (Windows). || Значение по умолчанию = 32 Диапазон = 0–65500
|-
| <code>ICMP_TIME_TO_LIVE</code> || integer || Эквивалентами параметров Time to live (TTL) Ping являются параметры <code>-t</code> (Linux) и <code>-i</code> (Windows). || Диапазон = 1–255
|-
| <code>ICMP_TYPE_OF_SERVICE</code> || integer || Эквивалентами процесса service Ping являются параметры <code>-Q</code> (Linux) и <code>-v</code> (Windows). || Диапазон = 0–255
|-
| <code>ICMP_DO_NOT_FRAGMENT_DATA</code> || boolean || Не фрагментировать. Эквивалентами процесса Ping являются параметры <code>-M do</code> (Linux) и <code>-f</code> (Windows). || <code>true</code> или <code>false</code>
|-
| <code>ICMP_TIMEOUT_FOR_REPLY</code> || string:duration || Дождитесь ответного сообщения с эхо-сигналом. Эквивалентами процесса Ping являются параметры <code>-W</code> (Linux) и <code>-w</code> (Windows). || Допустимая длительность, например, <code>PT1S</code> в миллисекундах в Windows; <code>PT0.1S</code> принимаются значения, подобные этому. В секундах в Linux; <code>PT1S</code> обязательны значения, подобные этому. Значение по умолчанию = <code>PT1S</code> Диапазон = <code>PT1S</code>–<code>PT2S</code>
|}

Интервал передачи пакетов задан жестко <code>200ms</code>, что соответствует минимальному значению, допустимому для параметра <code>-i</code> команды Linux ping без необходимости предоставления повышенных привилегий.

=== TCP ===
{| class="wikitable"
|-
! Имя !! Тип !! Описание !! Значения
|-
| <code>TCP_PORT_RANGES</code> || string || Список диапазонов портов, разделенных запятыми.
Один диапазон может представлять собой либо один номер порта, либо диапазон портов, определяемый как два номера портов, разделенных дефисом.
Итоговый список запросов для выполнения представляет собой произведение всех определенных портов и целевых хостов. Например, если на этапе заданы два целевых хоста (<code>1.1.1.1</code> и <code>2.2.2.2</code>) и диапазон из двух портов (<code>80-81</code>), то в рамках такого этапа выполняется четыре запроса.
* Запрос в <code>1.1.1.1</code> порт <code>80</code>
* Запрос в <code>1.1.1.1</code> порт <code>81</code>
* Запрос в <code>2.2.2.2</code> порт <code>80</code>
* Запрос в <code>2.2.2.2</code> порт <code>81</code>
|| Примеры значений:
* <code>8080</code>
* <code>8000-9000</code>
* <code>80,443,90-100</code>
|-
| <code>EXECUTION_TIMEOUT</code> || string:duration || Таймаут соединения || Например, срок действия. <code>PT1S</code>
Таймаут по умолчанию = <code>1s</code>
Диапазон = 0–PT2M
|}

=== DNS ===
{| class="wikitable"
|-
! Имя !! Тип !! Описание !! Значения
|-
| <code>DNS_RECORD_TYPES</code> || string || Список типов DNS-записей, разделенных запятыми.
Итоговый список выполненных запросов представляет собой произведение всех определенных типов записей и целевых хостов. Например, если шаг содержит два типа записей (<code>A</code>, <code>AAAA</code>) и два целевых хоста (<code>host1.domain.com</code> и <code>host2.domain.com</code>), то в рамках такого шага выполняется четыре запроса.
* Запрос на предоставление <code>A</code> содержимого записи для <code>host1.domain.com</code>
* Запрос на предоставление <code>AAAA</code> содержимого записи для <code>host1.domain.com</code>
* Запрос на предоставление <code>A</code> содержимого записи для <code>host2.domain.com</code>
* Запросить или <code>AAAA</code> записать содержимое для <code>host2.domain.com</code>
|| Примеры значений:
* <code>A</code>
* <code>A,AAAA</code>
* <code>A,AAAA,CNAME</code>
|-
| <code>EXECUTION_TIMEOUT</code> || string:duration || Таймаут соединения || Например, срок действия. <code>PT1S</code>
Таймаут по умолчанию = <code>2s</code>
Диапазон = 0–PT2M
|-
| <code>DNS_SERVER</code> || string || Адрес DNS-сервера для запроса, с необязательным указанием порта.
Если указано имя хоста, оно преобразуется в IP-адрес с использованием DNS-сервера по умолчанию системы.
Если указан только хост, используется порт по умолчанию <code>53</code>.
Если значение не указано, используются DNS-сервер и порт по умолчанию, указанные в системе.
|| Действительный адрес, например:
* <code>1.1.1.1</code>
* <code>8.4.4.8:53</code>
* <code>dns.google</code>
* <code>dns9.quad9.net:53</code>
|-
| <code>DNS_FORCE_TCP</code> || boolean || По умолчанию запрос к DNS-серверу осуществляется по протоколу UDP, если только сообщение не слишком велико для размещения в UDP-дейтаграмме. Эта опция позволяет указать вместо этого протокол TCP. || <code>true</code> или <code>false</code>
Значение по умолчанию = <code>false</code>
|}

== Ограничения конфигурации скрипта ==
Ограничения описывают условия успеха.

=== Ограничения на уровне шага ===
==== SUCCESS_RATE_PERCENT ====
Процент успешных запросов на этапе
Фактический процент успешных запросов = отношение количества запросов, которые не завершились неудачей (успешные + пропущенные запросы), ко всем запросам.
Например, если 1 запрос не удался, 2 запроса пропущены, а 3 запроса оказались успешными, то соотношение составит (2+3)/6 = 83,33%.

{| class="wikitable"
|-
! Атрибут !! Тип !! Описание !! Значения
|-
| <code>operator</code> || string || Оператор сравнения для сопоставления фактического и ожидаемого значения. || <code>>=</code> или значение по умолчанию <code>>=</code> <code><=</code> <code>!=</code> <code>>=</code>
|-
| <code>value</code> || integer || Ожидаемое значение показателя успешности для использования в качестве эталона сравнения. || Значение по умолчанию = 0 Диапазон = 0–100
|}

{| class="wikitable"
|<pre>
{
  "type": "SUCCESS_RATE_PERCENT",
  "properties": {
    "value": "83",
    "operator": ">"
  }
}
</pre>
|}

=== Ограничения запросов ICMP ===
==== ICMP_SUCCESS_RATE_PERCENT ====
Процент успешных пингов (эхо-запросов) в запросе
Фактический процент успешности = отношение количества полученных пакетов к количеству отправленных пакетов
Например, если было отправлено 5 пакетов и получено 4 пакета, то соотношение составит 4/5 = 80,00%.

{| class="wikitable"
|-
! Атрибут !! Тип !! Описание !! Значения
|-
| <code>operator</code> || string || Оператор сравнения для сопоставления фактического и ожидаемого значения. || <code>>=</code> или значение по умолчанию <code>>=</code> <code><=</code> <code>!=</code> <code>>=</code>
|-
| <code>value</code> || integer || Ожидаемое значение показателя успешности для использования в качестве эталона сравнения. || Значение по умолчанию = 0 Диапазон = 0–100
|}

{| class="wikitable"
|<pre>
{
  "type": "ICMP_SUCCESS_RATE_PERCENT",
  "properties": {
    "value": "79",
    "operator": ">"
  }
}
</pre>
|}

=== Ограничения TCP-запросов ===
==== TCP_PORT_UNREACHABLE ====
Это особое ограничение, которое инвертирует статус выполнения TCP-запросов. Его следует применять, если ожидается, что проверяемый порт недоступен.
Данное ограничение не имеет параметров конфигурации.
Если это ограничение применяется:
* Когда после попытки подключения обнаруживаются статусы <code>Execution timeout (12033)</code> и <code>TCP socket connection error (22000)</code>, они интерпретируются как <code>HEALTHY (0)</code>.
* Статус <code>HEALTHY (0)</code> соединения интерпретируется как <code>CONSTRAINT_VIOLATED (1401)</code> результат ожидаемого сбоя.
* Статусы <code>UNEXPECTED_ERROR (-1)</code> и <code>UNKNOWN_HOST (12013)</code> сохраняются и отображаются в неизменном виде.

{| class="wikitable"
|<pre>
{
  "type": "TCP_PORT_UNREACHABLE",
  "properties": {}
}
</pre>
|}

=== Ограничения на DNS-запросы ===
==== DNS_STATUS_CODE ====
Проверяет код состояния ответа DNS, который указывает, был ли запрос успешным или нет.

{| class="wikitable"
|-
! Атрибут !! Тип !! Описание !! Значения
|-
| <code>operator</code> || string || Оператор сравнения для сопоставления фактического и ожидаемого значения. || <code>=</code> или <code>!=</code> значение по умолчанию <code>=</code>
|-
| <code>statusCode</code> || integer || Числовой код, указывающий на статус ответа DNS. Эксклюзивно с <code>status</code> || Допустимый код, например: <code>0</code> Значение по умолчанию = <code>0</code> Диапазон = 0–65535
|-
| <code>status</code> || string || Мнемоническое обозначение, представляющее код состояния DNS. Эксклюзивно с <code>statusCode</code> || Допустимый статус, например, <code>NOERROR</code> значение по умолчанию = <code>NOERROR</code>
|}

{| class="wikitable"
|<pre>
{
  "type": "DNS_STATUS_CODE",
  "properties": {
    "operator": "=",
    "statusCode": "0"
  }
}
</pre>
|}

{| class="wikitable"
|<pre>
{
  "type": "DNS_STATUS_CODE",
  "properties": {
    "operator": "=",
    "status": "NOERROR"
  }
}
</pre>
|}

==== DNS_IP_ADDRESS ====
Проверяет значение IP-адреса, возвращаемое в записях A/AAAA.

{| class="wikitable"
|-
! Атрибут !! Тип !! Описание !! Значения
|-
| <code>quantifier</code> || string || Сколько записей должно соответствовать условию, чтобы ограничение было выполнено? || <code>any</code> (как минимум один) или <code>all</code> значение по умолчанию = <code>any</code>
|-
| <code>operator</code> || string || Оператор сравнения || <code>=</code> или значения по умолчанию = - для адреса - <code>!=</code> для подсети <code>in</code>
|-
| <code>recordType</code> || string || тип записи DNS || <code>A</code> или <code>AAAA</code> значения по умолчанию: - <code>A</code> если адрес/подсеть IPv4 - <code>AAAA</code> если адрес/подсеть IPv6
|-
| <code>address</code> || string || IPv4-адрес в точечной нотации или IPv6-адрес в нотации с двоеточием. Только у операторов <code>=</code>, <code>!=</code> эксклюзивно для <code>subnet</code> || Действительный адрес, например, <code>192.168.0.1</code>, <code>2001:db8::2:1</code>
|-
| <code>subnet</code> || string || Подсеть IPv4 в точечной нотации или подсеть IPv6 в нотации с двоеточием, за которой следует длина префикса сети. Только с оператором. <code>in</code> Исключительно с <code>address</code> || Допустимая подсеть, например, <code>172.22.80.0/20</code>, <code>2001:db8:85a3::0/48</code>
|}

{| class="wikitable"
|<pre>
{
  "constraintType": "DNS_IP_ADDRESS",
  "attributes": {
    "quantifier": "any",
    "recordType": "A",
    "operator": "=",
    "address": "54.208.9.71"
  }
}
</pre>
|}

{| class="wikitable"
|<pre>
{
  "constraintType": "DNS_IP_ADDRESS",
  "attributes": {
    "quantifier": "all",
    "recordType": "A",
    "operator": "in",
    "subnet": "10.102.44.0/24"
  }
}
</pre>
|}

==== DNS_RECORD_COUNT ====
Проверяет количество записей заданного типа.

{| class="wikitable"
|-
! Атрибут !! Тип !! Описание !! Значения
|-
| <code>operator</code> || string || Оператор сравнения || <code>>=</code> или значение по умолчанию <code>>=</code> <code><=</code> <code>!=</code> <code>></code>
|-
| <code>recordType</code> || string || тип записи DNS || Допустимый тип записи, например: <code>MX</code>
|-
| <code>value</code> || integer || Ожидаемое количество записей || Допустимое количество, например. <code>2</code> Значение по умолчанию = 0 Диапазон = 0–65535
|}

{| class="wikitable"
|<pre>
{
  "constraintType": "DNS_RECORD_COUNT",
  "attributes": {
    "recordType": "A",
    "operator": ">",
    "value": "0"
  }
}
</pre>
|}

==== DNS_TIME_TO_LIVE ====
Проверяет время жизни (TTL) записей заданного типа.

{| class="wikitable"
|-
! Атрибут !! Тип !! Описание !! Значения
|-
| <code>quantifier</code> || string || Сколько записей должно соответствовать условию, чтобы ограничение было выполнено? || <code>any</code> (как минимум один) или <code>all</code> значение по умолчанию = <code>any</code>
|-
| <code>operator</code> || string || Оператор сравнения || <code>>=</code> или значение по умолчанию <code>>=</code> <code><=</code> <code>!=</code> <code>></code>
|-
| <code>recordType</code> || string || тип записи DNS || Допустимый тип записи, например: <code>NS</code>
|-
| <code>value</code> || integer || Ожидаемое время жизни (TTL) в секундах || Допустимое значение TTL, например, <code>3600</code> значение по умолчанию = 0 Диапазон = 0–2147483647
|}

{| class="wikitable"
|<pre>
{
  "constraintType": "DNS_TIME_TO_LIVE",
  "attributes": {
    "quantifier": "any",
    "recordType": "A",
    "operator": ">=",
    "value": "30"
  }
}
</pre>
|}

==== DNS_RECORD_VALUE ====
Проверяет исходное значение записей заданного типа, при этом формат значения зависит от типа записи.
Ограничения обрабатывают все записи в ответе, независимо от того, к какому разделу они относятся (<code>answer</code>, <code>authority</code>, или <code>additional</code>).

{| class="wikitable"
|-
! Атрибут !! Тип !! Описание !! Значения
|-
| <code>quantifier</code> || string || Сколько записей должно соответствовать условию, чтобы ограничение было выполнено? || <code>any</code> (как минимум один) или <code>all</code> значение по умолчанию = <code>any</code>
|-
| <code>operator</code> || string || Оператор сравнения: <code>contains</code> проверяет, содержит ли значение записи заданную последовательность; <code>matches</code> проверяет, соответствует ли значение записи заданному шаблону. || <code>contains</code> или <code>matches</code> значение по умолчанию = <code>contains</code>
|-
| <code>recordType</code> || string || тип записи DNS || Допустимый тип записи, например: <code>TXT</code>
|-
| <code>sequence</code> || string || Последовательность символов, которую должно содержать значение записи. Только с оператором. <code>contains</code> Исключая с <code>pattern</code> || Непустая последовательность, например, <code>ms71815323</code>
|-
| <code>pattern</code> || string || Шаблон для сопоставления со значением записи, где <code>*</code> обозначает 0 или более символов. Только с оператором. <code>matches</code> Исключительно с <code>sequence</code> || Например, непустой шаблон <code>"v=spf1 include:*</code>
|}

{| class="wikitable"
|<pre>
{
  "constraintType": "DNS_RECORD_VALUE",
  "attributes": {
    "quantifier": "any",
    "recordType": "TXT",
    "operator": "contains",
    "sequence": "ms71815323"
  }
}
</pre>
|}

{| class="wikitable"
|<pre>
{
  "constraintType": "DNS_RECORD_VALUE",
  "attributes": {
    "quantifier": "any",
    "recordType": "TXT",
    "operator": "matches",
    "pattern": "\"v=spf1 include:*"
  }
}
</pre>
|}

== Целевой фильтр ==
Фильтр целевых устройств позволяет фильтровать хосты, отслеживаемые Ключ-АСТРОМ, или пользовательские устройства, имеющие IP-адреса. С помощью этого фильтра можно выбрать два типа целевых устройств на основе следующих критериев:

* тип (<code>type</code>)
* теги (<code>tag</code>)
* Идентификатор хоста (<code>hostId</code>) (устарело, работает только для хостов, используйте вместо него идентификатор сущности)
* Идентификатор сущности (<code>entityId</code>)
* группы хостов (<code>hostGroup</code>)
* зоны управления (<code>managementZone</code>)
* IP-маска (<code>ipMask</code>)
* Диапазон IP-адресов (<code>ipRange</code>)
* экземпляр группы процессов (<code>processGroupInstance</code>)
* сетевые интерфейсы конкретного пользовательского устройства (<code>interfacesOf</code>)
* имя расширения (<code>extensionName</code>)

Диапазон IP-адресов и маска IP-адреса являются фильтрами для хостов или устройств, известных как сервер Ключ-АСТРОМ, и не позволяют сканировать сеть.

=== Синтаксис ===
* Логические операторы: <code>AND</code> и <code>OR</code> (регистронезависимо)
* Скобки
* Операторы выражений: <code>==</code> и <code>!=</code>
* Названия и значения тегов
* Отрицание ("не"): <code>!=</code>.
* Подстановочный знак: <code>*</code> (выбирает все хосты, отслеживаемые Ключ-АСТРОМ)

=== Примеры ===
* <code>tag == tagname or hostGroup == group1</code>
* <code>(tag == tagname1:tagvalue1 or tag == tagname1:tagvalue2) and (hostGroup == group1 or managementZone == zone1)</code>
* <code>tag != tagname1 and tag != tagname2:tagvalue</code>
* <code>tag == tagname:tagvalue and (managementZone == zone1 or managementZone == zone2)</code>
* <code>tag == "[tagwithbrackets and spaces]":"value, with, commas, and, spaces"</code>
* <code>ipMask == 127.0.0.1/24</code>
* <code>hostId == HOST-000123</code>
* <code>type == CUSTOM_DEVICE and ipMask == 172.17.0.2/24</code>
* <code>entityId == HOST-045BFCDA3F507D30 or entityId == CUSTOM_DEVICE-13081D4B74B3E2C8</code>
* <code>type == HOST and processGroupInstance == PROCESS_GROUP_INSTANCE-07611353BB98908C</code>
* <code>type == CUSTOM_DEVICE and interfacesOf == CUSTOM_DEVICE-E1A88946BF04D5E7</code>
* <code>type == CUSTOM_DEVICE and extensionName == "Docker devices"</code>

== Метрики и параметры ==

=== Размеры (все мониторы доступности сети) ===
{| class="wikitable"
|-
! Имя !! Тип !! Описание !! Пример значения
|-
| <code>multi_protocol.request.type</code> || string || Тип запроса || <code>icmp</code>, <code>tcp</code>
|-
| <code>multi_protocol.request.target_address</code> || string || Адрес целевого объекта || <code>54.171.216.19</code>
|-
| <code>dt.entity.host</code> || string || Если имеется, идентификатор отслеживаемого объекта для целевого объекта. || <code>HOST-024C103F7F86A290</code>
|-
| <code>dt.entity.synthetic_location</code> || string || Синтетический идентификатор местоположения (идентификатор отслеживаемого объекта) || <code>SYNTHETIC_LOCATION-A4F834D72840EFC1</code>
|-
| <code>dt.entity.multiprotocol_monitor</code> || string || Идентификатор монитора (идентификатор отслеживаемого объекта) || <code>MULTIPROTOCOL_MONITOR-3F6C9D500287BBAF</code>
|-
| <code>multi_protocol.step.id</code> || numeric || Последовательный идентификатор шага || <code>1</code>
|-
| <code>multi_protocol.request.id</code> || numeric || Запросить последовательный идентификатор || <code>2</code>
|-
| <code>multi_protocol.result.status</code> || string || Статус выполнения || <code>HEALTHY</code>, <code>CONSTRAINT_VIOLATED</code>
|-
| <code>multi_protocol.result.status.code</code> || numeric || Числовое представление состояния выполнения || <code>0</code>, <code>1401</code>
|}

=== Отслеживание метрик (всех мониторов доступности сети) ===
{| class="wikitable"
|-
! Имя !! Тип !! Размеры !! Описание
|-
| <code>dt.synthetic.multi_protocol.execution_time</code> / <code>builtin:synthetic.multiProtocol.executionTime</code> || numeric || <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> || Продолжительность между началом и окончанием выполнения визита (в миллисекундах). Метрика доступна только в том случае, если визит действительно состоялся; должны быть доступны как время начала, так и время окончания.
|-
| <code>dt.synthetic.multi_protocol.success_rate</code> / <code>builtin:synthetic.multiProtocol.successRate</code> || numeric || <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> || Отношение выполненных шагов, которые не завершились с ошибкой (успешные + пропущенные), ко всем выполненным шагам. Мы учитываем шаги, которые были фактически выполнены, а не шаги, которые планировалось выполнить. Например, при 2 успешных шагах, 1 неудачном шаге и 8 не начатых шагах, отношение составляет 2/3, или 66,67%.
|-
| <code>dt.synthetic.multi_protocol.availability</code> / <code>builtin:synthetic.multiProtocol.availability</code> || numeric || <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> || Доступность рассчитывается на основе статуса выполнения посещений: 100% для кода = 0, HEALTHY, SCRIPT_FINISH - 0 SKIPPED % для кодов ошибок, таких как 1401 - CONSTRAINT_VIOLATED
|-
| <code>dt.synthetic.multi_protocol.executions</code> / <code>builtin:synthetic.multiProtocol.executions</code> || numeric || <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> <code>multi_protocol.result.status</code> <code>multi_protocol.result.status.code</code> || Количество выполнений монитора за определенный период времени
|-
| <code>dt.synthetic.multi_protocol.availability.excluding_maintenance_windows</code> / <code>builtin:synthetic.multiProtocol.availability.excludingMaintenanceWindows</code> || numeric || <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> || Доступность рассчитывается на основе статуса выполнения посещений и отображается только в том случае, если для монитора не определено окно технического обслуживания: 100% для кода = 0, HEALTHY, SCRIPT_FINISH - 0 SKIPPED % для кодов состояния ошибок, таких как 1401 - CONSTRAINT_VIOLATED
|}

=== Показатели шага (все мониторы доступности сети) ===
{| class="wikitable"
|-
! Имя !! Тип !! Размеры !! Описание
|-
| <code>dt.synthetic.multi_protocol.step.execution_time</code> / <code>builtin:synthetic.multiProtocol.step.executionTime</code> || numeric || <code>multi_protocol.request.type</code> <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> <code>multi_protocol.step.id</code> || Продолжительность между началом и концом выполнения шага (в миллисекундах). Эта метрика доступна только в том случае, если выполнение шага состоялось с четко определенным временем окончания; следовательно, она недоступна для пропущенных шагов.
|-
| <code>dt.synthetic.multi_protocol.step.success_rate</code> / <code>builtin:synthetic.multiProtocol.step.successRate</code> || numeric || <code>multi_protocol.request.type</code> <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> <code>multi_protocol.step.id</code> || Отношение количества выполненных запросов, не завершившихся с ошибкой (успешные + пропущенные), ко всем выполненным запросам. Если шаг был пропущен (любым из предшествующих шагов), он не имеет показателя успешности; мы рассматриваем его как невыполненный. Если для шага нет выполненных запросов (потому что его скрипт перед выполнением завершился с ошибкой или выдал ошибку SCRIPT_FINISH), мы возвращаем значение 0% (для неудачных запросов) или 100% (для завершенных). Например, при 2 успешных, 1 неудачном и 4 пропущенных запросах соотношение составляет 6/7, или 85,71%.
|-
| <code>dt.synthetic.multi_protocol.step.availability</code> / <code>builtin:synthetic.multiProtocol.step.availability</code> || numeric || <code>multi_protocol.request.type</code> <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> <code>multi_protocol.step.id</code> || Доступность рассчитывается на основе статуса выполнения шагов: 100% для кода = 0, HEALTHY, SCRIPT_FINISH - 0 SKIPPED % для кодов ошибок, таких как 1401 - CONSTRAINT_VIOLATED
|-
| <code>dt.synthetic.multi_protocol.step.executions</code> / <code>builtin:synthetic.multiProtocol.step.executions</code> || numeric || <code>multi_protocol.request.type</code> <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> <code>multi_protocol.step.id</code> <code>multi_protocol.result.status</code> <code>multi_protocol.result.status.code</code> || Количество выполнений шагов за определенный период времени
|-
| <code>dt.synthetic.multi_protocol.step.availability.excluding_maintenance_windows</code> / <code>builtin:synthetic.multiProtocol.step.availability.excludingMaintenanceWindows</code> || numeric || <code>multi_protocol.request.type</code> <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> <code>multi_protocol.step.id</code> || Доступность рассчитывается на основе статуса выполнения шагов и отображается только в том случае, если для монитора не определено окно обслуживания: 100% для кода = 0, HEALTHY, SCRIPT_FINISH - 0 SKIPPED % для кодов состояния ошибок, таких как 1401 - CONSTRAINT_VIOLATED
|}

=== Запрос метрик (всех мониторов доступности сети) ===
{| class="wikitable"
|-
! Имя !! Тип !! Размеры !! Описание
|-
| <code>dt.synthetic.multi_protocol.request.availability</code> / <code>builtin:synthetic.multiProtocol.request.availability</code> || numeric || <code>multi_protocol.request.type</code> <code>multi_protocol.request.target_address</code> <code>dt.entity.host</code> (только для мониторов с <code>filter</code> определенными характеристиками) <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> <code>multi_protocol.step.id</code> <code>multi_protocol.request.id</code> || Доступность рассчитывается на основе статуса выполнения запросов: 100% для кода = 0, HEALTHY, SCRIPT_FINISH - 0 SKIPPED % для кодов ошибок, таких как 1401 - CONSTRAINT_VIOLATED
|-
| <code>dt.synthetic.multi_protocol.request.executions</code> / <code>builtin:synthetic.multiProtocol.request.executions</code> || numeric || <code>multi_protocol.request.type</code> <code>multi_protocol.request.target_address</code> <code>dt.entity.host</code> (только для мониторов с <code>filter</code> определенными характеристиками) <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> <code>multi_protocol.step.id</code> <code>multi_protocol.request.id</code> <code>multi_protocol.result.status</code> <code>multi_protocol.result.status.code</code> || Количество выполнений запросов за определенный период времени
|-
| <code>dt.synthetic.multi_protocol.request.availability.excluding_maintenance_windows</code> / <code>builtin:synthetic.multiProtocol.request.availability.excludingMaintenanceWindows</code> || numeric || <code>multi_protocol.request.type</code> <code>multi_protocol.request.target_address</code> <code>dt.entity.host</code> (только для мониторов с <code>filter</code> определенными характеристиками) <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> <code>multi_protocol.step.id</code> <code>multi_protocol.request.id</code> || Доступность рассчитывается на основе статуса выполнения запросов и отображается только в том случае, если для монитора не определено окно технического обслуживания: 100% для кода = 0, HEALTHY, SCRIPT_FINISH - 0 SKIPPED % для кодов состояния ошибок, таких как 1401 - CONSTRAINT_VIOLATED
|}

=== Метрики монитора ICMP ===
{| class="wikitable"
|-
! Имя !! Тип !! Размеры !! Описание
|-
| <code>dt.synthetic.multi_protocol.icmp.success_rate</code> / <code>builtin:synthetic.multiProtocol.icmp.successRate</code> || numeric || <code>multi_protocol.request.type</code> <code>multi_protocol.request.target_address</code> <code>dt.entity.host</code> (Только для мониторов с заданным фильтром) <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> <code>multi_protocol.step.id</code> <code>multi_protocol.request.id</code> || Соотношение полученных и отправленных пакетов не учитывает заданное количество отправляемых пакетов. Например, если из 10 отправляемых пакетов 5 были отправлены, а 4 получены, то соотношение составляет 4/5, или 80,00%.
|-
| <code>dt.synthetic.multi_protocol.icmp.packets_sent</code> / <code>builtin:synthetic.multiProtocol.icmp.packetsSent</code> || numeric || <code>multi_protocol.request.type</code> <code>multi_protocol.request.target_address</code> <code>dt.entity.host</code> (Только для мониторов с заданным фильтром) <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> <code>multi_protocol.step.id</code> <code>multi_protocol.request.id</code> || Общее количество отправленных пакетов
|-
| <code>dt.synthetic.multi_protocol.icmp.packets_received</code> / <code>builtin:synthetic.multiProtocol.icmp.packetsReceived</code> || numeric || <code>multi_protocol.request.type</code> <code>multi_protocol.request.target_address</code> <code>dt.entity.host</code> (Только для мониторов с заданным фильтром) <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> <code>multi_protocol.step.id</code> <code>multi_protocol.request.id</code> || Количество успешно возвращенных пакетов.
|-
| <code>dt.synthetic.multi_protocol.icmp.average_round_trip_time</code> / <code>builtin:synthetic.multiProtocol.icmp.averageRoundTripTime</code> || numeric || <code>multi_protocol.request.type</code> <code>multi_protocol.request.target_address</code> <code>dt.entity.host</code> (Только для мониторов с заданным фильтром) <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> <code>multi_protocol.step.id</code> <code>multi_protocol.request.id</code> || Среднее время кругового пути (RTT)
|-
| <code>dt.synthetic.multi_protocol.icmp.min_round_trip_time</code> / <code>builtin:synthetic.multiProtocol.icmp.minRoundTripTime</code> || numeric || <code>multi_protocol.request.type</code> <code>multi_protocol.request.target_address</code> <code>dt.entity.host</code> (Только для мониторов с заданным фильтром) <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> <code>multi_protocol.step.id</code> <code>multi_protocol.request.id</code> || Минимальное время кругового обхода (RTT)
|-
| <code>dt.synthetic.multi_protocol.icmp.max_round_trip_time</code> / <code>builtin:synthetic.multiProtocol.icmp.maxRoundTripTime</code> || numeric || <code>multi_protocol.request.type</code> <code>multi_protocol.request.target_address</code> <code>dt.entity.host</code> (Только для мониторов с заданным фильтром) <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> <code>multi_protocol.step.id</code> <code>multi_protocol.request.id</code> || Максимальное время кругового обхода (RTT)
|-
| <code>dt.synthetic.multi_protocol.icmp.request_execution_time</code> / <code>builtin:synthetic.multiProtocol.icmp.requestExecutionTime</code> || numeric || <code>multi_protocol.request.type</code> <code>multi_protocol.request.target_address</code> <code>dt.entity.host</code> (Только для мониторов с заданным фильтром) <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> <code>multi_protocol.step.id</code> <code>multi_protocol.request.id</code> || Продолжительность между началом и окончанием обработки запроса (в миллисекундах). Этот показатель всегда предоставляется, даже если фактическое выполнение запроса не состоялось (например, из-за исключений или тайм-аутов). Диагностический показатель — позволяет проверить время выполнения внешнего процесса ping.
|}

=== Размеры монитора TCP ===
{| class="wikitable"
|-
! Имя !! Тип !! Описание !! Пример значения
|-
| <code>multi_protocol.request.tcp_port_number</code> || string || Номер порта для TCP-запросов, указанный в конфигурации монитора. || <code>665</code>
|}

=== метрики монитора TCP ===
{| class="wikitable"
|-
! Имя !! Тип !! Размеры !! Описание
|-
| <code>dt.synthetic.multi_protocol.tcp.connection_time</code> / <code>builtin:synthetic.multiProtocol.tcp.connectionTime</code> || numeric || <code>multi_protocol.request.type</code> <code>multi_protocol.request.target_address</code> <code>dt.entity.host</code> (Только для мониторов с заданным фильтром) <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> <code>multi_protocol.step.id</code> <code>multi_protocol.request.id</code> <code>multi_protocol.request.tcp_port_number</code> || Продолжительность между временем начала (создание и подключение сокета) и временем окончания (успешное установление соединения) в миллисекундах. Метрика доступна только в том случае, если запрос был выполнен (без исключений или тайм-аутов) с четко определенным временем окончания.
|}

=== Размеры монитора DNS ===
{| class="wikitable"
|-
! Имя !! Тип !! Описание !! Пример значения
|-
| <code>multi_protocol.request.dns_record_type</code> || string || Тип DNS-записи, запрашиваемой в запросе, указан в конфигурации. || <code>A</code>, <code>AAAA</code>, <code>CNAME</code>
|}

=== метрики монитора DNS ===
{| class="wikitable"
|-
! Имя !! Тип !! Размеры !! Описание
|-
| <code>dt.synthetic.multi_protocol.dns.resolution_time</code> / <code>builtin:synthetic.multiProtocol.dns.resolutionTime</code> || numeric || <code>multi_protocol.request.type</code> <code>multi_protocol.request.target_address</code> <code>dt.entity.host</code> (Только для мониторов с заданным фильтром) <code>dt.entity.synthetic_location</code> <code>dt.entity.multiprotocol_monitor</code> <code>multi_protocol.step.id</code> <code>multi_protocol.request.id</code> || Длительность между началом и окончанием запроса к DNS-серверу в миллисекундах. Метрика доступна только в том случае, если запрос был выполнен (без исключений или тайм-аутов) с четко определенным временем окончания.
|}

== Статусы выполнения ==

=== Все мониторы доступности сети ===
{| class="wikitable"
|-
! Код / сообщение !! Пример !! Описание
|-
| 0 HEALTHY || - || Все хорошо.
|-
| -1 UNEXPECTED_ERROR || Насыщение ресурсами || Неожиданная проблема, обычно связанная с компонентами выполнения монитора.
|-
| 1401 CONSTRAINT_VIOLATED || - || Ограничения, заданные в конфигурации монитора, не были соблюдены.
|-
| 1604 VALIDATION_ERROR || - || Обнаружена некорректная конфигурация монитора.
|-
| 12013 UNKNOWN_HOST || Ошибка в имени хоста. || Не удается определить IP-адрес хоста. Причиной этой ошибки может быть несколько факторов: - Недопустимое имя хоста - Недоступен DNS-сервер - Проблемы с DNS-кэшем - Помехи от брандмауэра или прокси-сервера
|-
| 12033 Execution timeout || Сервер работает медленно. || Превышение времени ожидания выполнения запроса — эта ошибка может быть вызвана несколькими причинами: — Проблемы с сетью; — Медленная работа или не отвечающий сервер или служба; — Блокировка соединения правилами брандмауэра; — Слишком малое значение времени ожидания.
|}

=== статусы выполнения монитора TCP ===
{| class="wikitable"
|-
! Код / сообщение !! Пример !! Описание
|-
| 22000 TCP socket connection error || Сервис не прослушивает указанный порт. || Этот статус означает, что хост был идентифицирован и доступен, но TCP-соединение не удалось установить или оно было неожиданно закрыто. Дополнительное пояснение к точному исключению приведено ниже. Этот статус используется, если исключение <code>java.net.SocketException</code> возникает во время попытки подключения. Причиной этой ошибки может быть несколько проблем: - Служба не прослушивает указанный порт; - Служба достигла предела ресурсов или соединений; - Служба стала недоступна в процессе установления сокетного соединения.
|}

== Примеры DQL-запросов для извлечения данных ==
В этих примерах используются блокноты Тетради и демонстрируется, как работать с результатами мониторинга доступности сети. В качестве отправной точки для изучения возможностей извлечения и интерпретации данных с помощью '''DQL''' используются метрики результатов.

=== Статус хост-сущности для запросов ICMP ===
Монитор <code>MULTIPROTOCOL_MONITOR-5C2F92334DF71A90</code> выполняет '''ICMP'''-запросы и фильтрует отслеживаемые хосты по метрике <code>"targetFilter": "hostGroup == e2e-synthetic-private-location"</code> (что составляет примерно 26 хостов). Используя метрику <code>dt.synthetic.multi_protocol.request.executions</code> и разделяя её по параметрам <code>dt.entity.host</code> и <code>multi_protocol.result.status</code>, мы можем отобразить статус соединения с конкретным отслеживаемым хостом в этой группе хостов. Некоторые хосты не соответствуют ожидаемому уровню успешности; вместо того, чтобы быть <code>HEALTHY</code> помеченными как, их запросы помечаются как <code>CONSTRAINT_VIOLATED</code>.

<pre>
Статус временного ряда = avg(dt.synthetic.multi_protocol.request.executions),
by: {dt.entity.host, multi_protocol.result.status},
filter: dt.entity.multiprotocol_monitor == "MULTIPROTOCOL_MONITOR-5C2F92334DF71A90"
</pre>

=== Количество отправленных и полученных ICMP-пакетов ===
Монитор <code>MULTIPROTOCOL_MONITOR-548C3CD54183CED9</code> отправляет '''ICMP'''-запросы хостам с явно определенными IP-адресами, <code>18.x.x.x</code>, <code>10.x.x.x</code> и <code>34.x.x.x</code>. Каждый из этих IP-адресов соответствует отдельному хосту. Мы используем сумму <code>dt.synthetic.multi_protocol.icmp.packets_sent</code> и сумму метрик <code>dt.synthetic.multi_protocol.icmp.packets_received</code>, чтобы получить представление о количестве отправленных и полученных пакетов. Мы разделяем результаты по измерению <code>multi_protocol.request.target_address</code> и фильтруем данные только для <code>18.x.x.x</code> и <code>10.x.x.x</code>. Для <code>18.x.x.x</code> было получено такое же количество пакетов, как и было отправлено, но для <code>10.x.x.x</code> все пакеты теряются, и ни один не был получен.

<pre>
временные ряды {
  packets_sent = sum(dt.synthetic.multi_protocol.icmp.packets_sent),
  packets_received = sum(dt.synthetic.multi_protocol.icmp.packets_received)
},
Автор: {multi_protocol.request.target_address},
filter: dt.entity.multiprotocol_monitor == "MULTIPROTOCOL_MONITOR-548C3CD54183CED9"
    И (
        multi_protocol.request.target_address == "18.xxx"
        ИЛИ multi_protocol.request.target_address == "10.xxx"
    )
</pre>

=== Целевой статус для TCP-запросов ===
Монитор <code>MULTIPROTOCOL_MONITOR-74E68F22FF5E9227</code> выполняет '''TCP'''-запросы к хостам из группы хостов, которая разрешается в IP-адреса <code>18.x.x.x</code>, <code>34.x.x.x</code>, и <code>44.x.x.x</code>. Используя метрику <code>dt.synthetic.multi_protocol.request.executions</code> и разделяя ее по измерениям <code>multi_protocol.request.target_address</code>, <code>multi_protocol.request.tcp_port_number</code>, и <code>multi_protocol.result.status</code>, мы можем отобразить состояние '''TCP'''-соединения для пары IP-адрес-порт. У каждого хоста открыты порты <code>22</code> (SSH) и <code>8080</code> (HTTP-сервер), и каждое соединение с хостами на этих портах завершается успешно со статусом <code>HEALTHY</code>. Ни одна служба не использует стандартный HTTP-порт <code>80</code>. Поэтому соединения со всеми хостами на этом порту завершаются с ошибкой со статусом <code>TCP socket connection error</code>. Обратите внимание, что результаты этого запроса можно ограничить только успешными запросами, отфильтровав по измерению <code>multi_protocol.result.status.code</code> (<code>code == 0</code>).

<pre>
статус временного ряда = сумма(dt.synthetic.multi_protocol.request.executions),
by: {multi_protocol.request.target_address, multi_protocol.request.tcp_port_number, multi_protocol.result.status},
filter: dt.entity.multiprotocol_monitor == "MULTIPROTOCOL_MONITOR-74E68F22FF5E9227"
// и multi_protocol.result.status.code == 0
</pre>

=== Время установления TCP-соединения с целевым портом ===
Монитор <code>MULTIPROTOCOL_MONITOR-74E68F22FF5E9227</code> выполняет '''TCP'''-запросы к хостам из группы хостов, которые разрешаются в IP-адреса <code>18.x.x.x</code>, <code>34.x.x.x</code>, и <code>44.x.x.x</code>. В этом примере вместо IP-адресов мы разделяем результаты по идентификаторам отслеживаемых хостов. Мы используем среднее значение метрики <code>dt.synthetic.multi_protocol.tcp.connection_time</code>, разделенной по измерениям <code>dt.entity.host</code>, <code>multi_protocol.request.target_address</code>, и <code>multi_protocol.request.tcp_port_number</code>, чтобы проверить типичное время, необходимое для успешного подключения к целевому порту для хоста. Открыты только порты <code>22</code> (SSH) и <code>8080</code> (HTTP-сервер), и это единственные порты, для которых доступен <code>dt.synthetic.multi_protocol.tcp.connection_time</code>. Хосты фактически находятся в разных географических местах (Огайо, Орегон и Северная Вирджиния в США), поэтому разница во времени подключения ожидаема.

<pre>
длительность временного ряда = avg(dt.synthetic.multi_protocol.tcp.connection_time),
by: {dt.entity.host, multi_protocol.request.target_address, multi_protocol.request.tcp_port_number},
filter: dt.entity.multiprotocol_monitor == "MULTIPROTOCOL_MONITOR-74E68F22FF5E9227"
</pre>