Dynatrace
Dynatrace обеспечивает оптимальную наблюдаемость в классе с помощью открытой платформы с поддержкой искусственного интеллекта. Этот соединитель содержит конечные точки для интерфейса "Проблемы Dynatrace".
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Поддержка Dynatrace |
| URL | https://www.dynatrace.com/services-support/ |
| Адрес электронной почты | microsoftalliances@dynatrace.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Dynatrace |
| Веб-сайт | https://www.dynatrace.com/ |
| Политика конфиденциальности | https://www.dynatrace.com/company/trust-center/privacy/ |
| Категории | Искусственный интеллект; Бизнес-аналитика |
Dynatrace является лидером в облачной наблюдаемости, используя ИИ и автоматизацию для мониторинга и оптимизации производительности приложений, разработки, безопасности, взаимодействия с пользователем и т. д. ИИ Дэвиса Dynatrace обеспечивает точный анализ первопричин проблем вашей среды. Используя соединитель Dynatrace, вы можете использовать аналитические сведения из API проблем Dynatrace, проблем безопасности, событий и метрик для анализа данных среды для выполнения любых действий с доступными соединителями в библиотеке Майкрософт. Дополнительные сведения об API Dynatrace см. здесь.
Предпосылки
Для использования соединителя потребуется следующее:
Платформа аналитики программного обеспечения Dynatrace. Чтобы приступить к работе, щелкните здесь
Создайте маркер доступа API к платформе Dynatrace с помощью следующих областей:
- Проблемы с чтением
- Проблемы с записью
- Чтение событий
- Прием событий
- Чтение entites
- Чтение проблем безопасности
Разверните OneAgent по крайней мере в приложении. Здесь приведены примеры приложений и семинаров для запуска приложений с помощью Azure в клиенте.
Получение учетных данных
- Вам потребуется клиент Dynatrace и ключ API. Следуйте инструкциям в разделе "Предварительные требования", чтобы создать оба.
Начало работы с соединителем
- Создание PowerApps, Потока PowerAutomate или приложения логики
- В разделе конструктора этих объектов добавьте соединитель Dynatrace.
- Чтобы начать использование соединителя, необходимо ввести URL-адрес клиента и ключ API. Следуйте приведенным выше инструкциям, чтобы получить оба элемента.
- Входной URL-адрес клиента должен быть в формате: abc123.dynatrace.com
- Ключ API должен быть введен в формате: Api-Token dt1234. ABCDEFGH
Известные проблемы и ограничения
У пользователя должен быть клиент Dynatrace, чтобы использовать этот соединитель
Распространенные ошибки и средства устранения неполадок
- Убедитесь, что входной клиент находится в формате "abc123.dynatrace.com"
- Если вы получаете ошибки проверки подлинности, убедитесь, что вы создали ключ API с соответствующими областями, перечисленными выше.
Часто задаваемые вопросы
Будет обновлено по мере того, как задаются вопросы.
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Ключ API | securestring | Ключ API для этого API (Api-Token dt1234. ABCDEFGH) | True |
| Клиент Dynatrace | струна | URL-адрес клиента. (abc123.dynatrace.com) | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Получение комментария проблемы по идентификатору проблемы |
Возвращает все комментарии по указанной проблеме |
| Получение комментария проблемы по идентификатору проблемы и идентификатору примечания |
Возвращает указанный комментарий о проблеме. |
| Получение проблем |
Выводит список проблем, наблюдаемых в течение указанного интервала времени. |
| Получение проблем безопасности по идентификатору |
Получение параметров проблем безопасности |
| Получение проблем с безопасностью |
Список всех проблем безопасности |
| Получение проблемы по идентификатору |
Возвращает свойства указанной проблемы. |
| Получение сущностей |
Возвращает сведения о отслеживаемых entites |
| Получение сущности по идентификатору |
Возвращает свойства указанной отслеживаемой сущности |
| Получить события |
Выводит список событий в течение указанного интервала времени |
| Прием событий после публикации |
Прием настраиваемого события |
| Примечание к проблеме |
Добавляет новый комментарий к указанной проблеме |
Получение комментария проблемы по идентификатору проблемы
Возвращает все комментарии по указанной проблеме
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проблемы
|
problemId | True | string |
Идентификатор проблемы |
Получение комментария проблемы по идентификатору проблемы и идентификатору примечания
Возвращает указанный комментарий о проблеме.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проблемы
|
problemId | True | string |
Идентификатор требуемой проблемы |
|
Идентификатор комментария
|
commentId | True | string |
Идентификатор требуемого комментария |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
id
|
id | string |
Идентификатор комментария |
|
createdAtTimestamp
|
createdAtTimestamp | integer |
Создание метки времени |
|
содержимое
|
content | string |
Содержимое примечания |
|
authorName
|
authorName | string |
Имя автора комментариев |
Получение проблем
Выводит список проблем, наблюдаемых в течение указанного интервала времени.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Диапазон времени
|
from | string |
Диапазон запроса. Пример: "now-1d" |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
totalCount
|
totalCount | integer |
Общее число |
|
pageSize
|
pageSize | integer |
Размер страницы |
|
nextPageKey
|
nextPageKey | string |
Ключ следующей страницы |
|
Проблемы
|
problems | array of object |
Проблемы |
|
затронутые сущности
|
problems.affectedEntities | array of object |
Затронутые сущности |
|
id
|
problems.affectedEntities.entityId.id | string |
Идентификатор затронутой сущности |
|
type
|
problems.affectedEntities.entityId.type | string |
Затронутый тип сущности |
|
имя
|
problems.affectedEntities.name | string |
Имя затронутой сущности |
|
displayId
|
problems.displayId | string |
Идентификатор отображения |
|
impactedEntities
|
problems.impactedEntities | array of object |
Затронутые сущности |
|
id
|
problems.impactedEntities.entityId.id | string |
Идентификатор затронутой сущности |
|
type
|
problems.impactedEntities.entityId.type | string |
Затронутый тип сущности |
|
имя
|
problems.impactedEntities.name | string |
Имя затронутой сущности |
|
displayId
|
problems.linkedProblemInfo.displayId | string |
Идентификатор отображения связанной проблемы |
|
problemId
|
problems.linkedProblemInfo.problemId | string |
Идентификатор связанной проблемы |
|
проблемыFilters
|
problems.problemFilters | array of object |
Фильтры проблем |
|
имя
|
problems.problemFilters.name | string |
Имя фильтра проблем |
|
id
|
problems.problemFilters.id | string |
Идентификатор фильтра проблем |
|
totalCount
|
problems.evidenceDetails.totalCount | integer |
Общее число |
|
details
|
problems.evidenceDetails.details | array of object |
Сведения |
|
evidenceType
|
problems.evidenceDetails.details.evidenceType | string |
Тип доказательства |
|
отображаемое имя
|
problems.evidenceDetails.details.displayName | string |
Отображаемое имя |
|
id
|
problems.evidenceDetails.details.entity.entityId.id | string |
Идентификатор сущности сведений о доказательствах |
|
type
|
problems.evidenceDetails.details.entity.entityId.type | string |
Тип сущности сведений о доказательствах |
|
имя
|
problems.evidenceDetails.details.entity.name | string |
Имя сущности сведений о доказательствах |
|
id
|
problems.evidenceDetails.details.groupingEntity.entityId.id | string |
Идентификатор сущности группировки |
|
type
|
problems.evidenceDetails.details.groupingEntity.entityId.type | string |
Тип сущности группировки |
|
имя
|
problems.evidenceDetails.details.groupingEntity.name | string |
Имя сущности группировки |
|
rootCauseRelevant
|
problems.evidenceDetails.details.rootCauseRelevant | boolean |
Релевантная первопричина |
|
startTime
|
problems.evidenceDetails.details.startTime | integer |
Время запуска сведений о доказательствах |
|
comments
|
problems.recentComments.comments | array of object |
Comments |
|
createdAtTimestamp
|
problems.recentComments.comments.createdAtTimestamp | integer |
Комментарий, созданный в метке времени |
|
authorName
|
problems.recentComments.comments.authorName | string |
Имя автора комментариев |
|
context
|
problems.recentComments.comments.context | string |
Контекст примечания |
|
id
|
problems.recentComments.comments.id | string |
Идентификатор комментария |
|
содержимое
|
problems.recentComments.comments.content | string |
Содержимое примечания |
|
pageSize
|
problems.recentComments.pageSize | integer |
PageSize |
|
nextPageKey
|
problems.recentComments.nextPageKey | string |
Ключ следующей страницы |
|
totalCount
|
problems.recentComments.totalCount | integer |
Общее число |
|
Воздействия
|
problems.impactAnalysis.impacts | array of object |
Воздействия |
|
impactType
|
problems.impactAnalysis.impacts.impactType | string |
Тип влияния |
|
id
|
problems.impactAnalysis.impacts.impactedEntity.entityId.id | string |
Идентификатор затронутой сущности |
|
type
|
problems.impactAnalysis.impacts.impactedEntity.entityId.type | string |
Затронутый тип сущности |
|
имя
|
problems.impactAnalysis.impacts.impactedEntity.name | string |
Имя затронутой сущности |
|
ОценкаAffectedUsers
|
problems.impactAnalysis.impacts.estimatedAffectedUsers | integer |
Предполагаемые затронутые пользователи |
|
id
|
problems.rootCauseEntity.entityId.id | string |
Идентификатор сущности корневой причины |
|
type
|
problems.rootCauseEntity.entityId.type | string |
Тип первопричин |
|
имя
|
problems.rootCauseEntity.name | string |
Имя сущности первопричины |
|
managementZones
|
problems.managementZones | array of object |
Зоны управления |
|
имя
|
problems.managementZones.name | string |
Имя зоны управления |
|
id
|
problems.managementZones.id | string |
Идентификатор зоны управления |
|
серьезностьLevel
|
problems.severityLevel | string |
Уровень серьезности |
|
entityTags
|
problems.entityTags | array of object |
Теги сущностей |
|
stringRepresentation
|
problems.entityTags.stringRepresentation | string |
Представление строки тега сущности |
|
value
|
problems.entityTags.value | string |
Значение тега сущности |
|
key
|
problems.entityTags.key | string |
Ключ тега сущности |
|
context
|
problems.entityTags.context | string |
Контекст тега сущности |
|
problemId
|
problems.problemId | string |
Идентификатор проблемы |
|
impactLevel
|
problems.impactLevel | string |
Уровень влияния |
|
статус
|
problems.status | string |
Состояние |
|
startTime
|
problems.startTime | integer |
Время начала |
|
endTime
|
problems.endTime | integer |
Время окончания |
|
title
|
problems.title | string |
Название |
|
Предупреждения
|
warnings | array of string |
Warnings |
Получение проблем безопасности по идентификатору
Получение параметров проблем безопасности
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проблемы Secuirty
|
id | True | string |
Идентификатор указанной проблемы безопасности |
|
Fields
|
fields | string |
Список дополнительных свойств проблемы безопасности, которые можно добавить в ответ. Чтобы добавить свойства, укажите их в разделенном запятыми списке и префиксе каждого свойства плюсом (например, +riskAssessment,+managementZones). |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
securityProblemId
|
securityProblemId | string |
Идентификатор проблемы безопасности |
|
displayId
|
displayId | string |
Идентификатор отображения |
|
статус
|
status | string |
Состояние |
|
приглушенный
|
muted | boolean |
Приглушенный |
|
externalVulnerabilityId
|
externalVulnerabilityId | string |
Идентификатор внешней уязвимости |
|
уязвимостьType
|
vulnerabilityType | string |
Тип уязвимости |
|
title
|
title | string |
Название |
|
packageName
|
packageName | string |
Название пакета |
|
URL-адрес
|
url | string |
URL |
|
описание
|
description | string |
Description |
|
Технологии
|
technology | string |
Технология |
|
firstSeenTimestamp
|
firstSeenTimestamp | integer |
Первый просмотр метки времени |
|
LastUpdatedTimestamp
|
lastUpdatedTimestamp | integer |
Последняя обновленная метка времени |
|
riskLevel
|
riskAssessment.riskLevel | string |
Уровень риска |
|
|
riskAssessment.riskScore | float |
Оценка риска |
|
riskVector
|
riskAssessment.riskVector | string |
Вектор риска |
|
baseRiskLevel
|
riskAssessment.baseRiskLevel | string |
Базовый уровень риска |
|
|
riskAssessment.baseRiskScore | float |
Базовая оценка риска |
|
baseRiskVector
|
riskAssessment.baseRiskVector | string |
Базовый вектор риска |
|
экспозиция
|
riskAssessment.exposure | string |
Экспозиция |
|
dataAssets
|
riskAssessment.dataAssets | string |
Ресурсы данных |
|
publicExploit
|
riskAssessment.publicExploit | string |
Общедоступный эксплойт |
|
vulnerableFunctionUsage
|
riskAssessment.vulnerableFunctionUsage | string |
Использование уязвимой функции |
|
managementZones
|
managementZones | array of object |
Зоны управления |
|
имя
|
managementZones.name | string |
Имя зоны управления |
|
id
|
managementZones.id | string |
Идентификатор зоны управления |
|
cveIds
|
cveIds | array of string |
Идентификаторы CVE |
|
events
|
events | array of object |
Events |
|
отметка времени
|
events.timestamp | integer |
Метка времени события |
|
причина
|
events.reason | string |
Причина события |
|
numberOfAffectedEntities
|
events.riskAssessmentSnapshot.numberOfAffectedEntities | integer |
Количество затронутых сущностей |
|
numberOfReachableDataAssets
|
events.riskAssessmentSnapshot.numberOfReachableDataAssets | integer |
Количество доступных ресурсов данных |
|
publicExploit
|
events.riskAssessmentSnapshot.publicExploit | string |
Общедоступный эксплойт |
|
экспозиция
|
events.riskAssessmentSnapshot.exposure | string |
Экспозиция |
|
vulnerableFunctionUsage
|
events.riskAssessmentSnapshot.vulnerableFunctionUsage | string |
Использование уязвимой функции |
|
Пользователь
|
events.muteState.user | string |
Отключить пользователь состояния |
|
причина
|
events.muteState.reason | string |
Причина отключения состояния |
|
Комментарий
|
events.muteState.comment | string |
Отключение примечания состояния |
|
уязвимые компоненты
|
vulnerableComponents | array of object |
Уязвимые компоненты |
|
id
|
vulnerableComponents.id | string |
Идентификатор уязвимых компонентов |
|
отображаемое имя
|
vulnerableComponents.displayName | string |
Отображаемое имя уязвимых Componenets |
|
fileName
|
vulnerableComponents.fileName | string |
Имя файла уязвимых компонентов |
|
numberOfAffectedEntities
|
vulnerableComponents.numberOfAffectedEntities | integer |
Уязвимые компоненты числа затронутых сущностей |
|
затронутые сущности
|
vulnerableComponents.affectedEntities | array of string |
Затронутые сущности |
|
затронутые сущности
|
affectedEntities | array of string |
Затронутые сущности |
|
exposedEntities
|
exposedEntities | array of string |
Предоставляемые сущности |
|
reachableDataAssets
|
reachableDataAssets | array of string |
Доступные ресурсы данных |
|
Приложения
|
relatedEntities.applications | array of object |
Приложения |
|
id
|
relatedEntities.applications.id | string |
Идентификатор приложения |
|
numberOfAffectedEntities
|
relatedEntities.applications.numberOfAffectedEntities | integer |
Количество затронутых сущностей |
|
затронутые сущности
|
relatedEntities.applications.affectedEntities | array of string |
Затронутые приложения сущности |
|
services
|
relatedEntities.services | array of object |
Services |
|
id
|
relatedEntities.services.id | string |
Идентификатор службы |
|
numberOfAffectedEntities
|
relatedEntities.services.numberOfAffectedEntities | integer |
Номер службы затронутых сущностей |
|
затронутые сущности
|
relatedEntities.services.affectedEntities | array of string |
Затронутые службы сущности |
|
экспозиция
|
relatedEntities.services.exposure | string |
Экспозиция |
|
hosts
|
relatedEntities.hosts | array of object |
Hosts |
|
id
|
relatedEntities.hosts.id | string |
Идентификатор узла |
|
numberOfAffectedEntities
|
relatedEntities.hosts.numberOfAffectedEntities | integer |
Количество затронутых сущностей |
|
затронутые сущности
|
relatedEntities.hosts.affectedEntities | array of string |
Затронутые узла сущности |
|
Баз данных
|
relatedEntities.databases | array of string |
Databases |
|
kubernetesWorkloads
|
relatedEntities.kubernetesWorkloads | array of object |
Рабочие нагрузки Kubernetes |
|
id
|
relatedEntities.kubernetesWorkloads.id | string |
Идентификатор рабочей нагрузки Kubernetes |
|
numberOfAffectedEntities
|
relatedEntities.kubernetesWorkloads.numberOfAffectedEntities | integer |
Число рабочих нагрузок Kubernetes затронутых сущностей |
|
затронутые сущности
|
relatedEntities.kubernetesWorkloads.affectedEntities | array of string |
Затронутые сущности рабочей нагрузки Kubernetes |
|
kubernetesClusters
|
relatedEntities.kubernetesClusters | array of object |
Кластеры Kubernetes |
|
id
|
relatedEntities.kubernetesClusters.id | string |
Идентификатор кластера Kubernetes |
|
numberOfAffectedEntities
|
relatedEntities.kubernetesClusters.numberOfAffectedEntities | integer |
Число затронутых сущностей Kubernetes Cluder |
|
затронутые сущности
|
relatedEntities.kubernetesClusters.affectedEntities | array of string |
Затронутые сущности кластера Kubernetes |
|
containerImages
|
relatedContainerImages.containerImages | array of object |
Образы контейнера |
|
imageId
|
relatedContainerImages.containerImages.imageId | string |
Идентификатор связанного образа контейнера |
|
imageName
|
relatedContainerImages.containerImages.imageName | string |
Имя связанного образа контейнера |
|
numberOfAffectedEntities
|
relatedContainerImages.containerImages.numberOfAffectedEntities | integer |
Связанное число контейнеров затронутых сущностей |
|
затронутые сущности
|
relatedContainerImages.containerImages.affectedEntities | array of string |
Связанные сущности, затронутые контейнером |
|
muteStateChangeInProgresss
|
muteStateChangeInProgress | boolean |
Изменение состояния отключения при выполнении |
Получение проблем с безопасностью
Список всех проблем безопасности
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Селектор проблем безопасности
|
securityProblemSelector | string |
Определяет область запроса. В ответ включаются только проблемы безопасности, соответствующие указанным критериям. |
|
|
Диапазон времени
|
from | string |
Начало запрошенного интервала времени |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
totalCount
|
totalCount | integer |
Общее число |
|
pageSize
|
pageSize | integer |
Размер страницы |
|
nextPageKey
|
nextPageKey | string |
Ключ следующей страницы |
|
SecurityProblems
|
securityProblems | array of object |
Проблемы безопасности |
|
securityProblemId
|
securityProblems.securityProblemId | string |
Идентификатор проблемы безопасности |
|
displayId
|
securityProblems.displayId | string |
Идентификатор отображения |
|
статус
|
securityProblems.status | string |
Состояние |
|
приглушенный
|
securityProblems.muted | boolean |
Приглушенный |
|
externalVulnerabilityId
|
securityProblems.externalVulnerabilityId | string |
Идентификатор внешней уязвимости |
|
уязвимостьType
|
securityProblems.vulnerabilityType | string |
Тип уязвимости |
|
title
|
securityProblems.title | string |
Название |
|
packageName
|
securityProblems.packageName | string |
Название пакета |
|
URL-адрес
|
securityProblems.url | string |
URL |
|
Технологии
|
securityProblems.technology | string |
Технология |
|
firstSeenTimestamp
|
securityProblems.firstSeenTimestamp | integer |
Первый просмотр метки времени |
|
LastUpdatedTimestamp
|
securityProblems.lastUpdatedTimestamp | integer |
Последняя обновленная метка времени |
|
riskLevel
|
securityProblems.riskAssessment.riskLevel | string |
Уровень риска |
|
riskScore
|
securityProblems.riskAssessment.riskScore | integer |
Оценка риска |
|
riskVector
|
securityProblems.riskAssessment.riskVector | string |
Вектор риска |
|
baseRiskLevel
|
securityProblems.riskAssessment.baseRiskLevel | string |
Базовый уровень риска |
|
baseRiskScore
|
securityProblems.riskAssessment.baseRiskScore | integer |
Базовая оценка риска |
|
baseRiskVector
|
securityProblems.riskAssessment.baseRiskVector | string |
Базовый вектор риска |
|
экспозиция
|
securityProblems.riskAssessment.exposure | string |
Экспозиция |
|
dataAssets
|
securityProblems.riskAssessment.dataAssets | string |
Ресурсы данных |
|
publicExploit
|
securityProblems.riskAssessment.publicExploit | string |
Общедоступный эксплойт |
|
vulnerableFunctionUsage
|
securityProblems.riskAssessment.vulnerableFunctionUsage | string |
Использование уязвимой функции |
|
managementZones
|
securityProblems.managementZones | array of object |
Зоны управления |
|
имя
|
securityProblems.managementZones.name | string |
Имя зоны управления |
|
id
|
securityProblems.managementZones.id | string |
Идентификатор зоны управления |
|
cveIds
|
securityProblems.cveIds | array of string |
Идентификаторы CVE |
Получение проблемы по идентификатору
Возвращает свойства указанной проблемы.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проблемы
|
problem_id | True | string |
Идентификатор требуемой проблемы |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
details
|
evidenceDetails.details | array of object |
Сведения |
|
evidenceType
|
evidenceDetails.details.evidenceType | string |
Тип доказательства |
|
отображаемое имя
|
evidenceDetails.details.displayName | string |
Отображаемое имя |
|
id
|
evidenceDetails.details.entity.entityId.id | string |
Идентификатор сущности доказательства |
|
type
|
evidenceDetails.details.entity.entityId.type | string |
Тип сущности Доказательства |
|
имя
|
evidenceDetails.details.entity.name | string |
Имя сущности доказательства |
|
id
|
evidenceDetails.details.groupingEntity.entityId.id | string |
Идентификатор сущности группировки |
|
type
|
evidenceDetails.details.groupingEntity.entityId.type | string |
Тип сущности группировки |
|
имя
|
evidenceDetails.details.groupingEntity.name | string |
Имя сущности группировки |
|
rootCauseRelevant
|
evidenceDetails.details.rootCauseRelevant | boolean |
Релевантная первопричина |
|
startTime
|
evidenceDetails.details.startTime | integer |
Время начала сведений о доказательствах |
|
totalCount
|
evidenceDetails.totalCount | integer |
Общее число сведений о доказательствах |
|
comments
|
recentComments.comments | array of object |
Comments |
|
authorName
|
recentComments.comments.authorName | string |
Имя автора последних комментариев |
|
createdAtTimestamp
|
recentComments.comments.createdAtTimestamp | integer |
Последние комментарии, созданные в метке времени |
|
context
|
recentComments.comments.context | string |
Контекст последних комментариев |
|
id
|
recentComments.comments.id | string |
Идентификатор последних комментариев |
|
содержимое
|
recentComments.comments.content | string |
Последнее содержимое примечаний |
|
pageSize
|
recentComments.pageSize | integer |
Размер страницы последних комментариев |
|
nextPageKey
|
recentComments.nextPageKey | string |
Последние комментарии на следующей странице |
|
totalCount
|
recentComments.totalCount | integer |
Общее количество последних комментариев |
|
displayId
|
linkedProblemInfo.displayId | string |
Идентификатор отображения связанной проблемы |
|
problemId
|
linkedProblemInfo.problemId | string |
Идентификатор связанной проблемы |
|
id
|
rootCauseEntity.entityId.id | string |
Идентификатор сущности корневой причины |
|
type
|
rootCauseEntity.entityId.type | string |
Тип сущности корневой причины |
|
имя
|
rootCauseEntity.name | string |
Имя сущности первопричины |
|
impactedEntities
|
impactedEntities | array of object |
Затронутые сущности |
|
id
|
impactedEntities.entityId.id | string |
Идентификатор затронутой сущности |
|
type
|
impactedEntities.entityId.type | string |
Затронутый тип сущности |
|
имя
|
impactedEntities.name | string |
Имя затронутой сущности |
|
Воздействия
|
impactAnalysis.impacts | array of object |
Воздействия |
|
impactType
|
impactAnalysis.impacts.impactType | string |
Тип влияния |
|
id
|
impactAnalysis.impacts.impactedEntity.entityId.id | string |
Идентификатор затронутой сущности |
|
type
|
impactAnalysis.impacts.impactedEntity.entityId.type | string |
Затронутый тип сущности |
|
имя
|
impactAnalysis.impacts.impactedEntity.name | string |
Имя затронутой сущности |
|
ОценкаAffectedUsers
|
impactAnalysis.impacts.estimatedAffectedUsers | integer |
Предполагаемые затронутые пользователи |
|
проблемыFilters
|
problemFilters | array of object |
Фильтры проблем |
|
имя
|
problemFilters.name | string |
Имя фильтров проблем |
|
id
|
problemFilters.id | string |
Идентификатор фильтров проблем |
|
impactLevel
|
impactLevel | string |
Уровень влияния |
|
displayId
|
displayId | string |
Идентификатор отображения |
|
затронутые сущности
|
affectedEntities | array of object |
Затронутые сущности |
|
id
|
affectedEntities.entityId.id | string |
Идентификатор затронутой сущности |
|
type
|
affectedEntities.entityId.type | string |
Затронутый тип сущности |
|
имя
|
affectedEntities.name | string |
Имя затронутой сущности |
|
managementZones
|
managementZones | array of object |
Зоны управления |
|
имя
|
managementZones.name | string |
Имя зоны управления |
|
id
|
managementZones.id | string |
Идентификатор зоны управления |
|
серьезностьLevel
|
severityLevel | string |
Уровень серьезности |
|
entityTags
|
entityTags | array of object |
Теги сущностей |
|
stringRepresentation
|
entityTags.stringRepresentation | string |
Представление строки тега сущности |
|
value
|
entityTags.value | string |
Значение тега сущности |
|
key
|
entityTags.key | string |
Ключ тега сущности |
|
context
|
entityTags.context | string |
Контекст тега сущности |
|
problemId
|
problemId | string |
Идентификатор проблемы |
|
статус
|
status | string |
Состояние |
|
startTime
|
startTime | integer |
Время начала |
|
endTime
|
endTime | integer |
Время окончания |
|
title
|
title | string |
Название |
Получение сущностей
Возвращает сведения о отслеживаемых entites
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Селектор сущностей
|
entitySelector | True | string |
Определяет область запроса. В ответ включаются только сущности, соответствующие указанным критериям. |
|
Диапазон времени
|
from | string |
Начало запрошенного интервала времени. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
totalCount
|
totalCount | integer |
Общее число |
|
pageSize
|
pageSize | integer |
Размер страницы |
|
nextPageKey
|
nextPageKey | string |
Ключ следующей страницы |
|
entities
|
entities | array of object |
Entities |
|
entityId
|
entities.entityId | string |
Идентификатор организации |
|
type
|
entities.type | string |
Тип сущности |
|
отображаемое имя
|
entities.displayName | string |
Отображаемое имя сущности |
|
primaryIconType
|
entities.icon.primaryIconType | string |
Тип первичного значка |
|
secondaryIconType
|
entities.icon.secondaryIconType | string |
Тип дополнительного значка |
|
customIconPath
|
entities.icon.customIconPath | string |
Путь к пользовательскому значку |
|
firstSeenTms
|
entities.firstSeenTms | integer |
Первое просмотренное время |
|
lastSeenTms
|
entities.lastSeenTms | integer |
Последние просмотренные времена |
|
битность
|
entities.properties.bitness | integer |
Битность |
|
monitoringMode
|
entities.properties.monitoringMode | string |
Режим мониторинга |
|
osType
|
entities.properties.osType | string |
Тип ОС |
|
osArchitecture
|
entities.properties.osArchitecture | string |
Архитектура ОС |
|
networkZoneId
|
entities.properties.networkZoneId | string |
Идентификатор зоны сети |
|
Ядра cpuCore
|
entities.properties.cpuCores | integer |
Ядра ЦП |
|
tags
|
entities.tags | array of object |
Метки |
|
context
|
entities.tags.context | string |
Контекст тега |
|
key
|
entities.tags.key | string |
Ключ тега |
|
value
|
entities.tags.value | string |
Значение тега |
|
stringRepresentation
|
entities.tags.stringRepresentation | string |
Представление строки тега |
|
managementZones
|
entities.managementZones | array of object |
Зоны управления |
|
id
|
entities.managementZones.id | string |
Идентификатор зоны управления |
|
имя
|
entities.managementZones.name | string |
Имя зоны управления |
|
isInstanceOf
|
entities.fromRelationships.isInstanceOf | array of object |
Экземпляр |
|
id
|
entities.fromRelationships.isInstanceOf.id | string |
Экземпляр идентификатора |
|
type
|
entities.fromRelationships.isInstanceOf.type | string |
Экземпляр типа |
|
isDiskOf
|
entities.toRelationships.isDiskOf | array of object |
Диск |
|
id
|
entities.toRelationships.isDiskOf.id | string |
Диск идентификатора |
|
type
|
entities.toRelationships.isDiskOf.type | string |
Диск типа |
Получение сущности по идентификатору
Возвращает свойства указанной отслеживаемой сущности
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор организации
|
entityId | True | string |
Идентификатор указанной отслеживаемой сущности |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
entityId
|
entityId | string |
Идентификатор организации |
|
type
|
type | string |
Тип сущности |
|
отображаемое имя
|
displayName | string |
Отображаемое имя сущности |
|
primaryIconType
|
icon.primaryIconType | string |
Тип первичного значка |
|
secondaryIconType
|
icon.secondaryIconType | string |
Тип дополнительного значка |
|
customIconPath
|
icon.customIconPath | string |
Путь к пользовательскому значку |
|
firstSeenTms
|
firstSeenTms | integer |
Первое просмотренное время |
|
lastSeenTms
|
lastSeenTms | integer |
Последние просмотренные времена |
|
|
properties.bitness | string |
Битность |
|
monitoringMode
|
properties.monitoringMode | string |
Режим мониторинга |
|
osType
|
properties.osType | string |
Тип ОС |
|
osArchitecture
|
properties.osArchitecture | string |
Архитектура ОС |
|
networkZoneId
|
properties.networkZoneId | string |
Идентификатор зоны сети |
|
Ядра cpuCore
|
properties.cpuCores | integer |
Ядра ЦП |
|
ipAddress
|
properties.ipAddress | array of string |
IP-адрес |
|
tags
|
tags | array of object |
Метки |
|
context
|
tags.context | string |
Контекст тега |
|
key
|
tags.key | string |
Ключ тега |
|
value
|
tags.value | string |
Значение тега |
|
stringRepresentation
|
tags.stringRepresentation | string |
Представление строки тега |
|
managementZones
|
managementZones | array of object |
Зоны управления |
|
id
|
managementZones.id | string |
Идентификатор зоны управления |
|
имя
|
managementZones.name | string |
Имя зоны управления |
|
isInstanceOf
|
fromRelationships.isInstanceOf | array of object |
Экземпляр |
|
id
|
fromRelationships.isInstanceOf.id | string |
Экземпляр идентификатора |
|
type
|
fromRelationships.isInstanceOf.type | string |
Экземпляр типа |
|
isDiskOf
|
toRelationships.isDiskOf | array of object |
Диск |
|
id
|
toRelationships.isDiskOf.id | string |
Диск идентификатора |
|
type
|
toRelationships.isDiskOf.type | string |
Диск типа |
Получить события
Выводит список событий в течение указанного интервала времени
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Временный интервал
|
from | string |
Начало запрошенного интервала времени. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Предупреждения
|
warnings | array of string |
Warnings |
|
events
|
events | array of object |
Events |
|
в разделе "Maintenance"
|
events.underMaintenance | boolean |
В соответствии с обслуживанием |
|
suppressAlert
|
events.suppressAlert | boolean |
Отключение оповещений |
|
SuppressProblem
|
events.suppressProblem | boolean |
Подавление проблемы |
|
частое время
|
events.frequentEvent | boolean |
Частое событие |
|
properties
|
events.properties | array of object |
Свойства |
|
value
|
events.properties.value | string |
Значение свойства |
|
key
|
events.properties.key | string |
Ключ свойства |
|
correlationId
|
events.correlationId | string |
Идентификатор корреляции |
|
статус
|
events.status | string |
Состояние |
|
startTime
|
events.startTime | integer |
Время начала |
|
endTime
|
events.endTime | integer |
Время окончания |
|
title
|
events.title | string |
Название |
|
eventType
|
events.eventType | string |
Тип события |
|
managementZones
|
events.managementZones | array of object |
Зоны управления |
|
имя
|
events.managementZones.name | string |
Имя зоны управления |
|
id
|
events.managementZones.id | string |
Идентификатор зоны управления |
|
eventId
|
events.eventId | string |
Идентификатор события |
|
entityTags
|
events.entityTags | array of object |
Теги сущностей |
|
stringRepresentation
|
events.entityTags.stringRepresentation | string |
Представление строки тега сущности |
|
value
|
events.entityTags.value | string |
Значение тега сущности |
|
key
|
events.entityTags.key | string |
Ключ тега сущности |
|
context
|
events.entityTags.context | string |
Контекст тега сущности |
|
id
|
events.entityId.entityId.id | string |
Идентификатор организации |
|
type
|
events.entityId.entityId.type | string |
Тип сущности |
|
имя
|
events.entityId.name | string |
Имя сущности |
|
nextPageKey
|
nextPageKey | string |
Ключ следующей страницы |
|
totalCount
|
totalCount | integer |
Общее число |
|
pageSize
|
pageSize | integer |
Размер страницы |
Прием событий после публикации
Прием настраиваемого события
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
eventType
|
eventType | True | string |
Тип события |
|
title
|
title | True | string |
Название |
|
startTime
|
startTime | string |
Время начала |
|
|
endTime
|
endTime | string |
Время окончания |
|
|
timeout
|
timeout | integer |
Таймаут |
|
|
entitySelector
|
entitySelector | string |
Селектор сущностей |
|
|
properties
|
properties | object |
Свойства |
Примечание к проблеме
Добавляет новый комментарий к указанной проблеме
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проблемы
|
problemId | True | string |
Идентификатор проблемы |
|
сообщение
|
message | string |
Message |
|
|
context
|
context | string |
Контекст |