События

Это системный контекст, который предоставляет доступ к различным данным и операциям, связанным с управлением событиями. Он не отображается в видимой части контекстного дерева.

Уникальные действия

[?]

Удалить истекшие события

Удаляет истекшие события из истории событий.

Тип действия:

вызвать функцию

Имя действия:

removeExpired

Права доступа:

Доступно на уровне с правами доступа для Инженеров.

Действия, относящиеся к переменным

[?]

Подтвердить тревогу

Это действие доступно для:

Это действие позволяет подтвердить событие тревоги, которое было выбрано в таблице активных экземпляров или активных тревог. Оно предлагает оператору сначала ввести текст подтверждения.

Имя действия:

acknowledgeAlert

Неинтерактивный режим:

не поддерживается

Права доступа:

Доступны на уровне прав доступа Отсутствует

Дополнительная информация

Информация о контексте

Тип контекста: события

Имя контекста: события

Описание контекста: события

Путь контекста: события

Контекстная маска: события

Права доступа к контексту

[?]

Уровень

Описание

Отсутствует

Нет доступа.

Наблюдатель

Доступ к истории событий.

Оператор

Подтверждение событий.

Менеджер

Удаление событий.

Инженер

Массовое удаление событий.

Удаление просроченных событий.

Администратор

Все операции.

Общие переменные (свойства)

[?]

У данного контекста нет общих переменных (свойств).

Общие функции

[?]

Подтвердить событие

Добавляет новое подтверждение в событие.

Имя функции:

acknowledge

Права доступа:

Доступно на уровне с правами доступа для Оператора.  

Записи ввода:

1

Формат ввода:

Имя

Тип

Описание

context

Строка

Контекст события для подтверждения.

name

Строка

Имя события для подтверждения.

id

Длинное

ID события для подтверждения.

ack

Строка

Текст подтверждения.

author

Строка

Автор подтверждения (факультативное поле, используется username активного пользователя, если автор не был задан). Это простое текстовое поле, поэтому его не следует считать проверяемым (auditable) (должно быть всегда точным).

Записи вывода:

0

Формат вывода:

нет

Обогатить событие

Добавляет новое обогащение к событию.

Имя функции:

enrich

Права доступа:

Accessible at Engineer permission level

Записи ввода:

1

Формат ввода:

Имя

Тип

Описание

context

Строка

Контекст события для подтверждения.

name

Строка

Имя события для подтверждения.

id

Длинное

Идентификатор события для подтверждения.

enrichmentName

Строка

Имя обогащения. Может содержать только английские буквы, цифры и подчеркивания.

enrichmentValue

Строка

Строка значения обогащения. Цифры, даты и другие типы обогащений должны быть закодированы в строки с использованием метода, предпочтительного для инструментов, которые должны будут позже анализировать это обогащение.

Записи вывода:

0

Формат вывода:

Отсутствует

Удалить событие

Навсегда удаляет событие из истории событий.

Имя функции:

delete

Права доступа:

Доступно на уровне с правами доступа для Менеджера.

Записи ввода:

0...не ограничено

Формат ввода:

Имя

Тип

Описание

context

Строка

Путь контекста события, в котором произвошло событие.

name

Строка

Имя события.

id

Длинное

Идентификатор события.

Записи вывода:

0

Формат вывода:

нет

Удалить истекшие события

Удаляет все истекшие события из истории событий. Обратите внимание, что обычно все истекшие события автоматически удаляетSberMobile Server при периодическом выполнении этой функции.

Имя функции:

removeExpired

Права доступа:

Доступно на уровне с правами доступа для Инженера.

Записи ввода:

0

Формат ввода:

нет

Записи вывода:

0

Формат вывода:

нет

Получить историю события

Возвращает историю определенного события. См. действие Просмотреть историю событий.

Имя функции:

get

Права доступа:

Доступно на уровне с правами доступа для Наблюдателя.

Записи ввода:

0

Формат ввода:

Имя

Тип

Описание

mask

Строка

Контекстная маска, определяющая ряд контекстов, из которых необходимо выбрать события.

event

Строка

Имя события.

filter

Строка

Текст выражения для фильтрации событий или NULL для отключения фильтрации.

Среда вычисления выражения фильтра:

Контекст по умолчанию

Контекст, в котором произошло событие.

Таблица данных по умолчанию

Таблица данных события.

Ряд по умолчанию

0

Переменные среды

Имя переменной

Тип значения

Описание

id

Длинное

Уникальный идентификатор события.

context

Строка

Полный путь к контексту события.

event

Строка

Имя события.

level

Целое

Уровень события.

time

Дата

Временная метка события.

acknowledgements

Таблица данных

Таблица подтверждений события.

enrichments

Таблица данных

Таблица обогащений события.

fromDate

Дата

Временная метка, используемая для выбора только тех событий, которые произошли после определенной даты. Если значение NULL, будут выбраны все события.

toDate

Дата

Временная метка, используемая для выбора только тех событий, которые произошли до определенной даты. Если значение NULL, будут выбраны все события.

dataAsTable

Булевое

Это скрытое поле.

Если оно равно false (по умолчанию), поле таблицы данных каждого события помещается в отдельное поле вывода функции.

Если оно равно true, таблица данных каждого события помещается в отдельное поле (тип - Таблица данных) вывода функции.

sortField

Строка

Это скрытое поле. Оно определяет порядок сортировки событий:

  • context - сортировать по пути источника контекста
  • name - сортировать по названию типа события
  • creationtime - сортировать по времени создания
  • expirationtime - сортировать по времени истечения
  • level - сортировать по уровню
  • count - сортировать по количеству дублированных событий

sortAscending

Булевое

Это скрытое поле. Оно определяет, должен ли использоваться восходящий порядок сортировки.

limit

Целое

Это скрытое поле. Оно определяет максимальное количество событий для загрузки или NULL для загрузки всех доступных событий. Эта опция не совместима с фильтрацией.

additionalCriteria

Таблица данных

Это скрытое поле. Определяет дополнительные критерии фильтрации уровня хранения. Подходит только для реляционных БД.

Иля поля

Тип значения

Описание

logical

Integer

Логическая операция:

  • 0 - НЕТ
  • 1 - И
  • 2 - ИЛИ

type

Integer

Тип фильтра:

  • 0 - Условие
  • 1 - Вложенное условие

column

String

Имя столбца.

operation

String

Операция фильтрации. Доступны следующие операции:

  • EQUALS
  • IS_GREATER_THAN
  • IS_GREATER_OR_EQUAL_THAN
  • IS_LESS_THAN
  • IS_LESS_OR_EQUAL_THAN

value

String

Значение столбца.

nested

Data Table

Определяет вложенное условие.

Записи вывода:

0...не ограничено

Формат вывода:

динамический

Имя

Тип

Описание

eId

Длинное

Идентификатор события (скрытое поле).

eCreationtime

Дата

Время создания события.

eExpirationtime

Дата

Время истечения события.

eContext

Строка

Путь контекста источника события.

eName

Строка

Имя типа события.

eLevel

Целое

Уровень события.

eCount

Целое

Количество событий (если подобные события были блокированы дедупликацией).

eAcknowledgements

Таблица данных

Подтверждения события.

eData

Таблица данных

Данные, специфичные для события. Это поле будет включено в вывод, только если включены настройки ввода dataAsTable.

*

*

Оставшиеся поля будут добавляться, только если выключены настройки ввода dataAsTable. Количество, имена, типы и другие параметры полей будут соответствовать тем, которые заявлены в определении событий.

Получить события по идентификатору

Возвращает одно событие с определенным идентификатором.

Имя функции:

getById

Права доступа:

Доступны на уровне с правами доступа для Наблюдателя

Записи ввода:

1

Формат ввода:

Имя

Тип

Описание

context

Строка

Контекст события.

event

Строка

Имя типа события.

id

Длинное

Идентификатор события.

dataAsTable

Булевое

Это скрытое поле.

Если оно равно false (по умолчанию), каждое поле таблицы данных события помещается в отдельное поле вывода функции.

Если равно true, каждая таблица данных события помещается в одно поле (тип - Таблица данных) вывода функции.

Записи вывода:

1

Формат вывода:

Динамический:

Имя

Тип

Описание

eId

Длинное

Идентификатор события (скрытое поле).

eCreationtime

Дата

Время создания события.

eExpirationtime

Дата

Время истечения события.

eContext

Строка

Путь контекста источника события.

eName

Строка

Имя типа события.

eLevel

Целое

Уровень события.

eCount

Целое

Количество событий (если подобные события блокировались дедупликацией).

eAcknowledgements

Таблица данных

Подтверждения события.

eData

Таблица данных

Данные, специфичные для события. Это поле будет включено в вывод, только если включены настройки ввода dataAsTable.

*

*

Оставшиеся поля будут добавляться, только если выключены настройки ввода dataAsTable. Количество, имена, типы и другие параметры полей будут соответствовать тем, которые заявлены в определении событий.

Удалить события

Удаляет события из истории событий.

Имя функции:

massDelete

Права доступа:

Доступно на уровне с правами доступа для Инженера.

Записи ввода:

1

Формат ввода:

Имя

Тип

Описание

mask

Строка

Контекстная маска, определяющая ряд контекстов, из которых необходимо удалить события.

event

Строка

Имя события.

startDate

Дата

Nullable (Нет данных). Если задано, удаляются только те события, которые возникают после startDate.

endDate

Дата

Nullable (Нет данных). Если задано, удаляются только те события, которые возникли до endDate.

Записи вывода:

0

Формат вывода:

нет

Общие события

[?]

Общие события: info (информация)