This is an automated email from the ASF dual-hosted git repository.
morningman pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris-website.git
The following commit(s) were added to refs/heads/master by this push:
new 576a9130ba8 [docs](be-log) add description for sys_log_verbose_flags_v
(#2267)
576a9130ba8 is described below
commit 576a9130ba8f8ba551cbc53e4e0a0ac8eeae98ce
Author: Kaijie Chen <c...@apache.org>
AuthorDate: Tue Apr 8 11:13:03 2025 +0800
[docs](be-log) add description for sys_log_verbose_flags_v (#2267)
## Issue
Fix #1973
## Versions
- [x] dev
- [x] 3.0
- [x] 2.1
- [x] 2.0
## Languages
- [x] Chinese
- [x] English
## Docs Checklist
- [ ] Checked by AI
- [ ] Test Cases Built
---
docs/admin-manual/log-management/be-log.md | 5 +++++
.../current/admin-manual/log-management/be-log.md | 5 +++++
.../version-2.1/admin-manual/log-management/be-log.md | 5 +++++
.../version-3.0/admin-manual/log-management/be-log.md | 5 +++++
versioned_docs/version-2.1/admin-manual/log-management/be-log.md | 5 +++++
versioned_docs/version-3.0/admin-manual/log-management/be-log.md | 5 +++++
6 files changed, 30 insertions(+)
diff --git a/docs/admin-manual/log-management/be-log.md
b/docs/admin-manual/log-management/be-log.md
index f61a8b0908e..b700e12eab9 100644
--- a/docs/admin-manual/log-management/be-log.md
+++ b/docs/admin-manual/log-management/be-log.md
@@ -106,6 +106,11 @@ will turn on all BE verbose log.
`sys_log_verbose_level` Indicates the level of DEBUG. The higher the number,
the more detailed the DEBUG log. The value ranges from 1 to 10.
+In most situations, setting `sys_log_verbose_modules` and
`sys_log_verbose_level` in `be.conf` is sufficient.
+Only in rare cases such as when debug logs do not appear as expected, you may
also need to configure `sys_log_verbose_flags_v`, which is not limited by the
module scope.
+
+`sys_log_verbose_flags_v` is the `FLAGS_v` in glog, which controls the global
verbosity level for `VLOG(n)` logging, where messages with `n <= FLAGS_v` will
be printed, allowing fine-grained control over log output detail.
+
### Dynamic Modification
Since 2.1, the DEBUG log of BE supports dynamic modification via the following
RESTful API:
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/log-management/be-log.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/log-management/be-log.md
index 0ee09fb61ba..e73168618c5 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/log-management/be-log.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/log-management/be-log.md
@@ -105,6 +105,11 @@ sys_log_verbose_modules=*
`sys_log_verbose_level` 表示 DEBUG 的级别。数字越大，则 DEBUG 日志越详细。取值范围在 1-10。
+通常情况下，只需在 `be.conf` 中配置 `sys_log_verbose_modules` 和 `sys_log_verbose_level`
即可满足需求。
+只有在特殊情况下，比如发现某些调试日志没有按预期输出时，才需要额外设置 `sys_log_verbose_flags_v`，它的作用范围不受 modules
限制。
+
+`sys_log_verbose_flags_v` 表示 glog 中的 `FLAGS_v`，用于控制全局的日志详细程度。数字越大，则 DEBUG
日志越详细。只有当 `n <= FLAGS_v` 时，`VLOG(n)` 的日志信息才会被输出，从而实现对日志输出粒度的精细控制。
+
### 动态调整
BE 的 DEBUG 日志从 2.1 开始支持动态修改，通过以下 RESTful API 即可：
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/admin-manual/log-management/be-log.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/admin-manual/log-management/be-log.md
index 671f996cb5e..cdcd72909f9 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/admin-manual/log-management/be-log.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/admin-manual/log-management/be-log.md
@@ -105,6 +105,11 @@ sys_log_verbose_modules=*
`sys_log_verbose_level` 表示 DEBUG 的级别。数字越大，则 DEBUG 日志越详细。取值范围在 1-10。
+通常情况下，只需在 `be.conf` 中配置 `sys_log_verbose_modules` 和 `sys_log_verbose_level`
即可满足需求。
+只有在特殊情况下，比如发现某些调试日志没有按预期输出时，才需要额外设置 `sys_log_verbose_flags_v`，它的作用范围不受 modules
限制。
+
+`sys_log_verbose_flags_v` 表示 glog 中的 `FLAGS_v`，用于控制全局的日志详细程度。数字越大，则 DEBUG
日志越详细。只有当 `n <= FLAGS_v` 时，`VLOG(n)` 的日志信息才会被输出，从而实现对日志输出粒度的精细控制。
+
### 动态调整
通过以下 RESTful API 即可：
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/admin-manual/log-management/be-log.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/admin-manual/log-management/be-log.md
index 671f996cb5e..cdcd72909f9 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/admin-manual/log-management/be-log.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/admin-manual/log-management/be-log.md
@@ -105,6 +105,11 @@ sys_log_verbose_modules=*
`sys_log_verbose_level` 表示 DEBUG 的级别。数字越大，则 DEBUG 日志越详细。取值范围在 1-10。
+通常情况下，只需在 `be.conf` 中配置 `sys_log_verbose_modules` 和 `sys_log_verbose_level`
即可满足需求。
+只有在特殊情况下，比如发现某些调试日志没有按预期输出时，才需要额外设置 `sys_log_verbose_flags_v`，它的作用范围不受 modules
限制。
+
+`sys_log_verbose_flags_v` 表示 glog 中的 `FLAGS_v`，用于控制全局的日志详细程度。数字越大，则 DEBUG
日志越详细。只有当 `n <= FLAGS_v` 时，`VLOG(n)` 的日志信息才会被输出，从而实现对日志输出粒度的精细控制。
+
### 动态调整
通过以下 RESTful API 即可：
diff --git a/versioned_docs/version-2.1/admin-manual/log-management/be-log.md
b/versioned_docs/version-2.1/admin-manual/log-management/be-log.md
index f61a8b0908e..b700e12eab9 100644
--- a/versioned_docs/version-2.1/admin-manual/log-management/be-log.md
+++ b/versioned_docs/version-2.1/admin-manual/log-management/be-log.md
@@ -106,6 +106,11 @@ will turn on all BE verbose log.
`sys_log_verbose_level` Indicates the level of DEBUG. The higher the number,
the more detailed the DEBUG log. The value ranges from 1 to 10.
+In most situations, setting `sys_log_verbose_modules` and
`sys_log_verbose_level` in `be.conf` is sufficient.
+Only in rare cases such as when debug logs do not appear as expected, you may
also need to configure `sys_log_verbose_flags_v`, which is not limited by the
module scope.
+
+`sys_log_verbose_flags_v` is the `FLAGS_v` in glog, which controls the global
verbosity level for `VLOG(n)` logging, where messages with `n <= FLAGS_v` will
be printed, allowing fine-grained control over log output detail.
+
### Dynamic Modification
Since 2.1, the DEBUG log of BE supports dynamic modification via the following
RESTful API:
diff --git a/versioned_docs/version-3.0/admin-manual/log-management/be-log.md
b/versioned_docs/version-3.0/admin-manual/log-management/be-log.md
index 1b7b06e570d..37d599a866b 100644
--- a/versioned_docs/version-3.0/admin-manual/log-management/be-log.md
+++ b/versioned_docs/version-3.0/admin-manual/log-management/be-log.md
@@ -106,6 +106,11 @@ will turn on all BE verbose log.
`sys_log_verbose_level` Indicates the level of DEBUG. The higher the number,
the more detailed the DEBUG log. The value ranges from 1 to 10.
+In most situations, setting `sys_log_verbose_modules` and
`sys_log_verbose_level` in `be.conf` is sufficient.
+Only in rare cases such as when debug logs do not appear as expected, you may
also need to configure `sys_log_verbose_flags_v`, which is not limited by the
module scope.
+
+`sys_log_verbose_flags_v` is the `FLAGS_v` in glog, which controls the global
verbosity level for `VLOG(n)` logging, where messages with `n <= FLAGS_v` will
be printed, allowing fine-grained control over log output detail.
+
### Dynamic Modification
Since 2.1, the DEBUG log of BE supports dynamic modification via the following
RESTful API:
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@doris.apache.org
For additional commands, e-mail: commits-h...@doris.apache.org
