ЕдиныйАгент на хосте: различия между версиями
ENetrebin (обсуждение | вклад) |
ENetrebin (обсуждение | вклад) |
||
Строка 505: | Строка 505: | ||
|- | |- | ||
|200 | |200 | ||
| | |HostsListPage | ||
|Успех | |Успех | ||
|} | |} | ||
Строка 511: | Строка 511: | ||
=== Объекты тела ответа === | === Объекты тела ответа === | ||
==== Объект | ==== Объект <code>HostsListPage</code> ==== | ||
Список хостов с информацией о развертывании | Список хостов с информацией о развертывании ЕдиногоАгента для каждого хоста. | ||
{| class="wikitable" | {| class="wikitable" | ||
!Элемент | !Элемент | ||
Строка 518: | Строка 518: | ||
!Описание | !Описание | ||
|- | |- | ||
| | |percentageOfEnvironmentSearched | ||
| | |number | ||
|Ход поиска среды в процентах. | |Ход поиска среды в процентах. | ||
|- | |- | ||
| | |nextPageKey | ||
| | |string | ||
|Курсор для следующей страницы результатов. | |Курсор для следующей страницы результатов. | ||
Строка 530: | Строка 530: | ||
Может быть другая страница результатов, даже если текущая страница пуста. | Может быть другая страница результатов, даже если текущая страница пуста. | ||
|- | |- | ||
| | |hosts | ||
| | |HostAgentInfo[] | ||
|Список хостов с информацией о развертывании | |Список хостов с информацией о развертывании ЕдиногоАгента для каждого хоста. | ||
|} | |} | ||
==== Объект | ==== Объект <code>HostAgentInfo</code> ==== | ||
Развертывание | Развертывание ЕдиногоАгента на хосте. | ||
{| class="wikitable" | {| class="wikitable" | ||
!Элемент | !Элемент | ||
Строка 542: | Строка 542: | ||
!Описание | !Описание | ||
|- | |- | ||
| | |hostInfo | ||
| | |Host | ||
|Информация о хозяине. | |Информация о хозяине. | ||
|- | |- | ||
| | |faultyVersion | ||
| | |boolean | ||
|Версия OneAgent ошибочна ( <code>true</code>) или нет ( <code>false</code>). | |Версия OneAgent ошибочна ( <code>true</code>) или нет ( <code>false</code>). | ||
|- | |- | ||
| | |active | ||
| | |boolean | ||
|OneAgent активен ( <code>true</code>) или неактивен ( <code>false</code>). | |OneAgent активен ( <code>true</code>) или неактивен ( <code>false</code>). | ||
|- | |- | ||
| | |configuredMonitoringMode | ||
| | |string | ||
|Настроен режим мониторинга OneAgent. | |Настроен режим мониторинга OneAgent. | ||
Строка 563: | Строка 563: | ||
* <code>FULL_STACK</code> | * <code>FULL_STACK</code> | ||
|- | |- | ||
| | |monitoringType | ||
| | |string | ||
|Режим мониторинга OneAgent. | |Режим мониторинга OneAgent. | ||
Строка 574: | Строка 574: | ||
|- | |- | ||
|autoUpdateSetting | |autoUpdateSetting | ||
| | |string | ||
|Эффективная настройка автоматического обновления OneAgent. Для хоста с унаследованной конфигурацией он рассчитывается на основе конфигурации его родителя. | |Эффективная настройка автоматического обновления OneAgent. Для хоста с унаследованной конфигурацией он рассчитывается на основе конфигурации его родителя. | ||
Строка 582: | Строка 582: | ||
* <code>DISABLED</code> | * <code>DISABLED</code> | ||
|- | |- | ||
| | |updateStatus | ||
| | |string | ||
|Текущий статус обновления OneAgent. | |Текущий статус обновления OneAgent. | ||
Строка 598: | Строка 598: | ||
* <code>UPDATE_PROBLEM</code> | * <code>UPDATE_PROBLEM</code> | ||
|- | |- | ||
| | |availableVersions | ||
| | |string [] | ||
|Список версий OneAgent, до которых можно обновить. | |Список версий OneAgent, до которых можно обновить. | ||
|- | |- | ||
| | |configuredMonitoringEnabled | ||
| | |boolean | ||
|Мониторинг включен ( <code>true</code>) или отключен ( <code>false</code>) в конфигурации OneAgent. | |Мониторинг включен ( <code>true</code>) или отключен ( <code>false</code>) в конфигурации OneAgent. | ||
|- | |- | ||
| | |availabilityState | ||
| | |string | ||
|Состояние доступности OneAgent. | |Состояние доступности OneAgent. | ||
Строка 621: | Строка 621: | ||
* <code>UNMONITORED</code> | * <code>UNMONITORED</code> | ||
|- | |- | ||
| | |detailedAvailabilityState | ||
| | |string | ||
|Подробное состояние доступности OneAgent. | |Подробное состояние доступности OneAgent. | ||
Строка 660: | Строка 660: | ||
|- | |- | ||
|<s>currentActiveGateId</s> | |<s>currentActiveGateId</s> | ||
| | |integer | ||
|УСТАРЕЛО | |УСТАРЕЛО | ||
Строка 668: | Строка 668: | ||
|- | |- | ||
|currentActiveGateIds | |currentActiveGateIds | ||
| | |string [] | ||
|Список идентификаторов ActiveGate для ActiveGate, к которым в данный момент подключен OneAgent. | |Список идентификаторов ActiveGate для ActiveGate, к которым в данный момент подключен OneAgent. | ||
|- | |- | ||
|currentNetworkZoneId | |currentNetworkZoneId | ||
| | |string | ||
|Идентификатор сетевой зоны, которую использует OneAgent. | |Идентификатор сетевой зоны, которую использует OneAgent. | ||
|- | |- | ||
| | |modules | ||
| | |ModuleInfo[] | ||
|Список модулей кода, развернутых на хосте. | |Список модулей кода, развернутых на хосте. | ||
|- | |- | ||
| | |plugins | ||
| | |PluginInfo[] | ||
|Список плагинов, развернутых на хосте. | |Список плагинов, развернутых на хосте. | ||
|} | |} | ||
==== Объект | ==== Объект <code>Host</code> ==== | ||
Информация о хозяине. | Информация о хозяине. | ||
{| class="wikitable" | {| class="wikitable" | ||
Строка 691: | Строка 691: | ||
!Описание | !Описание | ||
|- | |- | ||
| | |entityId | ||
| | |string | ||
|Идентификатор объекта Dynatrace требуемого объекта. | |Идентификатор объекта Dynatrace требуемого объекта. | ||
|- | |- | ||
| | |displayName | ||
| | |string | ||
|Имя объекта Dynatrace, отображаемое в пользовательском интерфейсе. | |Имя объекта 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 | ||
| - | | - | ||
Элемент может содержать эти значения | Элемент может содержать эти значения | ||
Строка 753: | Строка 753: | ||
|- | |- | ||
|paasAgentVersions | |paasAgentVersions | ||
| | |AgentVersion[] | ||
|Версии агентов PaaS, которые в настоящее время работают на объекте. | |Версии агентов PaaS, которые в настоящее время работают на объекте. | ||
|- | |- | ||
| | |ipAddresses | ||
| | |string [] | ||
| - | | - | ||
|- | |- | ||
| | |boshStemcellVersion | ||
| | |string | ||
|Версия стволовых клеток Cloud Foundry BOSH. | |Версия стволовых клеток Cloud Foundry BOSH. | ||
|- | |- | ||
| | |localIp | ||
| | |string | ||
| - | | - | ||
|- | |- | ||
| | |cloudType | ||
| | |string | ||
| - | | - | ||
Элемент может содержать эти значения | Элемент может содержать эти значения | ||
Строка 781: | Строка 781: | ||
|- | |- | ||
|CloudPlatformVendorVersion | |CloudPlatformVendorVersion | ||
| | |string | ||
|Определяет версию поставщика облачной платформы. | |Определяет версию поставщика облачной платформы. | ||
|- | |- | ||
| | |azureVmSizeLabel | ||
| | |string | ||
| - | | - | ||
|- | |- | ||
| | |zosLpaName | ||
| | |string | ||
|Имя LPAR. | |Имя LPAR. | ||
|- | |- | ||
| | |zosTotalGeneralPurposeProcessors | ||
| | |integer | ||
|Количество назначенных процессоров для этого LPAR. | |Количество назначенных процессоров для этого LPAR. | ||
|- | |- | ||
|openstackVmName | |openstackVmName | ||
| | |string | ||
| - | | - | ||
|- | |- | ||
|paasType | |paasType | ||
| | |string | ||
| - | | - | ||
Элемент может содержать эти значения | Элемент может содержать эти значения | ||
Строка 816: | Строка 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 | ||
| - | | - | ||
|- | |- | ||
| | |consumedHostUnits | ||
| | |string | ||
| - | | - | ||
|- | |- | ||
| | |autoInjection | ||
| | |string | ||
|Статус автоинъекции | |Статус автоинъекции | ||
Строка 865: | Строка 865: | ||
|- | |- | ||
|hostGroup | |hostGroup | ||
| | |HostGroup | ||
| - | | - | ||
|- | |- | ||
| | |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. | ||
|- | |- | ||
| | |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 | ||
| - | | - | ||
Элемент может содержать эти значения | Элемент может содержать эти значения | ||
Строка 945: | Строка 945: | ||
|- | |- | ||
|awsNameTag | |awsNameTag | ||
| | |string | ||
|Название унаследовано от AWS. | |Название унаследовано от AWS. | ||
|- | |- | ||
|azureVmName | |azureVmName | ||
| | |string | ||
| - | | - | ||
|- | |- | ||
|awsInstanceType | |awsInstanceType | ||
| | |string | ||
| - | | - | ||
|- | |- | ||
|boshInstanceId | |boshInstanceId | ||
| | |string | ||
|Идентификатор экземпляра Cloud Foundry BOSH. | |Идентификатор экземпляра Cloud Foundry BOSH. | ||
|- | |- | ||
| | |hypervisorType | ||
| | |string | ||
| - | | - | ||
Элемент может содержать эти значения | Элемент может содержать эти значения | ||
Строка 976: | Строка 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. | ||
|- | |- | ||
| | |azureSku | ||
| | |string | ||
| - | | - | ||
Элемент может содержать эти значения | Элемент может содержать эти значения | ||
Строка 1004: | Строка 1004: | ||
* <code>STANDARD</code> | * <code>STANDARD</code> | ||
|- | |- | ||
| | |azureEnvironment | ||
| | |string | ||
| - | | - | ||
|- | |- | ||
| | |azureZone | ||
| | |string | ||
| - | | - | ||
|- | |- | ||
| | |kubernetesCluster | ||
| | |string | ||
|Кластер kubernetes, в котором находится сущность. | |Кластер kubernetes, в котором находится сущность. | ||
|- | |- | ||
| | |logicalCpus | ||
| | |integer | ||
|Количество логических процессоров экземпляра AIX. | |Количество логических процессоров экземпляра AIX. | ||
|- | |- | ||
|gceMachineType | |gceMachineType | ||
| | |string | ||
|Тип машины Google Compute Engine. | |Тип машины Google Compute Engine. | ||
|- | |- | ||
|openStackInstaceType | |openStackInstaceType | ||
| | |string | ||
| - | | - | ||
|- | |- | ||
| | |bitness | ||
| | |string | ||
| - | | - | ||
Элемент может содержать эти значения | Элемент может содержать эти значения | ||
Строка 1037: | Строка 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. | |Пользовательское имя, указанное в конфигурации OneAgent. | ||
|- | |- | ||
| | |userLevel | ||
| | |string | ||
| - | | - | ||
Элемент может содержать эти значения | Элемент может содержать эти значения | ||
Строка 1077: | Строка 1077: | ||
* <code>SUPERUSER</code> | * <code>SUPERUSER</code> | ||
|- | |- | ||
| | |virtualCpus | ||
| | |integer | ||
|Количество виртуальных процессоров экземпляра AIX. | |Количество виртуальных процессоров экземпляра AIX. | ||
|- | |- | ||
| | |softwareTechnologies | ||
| | |TechnologyInfo[] | ||
| - | | - | ||
|- | |- | ||
|awsSecurityGroup | |awsSecurityGroup | ||
| | |string [] | ||
| - | | - | ||
|- | |- | ||
|azureResourceId | |azureResourceId | ||
| | |string | ||
| - | | - | ||
|- | |- | ||
| | |osType | ||
| | |string | ||
| - | | - | ||
Элемент может содержать эти значения | Элемент может содержать эти значения | ||
Строка 1107: | Строка 1107: | ||
|- | |- | ||
|openstackSecurityGroups | |openstackSecurityGroups | ||
| | |string [] | ||
| - | | - | ||
|- | |- | ||
| | |osArchitecture | ||
| | |string | ||
| - | | - | ||
Элемент может содержать эти значения | Элемент может содержать эти значения | ||
Строка 1125: | Строка 1125: | ||
* <code>ZOS</code> | * <code>ZOS</code> | ||
|- | |- | ||
| | |publicIp | ||
| | |string | ||
| - | | - | ||
|- | |- | ||
|zosTotalPhysicalMemory | |zosTotalPhysicalMemory | ||
| | |integer | ||
|Память, назначенная хосту (Терабайт). | |Память, назначенная хосту (Терабайт). | ||
|- | |- | ||
|zosCPUModelNumber | |zosCPUModelNumber | ||
| | |string | ||
|Номер модели процессора. | |Номер модели процессора. | ||
|- | |- | ||
|openstackAvZone | |openstackAvZone | ||
| | |string | ||
| - | | - | ||
|} | |} |
Версия 11:21, 11 октября 2022
ЕдиныйАгент на хосте API позволяет вам проверять конфигурацию экземпляров ЕдиныйАгент на ваших хостах.
Запрос создает application/json
полезную нагрузку.
GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v1/oneagents
|
Среда ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v1/oneagents
|
Аутентификация
Чтобы выполнить этот запрос, вам нужен токен доступа с проблемой доступа и каналом событий, метриками и областью топологии ( DataExport
) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
Параметр | Тип | Описание | In | Необходимый |
---|---|---|---|---|
includeDetails | boolean | Включает ( true ) или исключает ( false ) детали, которые запрашиваются у связанных объектов.
Исключение сведений может ускорить запросы. Если не установлено, то |
query | по желанию |
startTimestamp | integer | Метка времени начала запрошенного таймфрейма в миллисекундах (UTC).
Если не задано, используется отставание на 72 часа. |
query | по желанию |
endTimestamp | integer | Отметка времени окончания запрошенного таймфрейма в миллисекундах (UTC).
Если не задано, используется текущая метка времени. Срок не должен превышать 7 месяцев (214 дней). |
query | по желанию |
relativeTime | string | Относительный период времени, начиная с настоящего времени.
Если вам нужно указать относительный период времени, который не представлен в списке возможных значений, укажите startTimestamp (до 214 дней назад) и оставьте endTimestamp и relativeTime пустыми. Элемент может содержать эти значения
|
query | по желанию |
tag | string [] | Фильтрует результирующий набор хостов по указанному тегу. Вы можете указать несколько тегов в следующем формате: tag=tag1&tag=tag2 . Хост должен соответствовать всем указанным тегам.
В случае тегов «ключ-значение», таких как импортированные теги AWS или CloudFoundry, используйте следующий формат: |
query | по желанию |
entity | string [] | Фильтры приводят только к указанным хостам.
Для указания нескольких хостов используйте следующий формат: |
query | по желанию |
managementZoneId | integer | Возвращать только те хосты, которые входят в указанную зону управления.
Укажите здесь идентификатор зоны управления. |
query | по желанию |
Зона управления | string | Возвращать только те хосты, которые входят в указанную зону управления.
Укажите здесь имя зоны управления. Если задан параметр managementZoneId , этот параметр игнорируется. |
query | по желанию |
networkZoneId | string | Фильтрует результирующий набор хостов по указанной сетевой зоне.
Укажите идентификатор объекта Ключ-АСТРОМ требуемой сетевой зоны. Вы можете получить список доступных сетевых зон с помощью вызова GET all network zone . |
query | по желанию |
hostGroupId | string | Фильтрует результирующий набор хостов по указанной группе хостов.
Укажите идентификатор объекта Ключ-АСТРОМ требуемой группы хостов. |
query | по желанию |
hostGroupName | string | Фильтрует результирующий набор хостов по указанной группе хостов.
Укажите имя требуемой группы хостов. |
query | по желанию |
osType | string | Фильтрует результирующий набор хостов по типу ОС.
Элемент может содержать эти значения
|
query | по желанию |
cloudType | string | Фильтрует результирующий набор хостов по типу облака.
Элемент может содержать эти значения
|
query | по желанию |
autoInjection | string | Фильтрует результирующий набор хостов по статусу автоматической инъекции.
Элемент может содержать эти значения
|
query | по желанию |
availabilityState | string | Фильтрует результирующий набор хостов по состоянию доступности ЕдиногоАгента.
Элемент может содержать эти значения
|
query | по желанию |
detailedAvailabilityState | string | Фильтрует результирующий набор хостов по подробному состоянию доступности ЕдиногоАгента.
Элемент может содержать эти значения
|
query | по желанию |
monitoringType | string | Фильтрует результирующий набор узлов по режиму мониторинга ЕдиногоАгента, развернутого на узле.
Элемент может содержать эти значения
|
query | по желанию |
agentVersionIs | string | Отфильтровывает результирующий набор хостов по тем, на которых развернута определенная версия ЕдиногоАгента.
Укажите здесь оператор сравнения. Элемент может содержать эти значения
|
query | по желанию |
agentVersionNumber | string | Отфильтровывает результирующий набор хостов по тем, на которых развернута определенная версия ЕдиногоАгента.
Укажите версию в |
query | по желанию |
autoUpdateSetting | string | Фильтрует результирующий набор узлов по фактическому состоянию параметра автоматического обновления развернутых ЕдиныхАгентов.
Элемент может содержать эти значения
|
query | по желанию |
updateStatus | string | Фильтрует результирующий набор узлов по статусу обновления ЕдиногоАгента, развернутого на узле.
Элемент может содержать эти значения
|
query | по желанию |
faultyVersion | boolean | Отфильтровывает результирующий набор хостов, выбирая те, на которых работает версия ЕдиногоАгента, помеченная как неисправная. | query | по желанию |
ActiveGateId | string | Отфильтровывает результирующий набор хостов на те, которые в данный момент подключены к АктивномуШлюзу с указанным ID.
Используйте ключевое слово DIRECT_COMMUNICATION , чтобы найти хосты, не подключенные ни к одному АктивномуШлюзу. |
query | по желанию |
technologyModuleType | string | Отфильтровывает результирующий набор хостов до тех, на которых работает указанный модуль кода ЕдиногоАгента.
Если указано несколько фильтров модуля кода, модуль кода должен соответствовать всем фильтрам. Элемент может содержать эти значения
|
query | по желанию |
technologyModuleVersionIs | string | Отфильтровывает результирующий набор хостов для тех, на которых развернута определенная версия модуля кода.
Укажите здесь оператор сравнения. Если указано несколько фильтров модуля кода, модуль кода должен соответствовать всем фильтрам. Элемент может содержать эти значения
|
query | по желанию |
technologyModuleVersionNumber | string | Отфильтровывает результирующий набор хостов для тех, на которых развернута определенная версия модуля кода.
Укажите версию в Если указано несколько фильтров модуля кода, модуль кода должен соответствовать всем фильтрам. |
query | по желанию |
technologyModuleFaultyVersion | boolean | Отфильтровывает результирующий набор хостов до тех, на которых работает версия модуля кода, помеченная как неисправная.
Если указано несколько фильтров модуля кода, модуль кода должен соответствовать всем фильтрам. |
query | по желанию |
pluginName | string | Отфильтровывает результирующий набор хостов до тех, на которых работает плагин с указанным именем.
Оператор CONTAINS применяется к указанному значению. Если указано несколько фильтров плагина, плагин должен соответствовать всем фильтрам. |
query | по желанию |
pluginVersionIs | string | Отфильтровывает результирующий набор хостов до тех, на которых развернута определенная версия плагина.
Укажите здесь оператор сравнения. Если указано несколько фильтров плагина, плагин должен соответствовать всем фильтрам. Элемент может содержать эти значения
|
query | по желанию |
pluginVersionNumber | string | Отфильтровывает результирующий набор хостов до тех, на которых развернута определенная версия плагина.
Укажите версию в
Если указано несколько фильтров плагина, плагин должен соответствовать всем фильтрам. |
query | по желанию |
pluginState | string | Отфильтровывает результирующий набор хостов до тех, на которых работает плагин с указанным состоянием.
Элемент может содержать эти значения
|
query | по желанию |
nextPageKey | string | Курсор для следующей страницы результатов, если результаты не помещаются на одной странице. Вы можете найти значение курсора на текущей странице ответа, в поле nextPageKey .
Чтобы получить последующие страницы, вы должны указать это значение курсора в своем запросе, а все остальные параметры запроса оставить такими, какими они были в исходном запросе. Если вы не укажете курсор, всегда будет возвращаться первая страница. |
query | по желанию |
Ответ
Коды ответов
Код | Тип | Описание |
---|---|---|
200 | HostsListPage | Успех |
Объекты тела ответа
Объект HostsListPage
Список хостов с информацией о развертывании ЕдиногоАгента для каждого хоста.
Элемент | Тип | Описание |
---|---|---|
percentageOfEnvironmentSearched | number | Ход поиска среды в процентах. |
nextPageKey | string | Курсор для следующей страницы результатов.
Имеет значение Может быть другая страница результатов, даже если текущая страница пуста. |
hosts | HostAgentInfo[] | Список хостов с информацией о развертывании ЕдиногоАгента для каждого хоста. |
Объект HostAgentInfo
Развертывание ЕдиногоАгента на хосте.
Элемент | Тип | Описание |
---|---|---|
hostInfo | Host | Информация о хозяине. |
faultyVersion | boolean | Версия OneAgent ошибочна ( true ) или нет ( false ).
|
active | boolean | OneAgent активен ( true ) или неактивен ( false ).
|
configuredMonitoringMode | string | Настроен режим мониторинга OneAgent.
Элемент может содержать эти значения
|
monitoringType | string | Режим мониторинга OneAgent.
Элемент может содержать эти значения
|
autoUpdateSetting | string | Эффективная настройка автоматического обновления OneAgent. Для хоста с унаследованной конфигурацией он рассчитывается на основе конфигурации его родителя.
Элемент может содержать эти значения
|
updateStatus | string | Текущий статус обновления OneAgent.
Элемент может содержать эти значения
|
availableVersions | string [] | Список версий OneAgent, до которых можно обновить. |
configuredMonitoringEnabled | boolean | Мониторинг включен ( true ) или отключен ( false ) в конфигурации OneAgent.
|
availabilityState | string | Состояние доступности OneAgent.
Элемент может содержать эти значения
|
detailedAvailabilityState | string | Подробное состояние доступности OneAgent.
Элемент может содержать эти значения
|
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 | -
Элемент может содержать эти значения
|
paasAgentVersions | AgentVersion[] | Версии агентов PaaS, которые в настоящее время работают на объекте. |
ipAddresses | string [] | - |
boshStemcellVersion | string | Версия стволовых клеток Cloud Foundry BOSH. |
localIp | string | - |
cloudType | string | -
Элемент может содержать эти значения
|
CloudPlatformVendorVersion | string | Определяет версию поставщика облачной платформы. |
azureVmSizeLabel | string | - |
zosLpaName | string | Имя LPAR. |
zosTotalGeneralPurposeProcessors | integer | Количество назначенных процессоров для этого LPAR. |
openstackVmName | string | - |
paasType | string | -
Элемент может содержать эти значения
|
azureVmScaleSetName | string | - |
zosSystemName | string | Название системы. |
azureResourceGroupName | string | - |
networkZoneId | string | Идентификатор сетевой зоны, в которой находится объект. |
azureHostNames | string [] | - |
agentVersion | AgentVersion | Определяет версию агента, работающего в данный момент на объекте. |
paasMemoryLimit | integer | - |
vmwareName | string | - |
consumedHostUnits | string | - |
autoInjection | string | Статус автоинъекции
Элемент может содержать эти значения
|
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 | -
Элемент может содержать эти значения
|
awsNameTag | string | Название унаследовано от AWS. |
azureVmName | string | - |
awsInstanceType | string | - |
boshInstanceId | string | Идентификатор экземпляра Cloud Foundry BOSH. |
hypervisorType | string | -
Элемент может содержать эти значения
|
simultaneousMultithreading | integer | Количество одновременных потоков экземпляра AIX. |
gcePublicIpAddresses | string [] | Общедоступные IP-адреса Google Compute Engine. |
logicalCpuCores | integer | - |
boshInstanceName | string | Имя экземпляра Cloud Foundry BOSH. |
azureSku | string | -
Элемент может содержать эти значения
|
azureEnvironment | string | - |
azureZone | string | - |
kubernetesCluster | string | Кластер kubernetes, в котором находится сущность. |
logicalCpus | integer | Количество логических процессоров экземпляра AIX. |
gceMachineType | string | Тип машины Google Compute Engine. |
openStackInstaceType | string | - |
bitness | string | -
Элемент может содержать эти значения
|
gceProject | string | Проект Google Compute Engine. |
kubernetesLabels | object | Метки kubernetes, определенные для объекта. |
autoScalingGroup | string | - |
gceInstanceId | string | Идентификатор экземпляра Google Compute Engine. |
osVersion | string | - |
amiId | string | - |
isMonitoringCandidate | boolean | - |
oneAgentCustomHostName | string | Пользовательское имя, указанное в конфигурации OneAgent. |
userLevel | string | -
Элемент может содержать эти значения
|
virtualCpus | integer | Количество виртуальных процессоров экземпляра AIX. |
softwareTechnologies | TechnologyInfo[] | - |
awsSecurityGroup | string [] | - |
azureResourceId | string | - |
osType | string | -
Элемент может содержать эти значения
|
openstackSecurityGroups | string [] | - |
osArchitecture | string | -
Элемент может содержать эти значения
|
publicIp | string | - |
zosTotalPhysicalMemory | integer | Память, назначенная хосту (Терабайт). |
zosCPUModelNumber | string | Номер модели процессора. |
openstackAvZone | string | - |
Объект _ TagInfo
Тег сущности Dynatrace.
Элемент | Тип | Описание |
---|---|---|
контекст | нить | Происхождение тега, например AWS или Cloud Foundry.
Пользовательские теги используют это Элемент может содержать эти значения
|
ключ | нить | Ключ тега.
Пользовательские теги имеют значение тега здесь. |
ценность | нить | Значение тега.
Не применимо к пользовательским тегам. |
Объект _ EntityShortRepresentation
Краткое представление объекта Dynatrace.
Элемент | Тип | Описание |
---|---|---|
я бы | нить | Идентификатор объекта Dynatrace. |
имя | нить | Имя объекта Dynatrace. |
описание | нить | Краткое описание сущности Dynatrace. |
Объект _ AgentVersion
Определяет версию агента, работающего в данный момент на объекте.
Элемент | Тип | Описание |
---|---|---|
главный | целое число | Номер основной версии. |
незначительный | целое число | Младший номер версии. |
ревизия | целое число | Номер ревизии. |
отметка времени | нить | Строка временной метки: формат "ггггммдд-ччммсс |
Исходная версия | нить | Строковое представление номера версии SVN. |
Объект _ HostGroup
Элемент | Тип | Описание |
---|---|---|
meId | нить | Идентификатор объекта Dynatrace группы хостов. |
имя | нить | Имя объекта Dynatrace, отображаемое в пользовательском интерфейсе. |
Объект _ TechnologyInfo
Элемент | Тип | Описание |
---|---|---|
тип | нить | - |
версия | нить | - |
версия | нить | - |
Объект _ ModuleInfo
Модуль кода OneAgent.
Элемент | Тип | Описание |
---|---|---|
тип модуля | нить | Тип модуля кода.
Элемент может содержать эти значения
|
экземпляры | Экземпляр модуля [] | Список экземпляров модуля кода. |
Объект _ ModuleInstance
Экземпляр модуля кода OneAgent.
Элемент | Тип | Описание |
---|---|---|
имя_экземпляра | нить | Имя экземпляра. |
модульВерсия | нить | Версия модуля кода. |
ошибочная версия | логический | Версия кодового модуля ошибочна ( true ) или нет ( false ).
|
активный | логический | Экземпляр модуля кода активен ( true ) или неактивен ( false ).
|
Объект _ PluginInfo
Плагин OneAgent.
Элемент | Тип | Описание |
---|---|---|
имя_плагина | нить | Название плагина. |
экземпляры | Экземпляр плагина [] | Список экземпляров плагина. |
Объект _ PluginInstance
Экземпляр подключаемого модуля OneAgent.
Элемент | Тип | Описание |
---|---|---|
версия плагина | нить | Версия плагина. |
государство | нить | Состояние экземпляра плагина. |
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": "Dynatrace entity",
"description": "Dynatrace 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"
}
]
}
]
}
]
}