GET список*: различия между версиями
ENetrebin (обсуждение | вклад) (Новая страница: «Перечисляет проблемы (и их детали), обнаруженные Dynatrace за относительный период времени....») |
ENetrebin (обсуждение | вклад) |
||
(не показаны 3 промежуточные версии этого же участника) | |||
Строка 1: | Строка 1: | ||
Перечисляет проблемы (и их детали), обнаруженные | Перечисляет проблемы (и их детали), обнаруженные Ключ-АСТРОМ за относительный период времени. | ||
Проблема включается в ответ, если метка времени начала или окончания проблемы находится в пределах заданного периода времени. | Проблема включается в ответ, если метка времени начала или окончания проблемы находится в пределах заданного периода времени. | ||
Строка 7: | Строка 7: | ||
Запрос создает <code>application/json</code>полезную нагрузку. | Запрос создает <code>application/json</code>полезную нагрузку. | ||
{| class="wikitable" | {| class="wikitable" | ||
| rowspan=" | | rowspan="2" |GET | ||
| | |Managed | ||
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/problems</nowiki></code> | |<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/problems</nowiki></code> | ||
|- | |- | ||
| | |Cреда АктивногоШлюза | ||
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/problems</nowiki></code> | |<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/problems</nowiki></code> | ||
|} | |} | ||
== Аутентификация == | == Аутентификация == | ||
Чтобы выполнить этот запрос, вам нужен токен доступа с областью чтения проблем ( <code>problems.read</code>) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация . | Чтобы выполнить этот запрос, вам нужен токен доступа с областью чтения проблем ( <code>problems.read</code>) . Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] . | ||
== Параметры == | == Параметры == | ||
Строка 26: | Строка 23: | ||
!Тип | !Тип | ||
!Описание | !Описание | ||
! | !In | ||
! | !Необходимость | ||
|- | |- | ||
| | |fields | ||
| | |string | ||
|Список дополнительных свойств проблемы, которые вы можете добавить к ответу. | |Список дополнительных свойств проблемы, которые вы можете добавить к ответу. | ||
Строка 42: | Строка 39: | ||
Поле действительно только для текущей страницы результатов. Вы должны установить его для каждой страницы, которую вы запрашиваете. | Поле действительно только для текущей страницы результатов. Вы должны установить его для каждой страницы, которую вы запрашиваете. | ||
| | |query | ||
|по желанию | |по желанию | ||
|- | |- | ||
| | |nextPageKey | ||
| | |string | ||
|Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа. | |Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа. | ||
Строка 52: | Строка 49: | ||
Когда nextPageKey настроен на получение последующих страниц, вы должны опустить все остальные параметры запроса, кроме параметра необязательных полей . | Когда nextPageKey настроен на получение последующих страниц, вы должны опустить все остальные параметры запроса, кроме параметра необязательных полей . | ||
| | |query | ||
|по желанию | |по желанию | ||
|- | |- | ||
| | |pageSize | ||
| | |integer | ||
|Количество проблем в полезной нагрузке одного ответа. | |Количество проблем в полезной нагрузке одного ответа. | ||
Строка 62: | Строка 59: | ||
Если не установлено, используется 50. | Если не установлено, используется 50. | ||
| | |query | ||
|по желанию | |по желанию | ||
|- | |- | ||
| | |from | ||
| | |string | ||
|Начало запрошенного таймфрейма. | |Начало запрошенного таймфрейма. | ||
Строка 74: | Строка 71: | ||
* Человекочитаемый формат <code>2021-01-25T05:57:01.123+01:00</code>. Если часовой пояс не указан, используется UTC. Вы можете использовать пробел вместо <code>T</code>. Секунды и доли секунды не являются обязательными. | * Человекочитаемый формат <code>2021-01-25T05:57:01.123+01:00</code>. Если часовой пояс не указан, используется UTC. Вы можете использовать пробел вместо <code>T</code>. Секунды и доли секунды не являются обязательными. | ||
* Относительный таймфрейм, назад. Формат: <code>now-NU/A</code>, где <code>N</code>количество времени, <code>U</code>единица времени и <code>A</code>выравнивание. Выравнивание округляет все меньшие значения до ближайшего нуля в прошлом. Например, <code>now-1y/w</code>это один год назад, выровненный на неделю. Вы также можете указать относительный таймфрейм без выравнивания: <code>now-NU</code>. Поддерживаемые единицы времени для относительного таймфрейма: | * Относительный таймфрейм, назад. Формат: <code>now-NU/A</code>, где <code>N</code>количество времени, <code>U</code>единица времени и <code>A</code>выравнивание. Выравнивание округляет все меньшие значения до ближайшего нуля в прошлом. Например, <code>now-1y/w</code>это один год назад, выровненный на неделю. Вы также можете указать относительный таймфрейм без выравнивания: <code>now-NU</code>. Поддерживаемые единицы времени для относительного таймфрейма: | ||
** <code>m</code>: | ** <code>m</code>: минуты | ||
** <code>h</code>: часы | ** <code>h</code>: часы | ||
** <code>d</code>: | ** <code>d</code>: дни | ||
** <code>w</code>: недели | ** <code>w</code>: недели | ||
** <code>M</code>: месяцы | ** <code>M</code>: месяцы | ||
Строка 82: | Строка 79: | ||
Если не установлено, используется относительный таймфрейм в два часа ( <code>now-2h</code>). | Если не установлено, используется относительный таймфрейм в два часа ( <code>now-2h</code>). | ||
| | |query | ||
|по желанию | |по желанию | ||
|- | |- | ||
| | |to | ||
| | |string | ||
|Конец запрошенного периода времени. | |Конец запрошенного периода времени. | ||
Строка 94: | Строка 91: | ||
* Человекочитаемый формат <code>2021-01-25T05:57:01.123+01:00</code>. Если часовой пояс не указан, используется UTC. Вы можете использовать пробел вместо <code>T</code>. Секунды и доли секунды не являются обязательными. | * Человекочитаемый формат <code>2021-01-25T05:57:01.123+01:00</code>. Если часовой пояс не указан, используется UTC. Вы можете использовать пробел вместо <code>T</code>. Секунды и доли секунды не являются обязательными. | ||
* Относительный таймфрейм, назад. Формат: <code>now-NU/A</code>, где <code>N</code>количество времени, <code>U</code>единица времени и <code>A</code>выравнивание. Выравнивание округляет все меньшие значения до ближайшего нуля в прошлом. Например, <code>now-1y/w</code>это один год назад, выровненный на неделю. Вы также можете указать относительный таймфрейм без выравнивания: <code>now-NU</code>. Поддерживаемые единицы времени для относительного таймфрейма: | * Относительный таймфрейм, назад. Формат: <code>now-NU/A</code>, где <code>N</code>количество времени, <code>U</code>единица времени и <code>A</code>выравнивание. Выравнивание округляет все меньшие значения до ближайшего нуля в прошлом. Например, <code>now-1y/w</code>это один год назад, выровненный на неделю. Вы также можете указать относительный таймфрейм без выравнивания: <code>now-NU</code>. Поддерживаемые единицы времени для относительного таймфрейма: | ||
** <code>m</code>: | ** <code>m</code>: минуты | ||
** <code>h</code>: часы | ** <code>h</code>: часы | ||
** <code>d</code>: | ** <code>d</code>: дни | ||
** <code>w</code>: недели | ** <code>w</code>: недели | ||
** <code>M</code>: месяцы | ** <code>M</code>: месяцы | ||
Строка 102: | Строка 99: | ||
Если не установлено, используется текущая метка времени. | Если не установлено, используется текущая метка времени. | ||
| | |query | ||
|по желанию | |по желанию | ||
|- | |- | ||
| | |problemSelector | ||
| | |string | ||
|Определяет область запроса. В ответ включаются только проблемы, соответствующие заданным критериям. | |Определяет область запроса. В ответ включаются только проблемы, соответствующие заданным критериям. | ||
Строка 130: | Строка 127: | ||
Чтобы задать несколько критериев, разделите их запятой ( <code>,</code>). В ответ включаются только результаты, соответствующие всем критериям. | Чтобы задать несколько критериев, разделите их запятой ( <code>,</code>). В ответ включаются только результаты, соответствующие всем критериям. | ||
| | |query | ||
|по желанию | |по желанию | ||
|- | |- | ||
| | |entitySelector | ||
| | |string | ||
|Область сущности запроса. Вы должны установить один из этих критериев: | |Область сущности запроса. Вы должны установить один из этих критериев: | ||
* Тип объекта:<code>type("TYPE")</code> | * Тип объекта:<code>type("TYPE")</code> | ||
* Идентификатор объекта | * Идентификатор объекта Ключ-АСТРОМ: <code>entityId("id")</code>. Вы можете указать несколько идентификаторов, разделенных запятой ( <code>entityId("id-1","id-2")</code>). Все запрошенные сущности должны быть одного типа. | ||
Вы можете добавить один или несколько следующих критериев. Значения чувствительны к регистру, и <code>EQUALS</code>оператор используется, если не указано иное. | Вы можете добавить один или несколько следующих критериев. Значения чувствительны к регистру, и <code>EQUALS</code>оператор используется, если не указано иное. | ||
Строка 150: | Строка 147: | ||
** <code>entityName.in</code>: позволяет указать несколько значений. Оператор <code>EQUALS</code>обращается. | ** <code>entityName.in</code>: позволяет указать несколько значений. Оператор <code>EQUALS</code>обращается. | ||
** <code>caseSensitive(entityName.equals("value"))</code>: принимает любой критерий имени сущности в качестве аргументов и делает значение чувствительным к регистру. | ** <code>caseSensitive(entityName.equals("value"))</code>: принимает любой критерий имени сущности в качестве аргументов и делает значение чувствительным к регистру. | ||
* Состояние здоровья ( | * Состояние здоровья (HEALTHY,UNHEALTHY):<code>healthState("HEALTHY")</code> | ||
* Отметка времени первого увиденного: <code>firstSeenTms.<operator>(now-3h)</code>. Используйте любой формат метки времени из параметров from / to . Доступны следующие операторы: | * Отметка времени первого увиденного: <code>firstSeenTms.<operator>(now-3h)</code>. Используйте любой формат метки времени из параметров from / to . Доступны следующие операторы: | ||
** <code>lte</code>: раньше или в указанное время | ** <code>lte</code>: раньше или в указанное время | ||
Строка 160: | Строка 157: | ||
* Отрицание: <code>not(<criterion>)</code>. Инвертирует любой критерий, кроме type . | * Отрицание: <code>not(<criterion>)</code>. Инвертирует любой критерий, кроме type . | ||
Дополнительные сведения см. в разделе Селектор объектов в документации | Дополнительные сведения см. в разделе Селектор объектов в документации Ключ-АСТРОМ. | ||
Чтобы задать несколько критериев, разделите их запятой ( <code>,</code>). Например, <code>type("HOST"),healthState("HEALTHY")</code>. В ответ включаются только результаты, соответствующие всем критериям. | Чтобы задать несколько критериев, разделите их запятой ( <code>,</code>). Например, <code>type("HOST"),healthState("HEALTHY")</code>. В ответ включаются только результаты, соответствующие всем критериям. | ||
Строка 167: | Строка 164: | ||
Максимальное количество объектов, которые могут быть выбраны, ограничено 10000. | Максимальное количество объектов, которые могут быть выбраны, ограничено 10000. | ||
| | |query | ||
|по желанию | |по желанию | ||
|- | |- | ||
| | |sort | ||
| | |string | ||
|Указывает набор разделенных запятыми ( <code>,</code>) полей для сортировки в списке задач. | |Указывает набор разделенных запятыми ( <code>,</code>) полей для сортировки в списке задач. | ||
Строка 183: | Строка 180: | ||
Вы можете указать несколько уровней сортировки. Например, <code>+status,-startTime</code>сортирует проблемы по статусу, открывая проблемы первыми. В статусе проблемы отсортированы по времени начала, сначала самые старые. | Вы можете указать несколько уровней сортировки. Например, <code>+status,-startTime</code>сортирует проблемы по статусу, открывая проблемы первыми. В статусе проблемы отсортированы по времени начала, сначала самые старые. | ||
| | |query | ||
|по желанию | |по желанию | ||
|} | |} | ||
Строка 197: | Строка 194: | ||
|- | |- | ||
|200 | |200 | ||
| | |Problems | ||
|Успех | |Успех | ||
|} | |} | ||
Строка 203: | Строка 200: | ||
=== Объекты тела ответа === | === Объекты тела ответа === | ||
==== Объект | ==== Объект <code>Problems</code> ==== | ||
Список проблем. | Список проблем. | ||
{| class="wikitable" | {| class="wikitable" | ||
Строка 210: | Строка 207: | ||
!Описание | !Описание | ||
|- | |- | ||
| | |totalCount | ||
| | |integer | ||
|Общее количество записей в результате. | |Общее количество записей в результате. | ||
|- | |- | ||
| | |pageSize | ||
| | |integer | ||
|Количество записей на странице. | |Количество записей на странице. | ||
|- | |- | ||
| | |nextPageKey | ||
| | |string | ||
|Курсор для следующей страницы результатов. Имеет значение <code>null</code>на последней странице. | |Курсор для следующей страницы результатов. Имеет значение <code>null</code>на последней странице. | ||
Используйте его в параметре запроса nextPageKey для получения последующих страниц результата. | Используйте его в параметре запроса nextPageKey для получения последующих страниц результата. | ||
|- | |- | ||
| | |problems | ||
| | |Problem[] | ||
|Записи результатов. | |Записи результатов. | ||
|- | |- | ||
| | |warnings | ||
| | |string [] | ||
|Список предупреждений | |Список предупреждений | ||
|} | |} | ||
==== Объект | ==== Объект <code>Problem</code> ==== | ||
Свойства проблемы. | Свойства проблемы. | ||
{| class="wikitable" | {| class="wikitable" | ||
Строка 240: | Строка 237: | ||
!Описание | !Описание | ||
|- | |- | ||
| | |affectedEntities | ||
| | |EntityStub[] | ||
|Список всех объектов, затронутых проблемой. | |Список всех объектов, затронутых проблемой. | ||
|- | |- | ||
|rootCauseEntity | |rootCauseEntity | ||
| | |EntityStub | ||
|Краткое представление отслеживаемого объекта. | |Краткое представление отслеживаемого объекта. | ||
|- | |- | ||
| | |impactedEntities | ||
| | |EntityStub[] | ||
|Список всех объектов, затронутых проблемой. | |Список всех объектов, затронутых проблемой. | ||
|- | |- | ||
| | |linkedProblemInfo | ||
| | |LinkedProblem | ||
|Свойства связанной задачи. | |Свойства связанной задачи. | ||
|- | |- | ||
| | |problemFilters | ||
| | |AlertingProfileStub[] | ||
|Список профилей предупреждений, соответствующих проблеме. | |Список профилей предупреждений, соответствующих проблеме. | ||
|- | |- | ||
| | |evidenceDetails | ||
| | |EvidenceDetails | ||
|Доказательства подробности проблемы. | |Доказательства подробности проблемы. | ||
|- | |- | ||
| | |recentComments | ||
| | |CommentsList | ||
|Список комментариев. | |Список комментариев. | ||
|- | |- | ||
| | |impactAnalysis | ||
| | |ImpactAnalysis | ||
|Список всех последствий проблемы. | |Список всех последствий проблемы. | ||
|- | |- | ||
|displayId | |displayId | ||
| | |string | ||
|Идентификатор отображения проблемы. | |Идентификатор отображения проблемы. | ||
|- | |- | ||
| | |impactLevel | ||
| | |string | ||
|Уровень воздействия проблемы. Он показывает, на что влияет проблема. | |Уровень воздействия проблемы. Он показывает, на что влияет проблема. | ||
Строка 287: | Строка 284: | ||
* <code>SERVICES</code> | * <code>SERVICES</code> | ||
|- | |- | ||
| | |managementZones | ||
| | |ManagementZone[] | ||
|Список всех зон управления, к которым относится проблема. | |Список всех зон управления, к которым относится проблема. | ||
|- | |- | ||
| | |severityLevel | ||
| | |string | ||
|Серьезность проблемы. | |Серьезность проблемы. | ||
Строка 305: | Строка 302: | ||
* <code>RESOURCE_CONTENTION</code> | * <code>RESOURCE_CONTENTION</code> | ||
|- | |- | ||
| | |entityTags | ||
| | |METag[] | ||
|Список всех тегов | |Список всех тегов объектов проблемы. | ||
|- | |- | ||
| | |problemId | ||
| | |string | ||
|Идентификатор проблемы. | |Идентификатор проблемы. | ||
|- | |- | ||
| | |status | ||
| | |string | ||
|Статус проблемы. | |Статус проблемы. | ||
Строка 322: | Строка 319: | ||
* <code>OPEN</code> | * <code>OPEN</code> | ||
|- | |- | ||
| | |startTime | ||
| | |integer | ||
|Отметка времени начала проблемы в миллисекундах UTC. | |Отметка времени начала проблемы в миллисекундах UTC. | ||
|- | |- | ||
| | |endTime | ||
| | |integer | ||
|Отметка времени окончания проблемы в миллисекундах UTC. | |Отметка времени окончания проблемы в миллисекундах UTC. | ||
Имеет <code>-1</code>значение, если проблема все еще остается открытой. | Имеет <code>-1</code>значение, если проблема все еще остается открытой. | ||
|- | |- | ||
| | |title | ||
| | |string | ||
|Название проблемы, отображаемое в пользовательском интерфейсе. | |Название проблемы, отображаемое в пользовательском интерфейсе. | ||
|} | |} | ||
==== Объект | ==== Объект <code>EntityStub</code> ==== | ||
Краткое представление отслеживаемого объекта. | Краткое представление отслеживаемого объекта. | ||
{| class="wikitable" | {| class="wikitable" | ||
Строка 344: | Строка 341: | ||
!Описание | !Описание | ||
|- | |- | ||
| | |entityId | ||
| | |EntityId | ||
|Краткое представление отслеживаемого объекта. | |Краткое представление отслеживаемого объекта. | ||
|- | |- | ||
| | |name | ||
| | |string | ||
|Имя | |Имя объекта. | ||
Не включается в ответ, если сущность с соответствующим идентификатором не найдена. | Не включается в ответ, если сущность с соответствующим идентификатором не найдена. | ||
|} | |} | ||
==== Объект | ==== Объект <code>EntityId</code> ==== | ||
Краткое представление отслеживаемого объекта. | Краткое представление отслеживаемого объекта. | ||
{| class="wikitable" | {| class="wikitable" | ||
Строка 362: | Строка 359: | ||
!Описание | !Описание | ||
|- | |- | ||
| | |id | ||
| | |string | ||
|Идентификатор | |Идентификатор объекта. | ||
|- | |- | ||
| | |type | ||
| | |string | ||
|Тип | |Тип объекта. | ||
|} | |} | ||
==== Объект | ==== Объект <code>LinkedProblem</code> ==== | ||
Свойства связанной задачи. | Свойства связанной задачи. | ||
{| class="wikitable" | {| class="wikitable" | ||
Строка 379: | Строка 376: | ||
|- | |- | ||
|displayId | |displayId | ||
| | |string | ||
|Идентификатор отображения проблемы. | |Идентификатор отображения проблемы. | ||
|- | |- | ||
| | |details | ||
| | |string | ||
|Идентификатор проблемы. | |Идентификатор проблемы. | ||
|} | |} | ||
==== Объект | ==== Объект <code>AlertingProfileStub</code> ==== | ||
Краткое представление профиля предупреждений. | Краткое представление профиля предупреждений. | ||
{| class="wikitable" | {| class="wikitable" | ||
Строка 394: | Строка 391: | ||
!Описание | !Описание | ||
|- | |- | ||
| | |name | ||
| | |string | ||
|Имя профиля предупреждений. | |Имя профиля предупреждений. | ||
|- | |- | ||
| | |id | ||
| | |string | ||
|Идентификатор профиля оповещения. | |Идентификатор профиля оповещения. | ||
|} | |} | ||
==== Объект | ==== Объект <code>EvidenceDetails</code> ==== | ||
Доказательства подробности проблемы. | Доказательства подробности проблемы. | ||
{| class="wikitable" | {| class="wikitable" | ||
Строка 410: | Строка 407: | ||
!Описание | !Описание | ||
|- | |- | ||
| | |totalCount | ||
| | |integer | ||
|Общее количество признаков проблемы. | |Общее количество признаков проблемы. | ||
|- | |- | ||
| | |details | ||
| | |Evidence[] | ||
|Список всех доказательств. | |Список всех доказательств. | ||
|} | |} | ||
==== Объект | ==== Объект <code>Evidence</code> ==== | ||
Доказательство первопричины. | Доказательство первопричины. | ||
Строка 428: | Строка 425: | ||
!Описание | !Описание | ||
|- | |- | ||
| | |evidenceType | ||
| | |string | ||
|Определяет фактический набор полей в зависимости от значения. См. один из следующих объектов: | |Определяет фактический набор полей в зависимости от значения. См. один из следующих объектов: | ||
* <code>EVENT</code>-> EventEvidence | * <code>EVENT</code> -> EventEvidence | ||
* <code>METRIC</code>-> | * <code>METRIC</code> -> MetricEvidence | ||
* <code>TRANSACTIONAL</code>-> | * <code>TRANSACTIONAL</code> -> TransactionalEvidence | ||
* <code>MAINTENANCE_WINDOW</code>-> MaintenanceWindowEvidence | * <code>MAINTENANCE_WINDOW</code> -> MaintenanceWindowEvidence | ||
* <code>AVAILABILITY_EVIDENCE</code>-> | * <code>AVAILABILITY_EVIDENCE</code> -> AvailabilityEvidence | ||
Элемент может содержать эти значения | Элемент может содержать эти значения | ||
Строка 446: | Строка 443: | ||
* <code>TRANSACTIONAL</code> | * <code>TRANSACTIONAL</code> | ||
|- | |- | ||
| | |displayName | ||
| | |string | ||
|Отображаемое имя свидетельства. | |Отображаемое имя свидетельства. | ||
|- | |- | ||
| | |entity | ||
| | |EntityStub | ||
|Краткое представление отслеживаемого объекта. | |Краткое представление отслеживаемого объекта. | ||
|- | |- | ||
| | |groupingEntity | ||
| | |EntityStub | ||
|Краткое представление отслеживаемого объекта. | |Краткое представление отслеживаемого объекта. | ||
|- | |- | ||
|rootCauseRelevant | |rootCauseRelevant | ||
| | |boolean | ||
|Свидетельство является ( <code>true</code>) или не является ( <code>false</code>) частью первопричины. | |Свидетельство является ( <code>true</code>) или не является ( <code>false</code>) частью первопричины. | ||
|- | |- | ||
| | |startTime | ||
| | |integer | ||
|Время начала доказательства в миллисекундах UTC. | |Время начала доказательства в миллисекундах UTC. | ||
|} | |} | ||
==== Объект | ==== Объект <code>CommentsList</code> ==== | ||
Список комментариев. | Список комментариев. | ||
{| class="wikitable" | {| class="wikitable" | ||
Строка 474: | Строка 471: | ||
!Описание | !Описание | ||
|- | |- | ||
| | |comments | ||
| | |Comment[] | ||
|Записи результатов. | |Записи результатов. | ||
|- | |- | ||
| | |pageSize | ||
| | |integer | ||
|Количество записей на странице. | |Количество записей на странице. | ||
|- | |- | ||
| | |nextPageKey | ||
| | |string | ||
|Курсор для следующей страницы результатов. Имеет значение <code>null</code>на последней странице. | |Курсор для следующей страницы результатов. Имеет значение <code>null</code>на последней странице. | ||
Используйте его в параметре запроса nextPageKey для получения последующих страниц результата. | Используйте его в параметре запроса nextPageKey для получения последующих страниц результата. | ||
|- | |- | ||
| | |totalCount | ||
| | |integer | ||
|Общее количество записей в результате. | |Общее количество записей в результате. | ||
|} | |} | ||
==== Объект | ==== Объект <code>Comment</code> ==== | ||
Комментарий к проблеме. | Комментарий к проблеме. | ||
{| class="wikitable" | {| class="wikitable" | ||
Строка 500: | Строка 497: | ||
!Описание | !Описание | ||
|- | |- | ||
| | |authorName | ||
| | |string | ||
|Пользователь, написавший комментарий. | |Пользователь, написавший комментарий. | ||
|- | |- | ||
|createdAtTimestamp | |createdAtTimestamp | ||
| | |integer | ||
|Отметка времени создания комментария в миллисекундах UTC. | |Отметка времени создания комментария в миллисекундах UTC. | ||
|- | |- | ||
| | |context | ||
| | |string | ||
|Контекст комментария. | |Контекст комментария. | ||
|- | |- | ||
| | |id | ||
| | |string | ||
|Идентификатор комментария. | |Идентификатор комментария. | ||
|- | |- | ||
| | |content | ||
| | |string | ||
|Текст комментария. | |Текст комментария. | ||
|} | |} | ||
==== Объект | ==== Объект <code>ImpactAnalysis</code> ==== | ||
Список всех последствий проблемы. | Список всех последствий проблемы. | ||
{| class="wikitable" | {| class="wikitable" | ||
Строка 528: | Строка 525: | ||
!Описание | !Описание | ||
|- | |- | ||
| | |impacts | ||
| | |Impact[] | ||
|Список всех последствий проблемы. | |Список всех последствий проблемы. | ||
|} | |} | ||
==== Объект | ==== Объект <code>Impact</code> ==== | ||
Анализ воздействия проблемы на другие объекты/пользователей. | Анализ воздействия проблемы на другие объекты/пользователей. | ||
Строка 542: | Строка 539: | ||
!Описание | !Описание | ||
|- | |- | ||
| | |impactType | ||
| | |string | ||
|Определяет фактический набор полей в зависимости от значения. См. один из следующих объектов: | |Определяет фактический набор полей в зависимости от значения. См. один из следующих объектов: | ||
* <code>SERVICE</code>-> | * <code>SERVICE</code> -> ServiceImpact | ||
* <code>APPLICATION</code>-> | * <code>APPLICATION</code> -> ApplicationImpact | ||
* <code>MOBILE</code>-> | * <code>MOBILE</code> -> MobileImpact | ||
* <code>CUSTOM_APPLICATION</code>-> CustomApplicationImpact | * <code>CUSTOM_APPLICATION</code> -> CustomApplicationImpact | ||
Элемент может содержать эти значения | Элемент может содержать эти значения | ||
Строка 558: | Строка 555: | ||
* <code>SERVICE</code> | * <code>SERVICE</code> | ||
|- | |- | ||
| | |impactedEntity | ||
| | |EntityStub | ||
|Краткое представление отслеживаемого объекта. | |Краткое представление отслеживаемого объекта. | ||
|- | |- | ||
| | |estimatedAffectedUsers | ||
| | |integer | ||
|Предполагаемое количество затронутых пользователей. | |Предполагаемое количество затронутых пользователей. | ||
|} | |} | ||
==== Объект | ==== Объект <code>ManagementZone</code> ==== | ||
Краткое представление зоны управления. | Краткое представление зоны управления. | ||
{| class="wikitable" | {| class="wikitable" | ||
Строка 574: | Строка 571: | ||
!Описание | !Описание | ||
|- | |- | ||
| | |name | ||
| | |string | ||
|Имя зоны управления. | |Имя зоны управления. | ||
|- | |- | ||
| | |id | ||
| | |string | ||
|Идентификатор зоны управления. | |Идентификатор зоны управления. | ||
|} | |} | ||
==== Объект | ==== Объект <code>METag</code> ==== | ||
Тег отслеживаемого объекта. | Тег отслеживаемого объекта. | ||
{| class="wikitable" | {| class="wikitable" | ||
Строка 590: | Строка 587: | ||
!Описание | !Описание | ||
|- | |- | ||
| | |stringRepresentation | ||
| | |string | ||
|Строковое представление тега. | |Строковое представление тега. | ||
|- | |- | ||
| | |value | ||
| | |string | ||
|Значение тега. | |Значение тега. | ||
|- | |- | ||
| | |key | ||
| | |string | ||
|Ключ тега. | |Ключ тега. | ||
|- | |- | ||
| | |context | ||
| | |string | ||
|Происхождение тега, например AWS или Cloud Foundry. | |Происхождение тега, например AWS или Cloud Foundry. | ||
Текущая версия на 09:43, 17 октября 2022
Перечисляет проблемы (и их детали), обнаруженные Ключ-АСТРОМ за относительный период времени.
Проблема включается в ответ, если метка времени начала или окончания проблемы находится в пределах заданного периода времени.
Вы можете сузить вывод, указав критерии фильтрации — см. раздел « Параметры » .
Запрос создает application/json
полезную нагрузку.
GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/problems
|
Cреда АктивногоШлюза | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/problems
|
Аутентификация
Чтобы выполнить этот запрос, вам нужен токен доступа с областью чтения проблем ( problems.read
) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
Параметр | Тип | Описание | In | Необходимость |
---|---|---|---|---|
fields | string | Список дополнительных свойств проблемы, которые вы можете добавить к ответу.
Доступны следующие свойства (все остальные свойства включены всегда, и их нельзя удалить из ответа):
Чтобы добавить свойства, укажите их в виде списка, разделенного запятыми (например, Поле действительно только для текущей страницы результатов. Вы должны установить его для каждой страницы, которую вы запрашиваете. |
query | по желанию |
nextPageKey | string | Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа.
Первая страница всегда возвращается, если вы не укажете параметр запроса nextPageKey . Когда nextPageKey настроен на получение последующих страниц, вы должны опустить все остальные параметры запроса, кроме параметра необязательных полей . |
query | по желанию |
pageSize | integer | Количество проблем в полезной нагрузке одного ответа.
Максимально допустимый размер страницы – 500. Если не установлено, используется 50. |
query | по желанию |
from | string | Начало запрошенного таймфрейма.
Вы можете использовать один из следующих форматов:
Если не установлено, используется относительный таймфрейм в два часа ( |
query | по желанию |
to | string | Конец запрошенного периода времени.
Вы можете использовать один из следующих форматов:
Если не установлено, используется текущая метка времени. |
query | по желанию |
problemSelector | string | Определяет область запроса. В ответ включаются только проблемы, соответствующие заданным критериям.
Вы можете добавить один или несколько из перечисленных ниже критериев. Для каждого критерия можно указать несколько значений, разделенных запятыми, если не указано иное. Если указано несколько значений, применяется логика ИЛИ . Все значения должны быть указаны.
Чтобы задать несколько критериев, разделите их запятой ( |
query | по желанию |
entitySelector | string | Область сущности запроса. Вы должны установить один из этих критериев:
Вы можете добавить один или несколько следующих критериев. Значения чувствительны к регистру, и
Дополнительные сведения см. в разделе Селектор объектов в документации Ключ-АСТРОМ. Чтобы задать несколько критериев, разделите их запятой ( Поддерживаемая длина строки составляет 2000 символов. Максимальное количество объектов, которые могут быть выбраны, ограничено 10000. |
query | по желанию |
sort | string | Указывает набор разделенных запятыми ( , ) полей для сортировки в списке задач.
Вы можете сортировать по следующим свойствам с префиксом знака для порядка сортировки.
Если префикс не установлен, Вы можете указать несколько уровней сортировки. Например, |
query | по желанию |
Ответ
Некоторые модели JSON различаются в зависимости от типа модели. Чтобы найти все возможные варианты, обратитесь к моделям JSON .
Коды ответов
Код | Тип | Описание |
---|---|---|
200 | Problems | Успех |
Объекты тела ответа
Объект Problems
Список проблем.
Элемент | Тип | Описание |
---|---|---|
totalCount | integer | Общее количество записей в результате. |
pageSize | integer | Количество записей на странице. |
nextPageKey | string | Курсор для следующей страницы результатов. Имеет значение null на последней странице.
Используйте его в параметре запроса nextPageKey для получения последующих страниц результата. |
problems | Problem[] | Записи результатов. |
warnings | string [] | Список предупреждений |
Объект Problem
Свойства проблемы.
Элемент | Тип | Описание |
---|---|---|
affectedEntities | EntityStub[] | Список всех объектов, затронутых проблемой. |
rootCauseEntity | EntityStub | Краткое представление отслеживаемого объекта. |
impactedEntities | EntityStub[] | Список всех объектов, затронутых проблемой. |
linkedProblemInfo | LinkedProblem | Свойства связанной задачи. |
problemFilters | AlertingProfileStub[] | Список профилей предупреждений, соответствующих проблеме. |
evidenceDetails | EvidenceDetails | Доказательства подробности проблемы. |
recentComments | CommentsList | Список комментариев. |
impactAnalysis | ImpactAnalysis | Список всех последствий проблемы. |
displayId | string | Идентификатор отображения проблемы. |
impactLevel | string | Уровень воздействия проблемы. Он показывает, на что влияет проблема.
Элемент может содержать эти значения
|
managementZones | ManagementZone[] | Список всех зон управления, к которым относится проблема. |
severityLevel | string | Серьезность проблемы.
Элемент может содержать эти значения
|
entityTags | METag[] | Список всех тегов объектов проблемы. |
problemId | string | Идентификатор проблемы. |
status | string | Статус проблемы.
Элемент может содержать эти значения
|
startTime | integer | Отметка времени начала проблемы в миллисекундах UTC. |
endTime | integer | Отметка времени окончания проблемы в миллисекундах UTC.
Имеет |
title | string | Название проблемы, отображаемое в пользовательском интерфейсе. |
Объект EntityStub
Краткое представление отслеживаемого объекта.
Элемент | Тип | Описание |
---|---|---|
entityId | EntityId | Краткое представление отслеживаемого объекта. |
name | string | Имя объекта.
Не включается в ответ, если сущность с соответствующим идентификатором не найдена. |
Объект EntityId
Краткое представление отслеживаемого объекта.
Элемент | Тип | Описание |
---|---|---|
id | string | Идентификатор объекта. |
type | string | Тип объекта. |
Объект LinkedProblem
Свойства связанной задачи.
Элемент | Тип | Описание |
---|---|---|
displayId | string | Идентификатор отображения проблемы. |
details | string | Идентификатор проблемы. |
Объект AlertingProfileStub
Краткое представление профиля предупреждений.
Элемент | Тип | Описание |
---|---|---|
name | string | Имя профиля предупреждений. |
id | string | Идентификатор профиля оповещения. |
Объект EvidenceDetails
Доказательства подробности проблемы.
Элемент | Тип | Описание |
---|---|---|
totalCount | integer | Общее количество признаков проблемы. |
details | Evidence[] | Список всех доказательств. |
Объект Evidence
Доказательство первопричины.
Фактический набор полей зависит от типа свидетельства. Найдите список актуальных объектов в описании поляvideType или посмотрите модели Problems API v2-JSON .
Элемент | Тип | Описание |
---|---|---|
evidenceType | string | Определяет фактический набор полей в зависимости от значения. См. один из следующих объектов:
Элемент может содержать эти значения
|
displayName | string | Отображаемое имя свидетельства. |
entity | EntityStub | Краткое представление отслеживаемого объекта. |
groupingEntity | EntityStub | Краткое представление отслеживаемого объекта. |
rootCauseRelevant | boolean | Свидетельство является ( true ) или не является ( false ) частью первопричины.
|
startTime | integer | Время начала доказательства в миллисекундах UTC. |
Объект CommentsList
Список комментариев.
Элемент | Тип | Описание |
---|---|---|
comments | Comment[] | Записи результатов. |
pageSize | integer | Количество записей на странице. |
nextPageKey | string | Курсор для следующей страницы результатов. Имеет значение null на последней странице.
Используйте его в параметре запроса nextPageKey для получения последующих страниц результата. |
totalCount | integer | Общее количество записей в результате. |
Объект Comment
Комментарий к проблеме.
Элемент | Тип | Описание |
---|---|---|
authorName | string | Пользователь, написавший комментарий. |
createdAtTimestamp | integer | Отметка времени создания комментария в миллисекундах UTC. |
context | string | Контекст комментария. |
id | string | Идентификатор комментария. |
content | string | Текст комментария. |
Объект ImpactAnalysis
Список всех последствий проблемы.
Элемент | Тип | Описание |
---|---|---|
impacts | Impact[] | Список всех последствий проблемы. |
Объект Impact
Анализ воздействия проблемы на другие объекты/пользователей.
Фактический набор полей зависит от типа воздействия. Найдите список актуальных объектов в описании поля ImpactType или посмотрите модели Problems API v2-JSON .
Элемент | Тип | Описание |
---|---|---|
impactType | string | Определяет фактический набор полей в зависимости от значения. См. один из следующих объектов:
Элемент может содержать эти значения
|
impactedEntity | EntityStub | Краткое представление отслеживаемого объекта. |
estimatedAffectedUsers | integer | Предполагаемое количество затронутых пользователей. |
Объект ManagementZone
Краткое представление зоны управления.
Элемент | Тип | Описание |
---|---|---|
name | string | Имя зоны управления. |
id | string | Идентификатор зоны управления. |
Объект METag
Тег отслеживаемого объекта.
Элемент | Тип | Описание |
---|---|---|
stringRepresentation | string | Строковое представление тега. |
value | string | Значение тега. |
key | string | Ключ тега. |
context | string | Происхождение тега, например 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"
]
}