stumpless下载 - stumpless源代码下载

stumpless

C#源码

v2.2.0

下载

AC记录库为高性能和丰富的功能集建立。

한국어| 简体中文

关键功能|构建和安装|基本用法|贡献

关键功能

Stampless具有许多功能，可以使C快速轻松地登录：

登录许多东西，例如Splunk，Rsyslog，JournalD，Windows Event Log，Sqlite等！
结构化和非结构化日志以适合您的需求
建立在Linux，Windows，Mac，FreeBSD，Mingw，Mingw，Msys2，Cygwin，DOS等上！
线程安全
可以在编译期间调整或删除，以零运行时成本
用于多种语言的本地化？？？？？？？？？？？？？？？？？？？？？？？（加你！）
易于获取文档，示例和支持。

它可以登录什么？

该库的主要目标是为各种日志目标提供一致的记录接口。这意味着您可以专注于定义事件以及您希望它们去的地方，而无需找到其他SDK或添加守护程序和插件以将它们带到所需的位置。 Stumpless可以写日志：

简单的角色缓冲区
文件和流
UNIX插座（例如本地系统守护程序）
网络服务器（IPv4或IPv6，TCP或UDP）
SystemD JournalD服务
SQLITE3数据库
Windows事件日志
自定义功能，适用于您可能需要的任何其他功能！

看不到你需要什么吗？在您的请求中创建一个问题，我们将其纳入路线图！

快速构建并安装

Stumpless仅需要CMAKE和CMAKE支持的构建工具链（例如GCC或Visual Studio）才能构建。

 # cloning the latest version of the source tree
git clone [email protected]:goatshriek/stumpless.git

# creating a new build directory
mkdir build
cd build

# configuring the new build
cmake ../stumpless

# building stumpless (with 4 threads - adjust as desired)
cmake --build . --parallel 4

# install the library (you probably need sudo to do this)
sudo cmake --install .

查看安装说明，以获取有关在不同环境和/或其他工具链中构建和安装Stumpless的更多详细信息。

基本用法

最简单的入门方法是将stumplog函数用作标准库的syslog函数的直接替换：

 // if you're used to doing this:
syslog ( LOG_INFO | LOG_USER , "My message #%d" , count );

// then you can start by changing to this:
stumplog ( LOG_INFO | LOG_USER , "My message #%d" , count );

如果您尚未打开目标，则将将消息记录到平台的默认目标：在Linux上，这是/dev/log ，在Mac系统上，这将是/var/run/syslog ，在Windows计算机上，它是Windows Event Log。如果您在调用stumplog之前打开目标，甚至几个目标，则将日志发送到最近打开的目标。

如果您想要一个更短的函数调用，则可以使用stump功能将消息发送到当前目标。您也可以像printf一样使用格式指示符：

 stump ( "Login attempt failure #%d for user %s" , count , username );

如果您不需要格式指定符，请使用其中一个_str型号：既快速又更安全！

 stump_str ( "Login failure! See structured data for info." );

如果要打开特定目标而不是使用默认值，则只需打开所需的目标并开始发送消息即可。例如，登录到名为example.log的文件：

 target = stumpless_open_file_target ( "example.log" );

// uses the last opened target by default
stump ( "Login attempt failure #%d for user %s" , count , username );

通过网络将消息发送到Splunk或rsyslog之类的东西同样容易：

 target = stumpless_open_udp4_target ( "send-to-splunk-example" ,
                                     "mylogserver.com" ); // or use an IP
stump ( "Login attempt failure #%d for user %s" , count , username );

如果您有多个目标，则可以将消息发送到这样的目标：

 stumpless_add_message ( target ,
                       "Login attempt failure #%d for user %s" ,
                       count ,
                       username );

严重的速记

通常在记录呼叫中直接指定严重程度级别，因此Stumpless提供了一些宏观功能，以使其详细且效率更高。例如，要登录信息的严重性，您可以执行此操作：

 stump_i ( "this gets logged as an info message" );

而且，如果您还要查看源文件，行号和函数名称信息，则可以使用_t （'t'用于跟踪）：

 stump_t ( "this includes source info" );

使用这些函数具有附加的好处，即可以通过简单地定义STUMPLESS_ENABLE_UPTO或STUMPLESS_DISABLE_DOWNTO符号来在编译时删除它们。这使得可以轻松更改构建之间的记录级别，例如，具有产品和调试版本而没有其源代码差异。

 // be sure to define this before stumpless.h gets included
#define STUMPLESS_ENABLE_UPTO_INFO

// ...

// this log will go through just fine
stump_i ( "I'm doing that thing you asked" );

// this debugging message is completely removed: no runtime impact whatsoever
stump_d ( "DEBUG info: %d, %d, %s" , thing_1 , thing_2 , stringy_thingy );