kafka-logger

    简介

    是一个插件,可用作ngx_lua nginx 模块的 Kafka 客户端驱动程序。

    它可以将接口请求日志以 JSON 的形式推送给外部 Kafka 集群。如果在短时间内没有收到日志数据,请放心,它会在我们的批处理处理器中的计时器功能到期后自动发送日志。

    有关 Apache APISIX 中 Batch-Processor 的更多信息,请参考。

    • origin:

      ``` GET /hello?ab=cd HTTP/1.1 host: localhost content-length: 6 connection: close

    1. abcdef

    工作原理

    消息将首先写入缓冲区。 当缓冲区超过batch_max_size时,它将发送到 kafka 服务器, 或每个buffer_duration刷新缓冲区。

    插件支持一次推送到多个 Broker,如下配置:

    1. 为特定路由启用 kafka-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. "kafka-logger": {
    5. "broker_list" :
    6. "127.0.0.1":9092
    7. },
    8. "kafka_topic" : "test2",
    9. "key" : "key1"
    10. }
    11. },
    12. "upstream": {
    13. "nodes": {
    14. "127.0.0.1:1980": 1
    15. },
    16. "type": "roundrobin"
    17. },
    18. "uri": "/hello"

    测试插件

    成功

    APISIX 变量

    1. {
    2. "log_format": {
    3. "host": "$host",
    4. "@timestamp": "$time_iso8601",
    5. "client_ip": "$remote_addr"
    6. }
    7. }'

    禁用插件

    当您要禁用kafka-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. }'