Version: 2.11

syslog

摘要

定义

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

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

属性列表

名称类型必选项默认值有效值描述
hoststring必须IP地址或主机名
portinteger必须目标上游端口
namestring可选“sys logger”
timeoutinteger可选3[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[1, …]连接到日志服务器失败或将日志消息发送到日志服务器失败后的最大重试次数。
retry_intervalinteger可选1[0, …]重试连接到日志服务器或重试向日志服务器发送日志消息之前的时间延迟(以毫秒为单位)。
pool_sizeinteger可选5[5, …]sock:keepalive使用的Keepalive池大小。
batch_max_sizeinteger可选1000[1, …]每批的最大大小
buffer_durationinteger可选60[1, …]必须先处理批次中最旧条目的最大期限(以秒为单位)
include_req_bodyboolean可选false是否包括请求 body

如何开启

  1. 下面例子展示了如何为指定路由开启 sys-logger 插件的。
  1. curl http://127.0.0.1:9080/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
  2. {
  3. "plugins": {
  4. "syslog": {
  5. "host" : "127.0.0.1",
  6. "port" : 5044,
  7. "flush_limit" : 1
  8. }
  9. },
  10. "upstream": {
  11. "type": "roundrobin",
  12. "nodes": {
  13. "127.0.0.1:1980": 1
  14. }
  15. },
  16. "uri": "/hello"
  17. }'

测试插件

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

禁用插件

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

  1. $ curl http://127.0.0.1:9080/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
  2. {
  3. "methods": ["GET"],
  4. "uri": "/hello",
  5. "plugins": {},
  6. "upstream": {
  7. "type": "roundrobin",
  8. "nodes": {
  9. "127.0.0.1:1980": 1
  10. }
  11. }
  12. }'