最后于 2025年4月2日 更新

如何配置Kubernetes环境OneAgent自动监控范围

本文档用于自定义配置 Kubernetes 环境中 apo-one-agent 自动监控范围，请根据您apo-one-agent部署文档选择对应章节配置。apo-one-agent 默认监控 apo 以及 kubernetes 系统命名空间以外的所有组件。

使用”快速开始“文档部署

创建文件apo-values.yaml，并根据您的需求进行定义，并修改部署命令读取该apo-values.yaml文件，修改后的部署命令如下

helm install apo apo/apo -n apo --create-namespace \
--set apo-one-agent.enabled=true \
-f apo-values.yaml

示例1-apo-values.yaml 将指定命名空间加入黑名单

本示例配置apo-one-agent注入监控配置时会将default与test命名空间加入黑名单，将instrumentAllNamespace配置为true，在其余命名空间注入监控配置

apo-one-agent:
  odigos:
    instrumentor:
      # targetNamespace 
      # name：目标命名空间
      # value：
      #   enabled: 注入现有的所有服务,但不注入后续新增应用
      #   enabledFuture: 注入现在以及后续的所有服务
      #   disabled: 不注入指定namespace下的服务,用于在instrument-all-namespace时忽略特定的Namespace
      targetNamespace:
      - name: default
        value: disable
      - name: test
        value: disable
      # instrument-all-namespace 是否注入所有namespace
      # 等价于设置所有namespace的enabledFuture
      # 但如果已经设置了ns或者workload的disabled将不会注入
      instrumentAllNamespace: true
      # force-instrument-all-namespace 是否强制注入所有namespace
      # 和instrument-all-namespace类似,所有ns设置enabledFuture
      # 并忽略所有disabled设置
      forceInstrumentAllNamespace: false

示例2-apo-values.yaml 将指定命名空间加入白名单

本示例配置apo-one-agent注入监控配置时会将default与test命名空间加入白名单，且将instrumentAllNamespace配置为false，从而不会在其余命名空间注入监控配置

apo-one-agent:
  odigos:
    instrumentor:
      # targetNamespace 
      # name：目标命名空间
      # value：
      #   enabled: 注入现有的所有服务,但不注入后续新增应用
      #   enabledFuture: 注入现在以及后续的所有服务
      #   disabled: 不注入指定namespace下的服务,用于在instrument-all-namespace时忽略特定的Namespace
      targetNamespace:
      - name: default
        value: enabledFuture
      - name: test
        value: enabledFuture
      # instrument-all-namespace 是否注入所有namespace
      # 等价于设置所有namespace的enabledFuture
      # 但如果已经设置了ns或者workload的disabled将不会注入
      instrumentAllNamespace: false
      # force-instrument-all-namespace 是否强制注入所有namespace
      # 和instrument-all-namespace类似,所有ns设置enabledFuture
      # 并忽略所有disabled设置
      forceInstrumentAllNamespace: false