ЕдиныйАгент на хосте: различия между версиями

Материал из Документация Ключ-АСТРОМ
Строка 693: Строка 693:
|entityId
|entityId
|string
|string
|Идентификатор объекта Dynatrace требуемого объекта.
|Идентификатор объекта Ключ-АСТРОМ требуемого объекта.
|-
|-
|displayName
|displayName
|string
|string
|Имя объекта Dynatrace, отображаемое в пользовательском интерфейсе.
|Имя объекта Ключ-АСТРОМ, отображаемое в пользовательском интерфейсе.
|-
|-
|customizedName
|customizedName
Строка 854: Строка 854:
|autoInjection
|autoInjection
|string
|string
|Статус автоинъекции
|Статус автоинжектирования


Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 1066: Строка 1066:
|oneAgentCustomHostName
|oneAgentCustomHostName
|string
|string
|Пользовательское имя, указанное в конфигурации OneAgent.
|Пользовательское имя, указанное в конфигурации ЕдиногоАгента.
|-
|-
|userLevel
|userLevel
Строка 1142: Строка 1142:
|}
|}


==== Объект _ <code>TagInfo</code> ====
==== Объект <code>TagInfo</code> ====
Тег сущности Dynatrace.
Тег сущности Ключ-АСТРОМ.
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент
Строка 1149: Строка 1149:
!Описание
!Описание
|-
|-
|контекст
|context
|нить
|string
|Происхождение тега, например AWS или Cloud Foundry.
|Происхождение тега, например AWS или Cloud Foundry.


Строка 1166: Строка 1166:
* <code>KUBERNETES</code>
* <code>KUBERNETES</code>
|-
|-
|ключ
|key
|нить
|string
|Ключ тега.
|Ключ тега.


Пользовательские теги имеют значение тега здесь.
Пользовательские теги имеют значение тега здесь.
|-
|-
|ценность
|value
|нить
|string
|Значение тега.
|Значение тега.


Строка 1179: Строка 1179:
|}
|}


==== Объект _ <code>EntityShortRepresentation</code> ====
==== Объект <code>EntityShortRepresentation</code> ====
Краткое представление объекта Dynatrace.
Краткое представление объекта Ключ-АСТРОМ.
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент
Строка 1186: Строка 1186:
!Описание
!Описание
|-
|-
|я бы
|id
|нить
|string
|Идентификатор объекта Dynatrace.
|Идентификатор объекта Ключ-АСТРОМ.
|-
|-
|имя
|name
|нить
|string
|Имя объекта Dynatrace.
|Имя объекта Ключ-АСТРОМ.
|-
|-
|описание
|description
|нить
|string
|Краткое описание сущности Dynatrace.
|Краткое описание сущности Ключ-АСТРОМ.
|}
|}


==== Объект _ <code>AgentVersion</code> ====
==== Объект <code>AgentVersion</code> ====
Определяет версию агента, работающего в данный момент на объекте.
Определяет версию агента, работающего в данный момент на объекте.
{| class="wikitable"
{| class="wikitable"
Строка 1206: Строка 1206:
!Описание
!Описание
|-
|-
|главный
|major
|целое число
|integer
|Номер основной версии.
|Номер основной версии.
|-
|-
|незначительный
|minor
|целое число
|integer
|Младший номер версии.
|Младший номер версии.
|-
|-
|ревизия
|revision
|целое число
|integer
|Номер ревизии.
|Номер ревизии.
|-
|-
|отметка времени
|timestamp
|нить
|string
|Строка временной метки: формат "ггггммдд-ччммсс
|Строка временной метки: формат "ггггммдд-ччммсс
|-
|-
|Исходная версия
|sourceRevision
|нить
|string
|Строковое представление номера версии SVN.
|Строковое представление номера версии SVN.
|}
|}


==== Объект _ <code>HostGroup</code> ====
==== Объект <code>HostGroup</code> ====
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент
Строка 1234: Строка 1234:
|-
|-
|meId
|meId
|нить
|string
|Идентификатор объекта Dynatrace группы хостов.
|Идентификатор объекта Ключ-АСТРОМ группы хостов.
|-
|-
|имя
|name
|нить
|string
|Имя объекта Dynatrace, отображаемое в пользовательском интерфейсе.
|Имя объекта Ключ-АСТРОМ, отображаемое в пользовательском интерфейсе.
|}
|}


==== Объект _ <code>TechnologyInfo</code> ====
==== Объект <code>TechnologyInfo</code> ====
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент
Строка 1248: Строка 1248:
!Описание
!Описание
|-
|-
|тип
|type
|нить
|string
| -
| -
|-
|-
|версия
|edition
|нить
|string
| -
| -
|-
|-
|версия
|version
|нить
|string
| -
| -
|}
|}


==== Объект _ <code>ModuleInfo</code> ====
==== Объект <code>ModuleInfo</code> ====
Модуль кода OneAgent.
Модуль кода ЕдиныйАгент.
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент
Строка 1268: Строка 1268:
!Описание
!Описание
|-
|-
|тип модуля
|moduleType
|нить
|string
|Тип модуля кода.
|Тип модуля кода.


Строка 1296: Строка 1296:
* <code>Z_OS</code>
* <code>Z_OS</code>
|-
|-
|экземпляры
|instances
|Экземпляр модуля []
|ModuleInstance[]
|Список экземпляров модуля кода.
|Список экземпляров модуля кода.
|}
|}


==== Объект _ <code>ModuleInstance</code> ====
==== Объект <code>ModuleInstance</code> ====
Экземпляр модуля кода OneAgent.
Экземпляр модуля кода ЕдиногоАгента.
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент
Строка 1308: Строка 1308:
!Описание
!Описание
|-
|-
|имя_экземпляра
|instanceName
|нить
|string
|Имя экземпляра.
|Имя экземпляра.
|-
|-
|модульВерсия
|moduleVersion
|нить
|string
|Версия модуля кода.
|Версия модуля кода.
|-
|-
|ошибочная версия
|faultyVersion
|логический
|boolean
|Версия кодового модуля ошибочна ( <code>true</code>) или нет ( <code>false</code>).
|Версия кодового модуля ошибочна ( <code>true</code>) или нет ( <code>false</code>).
|-
|-
|активный
|active
|логический
|boolean
|Экземпляр модуля кода активен ( <code>true</code>) или неактивен ( <code>false</code>).
|Экземпляр модуля кода активен ( <code>true</code>) или неактивен ( <code>false</code>).
|}
|}


==== Объект _ <code>PluginInfo</code> ====
==== Объект <code>PluginInfo</code> ====
Плагин OneAgent.
Плагин ЕдиногоАгента.
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент
Строка 1332: Строка 1332:
!Описание
!Описание
|-
|-
|имя_плагина
|pluginName
|нить
|string
|Название плагина.
|Название плагина.
|-
|-
|экземпляры
|instances
|Экземпляр плагина []
|PluginInstance[]
|Список экземпляров плагина.
|Список экземпляров плагина.
|}
|}


==== Объект _ <code>PluginInstance</code> ====
==== Объект <code>PluginInstance</code> ====
Экземпляр подключаемого модуля OneAgent.
Экземпляр подключаемого модуля ЕдиногоАгента.
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент
Строка 1348: Строка 1348:
!Описание
!Описание
|-
|-
|версия плагина
|pluginVersion
|нить
|string
|Версия плагина.
|Версия плагина.
|-
|-
|государство
|state
|нить
|string
|Состояние экземпляра плагина.
|Состояние экземпляра плагина.
|}
|}
Строка 1399: Строка 1399:
           {
           {
             "id": "6a98d7bc-abb9-44f8-ae6a-73e68e71812a",
             "id": "6a98d7bc-abb9-44f8-ae6a-73e68e71812a",
             "name": "Dynatrace entity",
             "name": "Astromkey entity",
             "description": "Dynatrace entity for the REST API example"
             "description": "Astromkey entity for the REST API example"
           }
           }
         ],
         ],

Версия 11:40, 11 октября 2022

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

Запрос создает application/jsonполезную нагрузку.

GET Managed https://{your-domain}/e/{your-environment-id}/api/v1/oneagents
Среда ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/v1/oneagents

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

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

Параметры

Параметр Тип Описание In Необходимый
includeDetails boolean Включает ( true) или исключает ( false) детали, которые запрашиваются у связанных объектов.

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

Если не установлено, то trueиспользуется.

query по желанию
startTimestamp integer Метка времени начала запрошенного таймфрейма в миллисекундах (UTC).

Если не задано, используется отставание на 72 часа.

query по желанию
endTimestamp integer Отметка времени окончания запрошенного таймфрейма в миллисекундах (UTC).

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

Срок не должен превышать 7 месяцев (214 дней).

query по желанию
relativeTime string Относительный период времени, начиная с настоящего времени.

Если вам нужно указать относительный период времени, который не представлен в списке возможных значений, укажите startTimestamp (до 214 дней назад) и оставьте endTimestamp и relativeTime пустыми.

Элемент может содержать эти значения

  • 10mins
  • 15mins
  • 2hours
  • 30mins
  • 3days
  • 5mins
  • 6hours
  • day
  • hour
  • min
  • month
  • week
 query по желанию
tag string [] Фильтрует результирующий набор хостов по указанному тегу. Вы можете указать несколько тегов в следующем формате: tag=tag1&tag=tag2. Хост должен соответствовать всем указанным тегам.

В случае тегов «ключ-значение», таких как импортированные теги AWS или CloudFoundry, используйте следующий формат: tag=[context]key:value. Для пользовательских тегов "ключ-значение" не указывайте контекст: tag=key:value.

query по желанию
entity string [] Фильтры приводят только к указанным хостам.

Для указания нескольких хостов используйте следующий формат: entity=ID1&entity=ID2.

query по желанию
managementZoneId integer Возвращать только те хосты, которые входят в указанную зону управления.

Укажите здесь идентификатор зоны управления.

query по желанию
Зона управления string Возвращать только те хосты, которые входят в указанную зону управления.

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

Если задан параметр managementZoneId , этот параметр игнорируется.

query по желанию
networkZoneId string Фильтрует результирующий набор хостов по указанной сетевой зоне.

Укажите идентификатор объекта Ключ-АСТРОМ требуемой сетевой зоны. Вы можете получить список доступных сетевых зон с помощью вызова GET all network zone .

query по желанию
hostGroupId string Фильтрует результирующий набор хостов по указанной группе хостов.

Укажите идентификатор объекта Ключ-АСТРОМ требуемой группы хостов.

query по желанию
hostGroupName string Фильтрует результирующий набор хостов по указанной группе хостов.

Укажите имя требуемой группы хостов.

query по желанию
osType string Фильтрует результирующий набор хостов по типу ОС.

Элемент может содержать эти значения

  • AIX
  • DARWIN
  • HPUX
  • LINUX
  • SOLARIS
  • WINDOWS
  • ZOS
 query по желанию
cloudType string Фильтрует результирующий набор хостов по типу облака.

Элемент может содержать эти значения

  • AZURE
  • EC2
  • GOOGLE_CLOUD_PLATFORM
  • OPENSTACK
  • ORACLE
  • UNRECOGNIZED
 query по желанию
autoInjection string Фильтрует результирующий набор хостов по статусу автоматической инъекции.

Элемент может содержать эти значения

  • DISABLED_MANUALLY
  • DISABLED_ON_INSTALLATION
  • DISABLED_ON_SANITY_CHECK
  • ENABLED
  • FAILED_ON_INSTALLATION
 query по желанию
availabilityState string Фильтрует результирующий набор хостов по состоянию доступности ЕдиногоАгента.
  • MONITORED: хосты, на которых ЕдиныйАгент включен и активен.
  • UNMONITORED: хосты, на которых ЕдиныйАгент отключен и неактивен.
  • CRASHED: хосты, на которых ЕдиныйАгент вернул код состояния сбоя.
  • LOST: Хосты, где невозможно установить соединение с ЕдинымАгентом.
  • PRE_MONITORED: хосты, на которых ЕдиныйАгент инициализируется для мониторинга.
  • SHUTDOWN: хосты, на которых ЕдиныйАгент завершает работу в контролируемом процессе.
  • UNEXPECTED_SHUTDOWN: хосты, на которых ЕдиныйАгент завершает работу в результате неконтролируемого процесса.
  • UNKNOWN: хосты, на которых состояние ЕдиныйАгент неизвестно.

Элемент может содержать эти значения

  • CRASHED
  • LOST
  • MONITORED
  • PRE_MONITORED
  • SHUTDOWN
  • UNEXPECTED_SHUTDOWN
  • UNKNOWN
  • UNMONITORED
 query по желанию
detailedAvailabilityState string Фильтрует результирующий набор хостов по подробному состоянию доступности ЕдиногоАгента.
  • UNKNOWN: хосты, на которых состояние ЕдиногоАгента неизвестно.
  • PRE_MONITORED: хосты, на которых ЕдиныйАгент инициализируется для мониторинга.
  • CRASHED_UNKNOWN: хосты, на которых произошел сбой ЕдиногоАгента по неизвестной причине.
  • CRASHED_FAILURE: хосты, на которых ЕдиныйАгент вернул код состояния сбоя.
  • LOST_UNKNOWN: Хосты, на которых невозможно установить соединение с ЕдинымАгентом по неизвестной причине.
  • LOST_CONNECTION: хосты, на которых ЕдиныйАгент признан неактивным.
  • LOST_AGENT_UPGRADE_FAILED: хосты, на которых ЕдиныйАгент может иметь потенциальную проблему обновления из-за бездействия после обновления.
  • SHUTDOWN_UNKNOWN_UNEXPECTED: хосты, на которых ЕдиныйАгент завершает работу в результате неконтролируемого процесса.
  • SHUTDOWN_UNKNOWN: хосты, на которых ЕдиныйАгент отключился по неизвестной причине.
  • SHUTDOWN_GRACEFUL: хосты, на которых ЕдиныйАгент отключился из-за отключения хоста.
  • SHUTDOWN_STOPPED: хосты, на которых ЕдиныйАгент отключился из-за остановки хоста.
  • SHUTDOWN_AGENT_LOST: хосты, на которых модуль PaaS признан неактивным.
  • SHUTDOWN_SPOT_INSTANCE: хосты, на которых завершение работы ЕдиногоАгента было вызвано прерыванием работы спотового инстанса AWS.
  • UNMONITORED_UNKNOWN: хосты, на которых ЕдиныйАгент отключен и неактивен по неизвестной причине.
  • UNMONITORED_TERMINATED: хосты, на которых ЕдиныйАгент завершил работу.
  • UNMONITORED_DISABLED: хосты, на которых ЕдиныйАгент отключен в конфигурации.
  • UNMONITORED_AGENT_STOPPED: хосты, на которых ЕдиныйАгент остановлен.
  • UNMONITORED_AGENT_RESTART_TRIGGERED: хосты, на которых перезапускается ЕдиныйАгент.
  • UNMONITORED_AGENT_UNINSTALLED: хосты, на которых удален ЕдиныйАгент.
  • UNMONITORED_AGENT_DISABLED: хосты, на которых ЕдиныйАгент сообщил, что он отключен.
  • UNMONITORED_AGENT_UPGRADE_FAILED: Хосты, на которых у ЕдиногоАгента есть потенциальная проблема с обновлением.
  • UNMONITORED_ID_CHANGED: Хосты, ID которых ЕдиныйАгент потенциально может изменить во время обновления.
  • UNMONITORED_AGENT_LOST: хосты, на которых ЕдиныйАгент признан недоступным из-за проблем со связью с сервером.
  • UNMONITORED_AGENT_UNREGISTERED: хосты, на которых модуль кода был признан недоступным из-за завершения работы.
  • UNMONITORED_AGENT_VERSION_REJECTED: хосты, на которых ЕдиныйАгент был отклонен из-за того, что версия не соответствует минимальным требованиям к версии агента.
  • MONITORED: хосты, на которых ЕдиныйАгент включен и активен.
  • MONITORED_ENABLED: хосты, на которых ЕдиныйАгент включен в конфигурации.
  • MONITORED_AGENT_REGISTERED: Хосты, на которых был распознан новый ЕдиныйАгент.
  • MONITORED_AGENT_UPGRADE_STARTED: хосты, на которых ЕдиныйАгент был отключен из-за обновления.
  • MONITORED_AGENT_ENABLED: хосты, на которых ЕдиныйАгент сообщил, что он включен.
  • MONITORED_AGENT_VERSION_ACCEPTED: хосты, на которых ЕдиныйАгент был принят, поскольку версия соответствует минимальным требованиям к версии агента.

Элемент может содержать эти значения

  • CRASHED_FAILURE
  • CRASHED_UNKNOWN
  • LOST_AGENT_UPGRADE_FAILED
  • LOST_CONNECTION
  • LOST_UNKNOWN
  • MONITORED
  • MONITORED_AGENT_ENABLED
  • MONITORED_AGENT_REGISTERED
  • MONITORED_AGENT_UPGRADE_STARTED
  • MONITORED_AGENT_VERSION_ACCEPTED
  • MONITORED_ENABLED
  • PRE_MONITORED
  • SHUTDOWN_AGENT_LOST
  • SHUTDOWN_GRACEFUL
  • SHUTDOWN_SPOT_INSTANCE
  • SHUTDOWN_STOPPED
  • SHUTDOWN_UNKNOWN
  • SHUTDOWN_UNKNOWN_UNEXPECTED
  • UNKNOWN
  • UNMONITORED_AGENT_DISABLED
  • UNMONITORED_AGENT_LOST
  • UNMONITORED_AGENT_RESTART_TRIGGERED
  • UNMONITORED_AGENT_STOPPED
  • UNMONITORED_AGENT_UNINSTALLED
  • UNMONITORED_AGENT_UNREGISTERED
  • UNMONITORED_AGENT_UPGRADE_FAILED
  • UNMONITORED_AGENT_VERSION_REJECTED
  • UNMONITORED_DISABLED
  • UNMONITORED_ID_CHANGED
  • UNMONITORED_TERMINATED
  • UNMONITORED_UNKNOWN
 query по желанию
monitoringType string Фильтрует результирующий набор узлов по режиму мониторинга ЕдиногоАгента, развернутого на узле.

Элемент может содержать эти значения

  • CLOUD_INFRASTRUCTURE
  • FULL_STACK
  • STANDALONE
 query по желанию
agentVersionIs string Отфильтровывает результирующий набор хостов по тем, на которых развернута определенная версия ЕдиногоАгента.

Укажите здесь оператор сравнения.

Элемент может содержать эти значения

  • EQUAL
  • GREATER
  • GREATER_EQUAL
  • LOWER
  • LOWER_EQUAL
 query по желанию
agentVersionNumber string Отфильтровывает результирующий набор хостов по тем, на которых развернута определенная версия ЕдиногоАгента.

Укажите версию в <major>.<minor>.<revision>формате, например 1.182.0. Вы можете получить список доступных версий с помощью вызова доступных версий GET .

query по желанию
autoUpdateSetting string Фильтрует результирующий набор узлов по фактическому состоянию параметра автоматического обновления развернутых ЕдиныхАгентов.

Элемент может содержать эти значения

  • ENABLED
  • DISABLED
 query по желанию
updateStatus string Фильтрует результирующий набор узлов по статусу обновления ЕдиногоАгента, развернутого на узле.

Элемент может содержать эти значения

  • INCOMPATIBLE
  • OUTDATED
  • SCHEDULED
  • SUPPRESSED
  • UNKNOWN
  • UP2DATE
  • UPDATE_IN_PROGRESS
  • UPDATE_PENDING
  • UPDATE_PROBLEM
 query по желанию
faultyVersion boolean Отфильтровывает результирующий набор хостов, выбирая те, на которых работает версия ЕдиногоАгента, помеченная как неисправная. query по желанию
ActiveGateId string Отфильтровывает результирующий набор хостов на те, которые в данный момент подключены к АктивномуШлюзу с указанным ID.

Используйте ключевое слово DIRECT_COMMUNICATION , чтобы найти хосты, не подключенные ни к одному АктивномуШлюзу.

query по желанию
technologyModuleType string Отфильтровывает результирующий набор хостов до тех, на которых работает указанный модуль кода ЕдиногоАгента.

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

Элемент может содержать эти значения

  • APACHE
  • DOT_NET
  • DUMPPROC
  • GO
  • IBM_INTEGRATION_BUS
  • IIS
  • JAVA
  • LOG_ANALYTICS
  • NETTRACER
  • NETWORK
  • NGINX
  • NODE_JS
  • OPENTRACINGNATIVE
  • PHP
  • PROCESS
  • PYTHON
  • RUBY
  • SDK
  • UPDATER
  • VARNISH
  • Z_OS
 query по желанию
technologyModuleVersionIs string Отфильтровывает результирующий набор хостов для тех, на которых развернута определенная версия модуля кода.

Укажите здесь оператор сравнения.

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

Элемент может содержать эти значения

  • EQUAL
  • GREATER
  • GREATER_EQUAL
  • LOWER
  • LOWER_EQUAL
 query по желанию
technologyModuleVersionNumber string Отфильтровывает результирующий набор хостов для тех, на которых развернута определенная версия модуля кода.

Укажите версию в <major>.<minor>.<revision>формате, например 1.182.0. Вы можете получить список доступных версий с помощью вызова доступных версий GET .

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

query по желанию
technologyModuleFaultyVersion boolean Отфильтровывает результирующий набор хостов до тех, на которых работает версия модуля кода, помеченная как неисправная.

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

query по желанию
pluginName string Отфильтровывает результирующий набор хостов до тех, на которых работает плагин с указанным именем.

Оператор CONTAINS применяется к указанному значению.

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

query по желанию
pluginVersionIs string Отфильтровывает результирующий набор хостов до тех, на которых развернута определенная версия плагина.

Укажите здесь оператор сравнения.

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

Элемент может содержать эти значения

  • EQUAL
  • GREATER
  • GREATER_EQUAL
  • LOWER
  • LOWER_EQUAL
 query по желанию
pluginVersionNumber string Отфильтровывает результирующий набор хостов до тех, на которых развернута определенная версия плагина.

Укажите версию в <major>.<minor>.<revision>формате, например 1.182.0. Вы можете получить список доступных версий с помощью вызова доступных версий GET .

<minor>и <revision>части номера версии являются необязательными.

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

query по желанию
pluginState string Отфильтровывает результирующий набор хостов до тех, на которых работает плагин с указанным состоянием.

Элемент может содержать эти значения

  • DISABLED
  • ERROR_AUTH
  • ERROR_COMMUNICATION_FAILURE
  • ERROR_CONFIG
  • ERROR_TIMEOUT
  • ERROR_UNKNOWN
  • INCOMPATIBLE
  • LIMIT_REACHED
  • NOTHING_TO_REPORT
  • OK
  • STATE_TYPE_UNKNOWN
  • UNINITIALIZED
  • UNSUPPORTED
  • WAITING_FOR_STATE
 query по желанию
nextPageKey string Курсор для следующей страницы результатов, если результаты не помещаются на одной странице. Вы можете найти значение курсора на текущей странице ответа, в поле nextPageKey .

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

Если вы не укажете курсор, всегда будет возвращаться первая страница.

query по желанию

Ответ

Коды ответов

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

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

Объект HostsListPage

Список хостов с информацией о развертывании ЕдиногоАгента для каждого хоста.

Элемент Тип Описание
percentageOfEnvironmentSearched number Ход поиска среды в процентах.
nextPageKey string Курсор для следующей страницы результатов.

Имеет значение nullна последней странице.

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

hosts HostAgentInfo[] Список хостов с информацией о развертывании ЕдиногоАгента для каждого хоста.

Объект HostAgentInfo

Развертывание ЕдиногоАгента на хосте.

Элемент Тип Описание
hostInfo Host Информация о хозяине.
faultyVersion boolean Версия OneAgent ошибочна ( true) или нет ( false).
active boolean OneAgent активен ( true) или неактивен ( false).
configuredMonitoringMode string Настроен режим мониторинга OneAgent.

Элемент может содержать эти значения

  • CLOUD_INFRASTRUCTURE
  • FULL_STACK
monitoringType string Режим мониторинга OneAgent.

Элемент может содержать эти значения

  • CLOUD_INFRASTRUCTURE
  • FULL_STACK
  • STANDALONE
autoUpdateSetting string Эффективная настройка автоматического обновления OneAgent. Для хоста с унаследованной конфигурацией он рассчитывается на основе конфигурации его родителя.

Элемент может содержать эти значения

  • ENABLED
  • DISABLED
updateStatus string Текущий статус обновления OneAgent.

Элемент может содержать эти значения

  • INCOMPATIBLE
  • OUTDATED
  • SCHEDULED
  • SUPPRESSED
  • UNKNOWN
  • UP2DATE
  • UPDATE_IN_PROGRESS
  • UPDATE_PENDING
  • UPDATE_PROBLEM
availableVersions string [] Список версий OneAgent, до которых можно обновить.
configuredMonitoringEnabled boolean Мониторинг включен ( true) или отключен ( false) в конфигурации OneAgent.
availabilityState string Состояние доступности OneAgent.

Элемент может содержать эти значения

  • CRASHED
  • LOST
  • MONITORED
  • PRE_MONITORED
  • SHUTDOWN
  • UNEXPECTED_SHUTDOWN
  • UNKNOWN
  • UNMONITORED
detailedAvailabilityState string Подробное состояние доступности OneAgent.

Элемент может содержать эти значения

  • CRASHED_FAILURE
  • CRASHED_UNKNOWN
  • LOST_AGENT_UPGRADE_FAILED
  • LOST_CONNECTION
  • LOST_UNKNOWN
  • MONITORED
  • MONITORED_AGENT_ENABLED
  • MONITORED_AGENT_REGISTERED
  • MONITORED_AGENT_UPGRADE_STARTED
  • MONITORED_AGENT_VERSION_ACCEPTED
  • MONITORED_ENABLED
  • PRE_MONITORED
  • SHUTDOWN_AGENT_LOST
  • SHUTDOWN_GRACEFUL
  • SHUTDOWN_SPOT_INSTANCE
  • SHUTDOWN_STOPPED
  • SHUTDOWN_UNKNOWN
  • SHUTDOWN_UNKNOWN_UNEXPECTED
  • UNKNOWN
  • UNMONITORED_AGENT_DISABLED
  • UNMONITORED_AGENT_LOST
  • UNMONITORED_AGENT_RESTART_TRIGGERED
  • UNMONITORED_AGENT_STOPPED
  • UNMONITORED_AGENT_UNINSTALLED
  • UNMONITORED_AGENT_UNREGISTERED
  • UNMONITORED_AGENT_UPGRADE_FAILED
  • UNMONITORED_AGENT_VERSION_REJECTED
  • UNMONITORED_DISABLED
  • UNMONITORED_ID_CHANGED
  • UNMONITORED_TERMINATED
  • UNMONITORED_UNKNOWN
currentActiveGateId integer УСТАРЕЛО

Это поле устарело и предназначено для обратной совместимости.

Вместо этого используйте поле currentActiveGateIds .

currentActiveGateIds string [] Список идентификаторов ActiveGate для ActiveGate, к которым в данный момент подключен OneAgent.
currentNetworkZoneId string Идентификатор сетевой зоны, которую использует OneAgent.
modules ModuleInfo[] Список модулей кода, развернутых на хосте.
plugins PluginInfo[] Список плагинов, развернутых на хосте.

Объект Host

Информация о хозяине.

Элемент Тип Описание
entityId string Идентификатор объекта Ключ-АСТРОМ требуемого объекта.
displayName string Имя объекта Ключ-АСТРОМ, отображаемое в пользовательском интерфейсе.
customizedName string Пользовательское имя объекта
discoveredName string Обнаруженное имя объекта
firstSeenTimestamp integer Отметка времени первого обнаружения объекта в миллисекундах UTC.
lastSeenTimestamp integer Отметка времени последнего обнаружения объекта в миллисекундах UTC.
tags TagInfo[] Список тегов сущностей.
fromRelationships object -
toRelationships object -
managementZones EntityShortRepresentation[] Зоны управления, частью которых является объект.
localHostName string -
openstackComputeNodeName string -
esxiHostName string -
monitoringMode string -

Элемент может содержать эти значения

  • FULL_STACK
  • INFRASTRUCTURE
  • OFF
paasAgentVersions AgentVersion[] Версии агентов PaaS, которые в настоящее время работают на объекте.
ipAddresses string [] -
boshStemcellVersion string Версия стволовых клеток Cloud Foundry BOSH.
localIp string -
cloudType string -

Элемент может содержать эти значения

  • AZURE
  • EC2
  • GOOGLE_CLOUD_PLATFORM
  • OPENSTACK
  • ORACLE
  • UNRECOGNIZED
CloudPlatformVendorVersion string Определяет версию поставщика облачной платформы.
azureVmSizeLabel string -
zosLpaName string Имя LPAR.
zosTotalGeneralPurposeProcessors integer Количество назначенных процессоров для этого LPAR.
openstackVmName string -
paasType string -

Элемент может содержать эти значения

  • AWS_ECS_EC2
  • AWS_ECS_FARGATE
  • AWS_LAMBDA
  • AZURE_FUNCTIONS
  • AZURE_WEBSITES
  • CLOUD_FOUNDRY
  • GOOGLE_APP_ENGINE
  • HEROKU
  • KUBERNETES
  • OPENSHIFT
azureVmScaleSetName string -
zosSystemName string Название системы.
azureResourceGroupName string -
networkZoneId string Идентификатор сетевой зоны, в которой находится объект.
azureHostNames string [] -
agentVersion AgentVersion Определяет версию агента, работающего в данный момент на объекте.
paasMemoryLimit integer -
vmwareName string -
consumedHostUnits string -
autoInjection string Статус автоинжектирования

Элемент может содержать эти значения

  • DISABLED_MANUALLY
  • DISABLED_ON_INSTALLATION
  • DISABLED_ON_SANITY_CHECK
  • ENABLED
  • FAILED_ON_INSTALLATION
hostGroup HostGroup -
zosTotalZiipProcessors integer Количество назначенных процессоров поддержки для этого LPAR.
boshAvailabilityZone string Зона доступности Cloud Foundry BOSH.
beanstalkEnvironmentName string -
publicHostName string -
gceInstanceName string Имя экземпляра Google Compute Engine.
awsInstanceId string -
gceProjectId string Числовой идентификатор проекта Google Compute Engine.
ScaleSetName string -
openstackProjectName string -
azureSiteNames string [] -
zosCPUSerialNumber string Серийный номер процессора.
boshName string Название Cloud Foundry BOSH.
zosVirtualization string Тип виртуализации на мейнфрейме.
boshDeploymentId string Идентификатор развертывания Cloud Foundry BOSH.
gcpZone string Зона облачной платформы Google.
kubernetesNode string Узел kubernetes, в котором находится сущность.
cpuCores integer -
azureComputeModeName string -

Элемент может содержать эти значения

  • DEDICATED
  • SHARED
awsNameTag string Название унаследовано от AWS.
azureVmName string -
awsInstanceType string -
boshInstanceId string Идентификатор экземпляра Cloud Foundry BOSH.
hypervisorType string -

Элемент может содержать эти значения

  • AHV
  • HYPERV
  • KVM
  • LPAR
  • QEMU
  • UNRECOGNIZED
  • VIRTUALBOX
  • VMWARE
  • WPAR
  • XEN
simultaneousMultithreading integer Количество одновременных потоков экземпляра AIX.
gcePublicIpAddresses string [] Общедоступные IP-адреса Google Compute Engine.
logicalCpuCores integer -
boshInstanceName string Имя экземпляра Cloud Foundry BOSH.
azureSku string -

Элемент может содержать эти значения

  • BASIC
  • DYNAMIC
  • FREE
  • PREMIUM
  • SHARED
  • STANDARD
azureEnvironment string -
azureZone string -
kubernetesCluster string Кластер kubernetes, в котором находится сущность.
logicalCpus integer Количество логических процессоров экземпляра AIX.
gceMachineType string Тип машины Google Compute Engine.
openStackInstaceType string -
bitness string -

Элемент может содержать эти значения

  • 32bit
  • 64bit
gceProject string Проект Google Compute Engine.
kubernetesLabels object Метки kubernetes, определенные для объекта.
autoScalingGroup string -
gceInstanceId string Идентификатор экземпляра Google Compute Engine.
osVersion string -
amiId string -
isMonitoringCandidate boolean -
oneAgentCustomHostName string Пользовательское имя, указанное в конфигурации ЕдиногоАгента.
userLevel string -

Элемент может содержать эти значения

  • NON_SUPERUSER
  • NON_SUPERUSER_STRICT
  • SUPERUSER
virtualCpus integer Количество виртуальных процессоров экземпляра AIX.
softwareTechnologies TechnologyInfo[] -
awsSecurityGroup string [] -
azureResourceId string -
osType string -

Элемент может содержать эти значения

  • AIX
  • DARWIN
  • HPUX
  • LINUX
  • SOLARIS
  • WINDOWS
  • ZOS
openstackSecurityGroups string [] -
osArchitecture string -

Элемент может содержать эти значения

  • ARM
  • IA64
  • PARISC
  • PPC
  • PPCLE
  • S390
  • SPARC
  • X86
  • ZOS
publicIp string -
zosTotalPhysicalMemory integer Память, назначенная хосту (Терабайт).
zosCPUModelNumber string Номер модели процессора.
openstackAvZone string -

Объект TagInfo

Тег сущности Ключ-АСТРОМ.

Элемент Тип Описание
context string Происхождение тега, например AWS или Cloud Foundry.

Пользовательские теги используют это CONTEXTLESSзначение.

Элемент может содержать эти значения

  • AWS
  • AWS_GENERIC
  • AZURE
  • CLOUD_FOUNDRY
  • CONTEXTLESS
  • ENVIRONMENT
  • GOOGLE_CLOUD
  • KUBERNETES
key string Ключ тега.

Пользовательские теги имеют значение тега здесь.

value string Значение тега.

Не применимо к пользовательским тегам.

Объект EntityShortRepresentation

Краткое представление объекта Ключ-АСТРОМ.

Элемент Тип Описание
id string Идентификатор объекта Ключ-АСТРОМ.
name string Имя объекта Ключ-АСТРОМ.
description string Краткое описание сущности Ключ-АСТРОМ.

Объект AgentVersion

Определяет версию агента, работающего в данный момент на объекте.

Элемент Тип Описание
major integer Номер основной версии.
minor integer Младший номер версии.
revision integer Номер ревизии.
timestamp string Строка временной метки: формат "ггггммдд-ччммсс
sourceRevision string Строковое представление номера версии SVN.

Объект HostGroup

Элемент Тип Описание
meId string Идентификатор объекта Ключ-АСТРОМ группы хостов.
name string Имя объекта Ключ-АСТРОМ, отображаемое в пользовательском интерфейсе.

Объект TechnologyInfo

Элемент Тип Описание
type string -
edition string -
version string -

Объект ModuleInfo

Модуль кода ЕдиныйАгент.

Элемент Тип Описание
moduleType string Тип модуля кода.

Элемент может содержать эти значения

  • APACHE
  • DOT_NET
  • DUMPPROC
  • GO
  • IBM_INTEGRATION_BUS
  • IIS
  • JAVA
  • LOG_ANALYTICS
  • NETTRACER
  • NETWORK
  • NGINX
  • NODE_JS
  • OPENTRACINGNATIVE
  • PHP
  • PROCESS
  • PYTHON
  • RUBY
  • SDK
  • UPDATER
  • VARNISH
  • Z_OS
instances ModuleInstance[] Список экземпляров модуля кода.

Объект ModuleInstance

Экземпляр модуля кода ЕдиногоАгента.

Элемент Тип Описание
instanceName string Имя экземпляра.
moduleVersion string Версия модуля кода.
faultyVersion boolean Версия кодового модуля ошибочна ( true) или нет ( false).
active boolean Экземпляр модуля кода активен ( true) или неактивен ( false).

Объект PluginInfo

Плагин ЕдиногоАгента.

Элемент Тип Описание
pluginName string Название плагина.
instances PluginInstance[] Список экземпляров плагина.

Объект PluginInstance

Экземпляр подключаемого модуля ЕдиногоАгента.

Элемент Тип Описание
pluginVersion string Версия плагина.
state string Состояние экземпляра плагина.

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

{
  "percentageOfEnvironmentSearched": 1,
  "nextPageKey": "string",
  "hosts": [
    {
      "hostInfo": {
        "entityId": "string",
        "displayName": "string",
        "customizedName": "string",
        "discoveredName": "string",
        "firstSeenTimestamp": 1,
        "lastSeenTimestamp": 1,
        "tags": [
          {
            "context": "AWS",
            "key": "string",
            "value": "string"
          }
        ],
        "fromRelationships": {
          "isNetworkClientOfHost": [
            "string"
          ]
        },
        "toRelationships": {
          "isProcessOf": [
            "string"
          ],
          "isSiteOf": [
            "string"
          ],
          "isNetworkClientOfHost": [
            "string"
          ],
          "runsOn": [
            "string"
          ]
        },
        "managementZones": [
          {
            "id": "6a98d7bc-abb9-44f8-ae6a-73e68e71812a",
            "name": "Astromkey entity",
            "description": "Astromkey entity for the REST API example"
          }
        ],
        "localHostName": "string",
        "openstackComputeNodeName": "string",
        "esxiHostName": "string",
        "monitoringMode": "FULL_STACK",
        "paasAgentVersions": [
          {
            "major": 1,
            "minor": 1,
            "revision": 1,
            "timestamp": "string",
            "sourceRevision": "string"
          }
        ],
        "ipAddresses": [
          "string"
        ],
        "boshStemcellVersion": "string",
        "localIp": "string",
        "cloudType": "AZURE",
        "cloudPlatformVendorVersion": "string",
        "azureVmSizeLabel": "string",
        "zosLpaName": "string",
        "zosTotalGeneralPurposeProcessors": 1,
        "openstackVmName": "string",
        "paasType": "AWS_ECS_EC2",
        "azureVmScaleSetName": "string",
        "zosSystemName": "string",
        "azureResourceGroupName": "string",
        "networkZoneId": "string",
        "azureHostNames": [
          "string"
        ],
        "agentVersion": {},
        "paasMemoryLimit": 1,
        "vmwareName": "string",
        "consumedHostUnits": "string",
        "autoInjection": "DISABLED_MANUALLY",
        "hostGroup": {
          "meId": "string",
          "name": "string"
        },
        "zosTotalZiipProcessors": 1,
        "boshAvailabilityZone": "string",
        "beanstalkEnvironmentName": "string",
        "publicHostName": "string",
        "gceInstanceName": "string",
        "awsInstanceId": "string",
        "gceProjectId": "string",
        "scaleSetName": "string",
        "openstackProjectName": "string",
        "azureSiteNames": [
          "string"
        ],
        "zosCPUSerialNumber": "string",
        "boshName": "string",
        "zosVirtualization": "string",
        "boshDeploymentId": "string",
        "gcpZone": "string",
        "kubernetesNode": "string",
        "cpuCores": 1,
        "azureComputeModeName": "DEDICATED",
        "awsNameTag": "string",
        "azureVmName": "string",
        "awsInstanceType": "string",
        "boshInstanceId": "string",
        "hypervisorType": "AHV",
        "simultaneousMultithreading": 1,
        "gcePublicIpAddresses": [
          "string"
        ],
        "logicalCpuCores": 1,
        "boshInstanceName": "string",
        "azureSku": "BASIC",
        "azureEnvironment": "string",
        "azureZone": "string",
        "kubernetesCluster": "string",
        "logicalCpus": 1,
        "gceMachineType": "string",
        "openStackInstaceType": "string",
        "bitness": "32bit",
        "gceProject": "string",
        "kubernetesLabels": {},
        "autoScalingGroup": "string",
        "gceInstanceId": "string",
        "osVersion": "string",
        "amiId": "string",
        "isMonitoringCandidate": true,
        "oneAgentCustomHostName": "string",
        "userLevel": "NON_SUPERUSER",
        "virtualCpus": 1,
        "softwareTechnologies": [
          {
            "type": "string",
            "edition": "string",
            "version": "string"
          }
        ],
        "awsSecurityGroup": [
          "string"
        ],
        "azureResourceId": "string",
        "osType": "AIX",
        "openstackSecurityGroups": [
          "string"
        ],
        "osArchitecture": "ARM",
        "publicIp": "string",
        "zosTotalPhysicalMemory": 1,
        "zosCPUModelNumber": "string",
        "openstackAvZone": "string"
      },
      "faultyVersion": true,
      "active": true,
      "configuredMonitoringMode": "CLOUD_INFRASTRUCTURE",
      "monitoringType": "CLOUD_INFRASTRUCTURE",
      "autoUpdateSetting": "ENABLED",
      "updateStatus": "INCOMPATIBLE",
      "availableVersions": [
        "string"
      ],
      "configuredMonitoringEnabled": true,
      "availabilityState": "CRASHED",
      "detailedAvailabilityState": "CRASHED_FAILURE",
      "currentActiveGateId": 1,
      "currentActiveGateIds": [
        "string"
      ],
      "currentNetworkZoneId": "string",
      "modules": [
        {
          "moduleType": "APACHE",
          "instances": [
            {
              "instanceName": "string",
              "moduleVersion": "string",
              "faultyVersion": true,
              "active": true
            }
          ]
        }
      ],
      "plugins": [
        {
          "pluginName": "string",
          "instances": [
            {
              "pluginVersion": "string",
              "state": "string"
            }
          ]
        }
      ]
    }
  ]
}
Источник — https://doc.ruscomtech.ru/index.php?title=ЕдиныйАгент_на_хосте&oldid=1624