Skip to main content
Version: 2.15

syslog

描述#

sys 是一个将 Log data 请求推送到 Syslog 的插件。

这将提供将 Log 数据请求作为 JSON 对象发送的功能。

属性#

名称类型必选项默认值有效值描述
hoststring必须IP 地址或主机名
portinteger必须目标上游端口
namestring可选"sys logger"
timeoutinteger可选3000[1, ...]上游发送数据超时(以毫秒为单位)。
tlsboolean可选false用于控制是否执行 SSL 验证
flush_limitinteger可选4096[1, ...]如果缓冲的消息的大小加上当前消息的大小达到(> =)此限制(以字节为单位),则缓冲的日志消息将被写入日志服务器。默认为 4096(4KB)
drop_limitinteger可选1048576如果缓冲的消息的大小加上当前消息的大小大于此限制(以字节为单位),则由于缓冲区大小有限,当前的日志消息将被丢弃。默认为 1048576(1MB)
sock_typestring可选"tcp"["tcp","udp"]用于传输层的 IP 协议类型。
max_retry_timesinteger可选[1, ...]已废弃。请改用 max_retry_count。连接到日志服务器失败或将日志消息发送到日志服务器失败后的最大重试次数。
retry_intervalinteger可选[0, ...]已废弃。请改用 retry_delay。重试连接到日志服务器或重试向日志服务器发送日志消息之前的时间延迟(以毫秒为单位)。
pool_sizeinteger可选5[5, ...]sock:keepalive 使用的 Keepalive 池大小。
include_req_bodyboolean可选false是否包括请求 body

本插件支持使用批处理器来聚合并批量处理条目(日志/数据)。这样可以避免插件频繁地提交数据,默认设置情况下批处理器会每 5 秒钟或队列中的数据达到 1000 条时提交数据,如需了解或自定义批处理器相关参数设置,请参考 Batch-Processor 配置部分。

如何开启#

  1. 下面例子展示了如何为指定路由开启 sys-logger 插件的。
curl http://127.0.0.1:9080/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
{
"plugins": {
"syslog": {
"host" : "127.0.0.1",
"port" : 5044,
"flush_limit" : 1
}
},
"upstream": {
"type": "roundrobin",
"nodes": {
"127.0.0.1:1980": 1
}
},
"uri": "/hello"
}'

测试插件#

  • 成功的情况:
$ curl -i http://127.0.0.1:9080/hello
HTTP/1.1 200 OK
...
hello, world

禁用插件#

想要禁用“sys-logger”插件,是非常简单的,将对应的插件配置从 json 配置删除,就会立即生效,不需要重新启动服务:

$ curl http://127.0.0.1:9080/apisix/admin/routes/1  -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
{
"methods": ["GET"],
"uri": "/hello",
"plugins": {},
"upstream": {
"type": "roundrobin",
"nodes": {
"127.0.0.1:1980": 1
}
}
}'