You need to enable JavaScript to run this app. K3S下基于Jaeger Operator的Collector配置Ingress暴露gRPC端口供外部Agent访问
优惠活动
大模型
产品
解决方案
定价
更多

K3S下基于Jaeger Operator的Collector配置Ingress暴露gRPC端口供外部Agent访问

核心问题定位与修正方案

一、现有配置的核心错误点

  • 所有Ingress注解都是ingress-nginx控制器专属,和K3S默认搭载的Traefik Ingress控制器完全不兼容。之前配置的kubernetes.io/ingress.class: "nginx"直接让Traefik判定这条Ingress不属于自己的管控范围,完全忽略这条资源,这也是自建的Collector Ingress没有分配入口IP、Traefik日志无相关路由记录、所有请求返回404纯文本响应的根本原因。
  • 使用的networking.k8s.io/v1beta1版本的Ingress API在K3S较新版本中已被弃用,存在资源解析异常的风险。
  • 没有针对Traefik适配gRPC后端的转发规则,即使Ingress被正确加载,Traefik默认用HTTP/1.1协议转发流量,会和gRPC的明文HTTP/2协议不匹配,直接触发Unimplemented类错误。
  • 原配置的强制HTTPS跳转规则和当前Agent用80端口明文访问的场景冲突,gRPC客户端不会自动处理301跳转,会直接判定连接异常。

二、Traefik场景下的正确Collector Ingress配置

直接替换原有错误的simple-prod-collector Ingress资源,使用以下配置:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: simple-prod-collector
  namespace: monitoring
  annotations:
    # 指定走K3S默认的Traefik Ingress控制器
    kubernetes.io/ingress.class: traefik
    # 声明后端为明文HTTP/2(h2c)服务,适配gRPC协议转发
    traefik.ingress.kubernetes.io/service.server-scheme: h2c
    # 关闭强制HTTPS跳转,适配当前80端口明文访问的场景
    traefik.ingress.kubernetes.io/redirect-entry-point: ""
spec:
  rules:
  - host: jaeger-collector.my-container-dev
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: simple-prod-collector
            port:
              number: 14250

关键配置说明:

  • 升级API版本为稳定的networking.k8s.io/v1,避免版本兼容问题
  • 移除所有ingress-nginx专属注解,全部替换为Traefik可识别的规则
  • 配置后端转发协议为h2c,匹配Collector 14250端口的明文gRPC通信要求
  • 补全新版Ingress要求的path、pathType必填字段,确保路由解析正常

三、部署后验证流程

  • 应用新Ingress配置后,执行kubectl get ingress -n monitoring,确认simple-prod-collector的ADDRESS字段已经分配到和simple-prod-query一致的Traefik入口IP,不再为空。
  • 执行kubectl describe ingress simple-prod-collector -n monitoring,确认事件日志无路由解析报错,后端端点已正确关联到simple-prod-collector服务的14250端口。
  • 确认外部Agent所在节点的域名解析配置:把jaeger-collector.my-container-dev指向Traefik的入口IP(即之前simple-prod-query对应的10.128.107.220地址),可以直接修改Agent节点的hosts文件,也可以配置内部DNS统一解析。
  • 重新测试Agent通信:gRPC上报流量从Agent发出后,经过Traefik的80端口转发到Collector的14250端口,原有的404、content-type不匹配的错误会消失,链路数据可正常上报。

四、长期使用注意事项

  • 若后续需要为Collector配置TLS加密的gRPC通道,需要在Traefik上为对应域名绑定有效证书,同时在Agent端开启gRPC TLS相关配置,不要保留强制HTTPS跳转规则,避免gRPC协议握手失败。
  • 不要把Collector的多端口服务(14268 Thrift HTTP、9411 Zipkin接口)和14250的gRPC接口复用同一个Ingress路由,需要拆分独立host或路径分别配置对应协议的转发规则,避免协议不匹配。
  • 检查Traefik的全局配置,确认没有全局强制HTTPS跳转、IP白名单规则拦截该Ingress对应的路由流量,如存在全局规则,需要在当前Ingress上单独配置排除规则。

内容的提问来源于stack exchange,提问作者BearsEars

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 00:15:10