文章目录
- Syslog 概述
- syslog 协议标准
- syslog API
- syslog 日志文件
- 日志文件介绍
- 日志配置
- 产生本地日志
- 参考文章
Syslog 概述
syslog 常被称为系统日志或系统记录，系统日志通过 syslog 进程记录系统的有关事件，也可以记录应用程序运作事件。通过适当配置，甚至可以实现运行 syslog 协议的机器之间的通信。
早期的 syslog 日志服务对应的是 syslogd 守护进程，而目前很多 linux 发行版本已经使用 rsyslog 服务替换了 syslog 服务预装在 linux 系统中了，相应的守护进程就变成了rsyslogd（ubuntu 18中已经更新为 rsyslog）。
syslog 协议标准
syslog 协议是一种用来在互联网协议（TCP/IP）的网络中传递记录档讯息的标准，属于一种主从式协议：syslog 发送端发送一条文字信息到 syslog 接收端。具体协议如下图所示：
如上图所示，syslog 消息主要分为 priority、head 以及 message 三个部分，priority 是由两个部分组成的——facility、level。
- facility 表明该日志消息是由谁产生的，是内核 kern？还是用户 user？又或是邮件 mail？不同的 facility对应不同的代号，可通过 man 3 syslog 查看：
LOG_AUTHPRIV security/authorization messages (private) LOG_CRON clock daemon (cron and at) LOG_DAEMON system daemons without separate facility value LOG_FTP ftp daemon LOG_KERN kernel messages (these can’t be generated from user processes) LOG_LOCAL0 through LOG_LOCAL7 reserved for local use LOG_LPR line printer subsystem LOG_MAIL mail subsystem LOG_NEWS USENET news subsystem LOG_SYSLOG messages generated internally by syslogd(8) LOG_USER (default) generic user-level messages LOG_UUCP UUCP subsystem - level 表明该日志消息的重要程度，是导致系统不能正常使用了的紧急级别 emerg？还是需要被及时处理的警告级别 alert？又或仅仅是需要调试的 debug 级别的信息？同样可通过 man 3 syslog 查看：
LOG_EMERG system is unusable LOG_ALERT action must be taken immediately LOG_CRIT critical conditions LOG_ERR error conditions LOG_WARNING warning conditions LOG_NOTICE normal, but significant, condition LOG_INFO informational message LOG_DEBUG debug-level message
facility 和 level 分别定义了不同的代号，其各自的宏定义可见 /usr/include/sys/syslog.h 头文件，它们两者的组合构成了 priority 头的值。
syslog API
linux C 中提供了一套系统日志写入的接口—syslog 库，syslog 库可以将应用程序中的日志消息写入日志系统，主要涉及三个函数 openlog，syslog，closelog。如下所示：
#include <syslog.h>
void openlog(const char *ident, int option, int facility);功能：打开一个syslog连接：使用 openlog 函数来连接 syslogd 程序。参数：ident指定的字符串会放入到相应的消息日志中；option有如下可选项：LOG_CONS Write directly to system console if there is an error while sending to system logger.LOG_NDELAY Open the connection immediatelyLOG_NOWAIT Don’t wait for child processes that may have been created while logging the message.LOG_ODELAY The converse of LOG_NDELAY; opening of the connection is delayed until syslog() is called.LOG_PERROR (Not in POSIX.1-2001.) Print to stderr as well.LOG_PID Include PID with each message.facility有若干可选项，前面已经介绍过。返回值：空。
#include <syslog.h>
void syslog(int priority, const char *format, ...);
功能: 产生一条日志消息以特定的规则分发出去。
参数:priority 优先级，由 facility 和 level 的或运算组成；format 格式化输出，类似于printf函数中的format参数。
返回值：空
#include <syslog.h>
void closelog(void);
功能：关闭用来写日志记录的文件描述符。
参数：无
返回值：空
syslog 日志文件
日志文件介绍
日志一般都在 /var/log 目录下。该目录下有以下几个重要的的日志文件。
/var/log/maillog：记录邮件的往来信息，其实主要是记录 sendmail 与 dovecot 所产生的信息。/var/log/dmesg：记录开机开始到现在的内核检测过程所产生的各项信息。如果内核编程的模块中使用printk()，将会把相关信息打印到这里。/var/log/messages：系统发生的重要信息或者是错误信息都会记录在这个文件中，如果系统发生错误，这个文件就是需要查阅的文件之一。/var/log/httpd：这个文件里面主要记录各种网络服务信息。/var/log/cron：这个日志跟例行工作调度有关。即crontab有没有被执行，执行过程中有没有发生错误，在这个日子中均有体现。
上述的这些日志都是系统进程打印出的 log 日志。我们怎么能打印出自己的 log 日志呢？首先，我们要分清楚需求是什么，是通过内核打印出来？还是非内核应用中打印出来？
1、内核打印日志
相信很多使用过内核模块的朋友已经很清楚，在 linux 内核模块中编程的话，使用简单的 printk("helloworld"); 就能达到打印日志的效果。在linux中使用 dmesg 命令即可查看内核输出的日志。
2、非内核编程打印日志
若想在非内核的环境下打印日志，就必须要使用 syslog（或者 rsyslog） 了。若你的系统还是使用的 syslog，那就直接运行以下测试代码：
/**
*filename:syslog_test.c
*/
#include <syslog.h>
#include <sys/types.h>
#include <unistd.h>
int main()
{openlog("syslog_test", LOG_PID, LOG_USER);syslog(LOG_INFO, "The pid of syslog_test=%d", getpid());closelog();
}
编译、运行：
yxm@192:~/myshare/process_info$ gcc -Wall -g syslog_test.c -o syslog_test
yxm@192:~/myshare/process_info$ ./syslog_test
查看日志：
- Mar 16 23:48:44 是日志记录的时间；
- 192 是主机名；
- syslog_test 是 openlog 函数的第一个参数指定的字符串；
- [126266] 是openlog第二个参数指定了 LOG_PID 的结果；
- The pid of syslog_test=126266 则是 syslog 函数指定的日志消息内容了。
该条日志输出到了/var/log/syslog 文件内，其实输出路径以及各种 facility 和 level 都是可以通过配置文件进行相应的设置的，我们后面再说。
【注意】大家如果想删除日志，千万不要把日志文件直接删除，如果这样很有可能系统找不到文件，就无法再打印日志，恢复起来也是比较麻烦。直接清空日志内容即可：cat /dev/null > syslog。
日志配置
如果需要修改系统日志配置，修改以下两个文件。
1）/etc/rsyslog.conf
2）/etc/rsyslog.d/50-default.conf：日志文件的记录规则和路径
rsyslogd 进程的操作：
sudo service rsyslog restart
sudo service rsyslog stop
sudo service rsyslog start
产生本地日志
1、修改 /etc/rsyslog.d/50-default.conf 配置文件：
在文件最后添加如下一行：
# mylog
local0.* /var/log/mylocal.log
【注意】
- local0—local7 均可。
- /var/log/mylocal.log 是自己定义的日志文件。
-
- 表示所有的日志，可以保存部分日志，例如 local0.info 只会保留 LOG_INFO 级别的日志。
2、配置完需要重启 rsyslogd 程序
/etc/init.d/rsyslog restart
# 或者
sudo service rsyslog restart
# 或者
systemctl restart rsyslog
3、程序中用以下记入日志
openlog("syslog_test", LOG_PID, LOG_LOCAL0);
程序编译运行后，log 信息将被记录到 mylocal。
4、动态查看日志
tail -f /var/log/mylocal.log | grep syslog_test
参考文章
参考文章1
参考文章2
参考文章3
参考文章4
参考文章5
