Системные требования и особенности

Библиотека логирования и WFC-фреймворка, с большими возможностями кастомизации с помощью опций, обработчиков и конфигурационного файла в формате JSON.

Документация doxygen.
Репозитарий на github.com.
Отчет coverage

Каждая строка лога состоит из временной отметки, имени лога (по умолчанию WLOG), типа сообщения и текста сообщения. Запись в лог осуществляется с помощью набора макросов, например:

#define WLOG_ENABLE_DEBUG_LOG // Don't disable DEBUG and TRACE in Release

#include <wlog/wlog.hpp>
#include <wlog/init.hpp>

int main()
{
  wlog::init("example.log");
  WLOG_MESSAGE( "Example N" << 1 << " message" )
  WLOG_WARNING( "Example N" << 1 << " warning" )
  WLOG_ERROR( "Example N" << 2 << " error" )
  WLOG_DEBUG( "Example N" << 3 << " debug" )
  WLOG_TRACE( "Example N" << 4 << " trace" )
  return 0;
}

По умолчанию сообщения DEBUG и TRACE отключаются на уровне препроцессора в Release режиме.

Системные требования и особенности

linux
g++ 4.7 и выше, clang++
cmake 2.8 и выше
Стандарт c++11
thread-safe
Запись в файлы, stdout и syslog
Не header-only
Большие возможности кастомизации форматирования и ротирования как на уровне конфигурации, так и с помощью программных обработчиков
Можно писать наборы логов в разные файлы с различным форматированием (в том числе stdout) и режимами ротации
Динамическое реконфигурирование в любой момент времени
Поддержка JSON-конфигурации с комментариями в Си-стиле

Сборка и установка

make shared && sudo make install
make static && sudo make install

Для сборки примеров и тестов, а также чтобы отключить поддержку JSON-конфигурации:

git clone https://github.com/mambaru/wlog.git
mkdir wlog/build
cd wlog/build
cmake ..
# Для сборки примеров и тестов
cmake -DBUILD_TESTING=ON ..
# Если поддержка JSON не требуется
cmake -DWLOG_DISABLE_JSON=ON ..
cmake --build make
ctest

Для компиляции с поддержкой JSON-конфигурации потребуются header-only библиотеки wjson и faslib, которые система сборки автоматически клонирует в директорию сборки, если не найдет их в системе или на том же уровне файловой системы, куда вы клонировали wlog, но для использования они не нужны.

Подключение как submodule

main.cpp:

#include <wlog/logging.hpp>
#include <wlog/init.hpp>
#include <wlog/load.hpp>

int main()
{
  wlog::init(wlog::load("{}"));
  WLOG_MESSAGE("Hello")
}

Если нужен только wlog

CMakeLists.txt:

cmake_minimum_required(VERSION 2.8)
set(CMAKE_CXX_FLAGS "-std=c++11")
add_subdirectory(wlog)
add_executable(main main.cpp)
include_directories(wlog)
target_link_libraries(main wlog)

git init
git submodule add https://github.com/mambaru/wlog.git
mkdir build
cd build
cmake ..
make

С подключение faslib и wjson

CMakeLists.txt:

cmake_minimum_required(VERSION 2.8)
set(CMAKE_CXX_FLAGS "-std=c++11")
add_subdirectory(faslib)
add_subdirectory(wjson)
add_subdirectory(wlog)
include_directories(wlog wjson faslib)
add_executable(main main.cpp)
target_link_libraries(main wlog)

git init
git submodule add https://github.com/migashko/faslib.git
git submodule add https://github.com/mambaru/wjson.git
git submodule add https://github.com/mambaru/wlog.git
mkdir build
cd build
cmake ..
make

Инициализация

Если не вызвать wlog::init то вывод будет на экран без форматирования и синхронизации. Вызывать wlog::init можно в любое время в любом месте, а также повторно для реконфигурации.

#include <wlog/init.hpp>
#include <wlog/load.hpp>

  // По умолчанию вывод только в clog в цвете
  wlog::init();
  // Выводить с тысячными долями секунд и отключить цветовую раскраску
  wlog::init(wlog::resolutions::milliseconds, wlog::colorized_flags::none);
  // Выводить в файл и clog
  wlog::init("main.log");
  // Выводить с тысячными долями секунд в файл и clog и отключить цветовую раскраску для clog
  wlog::init("main.log", wlog::resolutions::milliseconds, wlog::colorized_flags::none);

  // Так можно задать все остальные опции
  wlog::logger_options opt;
  opt.path="main.log";
  wlog::init(opt);

  // Загрузить конфигурацию из файла
  wlog::init(wlog::load("logger.json"));
  // Загрузить конфигурацию из строки
  wlog::init(wlog::load("{\"path\":\"main.log\"}"));

  // Вариант с проверкой
  std::string err;
  opt = wlog::logger_options();
  if ( wlog::load("logger.json", &opt, &err) )
    wlog::init(opt);
  else
    std::cerr << "ERROR: " << err << std::endl;

Для вывода финального сообщения при завершении работы:

  // Выключаем логирование
  if (auto log = wlog::release() )
  {
    // Глобальный лог уже не доступен
    // Но можем записать в лог финальное сообщение
    log( wlog::time_point::clock::now(), "EXAMPLE4", "FINAL", "Bye!\n" );
  }

Это может быть полезно, если нужна гарантия, что сообщение будет последним в файле лога (например, в многопоточной среде, и/или много отладочных сообщений в деструкторах объектов)

Использование

В каждом сообщении лога присутствуют четыре основные элемента, которые можно кастомизировать или скрывать:

Дата и время + доли секунды
Имя лога
Тип сообщения:
- ERROR - ошибки, после которых система сохраняет работоспособность и согласованность данных
- WARNING - предупреждения, например о превышении размера очереди.
- MESSAGE - прочие уведомления
- FATAL - фатальная ошибка. Обычно далее следует останов системы
- BEGIN - начало какого либо процесса (например загрузка БД)
- END - окончание какого либо процесса (например загрузка БД)
- DEBUG - отладочные сообщения (отключается в релиз-версии на уровне препроцессора )
- TRACE - трассировка ввода/вывода (отключается в релиз-версии на уровне препроцессора )
- PROGRESS - трассировка прогресса длительных операций без перевода строки (например процент загрузки БД)
Сообщение. Произвольный формат

По умолчанию используется лог WLOG в соответствующем наборе макросов:

//wlog/logging.hpp
#define WLOG_ERROR(X)    WLOG_LOG_ERROR   ( "WLOG", X )
#define WLOG_WARNING(X)  WLOG_LOG_WARNING ( "WLOG", X )
#define WLOG_MESSAGE(X)  WLOG_LOG_MESSAGE ( "WLOG", X )
#define WLOG_FATAL(X)    WLOG_LOG_FATAL   ( "WLOG", X )
#define WLOG_BEGIN(X)    WLOG_LOG_BEGIN   ( "WLOG", X )
#define WLOG_END(X)      WLOG_LOG_END     ( "WLOG", X )
#define WLOG_DEBUG(X)    WLOG_LOG_DEBUG   ( "WLOG", X )
#define WLOG_TRACE(X)    WLOG_LOG_TRACE   ( "WLOG", X )
#define WLOG_PROGRESS(X) WLOG_LOG_PROGRESS( "WLOG", X )

Аналогичным образом можно сделать свой набор макросов для каждого лога. Если не устраивает предлагаемых сообщений, то можно задать свой, аналогично набору макросов для работы с syslog:

//wlog/logging.hpp
#define WSYSLOG_EMERG(X)   WLOG( "SYSLOG", "EMERG",   X)
#define WSYSLOG_ALERT(X)   WLOG( "SYSLOG", "ALERT",   X)
#define WSYSLOG_CRIT(X)    WLOG( "SYSLOG", "CRIT",    X)
#define WSYSLOG_ERR(X)     WLOG( "SYSLOG", "ERR",     X)
#define WSYSLOG_WARNING(X) WLOG( "SYSLOG", "WARNING", X)
#define WSYSLOG_NOTICE(X)  WLOG( "SYSLOG", "NOTICE",  X)
#define WSYSLOG_INFO(X)    WLOG( "SYSLOG", "INFO",    X)
#define WSYSLOG_DEBUG(X)   WLOG( "SYSLOG", "DEBUG",   X)

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

WLOG_MESSAGE("Это " << 10 << " сообщение" )
WLOG_ERROR("Это " << 25 << " ошибка" )

Конфигурирование

Здесь и далее будут приводиться примеры конфигурации в JSON-формате. Имена полей полностью совпадают с полями структур конфигурации. В неочевидных случаях, например при использовании перечислений, будут приведены примеры на C++. JSON-конфигурация, со значениями по умолчанию. Если значения по умолчанию вас устраивают, то эти поля можно удалять:

{
  /* Список доступных логов и типов сообщений */
  "allow": [],
  /* Список запрещенных логов и типов сообщений */
  "deny": [],
  /* Путь к файлу лога */
  "path": "",
  /* Синхронная запись (открыть-записать-закрыть) */
  "sync": true,

  /* --- Опции ротации --- */

  /* Начинать лог с начала файла (старый лог сохраняется, если задан rotation) */
  "startup_rotate": false,
  /* Ограничение лога по размеру (в байтах) */
  "size_limit": 0,
  /* Ограничение лога по времени (в секундах) */
  "time_limit": 0,
  /* Включить сохранение логов при ротации (макс. кол-во файлов) */
  "rotation": 0,
  /* Сопроводительное сообщение ротирование в начале файла */
  "rotation_header": true,
  /* Сопроводительное сообщение ротирование в конце файла */
  "rotation_footer": true,
  /* По умолчание к имени файла добавляется внутренний счетчи, если указать эту функцию - то unixtime*/
  "unixtime_suffix": false,

  /* --- Опции форматирования --- */
  // Ширина поля имени лога (в символах)
  "name_width": 6,
  // Ширина поля типа сообщения (в символах)
  "ident_width": 9,
  /* Точность отображения времени (от наносекунд до года)  */
  "resolution": "seconds",
  /* Формат представления даты и времени в формате strftime (игнорируется если заданы resolution (от minutes и выше) или любые комбинации hide) */
  "datetime_format": "",
  /* Перечисление скрываемых частей сообщения */
  "hide": "none",
  /* Локаль */
  "locale": "",
  /* Включить цветовую схему при записи в файл */
  "colorized": "none",
  /* Карта цветов*/
  "color_map": {},

  /* --- Кастомизация --- */

  /* Настройки стандартного вывода */
  "stdout": {
    /* Возможные значения: cout, clog, cerr и # для запрета вывода */
    "name":"cout",
    /* Делать flush после каждого сообщения */
    "sync": false,
    /* Включить цветовую схему при записи в stdout */
    "colorized": "all",
    /* -- остальные опции форматирования -- */
  },
  /* Настройки записи в системный лог */
  "syslog": {
    /* Имя для syslog. Если не указан (по умолчанию) то запись в syslog не ведется*/
    "name":""
  },
  /* Индивидуальные настройки для логов и типов сообщений */
  "customize": [ /* рассмотрим далее */ ]
}

Минимальная конфигурация:

{}

В этом случае запись в файл и syslog не производится, а вывод только в std::cout в цвете. Чтобы отключить раскраску:

{
  "stdout": {
    "colorized": "none",
  }
}

Для записи в файл достаточно указать путь:

{
  "path":"/path/to/log/file.log"
}

Чтобы запретить вывод в stdout, а в файл выводить в цвете:

{
  "path":"/path/to/log/file.log"
  "colorized": "none",
  "stdout": {
    "name":"#"
  }
}

Чтобы запретить запись сообщений конкретного лога или типов сообщений всех логов, нужно перечислить их в массиве deny, например для того чтобы отфильтровать "мусор" в Debug режиме:

{
  "path": "/path/to/log/file.log",
  "deny": ["DEBUG", "TRACE"]
}

Чтобы разрешить запись сообщений конкретного лога или некоторые типы сообщений, нужно перечислить их в массиве allow, например для того чтобы разрешить только сообщения лога MYLOG, и сообщения ERROR остальных логов:

{
  "path": "/path/to/log/file.log",
  "allow": ["MYLOG", "ERROR"]
}

Ускорить запись в лог примерно в три раза, но без гарантий в случае аварийных падений:

{
  "path": "/path/to/log/file.log",
  "sync": false
}

Настройки ротации

По умолчанию запись происходит в один и тот же файл, без ограничений. Чтобы при каждом запуске запись происходила с начала файла:

{
  "path": "/path/to/log/file.log",
  "startup_rotate": true
}

Чтобы при этом сохранялся лог от предыдущего запуска в файле /path/to/log/file.log.old-0:

{
  "path": "/path/to/log/file.log",
  "startup_rotate": true,
  "rotation": 1
}

Без указанных ограничений на размер или время, значения rotation больше единицы не дают эффекта. Для обнуления файла при достижении заданного размера (1МБ):

{
  "path": "/path/to/log/file.log",
  "size_limit": 1048576
}

В следующий конфигурации при запуске, запись будет продолжена в указанный лог, но при достижении размера в 1МБ файл будет переименован '/path/to/log/file.log.old-0' и запись начнется с начала файла:

{
  "path": "/path/to/log/file.log",
  "size_limit": 1048576,
  "rotation": 1
}

Запись в новый файл при запуске и сохранении истории в 10 файлов, с размером не более 1 МБ каждый:

{
  "path": "/path/to/log/file.log",
  "startup_rotate": true,
  "size_limit": 1048576,
  "rotation": 10
}

Посуточная ротация файлов с историей за месяц:

{
  "path": "/path/to/log/file.log",
  "time_limit": 86400,
  "rotation": 30
}

Посекундные срезы (например при трассировании трафика при большой нагрузке ):

{
  "path": "/path/to/log/file.log",
  "startup_rotate": true,
  "time_limit": 1,
  "rotation": 1024
}

С помощью unixtime_suffix можно изменить алгоритм формирования файла с простого счетчика на unixtime, например file-1521107160.log. В случае падений или повторной инициализации счетчики сбрасываются и старые файлы не удаляются. В случае с обычными счетчиками они в конечном итоге перезапишутся, а при unixtime нужно удалять вручную. По умолчанию, при ротации, в начало и конец файла записывается дополнительная информация, которую можно с помощью опций rotation_header и rotation_footer:

! ---------------- rotated ----------------
! Start time: Thu Mar 15 12:50:35 2018
! Summary size: 209
! Total Rotated: 1
! Previous log: ./example_j1.log
! -----------------------------------------
2018-03-15 12:50:35.255 WLOG   MESSAGE   Demo progress LOG
2018-03-15 12:50:35.255 WLOG   BEGIN     Progress...
2018-03-15 12:50:35.256 WLOG   WARNING   Test WARNING message №0
2018-03-15 12:50:36.398 WLOG   TRACE     Test TRACE message №1000
2018-03-15 12:50:37.548 WLOG   DEBUG     Test DEBUG message №2000
2018-03-15 12:50:41.002 WLOG   BEGIN     Test BEGIN message №5000
2018-03-15 12:50:42.154 WLOG   END       Test END message №6000
2018-03-15 12:50:43.304 WLOG   MESSAGE   Test MESSAGE message №7000
2018-03-15 12:50:44.455 EXAMPL MESSAGE   Test MESSAGE message №8000
2018-03-15 12:50:45.607 EXAMPL WARNING   Test WARNING message №9000
! ---------------- rotated ----------------
! Start time: Thu Mar 15 12:50:35 2018
! Summary size: 1067
! Total Rotated: 1
! Previous log: ./example_j1.log
! -----------------------------------------

Настройки форматирования

Для отображения долей секунд используется опция resolution со следующими значениями: seconds (без долей), deciseconds, centiseconds, milliseconds, microseconds или nanoseconds, например:

{
  "path": "/path/to/log/file.log",
  "resolution": "milliseconds"
}

Изменить отображение даты и времени можно с помощью дополнительных значений resolution: minutes, hours, days, month, year которые влияют на отображение информации, также как опция hide. Опция hide позволяет скрыть несколько частей сообщения в любой комбинации. Таблица возможных значений для hide:

date - все поле даты
time - все поле времени
year - год в поле даты
month - месяц в поле даты
weekday - день недели в поле даты
days - день месяца в поле даты
hours - часы в поле времени
minutes - минуты в поле времени
seconds - секунды в поле времени
fraction - доли секунды
name - имя лога
ident - идентификатор сообщения
message - текст сообщения

Значения частично скрывающие поля даты и времени влияют на формат отображения этих полей. Частично hide перекрывают resolution. Общая рекомендация - если необходимого представления возможно добиться с помощью опции resolution, то используем ее.

Далее, для удобства, отдельно приведены таблицы для полей даты и времени.

Возможные комбинации для hide и аналогичные resolution для поля времени с примерами отображения:

hide	resolution	Пример отображения
	milliseconds	18:36:12.805
fraction	seconds	18:36:12
fraction\|seconds	minutes	18:36
fraction\|seconds\|minutes	hours	18h

Следующий вывод можно добиться только с помощью hide для resolution==milliseconds:

hide	Пример отображения	Комментарий
hours	01m 55s.405	Сомнительно. Например при поминутных слепках.
hours\|minutes	1514304173.456	Если нужен unixtime.
hours\|minutes\|fraction	1514304173	Если нужен unixtime>. Но лучше hide=hours\|minutes и resolution=seconds
hours\|minutes\|seconds	.456	Бесполезно.
hours\|seconds	26m.37642	Сомнительно (доли минуты в resolution). Например при поминутных слепках.
minutes\|seconds	19h.1631487	Сомнительно (доли часа в resolution). Например при часовых слепках.

Возможные комбинации для hide и аналогичные resolution для поля времени с примерами вывода:

hide	resolution	Пример отображения
time	days	2017-12-27
time\|days	month	2017 Dec
time\|days\|month	year	2017

Следующий вывод даты можно добиться только с помощью hide:

hide	Пример отображения	Комментарий
year	Wed Dec 27
year\|month	Wed 27
year\|month\|weekday	27
month	27 Wed 2017
day	2017 Dec
minutes\|seconds	19h.1631487

Пример:

{
  "path": "/path/to/log/file.log",
  "resolution": "milliseconds",
  "hide":"year|month|seconds"
}

wlog::logger_options opt;
opt.path="/path/to/log/file.log";
opt.resolution = wlog::resolutions::milliseconds;
opt.hide = wlog::hide_flags::year|wlog::hide_flags::month|wlog::hide_flags::seconds;

Wed 27 17:53.17548 WLOG DEBUG Тестовое DEBUG сообщение №22000
Wed 27 17:53.18734 WLOG ERROR Тестовое ERROR сообщение №23000
Wed 27 17:53.19914 WLOG FATAL Тестовое FATAL сообщение №24000

Локализация

Для представления даты и времени в формате strftime можно с помощью опции datetime_format. Но нужно иметь ввиду, что в этом случае нельзя использовать resolution со значениями minutes, hours, days, month, year и любые комбинации hide. Для resolution со значениями deciseconds, centiseconds, milliseconds, microseconds или nanosecondsдоли секунды записываются сразу после строки времени через разделитель.

Для локализации отображения datetime_format используется, соответственно, locale. Задана только locale, но не заданы другие опции форматирования даты и времени, то datetime_format == "%c"

{
  "path": "/path/to/log/file.log",
  "resolution": "milliseconds",
  "locale": "ru_RU.UTF-8"
}

Ср 27 дек 2017 18:03:29,864 EXAMPLE [DEBUG] Тестовое DEBUG сообщение №11000
Ср 27 дек 2017 18:03:31,144 EXAMPLE [ERROR] Тестовое ERROR сообщение №12000
Ср 27 дек 2017 18:03:32,426 EXAMPLE [FATAL] Тестовое FATAL сообщение №13000

{
  "path": "/path/to/log/file.log",
  "resolution": "milliseconds",
  "locale": "en_US.UTF-8"
}

Wed 27 Dec 2017 06:04:35 PM MSK.057 WLOG TRACE Тестовое TRACE сообщение №1000
Wed 27 Dec 2017 06:04:36 PM MSK.331 WLOG DEBUG Тестовое DEBUG сообщение №2000
Wed 27 Dec 2017 06:04:37 PM MSK.608 WLOG ERROR Тестовое ERROR сообщение №3000

Настройки STDOUT

Наследует и/или переопределяет все настройки форматирования. Если опция определена в секции stdout то используется она, если нет, то опция из основной секции или значение по умолчанию. Исключение составляет опция colorized, у которой в основной секции по умолчанию значение none, но если она не определен в секции stdout, то по умолчанию значение all. Иными словами, по умолчанию, в основной лог запись идет без цветовой раскраски, а на экран в цвете. Также по умолчанию sync отключена и не наследуется.

{
  /* ... */
  "stdout": {
    /* Имя стандартного вывода (cout, cerr, clog)*/
    "name": "cout",
    "sync": false,
    "name_width": 6,
    "ident_width": 9,
    "resolution": "seconds",
    "datetime_format": "",
    "hide": "",
    "locale": "",
    "colorized": "all",
    "color_map": {}
  }
}

Если в основной секции определены datetime_format или locale, но вы не хотите их наследовать то используйте значение #, а для resolution и colorized - none. Здесь основная идея в том, что как правило нет нужды применять разное форматирование для файлов и stdout, но если очень хочется, то можно. Чаще всего требуется отключить цветовую раскраску или изменить stdout, а в остальном применяется такое же форматирование как и для файлов.

Кастомные настройки логов

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

{
  /* --- основные настройки --- */
  "customize": [
    {
      "names":["DEBUG", "MYLOG"],
      /* здесь доступны все опции основной секции, за исключением customize*/
    }
  ]
}

Чтобы вывести DEBUG и TRACE сообщения в отдельный файл:

{
  "path": "/path/to/log/file.log",
  "customize": [
    {
      "names":["DEBUG", "TRACE"],
      "path": "/path/to/log/file-Debug.log",
      "sync":false,
      "startup_rotate": true,
      "size_limit": 1048576,
      "rotation": 1,
      "stdout":{"name": "#"}
    }
  ]
}

Здесь в основной файл будет производиться без ротации, а в file-Debug.log ограничение в 1МБ. Также запрещаем выводить эти сообщения в stdout, и отключаем синхронную запись для ускорения. Если не указывать путь, то запись будет вестись в основной файл. Чтобы отладочные сообщения выводить только на экран, а все остальные только в файл:

{
  "path": "/path/to/log/file.log",
  "stdout":{"name": "#"}
  "customize": [
  {
    "names":["DEBUG", "TRACE"],
    "path": "#",
    "stdout":{"name": "cerr"}
  }
  ]
}

Можно выводить все сообщения лога в отдельный файл, или каждый тип сообщений по разным файлам указав в знак $ вместо пути:

{
  /* запрещаем DEBUG и TRACE сообщения
  "deny": ["DEBUG", "TRACE"],
  "path": "/path/to/log/file.log",
  "customize": [
    {
      /* Для всех сообщений MYLOG, включая DEBUG и TRACE*/
      "names":["MYLOG1", "MYLOG2"],
      /* но исключая PROGRESS */
      "deny": ["PROGRESS"],
      /* пишем в /path/to/log/file-MYLOG1.log и /path/to/log/file-MYLOG1.log */
      "path":"$"
    },
    {
      /* Для всех сообщений MYLOG, включая DEBUG и TRACE*/
      "names":["MYLOG3", "MYLOG4"],
      /* пишем MYLOG3 и MYLOG4 в /path/to/log/file-MYLOG34.log */
      "path":"$MYLOG34"
    },    {
      // все сообщения "PROGRESS" выводим только в stdout
      "names":["PROGRESS"],
      "path":"#"
    }
  ]
}

Обратите внимание все сообщения заблокированные deny в секции customize, не отбрасываются, поэтому сообщения PROGRESS будут писаться в основной лог, если не сделать отдельную кастомизацию.

настройки syslog

Для записи в syslog достаточно задать имя в соответствующей секции конфигурации, однако в этом случае в syslog будут писаться все сообщения всех логов, что и в основной файл, а не только лога SYSLOG. Чтобы исправить это:

{
  "path": "/path/to/log/file.log",
  "customize": [
    {
      "names":["SYSLOG"],
      "syslog":{
        "name":"myprj"
      }
    }
  ]
}

Цветовая схема

Для управление цветовой схемой используются опции colorized(для указания раскраски элементов записи лога) и color_map(для изменения цветовой схемы). Значения colorized:

none - отключить раскраску
date - дата
time - время
fraction - доли секунды
name - имя лога
notice - тип сообщения
ident - тип сообщения
message - текст сообщения (если не задан в color_map, то в цвет ident)
all - включить в раскраску все элементы

Для цветовой схемы, в качестве ключа используется имя лога, тип сообщения или одно из специальных значений:

$all - всю строку одним цветом (например чтобы выделить ошибку)
$date - цвет даты
$time - цвет времени
$fraction - доли секунды
$name - цвет имени лога
$ident - цвет типа сообщения
$message - цвет текста сообщения

В качестве значения номер цвета, или его названия


black	30
red	31
green	32
brown	33
blue	34
magenta	35
cyan	36
gray	37
dark_gray	90
light_red	91
light_green	92
yellow	93
light_blue	94
light_magenta	95
light_cyan	96
white	97

Раскрашиваем имя лога MYLOG в пурпурный цвет :

{
  "stdout": {
    "color_map":{"MYLOG":"light_magenta"}
  }
}

Делаем для сообщений FATAL красный фон:

{
  "customize": [
    {
      "names":["FATAL"],
      "stdout": {
        "color_map":{"$all":"41"}
      }
    }
  ]
}

Name		Name	Last commit message	Last commit date
Latest commit History 411 Commits
.ci/.orig		.ci/.orig
.cppcheck		.cppcheck
.github		.github
cmake		cmake
config		config
examples		examples
external		external
tests		tests
wlog		wlog
wlogjson		wlogjson
.dockerignore		.dockerignore
.gitignore		.gitignore
.gitmodules		.gitmodules
.travis.yml		.travis.yml
AUTHORS		AUTHORS
CMakeLists.txt		CMakeLists.txt
Dockerfile		Dockerfile
Doxyfile		Doxyfile
LICENSE		LICENSE
Makefile		Makefile
Readme.md		Readme.md
customdoxygen.css		customdoxygen.css
remove~.sh		remove~.sh
version.yml		version.yml

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Системные требования и особенности

Сборка и установка

Подключение как submodule

Если нужен только wlog

С подключение faslib и wjson

Инициализация

Использование

Конфигурирование

Настройки ротации

Настройки форматирования

Локализация

Настройки STDOUT

Кастомные настройки логов

настройки syslog

Цветовая схема

About

Releases

Packages

Contributors 2

Languages

License

mambaru/wlog

Folders and files

Latest commit

History

Repository files navigation

Системные требования и особенности

Сборка и установка

Подключение как submodule

Если нужен только wlog

С подключение faslib и wjson

Инициализация

Использование

Конфигурирование

Настройки ротации

Настройки форматирования

Локализация

Настройки STDOUT

Кастомные настройки логов

настройки syslog

Цветовая схема

About

Resources

License

Stars

Watchers

Forks

Releases

Packages 0

Contributors 2

Languages

Packages