Идентификаторы инцидентов и агрегаций инцидентов
При создании инцидентов и агрегаций инцидентов генерируются уникальные идентификаторы в определенном формате.
Зачем настраивать идентификаторы
Инкрементные идентификаторы короче случайных UUID, поэтому их удобнее использовать при поиске объектов, в отчетах и при обсуждении инцидентов. Суффикс позволяет дополнительно обозначить среду или другой контекст, например prod для продуктивной среды.
Если последовательная нумерация не требуется, настройка use_incremental_ids позволяет использовать случайные UUID. Настройки блокировки управляют параллельной генерацией инкрементных идентификаторов и обычно не требуют изменения.
Формат идентификаторов
Общий формат идентификаторов инцидентов: INC-<YYMMDD>-<unique_id>.
Общий формат идентификаторов агрегаций инцидентов: AGG-<YYMMDD>-<unique_id>.
Где:
<YYMMDD>— дата создания объекта в формате год-месяц-день<unique_id>— числовой счетчик, инкрементируемый при создании каждого нового объекта
Если во время генерации идентификатора возникнет ошибка, вместо <unique_id> объекту будет присвоен случайный UUID.
Настройки Incident Manager для генерации идентификаторов
Для регулирования генерации идентификаторов используются следующие настройки Incident Manager:
| Название | Синтаксис | Значение по умолчанию | Описание |
|---|---|---|---|
use_incremental_ids | <boolean> | true | При значении true используются идентификаторы в указанном выше формате, при значении false создаются случайные UUID. |
default_incident_suffix | <string> | "" | Если значение суффикса не пустое, оно будет добавляться в идентификаторы всех инцидентов и агрегаций инцидентов. В таком случае формат будет следующим: INC/AGG-<suffix>-<YYMMDD>-<unique_id> |
acquire_lock_timeout | <int> | 10 | Интервал ожидания между повторными попытками захвата блокировки при генерации идентификаторов. Значение указывается в миллисекундах. |
lock_expiration_timeout | <int> | 60000 | Максимальное время удержания блокировки. При превышении интервала блокировка считается просроченной, а другие потоки могут ее захватить. Значение указывается в миллисекундах. |
Получить текущие настройки можно с помощью запроса:
GET _core/im_settings/incident-manager-settings
Значения настроек acquire_lock_timeout и lock_expiration_timeout не рекомендуется изменять без необходимости.
Изменение настроек
Чтобы изменить настройки, выполните запрос в консоли разработчика (Навигационное меню - Параметры системы - Консоль разработчика). В теле запроса укажите настройки, которые требуется изменить.
Чтобы использовать случайные UUID вместо инкрементных идентификаторов, выполните запрос:
PUT _core/im_settings/incident-manager-settings
{
"use_incremental_ids": false
}
Чтобы включить инкрементные идентификаторы и добавить к ним суффикс prod, выполните запрос:
PUT _core/im_settings/incident-manager-settings
{
"use_incremental_ids": true,
"default_incident_suffix": "prod"
}
Чтобы удалить суффикс, передайте пустую строку:
PUT _core/im_settings/incident-manager-settings
{
"default_incident_suffix": ""
}
Измененные настройки применяются при генерации идентификаторов новых инцидентов и агрегаций и не изменяют идентификаторы уже созданных объектов.
Примеры идентификаторов
INC-250417-2017 — инцидент был создан 17 апреля 2025 года и имеет уникальный номер 2017.
AGG-prod-250417-41 — агрегация была создана 17 апреля 2025 года и имеет уникальный номер 41. Значение настройки default_incident_suffix было равно prod.