---
title: "配置 ob-operator | OceanBase 文档中心"
description: 配置 ob-operator 本文介绍 ob-operator 的启动参数和使用到的环境变量以及修改方法。用户可通过改变启动参数和环境变量影响 ob-operator 的行为。 启动参数 参数名 含义 默认值 deploy 配置 namespace 监听的命名空间，留空表示监听所有命名空间 空 空 manager-n…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*_Ef7QIYUi3gAAAAAAAAAAAAADiGDAQ/original) ob-operatorV 2.3.0 社区版

# 配置 ob-operator

更新时间：2026-04-13 16:46:35

[编辑](https://github.com/oceanbase/ob-operator-doc/edit/V2.3.0/zh-CN/500.configuration-of-ob-operator.md)  

本文介绍 ob-operator 的启动参数和使用到的环境变量以及修改方法。用户可通过改变启动参数和环境变量影响 ob-operator 的行为。

## 启动参数

| 参数名 | 含义 | 默认值 | deploy 配置 |
| --- | --- | --- | --- |
| namespace | 监听的命名空间，留空表示监听所有命名空间 | 空 | 空 |
| manager-namespace | ob-operator 运行的命名空间 | oceanbase-system | oceanbase-system |
| metrics-bind-address | ob-operator 提供 Prometheus 指标的服务端口 | :8080 | 127.0.0.1:8080 |
| health-probe-bind-address | ob-operator 进程健康探针绑定端口 | :8081 | :8081 |
| leader-elect | 启动 ob-operator 时是否采用选主流程 | false | true |
| log-verbosity | 日志输出量，为 0 输出关键信息，为 1 输出调试信息，为 2 输出溯源信息 | 0 | 0 |

## 环境变量

| 环境变量名 | 含义 | deploy 配置 |
| --- | --- | --- |
| TELEMETRY_REPORT_HOST | 遥测采集数据收集端 | https://openwebapi.oceanbase.com |
| TELEMETRY_DEBUG | 设置为 true 可开启遥测采集调试模式 | 空 |
| DISABLE_WEBHOOKS | 设置为 true 可禁用 webhooks 校验 | 空 |
| DISABLE_TELEMETRY | 设置为 true 可禁用遥测采集模块，遥测采集模块会采集集群环境和事件信息脱敏后发送给 OceanBase，期望通过这些数据帮助改善 ob-operator | 空 |

## 修改方法

使用 `deploy/operator.yaml` 中的配置文件，找到名为 `oceanbase-controller-manager` 的 `Deployment` 资源，在其容器列表中修改名为 `manager` 容器的启动参数和环境变量，下面截取 `deploy/operator.yaml` 中该部分为例。

```yaml
      # 原本的配置
      containers:
      - args:
        - --health-probe-bind-address=:8081
        - --metrics-bind-address=:8080
        - --leader-elect
        - --manager-namespace=oceanbase-system
        - --log-verbosity=0
        command:
        - /manager
        env:
        - name: TELEMETRY_REPORT_HOST
          value: https://openwebapi.oceanbase.com

```

### 示例：增大日志输出量

如果用户希望增加 ob-operator 的日志输出量，可增大 `log-verbosity` 参数到 1 或者 2，值越大输出的日志越多。

```yaml
      # 修改后的配置
      containers:
      - args:
        - --health-probe-bind-address=:8081
        - --metrics-bind-address=:8080
        - --leader-elect
        - --manager-namespace=oceanbase-system
        - --log-verbosity=2 # 日志输出量增大到 2
        command:
        - /manager
        env:
        - name: TELEMETRY_REPORT_HOST
          value: https://openwebapi.oceanbase.com

```

### 示例：指定资源命名空间

```yaml
      # 修改后的配置
      containers:
      - args:
        - --health-probe-bind-address=:8081
        - --metrics-bind-address=:8080
        - --leader-elect
        - --manager-namespace=oceanbase-system
        - --log-verbosity=0
        - --namespace=oceanbase # 限定 ob-operator 只监听命名空间为 oceanbase 内的资源
        command:
        - /manager
        env:
        - name: TELEMETRY_REPORT_HOST
          value: https://openwebapi.oceanbase.com

```

### 应用到集群中

修改完成后通过 `kubectl apply -f deploy/operator.yaml` 将配置文件应用到集群中即可生效。环境变量的配置方法与启动参数相同，本文不再赘述。

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线