Документация для версии Axxon Next 4.5.0 - 4.5.10. Документация на другие версии также доступна.

Предыдущая страница Получение списка срабатываний детекторов  Получение событий аудита из системного журнала Следующая страница

GET http://IP-адрес:порт/префикс/archive/events/alerts/{ENDTIME}/{BEGINTIME} - получение тревог со всех Серверов Axxon-домена.

Примечание

Синтаксис ENDTIME и BEGINTIME описан в разделе Получение содержания архивов.

Внимание!

Если в запросе ENDTIME < BEGINTIME, то события в ответе будут отсортированы по возрастанию времени. 

Если ENDTIME > BEGINTIME, то сортировка будет по убыванию.

GET http://IP-адрес:порт/префикс/archive/events/alerts/{HOSTNAME}/{ENDTIME}/{BEGINTIME} - получение тревог с конкретного Сервера.

{HOSTNAME} - имя Сервера (см. Получение списка серверов).

GET http://IP-адрес:порт/префикс/archive/events/alerts/{VIDEOSOURCEID}/{ENDTIME}/{BEGINTIME} - получение тревог с конкретной видеокамеры.

{VIDEOSOURCEID} - трехкомпонентный идентификатор endpoint-а источника (см. Получение списка источников видео (камер)).  Например, "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".

ПараметрОбязательныйОписание
limitНетЛимит тревог в ответе. Если не задан, по умолчанию 100.
offsetНетСмещение результатов выдачи на заданное число. Например, если запрос с offset=0 вернул 100 результатов, то для получения следующих необходимо выполнить запрос с offset=100. Если на второй запрос было возвращено 250 результатов, то для получения следующих требуется задать в запросе offset=350 и т.д.
limit_to_archiveНет

Доступен, начиная с Axxon Next 4.4.1.9150.

Если limit_to_archive=1, то ответ вернет события только из доступной части архива (см. Настройка ограничения доступности архива).

archiveНет

Доступен, начиная с Axxon Next 4.4.1.9150.

Имя архива из запроса получения списка архивов (см. Получение содержания архивов).

Пример запроса:

GET http://127.0.0.1:80/archive/events/alerts/Server1/past/future?limit=50&offset=0

Пример ответа:

{
    "events": [
        {
            "type": "alert",
            "id": "2bb7f765-eb57-604d-a38c-d1d26d22e4d9",
            "raisedAt": "20181219T151437.312808",
            "zone": "hosts/DESKTOP-O0P0IBQ/DeviceIpint.1/SourceEndpoint.video:0:0",
            "reasons": [
                "ruleAlert",
                "videoDetector"
            ],
            "initiator": "faceAppeared",
            "reaction": {
                "user": "",
                "reactedAt": "20181219T151937.342036",
                "severity": "unclassified"
            },
            "detectorName": "1.Детектор лиц",
            "rectangles": [
                {
                    "index": "47",
                    "left": "0,85343749999999996",
                    "top": "0,37958333333333333",
                    "right": "1",
                    "bottom": "0,58083333333333331"
                }
            ]
        },
        {
            "type": "alert",
            "id": "03c0d49f-5475-684e-a622-2aaeac303508",
            "raisedAt": "20181219T151005.933417",
            "zone": "hosts/DESKTOP-O0P0IBQ/DeviceIpint.1/SourceEndpoint.video:0:0",
            "reasons": [
                "ruleAlert",
                "videoDetector"
            ],
            "initiator": "faceAppeared",
            "reaction": {
                "user": "root",
                "reactedAt": "20181219T151013.109256",
                "severity": "alarm"
            },
            "detectorName": "1.Детектор лиц",
            "rectangles": [
                {
                    "index": "9",
                    "left": "0,83406249999999993",
                    "top": "0,36416666666666664",
                    "right": "1",
                    "bottom": "0,58583333333333332"
                }
            ]
        },
        {
            "type": "alert",
            "id": "6d396f93-4acf-c54b-a26e-c1ab178bdb06",
            "raisedAt": "20181219T150911.101417",
            "zone": "hosts/DESKTOP-O0P0IBQ/DeviceIpint.1/SourceEndpoint.video:0:0",
            "reasons": [
                "userAlert"
            ],
            "initiator": "root",
            "reaction": {
                "user": "root",
                "reactedAt": "20181219T150916.264631",
                "severity": "alarm"
            },
            "detectorName": "",
            "rectangles": []
        }
    ],
    "more": false
}
ПараметрОписание
raisedAtПоле raisedAt не уникальное, поэтому может понадобиться пропуск уже полученных ранее тревог от начала интервала поиска.
reasonsВозможные значения в массиве reasons: armed, disarmed, userAlert, ruleAlert, videoDetector, audioDetector, ray.
severityВозможные значения поля severity: unclassified, false, notice, warning, alarm.
initiator:

Возможные значения поля initiator:

  1. Имя пользователя, инициировавшего тревогу.
  2. Id макрокоманды (см. Макрокоманды), если тревога инициирована макрокомандой, которая была запущена НЕ детектором. При этом следует иметь в виду, что данная макрокоманда может быть уже удалена из конфигурации.
  3. Тип детектора, который вызвал сработку макрокоманды, которая инициировала тревогу (см. Получение списка срабатываний детекторов).
  • No labels