静态配置
默认情况下,默认配置中 zipkin 插件的 NGINX 变量配置设置为 false。
需要更新的文件取决于网关的部署方式:
- Host or Docker
- Kubernetes (Helm)
对于主机或 Docker 部署,请配置以下设置:
config.yaml
plugin_attr:
zipkin:
set_ngx_var: true
然后重新加载网关,使更改生效。
对于 Helm 部署,请更新用于渲染 plugin_attr.zipkin 的 Chart values,并保持 values 文件中的其 他配置不变。
对于 APISIX Helm Chart,请设置以下 values:
values.yaml
apisix:
pluginAttrs:
zipkin:
set_ngx_var: true
对于 API7 网关 Helm Chart,请设置以下 values:
values.yaml
pluginAttrs:
zipkin:
set_ngx_var: true
然后使用当前网关版本对应的 Chart 应用 values 文件:
helm upgrade <release-name> <chart-name> -n <namespace> -f values.yaml
参数
请参阅插件通用配置,了解所有插件通用的配置选项。
endpoint
string
必填
用于接收跨度的 Zipkin 端点,例如
http://127.0.0.1:9411/api/v2/spans。sample_ratio
number
必填
有效值:
介于 0.00001 和 1 之间(含边界值)
采样请求的频率。设置为 1 表示采样每个请求。
service_name
string
默认值:
APISIXZipkin 中显示的 Zipkin 报告器的服务名称。
server_addr
string
默认值:
the value of $server_addr有效值:
IPv4 地址
Zipkin 报告器的 IPv4 地址。例如,你可以将其设置为你的外部 IP 地址。
span_version
integer
默认值:
2有效值:
1 或 2
跨度类型的版本。