ЕдиныйАгент на хосте

ЕдиныйАгент на хосте 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	Фильтрует результирующий набор хостов по указанной сетевой зоне. Укажите идентификатор объекта Dynatrace требуемой сетевой зоны. Вы можете получить список доступных сетевых зон с помощью вызова GET all network zone .	query	по желанию
hostGroupId	string	Фильтрует результирующий набор хостов по указанной группе хостов. Укажите идентификатор объекта Dynatrace требуемой группы хостов.	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	Идентификатор объекта Dynatrace требуемого объекта.
displayName	string	Имя объекта Dynatrace, отображаемое в пользовательском интерфейсе.
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

Тег сущности Dynatrace.

Элемент	Тип	Описание
context	string	Происхождение тега, например AWS или Cloud Foundry. Пользовательские теги используют это CONTEXTLESSзначение. Элемент может содержать эти значения AWS AWS_GENERIC AZURE CLOUD_FOUNDRY CONTEXTLESS ENVIRONMENT GOOGLE_CLOUD KUBERNETES
key	string	Ключ тега. Пользовательские теги имеют значение тега здесь.
value	string	Значение тега. Не применимо к пользовательским тегам.

Объект EntityShortRepresentation

Краткое представление объекта Dynatrace.

Элемент	Тип	Описание
id	string	Идентификатор объекта Dynatrace.
name	string	Имя объекта Dynatrace.
description	string	Краткое описание сущности Dynatrace.

Объект AgentVersion

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

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

Объект HostGroup

Элемент	Тип	Описание
meId	string	Идентификатор объекта Dynatrace группы хостов.
name	string	Имя объекта Dynatrace, отображаемое в пользовательском интерфейсе.

Объект 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"
            }
          ]
        }
      ]
    }
  ]
}