Обнаружение аномалий хоста API - GET конфигурация

Материал из Документация Ключ-АСТРОМ
Версия от 14:53, 28 октября 2022; ENetrebin (обсуждение | вклад)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)

Получает конфигурацию обнаружения аномалий для хостов.

Запрос создает в качестве полезной нагрузки application/json формат.

GET Managed https://{your-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/hosts
Среда АктивногоШлюза https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/anomalyDetection/hosts

Аутентификация

Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Чтение конфигурации ( ReadConfig) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .

Параметры

Запрос не предоставляет никаких настраиваемых параметров.

Ответ

Коды ответов

Код Тип Описание
200 HostsAnomalyDetectionConfig Успех

Объекты тела ответа

Объект HostsAnomalyDetectionConfig

Настройка обнаружения аномалий для хостов.

Элемент Тип Описание
metadata ConfigurationMetadata Метаданные, полезные для отладки
connectionLostDetection ConnectionLostDetectionConfig Настройка обнаружения потерянного соединения.
highCpuSaturationDetection HighCpuSaturationDetectionConfig Конфигурация обнаружения высокой загрузки ЦП
highMemoryDetection HighMemoryDetectionConfig Конфигурация обнаружения высокого использования памяти.
highGcActivityDetection HighGcActivityDetectionConfig Настройка обнаружения высокой активности сборщика мусора.
outOfMemoryDetection OutOfMemoryDetectionConfig Конфигурация Java для обнаружения проблем с нехваткой памяти.
outOfThreadsDetection OutOfThreadsDetectionConfig Конфигурация обнаружения проблем Java вне потоков.
networkDroppedPacketsDetection NetworkDroppedPacketsDetectionConfig Настройка обнаружения большого количества отброшенных пакетов.
networkErrorsDetection NetworkErrorsDetectionConfig Настройка обнаружения большого количества сетевых ошибок.
highNetworkDetection HighNetworkDetectionConfig Конфигурация обнаружения высокой загрузки сети.
networkTcpProblemsDetection NetworkTcpProblemsDetectionConfig Настройка обнаружения проблем с подключением TCP.
networkHighRetransmissionDetection NetworkHighRetransmissionDetectionConfig Конфигурация обнаружения высокой скорости повторной передачи.
diskLowSpaceDetection DiskLowSpaceDetectionConfig Настройка обнаружения нехватки места на диске.
diskSlowWritesAndReadsDetection DiskSlowWritesAndReadsDetectionConfig Настройка обнаружения медленно работающих дисков.
diskLowInodesDetection DiskLowInodesDetectionConfig Конфигурация обнаружения низкого количества инодов на диске.

Объект ConfigurationMetadata

Метаданные, полезные для отладки

Элемент Тип Описание
configurationVersions integer[] Отсортированный список номеров версий конфигурации.
currentConfigurationVersions string[] Отсортированный список номеров версий конфигурации.
clusterVersion string Версия Ключ-АСТРОМ.

Объект ConnectionLostDetectionConfig

Настройка обнаружения потерянного соединения.

Элемент Тип Описание
enabled boolean Обнаружение включено ( true) или отключено ( false).
EnabledOnGracefulShutdowns boolean Оповещение ( true) о корректном завершении работы хоста.

Объект HighCpuSaturationDetectionConfig

Конфигурация обнаружения высокой загрузки ЦП

Элемент Тип Описание
enabled boolean Обнаружение включено ( true) или отключено ( false).
customThresholds HighCpuSaturationThresholds Пользовательские пороги для высокой загрузки ЦП. Если не установлено, то используется автоматический режим.

Объект HighCpuSaturationThresholds

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

Элемент Тип Описание
cpuSaturation integer Предупреждает, если загрузка ЦП превышает X % в 3 из 5 выборок.

Объект HighMemoryDetectionConfig

Конфигурация обнаружения высокого использования памяти.

Элемент Тип Описание
enabled boolean Обнаружение включено ( true) или отключено ( false).
customThresholds HighMemoryThresholds Пользовательские пороги для высокого использования памяти. Если не установлено, то используется автоматический режим.

Оба условия должны быть выполнены для срабатывания предупреждения.

Объект HighMemoryThresholds

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

Оба условия должны быть выполнены для срабатывания предупреждения.

Элемент Тип Описание
pageFaultsPerSecondWindows integer Частота ошибок страницы памяти выше, чем X ошибок в секунду в Windows.
usedMemoryPercentageWindows integer Использование памяти выше, чем X % в Windows.
pageFaultsPerSecondNonWindows integer Частота ошибок страницы памяти выше, чем X ошибок в секунду в Linux.
usedMemoryPercentageNonWindows integer Использование памяти выше, чем X % в Linux.

Объект HighGcActivityDetectionConfig

Настройка обнаружения высокой активности сборщика мусора.

Элемент Тип Описание
enabled boolean Обнаружение включено ( true) или отключено ( false).
customThresholds HighGcActivityThresholds Пользовательские пороги для высокой активности GC. Если не установлено, используется автоматический режим.

Выполнение любого из этих условий приводит к срабатыванию предупреждения.

Объект HighGcActivityThresholds

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

Выполнение любого из этих условий приводит к срабатыванию предупреждения.

Элемент Тип Описание
gcTimePercentage integer Время GC превышает X % в 3 из 5 образцов.
gcSuspensionPercentage integer Взвесь GC выше, чем X % в 3 из 5 образцов.

Объект OutOfMemoryDetectionConfig

Конфигурация Java для обнаружения проблем с нехваткой памяти.

Элемент Тип Описание
enabled boolean Обнаружение включено ( true) или отключено ( false).
customThresholds OutOfMemoryThresholds Пользовательские пороги для Java из памяти. Если не установлено, используется автоматический режим.

Объект OutOfMemoryThresholds

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

Элемент Тип Описание
outOfMemoryExceptionsNumber integer Предупреждать, если количество исключений Java из-за нехватки памяти составляет X в минуту или выше.

Объект OutOfThreadsDetectionConfig

Конфигурация обнаружения проблем Java вне потоков.

Элемент Тип Описание
enabled boolean Обнаружение включено ( true) или отключено ( false).
customThresholds OutOfThreadsThresholds Пользовательские пороги для обнаружения Java вне потоков. Если не установлено, используется автоматический режим.

Объект OutOfThreadsThresholds

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

Элемент Тип Описание
outOfThreadsExceptionsNumber integer Предупреждать, если количество исключений Java out of threads равно X в минуту или выше.

Объект NetworkDroppedPacketsDetectionConfig

Настройка обнаружения большого количества отброшенных пакетов.

Элемент Тип Описание
enabled boolean Обнаружение включено ( true) или отключено ( false).
customThresholds NetworkDroppedPacketsThresholds Пользовательские пороги для отброшенных пакетов. Если не установлено, используется автоматический режим.

Все эти условия должны быть соблюдены для срабатывания оповещения.

Объект NetworkDroppedPacketsThresholds

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

Все эти условия должны быть соблюдены для срабатывания оповещения.

Элемент Тип Описание
dropPacketsPercentage integer Процент потерянных пакетов при приеме/передаче превышает X % в 3 из 5 образцов.
TotalPacketsRate integer Суммарная скорость приема/передачи пакетов превышает X пакетов в секунду в 3 из 5 выборок.

Объект NetworkErrorsDetectionConfig

Настройка обнаружения большого количества сетевых ошибок.

Элемент Тип Описание
enabled boolean Обнаружение включено ( true) или отключено ( false).
customThresholds NetworkErrorsThresholds Пользовательские пороги для сетевых ошибок. Если не установлено, используется автоматический режим.

Все эти условия должны быть соблюдены для срабатывания оповещения.

Объект NetworkErrorsThresholds

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

Все эти условия должны быть соблюдены для срабатывания оповещения.

Элемент Тип Описание
errorsPercentage integer Процент пакетов с ошибками приема/передачи превышает X % в 3 из 5 выборок.
TotalPacketsRate integer Суммарная скорость приема/передачи пакетов превышает X пакетов в секунду в 3 из 5 выборок.

Объект HighNetworkDetectionConfig

Конфигурация обнаружения высокой загрузки сети.

Элемент Тип Описание
enabled boolean Обнаружение включено ( true) или отключено ( false).
customThresholds HighNetworkThresholds Пользовательские пороги для высокой загрузки сети. Если не установлено, используется автоматический режим.

Объект HighNetworkThresholds

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

Элемент Тип Описание
utilizationPercentage integer Оповещение, если использование отправленного/полученного трафика превышает X % в 3 из 5 выборок.

Объект NetworkTcpProblemsDetectionConfig

Настройка обнаружения проблем с подключением TCP.

Элемент Тип Описание
enabled boolean Обнаружение включено ( true) или отключено ( false).
customThresholds NetworkTcpProblemsThresholds Пользовательские пороги для проблем с TCP-соединением. Если не установлено, используется автоматический режим.

Все эти условия должны быть соблюдены для срабатывания оповещения.

Объект NetworkTcpProblemsThresholds

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

Все эти условия должны быть соблюдены для срабатывания оповещения.

Элемент Тип Описание
newConnectionFailuresPercentage integer Процент новых сбоев соединения превышает X % в 3 из 5 выборок.
failedConnectionsNumberPerMinute integer Количество неудачных подключений превышает X подключений в минуту в 3 из 5 образцов.

Объект _ NetworkHighRetransmissionDetectionConfig

Конфигурация обнаружения высокой скорости повторной передачи.

Элемент Тип Описание
enabled boolean Обнаружение включено ( true) или отключено ( false).
customThresholds NetworkHighRetransmissionThresholds Пользовательские пороги для высокой скорости повторной передачи. Если не установлено, используется автоматический режим.

Все эти условия должны быть соблюдены для срабатывания оповещения.

Объект NetworkHighRetransmissionThresholds

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

Все эти условия должны быть соблюдены для срабатывания оповещения.

Элемент Тип Описание
retransmissionRatePercentage integer Скорость повторной передачи выше, чем X % в 3 из 5 образцов.
retransmittedPacketsNumberPerMinute integer Количество повторно переданных пакетов превышает X пакетов в минуту в 3 из 5 выборок.

Объект DiskLowSpaceDetectionConfig

Настройка обнаружения нехватки места на диске.

Элемент Тип Описание
enabled boolean Обнаружение включено ( true) или отключено ( false).
customThresholds DiskLowSpaceThresholds Пользовательские пороги для нехватки места на диске. Если не установлено, используется автоматический режим.

Объект DiskLowSpaceThresholds

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

Элемент Тип Описание
freeSpacePercentage integer Предупреждает, если свободное место на диске меньше X % в 3 из 5 образцов.

Объект DiskSlowWritesAndReadsDetectionConfig

Настройка обнаружения медленно работающих дисков.

Элемент Тип Описание
enabled boolean Обнаружение включено ( true) или отключено ( false).
customThresholds DiskSlowWriteAndReadsThresholds Пользовательские пороги для медленных дисков. Если не установлено, используется автоматический режим.

Объект DiskSlowWriteAndReadsThresholds

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

Элемент Тип Описание
writeAndReadTime integer Предупреждает, если время чтения/записи диска превышает X миллисекунд в 3 из 5 выборок.

Объект DiskLowInodesDetectionConfig

Конфигурация обнаружения низкого количества инодов на диске.

Элемент Тип Описание
enabled boolean Обнаружение включено ( true) или отключено ( false).
customThresholds DiskLowInodesThresholds Пользовательские пороги для низкого количества инодов на диске. Если не установлено, используется автоматический режим.

Объект DiskLowInodesThresholds

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

Элемент Тип Описание
freeInodesPercentage integer Оповещает, если процент доступных инодов ниже X % в 3 из 5 выборок.

JSON-модель тела ответа

{
  "metadata": {
    "configurationVersions": [
      4,
      2
    ],
    "clusterVersion": "Mock version"
  },
  "connectionLostDetection": {
    "enabled": true,
    "enabledOnGracefulShutdowns": true
  },
  "highCpuSaturationDetection": {
    "enabled": true,
    "customThresholds": {
      "cpuSaturation": 90
    }
  },
  "highMemoryDetection": {
    "enabled": true,
    "customThresholds": {
      "pageFaultsPerSecondWindows": 50,
      "usedMemoryPercentageWindows": 85,
      "pageFaultsPerSecondNonWindows": 10,
      "usedMemoryPercentageNonWindows": 85
    }
  },
  "highGcActivityDetection": {
    "enabled": true,
    "customThresholds": {
      "gcTimePercentage": 35,
      "gcSuspensionPercentage": 20
    }
  },
  "outOfMemoryDetection": {
    "enabled": true,
    "customThresholds": {
      "outOfMemoryExceptionsNumber": 2
    }
  },
  "outOfThreadsDetection": {
    "enabled": true,
    "customThresholds": {
      "outOfThreadsExceptionsNumber": 2
    }
  },
  "networkDroppedPacketsDetection": {
    "enabled": true,
    "customThresholds": {
      "droppedPacketsPercentage": 8,
      "totalPacketsRate": 8
    }
  },
  "networkErrorsDetection": {
    "enabled": true,
    "customThresholds": {
      "errorsPercentage": 9,
      "totalPacketsRate": 9
    }
  },
  "highNetworkDetection": {
    "enabled": true,
    "customThresholds": {
      "utilizationPercentage": 88
    }
  },
  "networkTcpProblemsDetection": {
    "enabled": true,
    "customThresholds": {
      "newConnectionFailuresPercentage": 5,
      "failedConnectionsNumberPerMinute": 5
    }
  },
  "networkHighRetransmissionDetection": {
    "enabled": true,
    "customThresholds": {
      "retransmissionRatePercentage": 15,
      "retransmittedPacketsNumberPerMinute": 15
    }
  },
  "diskLowSpaceDetection": {
    "enabled": true,
    "customThresholds": {
      "freeSpacePercentage": 10
    }
  },
  "diskSlowWritesAndReadsDetection": {
    "enabled": true,
    "customThresholds": {
      "writeAndReadTime": 300
    }
  },
  "diskLowInodesDetection": {
    "enabled": true,
    "customThresholds": {
      "freeInodesPercentage": 10
    }
  }
}

Пример

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

Маркер API передается в заголовке авторизации .

Конфигурация имеет следующие настройки:

Host1.png

Curl

curl -X GET \
  https://mySampleEnv.live.ruscomtech.ru/api/config/v1/anomalyDetection/hosts \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

URL-адрес запроса

https://mySampleEnv.live.ruscomtech.ru/api/config/v1/anomalyDetection/hosts

Тело ответа

{
  "metadata": {
    "clusterVersion": "1.163.5.20190201-130834",
    "configurationVersions": [
      91
    ]
  },
  "connectionLostDetection": {
    "enabled": true,
    "enabledOnGracefulShutdowns": false
  },
  "highCpuSaturationDetection": {
    "enabled": true
  },
  "highMemoryDetection": {
    "enabled": true
  },
  "highGcActivityDetection": {
    "enabled": true
  },
  "outOfMemoryDetection": {
    "enabled": true
  },
  "outOfThreadsDetection": {
    "enabled": true
  },
  "networkDroppedPacketsDetection": {
    "enabled": true
  },
  "networkErrorsDetection": {
    "enabled": true
  },
  "highNetworkDetection": {
    "enabled": true
  },
  "networkTcpProblemsDetection": {
    "enabled": true
  },
  "networkHighRetransmissionDetection": {
    "enabled": true
  },
  "diskLowSpaceDetection": {
    "enabled": true
  },
  "diskSlowWritesAndReadsDetection": {
    "enabled": true
  },
  "diskLowInodesDetection": {
    "enabled": true
  }
}

Код ответа

200