您现在的位置是：首页 > 文章详情

Apache APISIX 2.12.0 发布，云原生的微服务 API 网关

日期：2022-01-27点击：525收藏

继 2.11.0 版本发布之后，Apache APISIX 也在即将到来的新春佳节，为大家带来 2022 年第一个带有新功能的版本。

新功能

更多的日志功能

除了上边提到的鉴权插件，本次新版本还将带来三个新的日志插件：google-cloud-logging 、splunk-hec-logging 以及 rocketmq-logger。

从插件名称上也很容易理解，通过上述三个插件可以把日志分别发送到 Google Cloud、Splunk 和 Apache RocketMQ。未来，Apache APISIX 将会对接越来越多的日志服务商和开源 Broker，让日志处理变得更加轻松。

支持记录响应体

同时，此次 2.12.0 版本还在日志层面支持记录响应体。与 Apache APISIX 其他功能一样，该功能也可以通过表达式进行动态开启。这样在使用中，就可以实现仅在上游返回特定的 Content-Type 和 Content-Length 时进行日志记录，不用再去顾虑全量采集响应体而带来的问题了。

具体示例可参考下方：

 {    "plugins": {        "kafka-logger": {            "broker_list" : {                "127.0.0.1":9092            },            "kafka_topic" : "test2",            "include_resp_body": true,            "include_resp_body_expr": [                [                    "sent_http_content_length",                    "<",                    "4096"                ],                [                    "sent_http_content_type",                    "==",                    "application/json"                ],            ]        }    },    "upstream": {        "nodes": {            "127.0.0.1:1980": 1        },        "type": "roundrobin"    },    "uri": "/hello"}

上述配置会仅在 Content-Length < 4096 且 Content-Type 为 "application/json" 才记录日志。

支持注册自定义变量

另一个跟日志紧密相关的功能，就是新版本的 Apache APISIX 已支持注册自定义变量。同时结合 APISIX 的自定义日志格式，就可以实现完全自定义上报的日志内容。即无需修改具体的日志插件，就能实现日志生成和上报的解耦合。这里我们通过一个示例进行简单演示一下。

比如我们可以在自己的插件中注册一个 a6_route_labels 的变量：

 local core = require "apisix.core" core.ctx.register_var("a6_route_labels", function(ctx)    local route = ctx.matched_route and ctx.matched_route.value    if route and route.labels then        return route.labels    end    return nilend)

并在自定义日志格式中使用它：

 {    "log_format": {        "host": "$host",        "labels": "$a6_route_labels",        "client_ip": "$remote_addr"    }}

假设我们的 Route 长这样：

 {    "plugins": {        "http-logger": {            "uri": "http://127.0.0.1:1980/log",            "batch_max_size": 1,            "concat_method": "json"        }    },    "upstream": {        "nodes": {            "127.0.0.1:1982": 1        },        "type": "roundrobin"    },    "labels": {        "k": "v"    },    "uri": "/hello"}

最终就会收到如下所示的日志：

 {"client_ip":"127.0.0.1","host":"localhost","labels":{"k":"v"},"route_id":"1"}

L4 代理支持 TLS over TCP 上游

在 2.12.0 版本中还引入了新的 Upstream Scheme，现在 Apache APISIX 已支持代理到 TLS over TCP 上游了。

具体做法可参考下方，只需在 Upstream 配置中指明 Scheme 为 TLS 即可。

 {    "scheme": "tls",    "nodes": {        "127.0.0.1:1995": 1    },    "type": "roundrobin"}

至此 Apache APISIX 的 TCP 代理功能得到了 TLS 全方位的支持。此外，我们还支持在静态文件中配置 L4 代理的 Access Log：

 stream:    enable_access_log: false         # enable access log or not, default false    access_log: logs/access_stream.log    access_log_format: "$remote_addr [$time_local] $protocol $status $bytes_sent $bytes_received $session_time"                                            # create your custom log format by visiting http://nginx.org/en/docs/varindex.html    access_log_format_escape: default       # allows setting json or default characters escaping in variables