skywalking-logger

如果上下文中存在 tracing context，插件会自动建立 trace 与日志的关联，该功能依赖于 。

该插件也提供了将访问日志作为 JSON 对象发送到 SkyWalking OAP 服务器的能力。

属性

该插件支持使用批处理器来聚合并批量处理条目（日志/数据）。这样可以避免插件频繁地提交数据，默认设置情况下批处理器会每 5 秒钟或队列中的数据达到 1000 条时提交数据，如需了解批处理器相关参数设置，请参考 。

名称类型必选项默认值有效值描述
log_formatobject否{“host”: “$host”, “@timestamp”: “$time_iso8601”, “client_ip”: “$remote_addr”}以 JSON 格式的键值对来声明日志格式。对于值部分，仅支持字符串。如果是以 $ 开头，则表明是要获取 或 NGINX 变量。
重要

该配置全局生效。如果你指定了 log_format，该配置就会对所有绑定 skywalking-logger 的路由或服务生效。

以下示例展示了如何通过 Admin API 进行插件元数据配置：

配置成功后，将得到如下日志格式：

启用插件

现在你可以向 APISIX 发起请求：

完成上述步骤后，你可以在 SkyWalking UI 查看到相关日志。

禁用插件

当你需要禁用该插件时，可通过以下命令删除相应的 JSON 配置，APISIX 将会自动重新加载相关配置，无需重启服务：