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

Материал из Документация Ключ-АСТРОМ
(Новая страница: « OneAgent на хосте API позволяет вам проверять конфигурацию экземпляров OneAgent на ваших хостах....»)
 
 
(не показаны 4 промежуточные версии этого же участника)
Строка 1: Строка 1:


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


Запрос создает <code>application/json</code>полезную нагрузку.
Запрос создает <code>application/json</code>полезную нагрузку.
{| class="wikitable"
{| class="wikitable"
| rowspan="3" |ПОЛУЧИТЬ
| rowspan="2" |GET
|Удалось
|Managed
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v1/oneagents</nowiki></code>
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v1/oneagents</nowiki></code>
|-
|-
|SaaS
|Среда АктивногоШлюза
|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v1/oneagents</nowiki></code>
|-
|Окружающая среда ActiveGate
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v1/oneagents</nowiki></code>
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v1/oneagents</nowiki></code>
|}
|}


== Аутентификация ==
== Аутентификация ==
Чтобы выполнить этот запрос, вам нужен токен доступа с проблемой доступа и каналом событий, метриками и областью топологии ( <code>DataExport</code>) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Чтобы выполнить этот запрос, вам нужен токен доступа с проблемой доступа и каналом событий, метриками и областью топологии ( <code>DataExport</code>) . Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] .


== Параметры ==
== Параметры ==
Строка 24: Строка 20:
!Тип
!Тип
!Описание
!Описание
!В
!In
!Необходимый
!Необходимый
|-
|-
|включитьДетали
|includeDetails
|логический
|boolean
|Включает ( <code>true</code>) или исключает ( <code>false</code>) детали, которые запрашиваются у связанных объектов.
|Включает ( <code>true</code>) или исключает ( <code>false</code>) детали, которые запрашиваются у связанных объектов.


Строка 34: Строка 30:


Если не установлено, то <code>true</code>используется.
Если не установлено, то <code>true</code>используется.
|запрос
|query
|по желанию
|по желанию
|-
|-
|startTimestamp
|startTimestamp
|целое число
|integer
|Метка времени начала запрошенного таймфрейма в миллисекундах (UTC).
|Метка времени начала запрошенного таймфрейма в миллисекундах (UTC).


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


Строка 52: Строка 48:


Срок не должен превышать 7 месяцев (214 дней).
Срок не должен превышать 7 месяцев (214 дней).
|запрос
|query
|по желанию
|по желанию
|-
|-
|относительное время
|relativeTime
|нить
|string
|Относительный период времени, начиная с настоящего времени.
|Относительный период времени, начиная с настоящего времени.


Строка 75: Строка 71:
* <code>month</code>
* <code>month</code>
* <code>week</code>
* <code>week</code>
|запрос
|query
|по желанию
|по желанию
|-
|-
|ярлык
|tag
|строка []
|string []
|Фильтрует результирующий набор хостов по указанному тегу. Вы можете указать несколько тегов в следующем формате: <code>tag=tag1&tag=tag2</code>. Хост должен соответствовать всем указанным тегам.
|Фильтрует результирующий набор хостов по указанному тегу. Вы можете указать несколько тегов в следующем формате: <code>tag=tag1&tag=tag2</code>. Хост должен соответствовать всем указанным тегам.


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


Для указания нескольких хостов используйте следующий формат: <code>entity=ID1&entity=ID2</code>.
Для указания нескольких хостов используйте следующий формат: <code>entity=ID1&entity=ID2</code>.
|запрос
|query
|по желанию
|по желанию
|-
|-
|managementZoneId
|managementZoneId
|целое число
|integer
|Возвращать только те хосты, которые входят в указанную зону управления.
|Возвращать только те хосты, которые входят в указанную зону управления.


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


Строка 109: Строка 105:


Если задан параметр managementZoneId , этот параметр игнорируется.
Если задан параметр managementZoneId , этот параметр игнорируется.
|запрос
|query
|по желанию
|по желанию
|-
|-
|networkZoneId
|networkZoneId
|нить
|string
|Фильтрует результирующий набор хостов по указанной сетевой зоне.
|Фильтрует результирующий набор хостов по указанной сетевой зоне.


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


Укажите идентификатор объекта Dynatrace требуемой группы хостов.
Укажите идентификатор объекта Ключ-АСТРОМ требуемой группы хостов.
|запрос
|query
|по желанию
|по желанию
|-
|-
|hostGroupName
|hostGroupName
|нить
|string
|Фильтрует результирующий набор хостов по указанной группе хостов.
|Фильтрует результирующий набор хостов по указанной группе хостов.


Укажите имя требуемой группы хостов.
Укажите имя требуемой группы хостов.
|запрос
|query
|по желанию
|по желанию
|-
|-
|тип ОС
|osType
|нить
|string
|Фильтрует результирующий набор хостов по типу ОС.
|Фильтрует результирующий набор хостов по типу ОС.


Строка 149: Строка 145:
* <code>WINDOWS</code>
* <code>WINDOWS</code>
* <code>ZOS</code>
* <code>ZOS</code>
|запрос
|query
|по желанию
|по желанию
|-
|-
|тип облака
|cloudType
|нить
|string
|Фильтрует результирующий набор хостов по типу облака.
|Фильтрует результирующий набор хостов по типу облака.


Строка 164: Строка 160:
* <code>ORACLE</code>
* <code>ORACLE</code>
* <code>UNRECOGNIZED</code>
* <code>UNRECOGNIZED</code>
|запрос
|query
|по желанию
|по желанию
|-
|-
|автоинъекция
|autoInjection
|нить
|string
|Фильтрует результирующий набор хостов по статусу автоматической инъекции.
|Фильтрует результирующий набор хостов по статусу автоматической инъекции.


Строка 178: Строка 174:
* <code>ENABLED</code>
* <code>ENABLED</code>
* <code>FAILED_ON_INSTALLATION</code>
* <code>FAILED_ON_INSTALLATION</code>
|запрос
|query
|по желанию
|по желанию
|-
|-
|состояние доступности
|availabilityState
|нить
|string
|Фильтрует результирующий набор хостов по состоянию доступности OneAgent.
|Фильтрует результирующий набор хостов по состоянию доступности ЕдиногоАгента.


* <code>MONITORED</code>: хосты, на которых OneAgent включен и активен.
* <code>MONITORED</code>: хосты, на которых ЕдиныйАгент включен и активен.
* <code>UNMONITORED</code>: хосты, на которых OneAgent отключен и неактивен.
* <code>UNMONITORED</code>: хосты, на которых ЕдиныйАгент отключен и неактивен.
* <code>CRASHED</code>: хосты, на которых OneAgent вернул код состояния сбоя.
* <code>CRASHED</code>: хосты, на которых ЕдиныйАгент вернул код состояния сбоя.
* <code>LOST</code>: Хосты, где невозможно установить соединение с OneAgent.
* <code>LOST</code>: Хосты, где невозможно установить соединение с ЕдинымАгентом.
* <code>PRE_MONITORED</code>: хосты, на которых OneAgent инициализируется для мониторинга.
* <code>PRE_MONITORED</code>: хосты, на которых ЕдиныйАгент инициализируется для мониторинга.
* <code>SHUTDOWN</code>: хосты, на которых OneAgent завершает работу в контролируемом процессе.
* <code>SHUTDOWN</code>: хосты, на которых ЕдиныйАгент завершает работу в контролируемом процессе.
* <code>UNEXPECTED_SHUTDOWN</code>: хосты, на которых OneAgent завершает работу в результате неконтролируемого процесса.
* <code>UNEXPECTED_SHUTDOWN</code>: хосты, на которых ЕдиныйАгент завершает работу в результате неконтролируемого процесса.
* <code>UNKNOWN</code>: хосты, на которых состояние OneAgent неизвестно.
* <code>UNKNOWN</code>: хосты, на которых состояние ЕдиныйАгент неизвестно.


Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 204: Строка 200:
* <code>UNKNOWN</code>
* <code>UNKNOWN</code>
* <code>UNMONITORED</code>
* <code>UNMONITORED</code>
|запрос
|query
|по желанию
|по желанию
|-
|-
|подробныйAvailabilityState
|detailedAvailabilityState
|нить
|string
|Фильтрует результирующий набор хостов по подробному состоянию доступности OneAgent.
|Фильтрует результирующий набор хостов по подробному состоянию доступности ЕдиногоАгента.


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


Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 276: Строка 272:
* <code>UNMONITORED_TERMINATED</code>
* <code>UNMONITORED_TERMINATED</code>
* <code>UNMONITORED_UNKNOWN</code>
* <code>UNMONITORED_UNKNOWN</code>
|запрос
|query
|по желанию
|по желанию
|-
|-
|Тип мониторинга
|monitoringType
|нить
|string
|Фильтрует результирующий набор узлов по режиму мониторинга OneAgent, развернутого на узле.
|Фильтрует результирующий набор узлов по режиму мониторинга ЕдиногоАгента, развернутого на узле.


Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 288: Строка 284:
* <code>FULL_STACK</code>
* <code>FULL_STACK</code>
* <code>STANDALONE</code>
* <code>STANDALONE</code>
|запрос
|query
|по желанию
|по желанию
|-
|-
|агентверсионис
|agentVersionIs
|нить
|string
|Отфильтровывает результирующий набор хостов по тем, на которых развернута определенная версия OneAgent.
|Отфильтровывает результирующий набор хостов по тем, на которых развернута определенная версия ЕдиногоАгента.


Укажите здесь оператор сравнения.
Укажите здесь оператор сравнения.
Строка 304: Строка 300:
* <code>LOWER</code>
* <code>LOWER</code>
* <code>LOWER_EQUAL</code>
* <code>LOWER_EQUAL</code>
|запрос
|query
|по желанию
|по желанию
|-
|-
|номер версии агента
|agentVersionNumber
|нить
|string
|Отфильтровывает результирующий набор хостов по тем, на которых развернута определенная версия OneAgent.
|Отфильтровывает результирующий набор хостов по тем, на которых развернута определенная версия ЕдиногоАгента.


Укажите версию в <code><major>.<minor>.<revision></code>формате, например <code>1.182.0</code>. Вы можете получить список доступных версий с помощью вызова доступных версий GET .
Укажите версию в <code><major>.<minor>.<revision></code>формате, например <code>1.182.0</code>. Вы можете получить список доступных версий с помощью вызова доступных версий GET .
|запрос
|query
|по желанию
|по желанию
|-
|-
|autoUpdateSetting
|autoUpdateSetting
|нить
|string
|Фильтрует результирующий набор узлов по фактическому состоянию параметра автоматического обновления развернутых агентов OneAgent.
|Фильтрует результирующий набор узлов по фактическому состоянию параметра автоматического обновления развернутых ЕдиныхАгентов.


Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 323: Строка 319:
* <code>ENABLED</code>
* <code>ENABLED</code>
* <code>DISABLED</code>
* <code>DISABLED</code>
|запрос
|query
|по желанию
|по желанию
|-
|-
|обновить состояние
|updateStatus
|нить
|string
|Фильтрует результирующий набор узлов по статусу обновления OneAgent, развернутого на узле.
|Фильтрует результирующий набор узлов по статусу обновления ЕдиногоАгента, развернутого на узле.


Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 341: Строка 337:
* <code>UPDATE_PENDING</code>
* <code>UPDATE_PENDING</code>
* <code>UPDATE_PROBLEM</code>
* <code>UPDATE_PROBLEM</code>
|запрос
|query
|по желанию
|по желанию
|-
|-
|ошибочная версия
|faultyVersion
|логический
|boolean
|Отфильтровывает результирующий набор хостов, выбирая те, на которых работает версия OneAgent, помеченная как неисправная.
|Отфильтровывает результирующий набор хостов, выбирая те, на которых работает версия ЕдиногоАгента, помеченная как неисправная.
|запрос
|query
|по желанию
|по желанию
|-
|-
|ActiveGateId
|ActiveGateId
|нить
|string
|Отфильтровывает результирующий набор хостов на те, которые в данный момент подключены к ActiveGate с указанным ID.
|Отфильтровывает результирующий набор хостов на те, которые в данный момент подключены к АктивномуШлюзу с указанным ID.


Используйте ключевое слово DIRECT_COMMUNICATION , чтобы найти хосты, не подключенные ни к одному ActiveGate.
Используйте ключевое слово DIRECT_COMMUNICATION , чтобы найти хосты, не подключенные ни к одному АктивномуШлюзу.
|запрос
|query
|по желанию
|по желанию
|-
|-
|технологияModuleType
|technologyModuleType
|нить
|string
|Отфильтровывает результирующий набор хостов до тех, на которых работает указанный модуль кода OneAgent.
|Отфильтровывает результирующий набор хостов до тех, на которых работает указанный модуль кода ЕдиногоАгента.


Если указано несколько фильтров модуля кода, модуль кода должен соответствовать всем фильтрам.
Если указано несколько фильтров модуля кода, модуль кода должен соответствовать всем фильтрам.
Строка 387: Строка 383:
* <code>VARNISH</code>
* <code>VARNISH</code>
* <code>Z_OS</code>
* <code>Z_OS</code>
|запрос
|query
|по желанию
|по желанию
|-
|-
|технологияModuleVersionIs
|technologyModuleVersionIs
|нить
|string
|Отфильтровывает результирующий набор хостов для тех, на которых развернута определенная версия модуля кода.
|Отфильтровывает результирующий набор хостов для тех, на которых развернута определенная версия модуля кода.


Строка 405: Строка 401:
* <code>LOWER</code>
* <code>LOWER</code>
* <code>LOWER_EQUAL</code>
* <code>LOWER_EQUAL</code>
|запрос
|query
|по желанию
|по желанию
|-
|-
|номер_версии_модуля_технологии
|technologyModuleVersionNumber
|нить
|string
|Отфильтровывает результирующий набор хостов для тех, на которых развернута определенная версия модуля кода.
|Отфильтровывает результирующий набор хостов для тех, на которых развернута определенная версия модуля кода.


Строка 415: Строка 411:


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


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


Строка 433: Строка 429:


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


Строка 451: Строка 447:
* <code>LOWER</code>
* <code>LOWER</code>
* <code>LOWER_EQUAL</code>
* <code>LOWER_EQUAL</code>
|запрос
|query
|по желанию
|по желанию
|-
|-
|номер версии плагина
|pluginVersionNumber
|нить
|string
|Отфильтровывает результирующий набор хостов до тех, на которых развернута определенная версия плагина.
|Отфильтровывает результирующий набор хостов до тех, на которых развернута определенная версия плагина.


Строка 463: Строка 459:


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


Строка 486: Строка 482:
* <code>UNSUPPORTED</code>
* <code>UNSUPPORTED</code>
* <code>WAITING_FOR_STATE</code>
* <code>WAITING_FOR_STATE</code>
|запрос
|query
|по желанию
|по желанию
|-
|-
|ключ следующей страницы
|nextPageKey
|нить
|string
|Курсор для следующей страницы результатов, если результаты не помещаются на одной странице. Вы можете найти значение курсора на текущей странице ответа, в поле nextPageKey .
|Курсор для следующей страницы результатов, если результаты не помещаются на одной странице. Вы можете найти значение курсора на текущей странице ответа, в поле nextPageKey .


Строка 496: Строка 492:


Если вы не укажете курсор, всегда будет возвращаться первая страница.
Если вы не укажете курсор, всегда будет возвращаться первая страница.
|запрос
|query
|по желанию
|по желанию
|}
|}
Строка 509: Строка 505:
|-
|-
|200
|200
|Страница со списком хостов
|HostsListPage
|Успех
|Успех
|}
|}
Строка 515: Строка 511:
=== Объекты тела ответа ===
=== Объекты тела ответа ===


==== Объект _ <code>HostsListPage</code> ====
==== Объект <code>HostsListPage</code> ====
Список хостов с информацией о развертывании OneAgent для каждого хоста.
Список хостов с информацией о развертывании ЕдиногоАгента для каждого хоста.
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент
Строка 522: Строка 518:
!Описание
!Описание
|-
|-
|процент среды
|percentageOfEnvironmentSearched
|количество
|number
|Ход поиска среды в процентах.
|Ход поиска среды в процентах.
|-
|-
|ключ следующей страницы
|nextPageKey
|нить
|string
|Курсор для следующей страницы результатов.
|Курсор для следующей страницы результатов.


Строка 534: Строка 530:
Может быть другая страница результатов, даже если текущая страница пуста.
Может быть другая страница результатов, даже если текущая страница пуста.
|-
|-
|хозяева
|hosts
|Информация об агенте хоста []
|HostAgentInfo[]
|Список хостов с информацией о развертывании OneAgent для каждого хоста.
|Список хостов с информацией о развертывании ЕдиногоАгента для каждого хоста.
|}
|}


==== Объект _ <code>HostAgentInfo</code> ====
==== Объект <code>HostAgentInfo</code> ====
Развертывание OneAgent на хосте.
Развертывание ЕдиногоАгента на хосте.
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент
Строка 546: Строка 542:
!Описание
!Описание
|-
|-
|информация о хосте
|hostInfo
|Хозяин
|Host
|Информация о хозяине.
|Информация о хозяине.
|-
|-
|ошибочная версия
|faultyVersion
|логический
|boolean
|Версия OneAgent ошибочна ( <code>true</code>) или нет ( <code>false</code>).
|Версия ЕдиногоАгента ошибочна ( <code>true</code>) или нет ( <code>false</code>).
|-
|-
|активный
|active
|логический
|boolean
|OneAgent активен ( <code>true</code>) или неактивен ( <code>false</code>).
|ЕдиныйАгент активен ( <code>true</code>) или неактивен ( <code>false</code>).
|-
|-
|сконфигурированныйМониторингМоде
|configuredMonitoringMode
|нить
|string
|Настроен режим мониторинга OneAgent.
|Настроен режим мониторинга ЕдиногоАгента.


Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 567: Строка 563:
* <code>FULL_STACK</code>
* <code>FULL_STACK</code>
|-
|-
|Тип мониторинга
|monitoringType
|нить
|string
|Режим мониторинга OneAgent.
|Режим мониторинга ЕдиногоАгента.


Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 578: Строка 574:
|-
|-
|autoUpdateSetting
|autoUpdateSetting
|нить
|string
|Эффективная настройка автоматического обновления OneAgent. Для хоста с унаследованной конфигурацией он рассчитывается на основе конфигурации его родителя.
|Эффективная настройка автоматического обновления ЕдиногоАгента. Для хоста с унаследованной конфигурацией он рассчитывается на основе конфигурации его родителя.


Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 586: Строка 582:
* <code>DISABLED</code>
* <code>DISABLED</code>
|-
|-
|обновить состояние
|updateStatus
|нить
|string
|Текущий статус обновления OneAgent.
|Текущий статус обновления ЕдиногоАгента.


Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 602: Строка 598:
* <code>UPDATE_PROBLEM</code>
* <code>UPDATE_PROBLEM</code>
|-
|-
|доступные версии
|availableVersions
|строка []
|string []
|Список версий OneAgent, до которых можно обновить.
|Список версий ЕдиногоАгента, до которых можно обновить.
|-
|-
|сконфигурированныймониторингенаблед
|configuredMonitoringEnabled
|логический
|boolean
|Мониторинг включен ( <code>true</code>) или отключен ( <code>false</code>) в конфигурации OneAgent.
|Мониторинг включен ( <code>true</code>) или отключен ( <code>false</code>) в конфигурации ЕдиногоАгента.
|-
|-
|состояние доступности
|availabilityState
|нить
|string
|Состояние доступности OneAgent.
|Состояние доступности ЕдиногоАгента.


Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 625: Строка 621:
* <code>UNMONITORED</code>
* <code>UNMONITORED</code>
|-
|-
|подробныйAvailabilityState
|detailedAvailabilityState
|нить
|string
|Подробное состояние доступности OneAgent.
|Подробное состояние доступности ЕдиногоАгента.


Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 664: Строка 660:
|-
|-
|<s>currentActiveGateId</s>
|<s>currentActiveGateId</s>
|целое число
|integer
|УСТАРЕЛО
|УСТАРЕЛО


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


==== Объект _ <code>Host</code> ====
==== Объект <code>Host</code> ====
Информация о хозяине.
Информация о хозяине.
{| class="wikitable"
{| class="wikitable"
Строка 695: Строка 691:
!Описание
!Описание
|-
|-
|идентификатор объекта
|entityId
|нить
|string
|Идентификатор объекта Dynatrace требуемого объекта.
|Идентификатор объекта Ключ-АСТРОМ требуемого объекта.
|-
|-
|показать имя
|displayName
|нить
|string
|Имя объекта Dynatrace, отображаемое в пользовательском интерфейсе.
|Имя объекта Ключ-АСТРОМ, отображаемое в пользовательском интерфейсе.
|-
|-
|индивидуальное имя
|customizedName
|нить
|string
|Пользовательское имя объекта
|Пользовательское имя объекта
|-
|-
|обнаружил имя
|discoveredName
|нить
|string
|Обнаруженное имя объекта
|Обнаруженное имя объекта
|-
|-
|firstSeenTimestamp
|firstSeenTimestamp
|целое число
|integer
|Отметка времени первого обнаружения объекта в миллисекундах UTC.
|Отметка времени первого обнаружения объекта в миллисекундах UTC.
|-
|-
|lastSeenTimestamp
|lastSeenTimestamp
|целое число
|integer
|Отметка времени последнего обнаружения объекта в миллисекундах UTC.
|Отметка времени последнего обнаружения объекта в миллисекундах UTC.
|-
|-
|теги
|tags
|Информация о теге []
|TagInfo[]
|Список тегов сущностей.
|Список тегов сущностей.
|-
|-
|отОтношения
|fromRelationships
|объект
|object
| -
| -
|-
|-
|кОтношения
|toRelationships
|объект
|object
| -
| -
|-
|-
|управлениеЗоны
|managementZones
|Краткое представление объекта []
|EntityShortRepresentation[]
|Зоны управления, частью которых является объект.
|Зоны управления, частью которых является объект.
|-
|-
|localHostName
|localHostName
|нить
|string
| -
| -
|-
|-
|openstackComputeNodeName
|openstackComputeNodeName
|нить
|string
| -
| -
|-
|-
|esxiHostName
|esxiHostName
|нить
|string
| -
| -
|-
|-
|режим мониторинга
|monitoringMode
|нить
|string
| -
| -
Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 757: Строка 753:
|-
|-
|paasAgentVersions
|paasAgentVersions
|Версия агента []
|AgentVersion[]
|Версии агентов PaaS, которые в настоящее время работают на объекте.
|Версии агентов PaaS, которые в настоящее время работают на объекте.
|-
|-
|IP-адреса
|ipAddresses
|строка []
|string []
| -
| -
|-
|-
|boshStemcellВерсия
|boshStemcellVersion
|нить
|string
|Версия стволовых клеток Cloud Foundry BOSH.
|Версия стволовых клеток Cloud Foundry BOSH.
|-
|-
|локальный IP
|localIp
|нить
|string
| -
| -
|-
|-
|тип облака
|cloudType
|нить
|string
| -
| -
Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 785: Строка 781:
|-
|-
|CloudPlatformVendorVersion
|CloudPlatformVendorVersion
|нить
|string
|Определяет версию поставщика облачной платформы.
|Определяет версию поставщика облачной платформы.
|-
|-
|азуревмсизелабел
|azureVmSizeLabel
|нить
|string
| -
| -
|-
|-
|зослпанаме
|zosLpaName
|нить
|string
|Имя LPAR.
|Имя LPAR.
|-
|-
|zosTotalGeneralPurposeПроцессоры
|zosTotalGeneralPurposeProcessors
|целое число
|integer
|Количество назначенных процессоров для этого LPAR.
|Количество назначенных процессоров для этого LPAR.
|-
|-
|openstackVmName
|openstackVmName
|нить
|string
| -
| -
|-
|-
|paasType
|paasType
|нить
|string
| -
| -
Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 820: Строка 816:
* <code>OPENSHIFT</code>
* <code>OPENSHIFT</code>
|-
|-
|азуревмскалесетнаме
|azureVmScaleSetName
|нить
|string
| -
| -
|-
|-
|zosSystemName
|zosSystemName
|нить
|string
|Название системы.
|Название системы.
|-
|-
|azureResourceGroupName
|azureResourceGroupName
|нить
|string
| -
| -
|-
|-
|networkZoneId
|networkZoneId
|нить
|string
|Идентификатор сетевой зоны, в которой находится объект.
|Идентификатор сетевой зоны, в которой находится объект.
|-
|-
|azureHostNames
|azureHostNames
|строка []
|string []
| -
| -
|-
|-
|агентВерсия
|agentVersion
|Версия агента
|AgentVersion
|Определяет версию агента, работающего в данный момент на объекте.
|Определяет версию агента, работающего в данный момент на объекте.
|-
|-
|paasMemoryLimit
|paasMemoryLimit
|целое число
|integer
| -
| -
|-
|-
|vmwareName
|vmwareName
|нить
|string
| -
| -
|-
|-
|потребляемыеHostUnits
|consumedHostUnits
|нить
|string
| -
| -
|-
|-
|автоинъекция
|autoInjection
|нить
|string
|Статус автоинъекции
|Статус автоинжектирования


Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 869: Строка 865:
|-
|-
|hostGroup
|hostGroup
|Хост- группа
|HostGroup
| -
| -
|-
|-
|zosTotalZiipПроцессоры
|zosTotalZiipProcessors
|целое число
|integer
|Количество назначенных процессоров поддержки для этого LPAR.
|Количество назначенных процессоров поддержки для этого LPAR.
|-
|-
|boshAvailabilityZone
|boshAvailabilityZone
|нить
|string
|Зона доступности Cloud Foundry BOSH.
|Зона доступности Cloud Foundry BOSH.
|-
|-
|beanstalkEnvironmentName
|beanstalkEnvironmentName
|нить
|string
| -
| -
|-
|-
|общественное имя хоста
|publicHostName
|нить
|string
| -
| -
|-
|-
|gceInstanceName
|gceInstanceName
|нить
|string
|Имя экземпляра Google Compute Engine.
|Имя экземпляра Google Compute Engine.
|-
|-
|awsInstanceId
|awsInstanceId
|нить
|string
| -
| -
|-
|-
|gceProjectId
|gceProjectId
|нить
|string
|Числовой идентификатор проекта Google Compute Engine.
|Числовой идентификатор проекта Google Compute Engine.
|-
|-
|ScaleSetName
|ScaleSetName
|нить
|string
| -
| -
|-
|-
|openstackProjectName
|openstackProjectName
|нить
|string
| -
| -
|-
|-
|azureSiteNames
|azureSiteNames
|строка []
|string []
| -
| -
|-
|-
|zosCPUSerialNumber
|zosCPUSerialNumber
|нить
|string
|Серийный номер процессора.
|Серийный номер процессора.
|-
|-
|boshName
|boshName
|нить
|string
|Название Cloud Foundry BOSH.
|Название Cloud Foundry BOSH.
|-
|-
|zosВиртуализация
|zosVirtualization
|нить
|string
|Тип виртуализации на мейнфрейме.
|Тип виртуализации на мейнфрейме.
|-
|-
|boshDeploymentId
|boshDeploymentId
|нить
|string
|Идентификатор развертывания Cloud Foundry BOSH.
|Идентификатор развертывания Cloud Foundry BOSH.
|-
|-
|gcpZone
|gcpZone
|нить
|string
|Зона облачной платформы Google.
|Зона облачной платформы Google.
|-
|-
|kubernetesNode
|kubernetesNode
|нить
|string
|Узел kubernetes, в котором находится сущность.
|Узел kubernetes, в котором находится сущность.
|-
|-
|процессорные ядра
|cpuCores
|целое число
|integer
| -
| -
|-
|-
|azureComputeModeName
|azureComputeModeName
|нить
|string
| -
| -
Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 949: Строка 945:
|-
|-
|awsNameTag
|awsNameTag
|нить
|string
|Название унаследовано от AWS.
|Название унаследовано от AWS.
|-
|-
|azureVmName
|azureVmName
|нить
|string
| -
| -
|-
|-
|awsInstanceType
|awsInstanceType
|нить
|string
| -
| -
|-
|-
|boshInstanceId
|boshInstanceId
|нить
|string
|Идентификатор экземпляра Cloud Foundry BOSH.
|Идентификатор экземпляра Cloud Foundry BOSH.
|-
|-
|тип гипервизора
|hypervisorType
|нить
|string
| -
| -
Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 980: Строка 976:
* <code>XEN</code>
* <code>XEN</code>
|-
|-
|одновременная многопоточность
|simultaneousMultithreading
|целое число
|integer
|Количество одновременных потоков экземпляра AIX.
|Количество одновременных потоков экземпляра AIX.
|-
|-
|gcePublicIpAddresses
|gcePublicIpAddresses
|строка []
|string []
|Общедоступные IP-адреса Google Compute Engine.
|Общедоступные IP-адреса Google Compute Engine.
|-
|-
|логические процессорные ядра
|logicalCpuCores
|целое число
|integer
| -
| -
|-
|-
|boshInstanceName
|boshInstanceName
|нить
|string
|Имя экземпляра Cloud Foundry BOSH.
|Имя экземпляра Cloud Foundry BOSH.
|-
|-
|лазурныйSku
|azureSku
|нить
|string
| -
| -
Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 1008: Строка 1004:
* <code>STANDARD</code>
* <code>STANDARD</code>
|-
|-
|лазурная среда
|azureEnvironment
|нить
|string
| -
| -
|-
|-
|лазурная зона
|azureZone
|нить
|string
| -
| -
|-
|-
|kubernetesкластер
|kubernetesCluster
|нить
|string
|Кластер kubernetes, в котором находится сущность.
|Кластер kubernetes, в котором находится сущность.
|-
|-
|логический ЦП
|logicalCpus
|целое число
|integer
|Количество логических процессоров экземпляра AIX.
|Количество логических процессоров экземпляра AIX.
|-
|-
|gceMachineType
|gceMachineType
|нить
|string
|Тип машины Google Compute Engine.
|Тип машины Google Compute Engine.
|-
|-
|openStackInstaceType
|openStackInstaceType
|нить
|string
| -
| -
|-
|-
|битность
|bitness
|нить
|string
| -
| -
Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 1041: Строка 1037:
|-
|-
|gceProject
|gceProject
|нить
|string
|Проект Google Compute Engine.
|Проект Google Compute Engine.
|-
|-
|kubernetesLabels
|kubernetesLabels
|объект
|object
|Метки kubernetes, определенные для объекта.
|Метки kubernetes, определенные для объекта.
|-
|-
|autoScalingGroup
|autoScalingGroup
|нить
|string
| -
| -
|-
|-
|gceInstanceId
|gceInstanceId
|нить
|string
|Идентификатор экземпляра Google Compute Engine.
|Идентификатор экземпляра Google Compute Engine.
|-
|-
|ОСВерсия
|osVersion
|нить
|string
| -
| -
|-
|-
|среди
|amiId
|нить
|string
| -
| -
|-
|-
|isMonitoringCandidate
|isMonitoringCandidate
|логический
|boolean
| -
| -
|-
|-
|oneAgentCustomHostName
|oneAgentCustomHostName
|нить
|string
|Пользовательское имя, указанное в конфигурации OneAgent.
|Пользовательское имя, указанное в конфигурации ЕдиногоАгента.
|-
|-
|уровень пользователя
|userLevel
|нить
|string
| -
| -
Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 1081: Строка 1077:
* <code>SUPERUSER</code>
* <code>SUPERUSER</code>
|-
|-
|виртуальный процессор
|virtualCpus
|целое число
|integer
|Количество виртуальных процессоров экземпляра AIX.
|Количество виртуальных процессоров экземпляра AIX.
|-
|-
|программное обеспечениеТехнологии
|softwareTechnologies
|Информация о технологии []
|TechnologyInfo[]
| -
| -
|-
|-
|awsSecurityGroup
|awsSecurityGroup
|строка []
|string []
| -
| -
|-
|-
|azureResourceId
|azureResourceId
|нить
|string
| -
| -
|-
|-
|тип ОС
|osType
|нить
|string
| -
| -
Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 1111: Строка 1107:
|-
|-
|openstackSecurityGroups
|openstackSecurityGroups
|строка []
|string []
| -
| -
|-
|-
|ОСАрхитектура
|osArchitecture
|нить
|string
| -
| -
Элемент может содержать эти значения
Элемент может содержать эти значения
Строка 1129: Строка 1125:
* <code>ZOS</code>
* <code>ZOS</code>
|-
|-
|публичный IP
|publicIp
|нить
|string
| -
| -
|-
|-
|zosTotalPhysicalMemory
|zosTotalPhysicalMemory
|целое число
|integer
|Память, назначенная хосту (Терабайт).
|Память, назначенная хосту (Терабайт).
|-
|-
|zosCPUModelNumber
|zosCPUModelNumber
|нить
|string
|Номер модели процессора.
|Номер модели процессора.
|-
|-
|openstackAvZone
|openstackAvZone
|нить
|string
| -
| -
|}
|}


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


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


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


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


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


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


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


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


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


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


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


==== Объект _ <code>PluginInstance</code> ====
==== Объект <code>PluginInstance</code> ====
Экземпляр подключаемого модуля OneAgent.
Экземпляр подключаемого модуля ЕдиногоАгента.
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент
Строка 1352: Строка 1348:
!Описание
!Описание
|-
|-
|версия плагина
|pluginVersion
|нить
|string
|Версия плагина.
|Версия плагина.
|-
|-
|государство
|state
|нить
|string
|Состояние экземпляра плагина.
|Состояние экземпляра плагина.
|}
|}
Строка 1403: Строка 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"
           }
           }
         ],
         ],

Текущая версия на 15:34, 21 сентября 2023

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

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

GET Managed https://{your-domain}/e/{your-environment-id}/api/v1/oneagents
Среда АктивногоШлюза 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 Версия ЕдиногоАгента ошибочна ( true) или нет ( false).
active boolean ЕдиныйАгент активен ( true) или неактивен ( false).
configuredMonitoringMode string Настроен режим мониторинга ЕдиногоАгента.

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

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

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

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

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

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

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

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

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

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

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

  • 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 [] Список идентификаторов АктивногоШлюза для АктивногоШлюза, к которым в данный момент подключен ЕдиныйАгент.
currentNetworkZoneId string Идентификатор сетевой зоны, которую использует ЕдиныйАгент.
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=3135