GET список*
Перечисляет проблемы (и их детали), обнаруженные Dynatrace за относительный период времени.
Проблема включается в ответ, если метка времени начала или окончания проблемы находится в пределах заданного периода времени.
Вы можете сузить вывод, указав критерии фильтрации — см. раздел « Параметры » .
Запрос создает application/json
полезную нагрузку.
ПОЛУЧИТЬ | Удалось | https://{your-domain}/e/{your-environment-id}/api/v2/problems
|
SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/problems
| |
Окружающая среда ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/problems
|
Аутентификация
Чтобы выполнить этот запрос, вам нужен токен доступа с областью чтения проблем ( problems.read
) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
Параметр | Тип | Описание | В | Необходимый |
---|---|---|---|---|
поля | нить | Список дополнительных свойств проблемы, которые вы можете добавить к ответу.
Доступны следующие свойства (все остальные свойства включены всегда, и их нельзя удалить из ответа):
Чтобы добавить свойства, укажите их в виде списка, разделенного запятыми (например, Поле действительно только для текущей страницы результатов. Вы должны установить его для каждой страницы, которую вы запрашиваете. |
запрос | по желанию |
ключ следующей страницы | нить | Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа.
Первая страница всегда возвращается, если вы не укажете параметр запроса nextPageKey . Когда nextPageKey настроен на получение последующих страниц, вы должны опустить все остальные параметры запроса, кроме параметра необязательных полей . |
запрос | по желанию |
размер страницы | целое число | Количество проблем в полезной нагрузке одного ответа.
Максимально допустимый размер страницы – 500. Если не установлено, используется 50. |
запрос | по желанию |
из | нить | Начало запрошенного таймфрейма.
Вы можете использовать один из следующих форматов:
Если не установлено, используется относительный таймфрейм в два часа ( |
запрос | по желанию |
к | нить | Конец запрошенного периода времени.
Вы можете использовать один из следующих форматов:
Если не установлено, используется текущая метка времени. |
запрос | по желанию |
селектор проблем | нить | Определяет область запроса. В ответ включаются только проблемы, соответствующие заданным критериям.
Вы можете добавить один или несколько из перечисленных ниже критериев. Для каждого критерия можно указать несколько значений, разделенных запятыми, если не указано иное. Если указано несколько значений, применяется логика ИЛИ . Все значения должны быть указаны.
Чтобы задать несколько критериев, разделите их запятой ( |
запрос | по желанию |
селектор объектов | нить | Область сущности запроса. Вы должны установить один из этих критериев:
Вы можете добавить один или несколько следующих критериев. Значения чувствительны к регистру, и
Дополнительные сведения см. в разделе Селектор объектов в документации Dynatrace. Чтобы задать несколько критериев, разделите их запятой ( Поддерживаемая длина строки составляет 2000 символов. Максимальное количество объектов, которые могут быть выбраны, ограничено 10000. |
запрос | по желанию |
Сортировать | нить | Указывает набор разделенных запятыми ( , ) полей для сортировки в списке задач.
Вы можете сортировать по следующим свойствам с префиксом знака для порядка сортировки.
Если префикс не установлен, Вы можете указать несколько уровней сортировки. Например, |
запрос | по желанию |
Ответ
Некоторые модели JSON различаются в зависимости от типа модели. Чтобы найти все возможные варианты, обратитесь к моделям JSON .
Коды ответов
Код | Тип | Описание |
---|---|---|
200 | Проблемы | Успех |
Объекты тела ответа
Объект _ Problems
Список проблем.
Элемент | Тип | Описание |
---|---|---|
общее количество | целое число | Общее количество записей в результате. |
размер страницы | целое число | Количество записей на странице. |
ключ следующей страницы | нить | Курсор для следующей страницы результатов. Имеет значение null на последней странице.
Используйте его в параметре запроса nextPageKey для получения последующих страниц результата. |
проблемы | Проблема [] | Записи результатов. |
предупреждения | строка [] | Список предупреждений |
Объект _ Problem
Свойства проблемы.
Элемент | Тип | Описание |
---|---|---|
затронутые объекты | Заглушка объекта [] | Список всех объектов, затронутых проблемой. |
rootCauseEntity | Заглушка сущности | Краткое представление отслеживаемого объекта. |
затронутые объекты | Заглушка объекта [] | Список всех объектов, затронутых проблемой. |
связанная информация о проблеме | Связанная проблема | Свойства связанной задачи. |
проблемаФильтры | Предупреждающая заготовка профиля [ ] | Список профилей предупреждений, соответствующих проблеме. |
доказательстваДетали | Сведения о доказательствах | Доказательства подробности проблемы. |
недавние комментарии | Список комментариев | Список комментариев. |
влияниеАнализ | Анализ воздействия | Список всех последствий проблемы. |
displayId | нить | Идентификатор отображения проблемы. |
уровень воздействия | нить | Уровень воздействия проблемы. Он показывает, на что влияет проблема.
Элемент может содержать эти значения
|
управлениеЗоны | Зона управления [] | Список всех зон управления, к которым относится проблема. |
Уровень опасности | нить | Серьезность проблемы.
Элемент может содержать эти значения
|
сущностьТеги | М Е тег [] | Список всех тегов сущностей проблемы. |
идентификатор проблемы | нить | Идентификатор проблемы. |
статус | нить | Статус проблемы.
Элемент может содержать эти значения
|
время начала | целое число | Отметка времени начала проблемы в миллисекундах UTC. |
время окончания | целое число | Отметка времени окончания проблемы в миллисекундах UTC.
Имеет |
заглавие | нить | Название проблемы, отображаемое в пользовательском интерфейсе. |
Объект _ EntityStub
Краткое представление отслеживаемого объекта.
Элемент | Тип | Описание |
---|---|---|
идентификатор сущности | Идентификатор объекта | Краткое представление отслеживаемого объекта. |
имя | нить | Имя сущности.
Не включается в ответ, если сущность с соответствующим идентификатором не найдена. |
Объект _ EntityId
Краткое представление отслеживаемого объекта.
Элемент | Тип | Описание |
---|---|---|
я бы | нить | Идентификатор сущности. |
тип | нить | Тип сущности. |
Объект _ LinkedProblem
Свойства связанной задачи.
Элемент | Тип | Описание |
---|---|---|
displayId | нить | Идентификатор отображения проблемы. |
идентификатор проблемы | нить | Идентификатор проблемы. |
Объект _ AlertingProfileStub
Краткое представление профиля предупреждений.
Элемент | Тип | Описание |
---|---|---|
имя | нить | Имя профиля предупреждений. |
я бы | нить | Идентификатор профиля оповещения. |
Объект _ EvidenceDetails
Доказательства подробности проблемы.
Элемент | Тип | Описание |
---|---|---|
общее количество | целое число | Общее количество признаков проблемы. |
Детали | Доказательства [] | Список всех доказательств. |
Объект _ Evidence
Доказательство первопричины.
Фактический набор полей зависит от типа свидетельства. Найдите список актуальных объектов в описании поляvideType или посмотрите модели Problems API v2-JSON .
Элемент | Тип | Описание |
---|---|---|
тип доказательства | нить | Определяет фактический набор полей в зависимости от значения. См. один из следующих объектов:
Элемент может содержать эти значения
|
показать имя | нить | Отображаемое имя свидетельства. |
организация | Заглушка сущности | Краткое представление отслеживаемого объекта. |
группировкаEntity | Заглушка сущности | Краткое представление отслеживаемого объекта. |
rootCauseRelevant | логический | Свидетельство является ( true ) или не является ( false ) частью первопричины.
|
время начала | целое число | Время начала доказательства в миллисекундах UTC. |
Объект _ CommentsList
Список комментариев.
Элемент | Тип | Описание |
---|---|---|
Комментарии | Комментарий [] | Записи результатов. |
размер страницы | целое число | Количество записей на странице. |
ключ следующей страницы | нить | Курсор для следующей страницы результатов. Имеет значение null на последней странице.
Используйте его в параметре запроса nextPageKey для получения последующих страниц результата. |
общее количество | целое число | Общее количество записей в результате. |
Объект _ Comment
Комментарий к проблеме.
Элемент | Тип | Описание |
---|---|---|
имя автора | нить | Пользователь, написавший комментарий. |
createdAtTimestamp | целое число | Отметка времени создания комментария в миллисекундах UTC. |
контекст | нить | Контекст комментария. |
я бы | нить | Идентификатор комментария. |
содержание | нить | Текст комментария. |
Объект _ ImpactAnalysis
Список всех последствий проблемы.
Элемент | Тип | Описание |
---|---|---|
удары | Влияние [] | Список всех последствий проблемы. |
Объект _ Impact
Анализ воздействия проблемы на другие объекты/пользователей.
Фактический набор полей зависит от типа воздействия. Найдите список актуальных объектов в описании поля ImpactType или посмотрите модели Problems API v2-JSON .
Элемент | Тип | Описание |
---|---|---|
ударТип | нить | Определяет фактический набор полей в зависимости от значения. См. один из следующих объектов:
Элемент может содержать эти значения
|
воздействующий объект | Заглушка сущности | Краткое представление отслеживаемого объекта. |
предполагаемые затронутые пользователи | целое число | Предполагаемое количество затронутых пользователей. |
Объект _ ManagementZone
Краткое представление зоны управления.
Элемент | Тип | Описание |
---|---|---|
имя | нить | Имя зоны управления. |
я бы | нить | Идентификатор зоны управления. |
Объект _ METag
Тег отслеживаемого объекта.
Элемент | Тип | Описание |
---|---|---|
представление строки | нить | Строковое представление тега. |
ценность | нить | Значение тега. |
ключ | нить | Ключ тега. |
контекст | нить | Происхождение тега, например AWS или Cloud Foundry.
Пользовательские теги используют это |
JSON-модель тела ответа
{
"totalCount": 1,
"pageSize": 1,
"nextPageKey": "AQAAABQBAAAABQ==",
"problems": [
{
"affectedEntities": [
{
"entityId": {
"id": "string",
"type": "string"
},
"name": "string"
}
],
"rootCauseEntity": {},
"impactedEntities": [
{}
],
"linkedProblemInfo": {
"displayId": "string",
"problemId": "string"
},
"problemFilters": [
{
"name": "string",
"id": "string"
}
],
"evidenceDetails": {
"totalCount": 1,
"details": [
{
"evidenceType": "AVAILABILITY_EVIDENCE",
"displayName": "string",
"entity": {},
"groupingEntity": {},
"rootCauseRelevant": true,
"startTime": 1
}
]
},
"recentComments": {
"comments": [
{
"authorName": "string",
"createdAtTimestamp": 1,
"context": "string",
"id": "string",
"content": "string"
}
],
"pageSize": 1,
"nextPageKey": "AQAAABQBAAAABQ==",
"totalCount": 1
},
"impactAnalysis": {
"impacts": [
{
"impactType": "APPLICATION",
"impactedEntity": {},
"estimatedAffectedUsers": 1
}
]
},
"displayId": "string",
"impactLevel": "APPLICATION",
"managementZones": [
{
"name": "string",
"id": "string"
}
],
"severityLevel": "AVAILABILITY",
"entityTags": [
{
"stringRepresentation": "string",
"value": "string",
"key": "string",
"context": "string"
}
],
"problemId": "string",
"status": "CLOSED",
"startTime": 1,
"endTime": 1,
"title": "string"
}
],
"warnings": [
"string"
]
}