Introduction:

OS	GCC	CLANG
OSX
Linux

fn-log is an open source C++ lightweight & cross platform log library. It's an iteration from log4z.
It provides in a C++ application log and trace debug function for 7*24h service program.
Support 64/32 of windows/linux/mac/android/iOS.
fn-log是一款开源的轻量级高性能的跨平台日志库, 从log4z迭代而来, 主要针对7*24小时服务器程序的日志输出与跟踪调试,
支持64/32位的windows/linux/mac/android/iOS等操作系统.

Feature:

文件写入可以达到300万行/秒, UDP 50万/秒, 关闭文件flush(系统定时自动flush)则可高达3100万行/秒.

自定义的配置解析器简洁易用

Example

Log Format

[20190514 16:47:20.536][ALARM] [15868]channel [0] start.

[20190514 16:47:20.548][DEBUG] [15868] fn-log\tests\simple_test.cpp:<40> main log init success
[20190514 16:47:20.548][DEBUG] [15868] fn-log\tests\simple_test.cpp:<42> main now time:1557823640;
[20190514 16:47:20.548][DEBUG] [15868] fn-log\tests\simple_test.cpp:<44> main hex text:
	[
	[0x7FF67B00B4B4:  f  n  l  o  g  . 
	[0x7FF67B00B4B4: 66 6E 6C 6F 67 00 
	]
	
[20190514 16:47:20.548][ALARM] [15868] fn-log\tests\simple_test.cpp:<46> main finish

Fast Use Example With Out Yaml File

#include "fn_log.h"

int main(int argc, char* argv[])
{
    int ret = FNLog::FastStartDefaultLogger();
    if (ret != 0)
    {
        return ret;
    }

    LogAlarm() << "log init success";

    LogDebug() << "now time:" << time(nullptr) << ";";
    LOGD("now time:" << time(nullptr) << ";");
    LogDebugPack(0, 0, "now time:", time(nullptr), ";");
    
    LogAlarm() << "finish";

    return 0;
}

Fast Use Example With Yaml File

yaml file

# 配表文件  

 hot_update: true
# 0通道为多线程带文件和屏显输出
 - channel: 0  
    priority: trace
    category: 0
    category_extend: 0
    -device: 0
        disable: false
        out_type: file
        priority: trace
        category: 0
        category_extend: 0
        path: "./log/"
        file: "$PNAME_$YEAR$MON$DAY"
        rollback: 4
        limit_size: 1000 m #only support M byte
    -device: 1
        disable: false
        out_type: screen
        category: 0
        category_extend: 0
 # 1通道为多线程不挂任何输出端
 - channel: 1

 # 2通道为单线程同步写文件
 - channel: 2
    sync_write: 1 #only support single thread
    -device: 0
        disable: false
        out_type: file

 # 3通道为单线程无输出端
 - channel: 3
    sync_write: 1 #only support single thread

code

#include "fn_log.h"

int main(int argc, char* argv[])
{
    int ret = FNLog::LoadAndStartDefaultLogger("./log.yaml");
    if (ret != 0)
    {
        return ret;
    }
    
    int limit_second = 50;
    while (limit_second > 0)
    {
        LogDebug() << "default channel.";
        LogDebugStream(1, 0) << "channel:1, category:0.";
        LogDebugStream(2, 0) << "channel:2, category:0.";
        LogDebugStream(3, 0) << "channel:3, category:0.";
        std::this_thread::sleep_for(std::chrono::milliseconds(1000));
        limit_second--;
    }


    LogAlarm() << "finish";
    return 0;
}

How To Use

multi header file

cp src/include/*.h to dst project.

single header file

cp fn_log.h.only to dst project and remove suffix ".only"

the file fn_log.h.only merge from src/include/*.h

Supported Compilers

GCC >= 4.8
MSVC >= VS2015
CLANG >= 3.3

How To Test

mkdir build
cd build
cmake ..
make
cd ../bin
./buffer_test
./buffer_correct_test
./load_config_test
./simple_test
./stress_udp_test
./stress_test
./multi-thread_test
./multi-thread_write_file_test

Yaml Manual

Global Option:

hot_update

option: true false
default: false
desc: moniter yaml file modify and update logger option.

Channel Option: (channel.)

sync

option: async syncring
default: async
desc: async support multi-thread write, other not.
desc: sync is sync write file and flush file every write op.
desc: ring is async write file but only support single thread write, it's ring-buffer channel impl.
priority

option: trace debug info warn error alarm fatal
default: trace
desc: log will discard when log priority less than filter priority.
category
category_extend

option:
default: 0, invalid value.
desc: log will reserve when category in set [category, category+category_extend], and other not.

Device Option: (channel.device.)

disable

option: true, false
default: true
desc: the device will ignore in proc log when this option is disable state.
out_type

option: null, file, udp, screen
default: null
desc: as the option name.
priority

option: trace debug info warn error alarm fatal
default: trace
desc: log will not process when log priority less than filter priority.
category
category_extend

option:
default: 0, invalid value.
desc: log will process when category in set [category, category+category_extend], and other not.
udp_addr

option:
default:
desc: in out_type:udp valid.
desc: example format 127.0.0.1_8080
path

option:
default: "./"
desc: in out_type:file valid.
desc: out file path.
file

option:
default: "$PNAME_$YEAR$MON$DAY_$PID."
desc: in out_type:file valid.
desc: diy out file name. support escape string: $PNAME $PID $YEAR $MON $DAY $HOUR $MIN $SEC
rollback

option: default: 0
desc: in out_type:file valid.
desc: 0 is no rollback op, and other number is rollback file count.
limit_size

option: default: 0
desc: in out_type:file valid.
desc: 0 is no limit, and other number is rollback file limit size (M byte).
```
stress_test_2019.log
stress_test_2019.log.1
stress_test_2019.log.2
stress_test_2019.log.3
```

About The Author

Author: YaweiZhang
Mail: yawei.zhang@foxmail.com
QQGROUP: 524700770
GitHub: https://github.com/zsummer/fn-log

yoshiny/fn-log