Документация для разработчиков
Темная тема

GetList

int
CEventLog::GetList(
	arOrder = Array
		("ID" => "DESC"),
	arFilter = array(),
	$arNavParams = false
)

Метод возвращает отфильтрованный и отсортированный список записей в логе. Нестатический метод.

Параметры

ПараметрОписание С версии
Order Массив для сортировки результата. Массив вида array("поле сортировки"=>"направление сортировки" [, ...]). Поле для сортировки может принимать значения:
  • ID - идентификатор записи;
  • TIMESTAMP_X - Время в Unix-формате.
Направление сортировки может принимать значения:
  • asc - по возрастанию;
  • desc - по убыванию.
Filter Массив вида array("фильтруемое поле"=>"значение" [, ...]), может принимать значения:
  • SEVERITY - степень важности записи. Доступны значения: SECURITY или WARNING, для иного система установит UNKNOWN.
  • AUDIT_TYPE_ID - собственный ID типа события.
  • MODULE_ID - модуль, с которого происходит запись в лог.
  • ITEM_ID - ID объекта, в связи с которым происходит добавление (пользователь, элемент ИБ, ID сообщения)
  • REMOTE_ADDR - IP, с которого обратились.
  • USER_AGENT - браузер.
  • REQUEST_URI - URL страницы.
  • SITE_ID - ID сайта, к которому относится добавляемое событие.
  • USER_ID - ID пользователя.
  • GUEST_ID - ID пользователя из модуля статистики.
  • DESCRIPTION - собственно описание записи лога, или техническая информация.
  • TIMESTAMP_X_1 - поля фильтра для выборке по диапазону дат, старт диапозона. Формат - dd.mm.yyyy hh:mm:ss
  • TIMESTAMP_X_2 - поля фильтра для выборке по диапазону дат, конец диапозона. Формат - dd.mm.yyyy hh:mm:ss.
arNavParams Массив настроек постраничной навигации.12.0.9

TIMESTAMP_X_1 и TIMESTAMP_X_2 - поля фильтра для выборке по диапазону дат. Формат - dd.mm.yyyy hh:mm:ss

Примеры использования

<?

?>


Пользовательские комментарии

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

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Татьяна Сморудова
Если нужно сделать выборку по нескольким модулям или типам событий, нужно записать ключи в виде "=AUDIT_TYPE_ID" и "=MODULE_ID" и передать массив.
По дефолту по всем ключам ожидается строка.

К примеру, выборка по событиям журнала вторжений:
Код
$queryEventLogs = \CEventLog::GetList(
 ["ID" => "DESC"], 
 [
  "=AUDIT_TYPE_ID" => [
   "SECURITY_FILTER_PHP", 
   "SECURITY_FILTER_SQL", 
   "SECURITY_FILTER_XSS", 
   "SECURITY_FILTER_XSS2", 
   "SECURITY_OTP",
   "SECURITY_REDIRECT",
   "SECURITY_VIRUS"
  ]
 ]
);
0
Вячеслав Королев
Чтобы отфильтровать по диапазону дат, например за последний час, то:
Код
$startTime = date("d.m.Y h:i:s", time() - (60*60));
$endTime = date("d.m.Y h:i:s", time());
$queryEventLogs = CEventLog::GetList(["ID" => "DESC"], ["TIMESTAMP_X_1" => $startTime, "TIMESTAMP_X_2" => $endTime], false);
    while ($eventLog = $queryEventLogs -> fetch()) {
}
Обратите внимание на формат даты.  
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх