0x00 缘起
做为一名合格的后端,最常用的日常操作莫过于查看接口日志吧:-) 使用nginx的小伙伴们都知道,nignx自带一套日志文件体系. 那么,我们在kong中如何理解和使用相关的日志文件呢? 本文就带大家了解一下kong系统中的日志文件信息.
0x01 Kong的日志文件系统
通过 kong check 命令,我可以知道,kong正在使用的配置文件.
然后,我们打开配置文件 vim /etc/kong/kong.conf,
在26行处,可以看到kong的默认工作目录位于 /usr/local/kong/,然后记录着3个日志输出文件的位置.
值得注意的是: 在我们配置,调试插件的过程中,应该多留意一下这几个日志文件的输出内容. 可以帮助我们分析定位问题, 尤其是在调试自定义插件的时候.
0x02 添加Kong的日志插件
如果我们希望针对某些Router记录更详细的日志内容时,应该怎么做呢? 我们可以使用Kong自带的一些日志工具插件,来完成这个需求. 本文介绍一下最简单的文件日志类型.
- 添加插件
跟之前的文章一样, 我们在一个选定的router下面,添加一个新插件,类型选择为
File Log
在弹出的配置画面,输入我们希望保存的日志文件位置.
这里我们采用绝对路径 /usr/local/kong/logs/out.log
保存时,如果发现有权限出错问题.可以通过下面操作解决:
cd /usr/local/kong/logs
touch out.log
chmod 666 out.log
- 验证
保存成功后, 插件已经同时生效.
我们多访问几次测试API:
然后,再去同步查看日志文件:tail -f out.log, 会发看到有很详细的日志内容被追加到文件中来.
0x03 后记
其实我们生产中在使用日志文件时,主要分两类:
-
微服务中的业务日志 主要用于业务信息记录;可用于分析接口请求参数或返回异常时,出错代码信息定位等功能.
-
API请求日志 主要用于分析接口的访问频率,响应时间等统计信息.也可以由这些信息,生成dashboard,可以实时查看接口压力情况.
