zh-translation: docs/ops/diagnostic-tools/component-logging/index.md (#9809)

* zh-translation: docs/ops/diagnostic-tools/component-logging/index.md

* lint
This commit is contained in:
orangegzx 2021-05-31 19:22:46 +08:00 committed by GitHub
parent 4882a7c31b
commit c3990358c7
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 9 additions and 13 deletions

View File

@ -16,15 +16,11 @@ Istio 组件使用一个灵活的日志框架来构建,该框架提供了许
组件输出的日志信息按 `作用域` 分类,一个作用域代表可以被控制的相关日志信息的整体。根据组件提供的功能,不同的组件具有不同的作用域。所有组件都有 `default` 作用域,该作用域用于未分类的日志信息。
例如,在撰写本文时Mixer 有 5 个作用域,代表了 Mixer 中的不同功能区域:
例如,截至目前,`istioctl` 有 25 个作用域,代表命令中的不同功能区域:
- `adapters`
- `api`
- `attributes`
- `default`
- `grpcAdapter`
- `ads``adsc``all``analysis``authn``authorization``ca``cache``cli``default``installer``klog``mcp``model``patch``processing``resource``source``spiffe``tpath``translator``util``validation``validationController``wle`
Pilot、Citadel 和 Galley 具有它们自己的范围,可以通过查看它们的[参考文档](/zh/docs/reference/commands/)来获取更多信息。
Pilot、Citadel 和 Galley 具有它们自己的范围,您可以通过查看它们的[参考文档](/zh/docs/reference/commands/)来获取更多信息。
每个作用域都有一个唯一的输出级别,为下列其中之一:
@ -34,28 +30,28 @@ Pilot、Citadel 和 Galley 具有它们自己的范围,你可以通过查看
1. info
1. debug
其中 `none` 不产生任何输出信息,并且 `debug` 产生的输出信息最多。所有作用域的默认级别是 `info` ,为在正常情况下使用 Istio 提供大量的日志信息。
其中 `none` 不产生任何输出信息,并且 `debug` 产生的输出信息最多。所有作用域的默认级别是 `info`,为在正常情况下使用 Istio 提供大量的日志信息。
要控制输出级别,也可以在命令行使用 `--log_output_level` 选项。例如:
{{< text bash >}}
$ mixs server --log_output_level attributes=debug,adapters=warning
$ istioctl analyze --log_output_level klog:none,cli:info
{{< /text >}}
除了从命令行控制输出级别外,也可以使用 [ControlZ](/zh/docs/ops/diagnostic-tools/controlz) 界面控制一个运行组件的输出级别。
除了从命令行控制输出级别外,也可以使用 [ControlZ](/zh/docs/ops/diagnostic-tools/controlz) 界面控制一个运行组件的输出级别。
## 控制输出{#controlling-output}
日志信息通常发送到组件的标准输出。`--log_target` 选项可以定向输出到许多不同的位置。可以使用一个逗号分隔列表中的文件系统路径,以及分别表示标准输出和标准错误输出流的特殊值 `stdout``stderr`
日志信息通常发送到组件的标准输出。`--log_target` 选项可以定向输出到许多不同的位置。可以使用一个逗号分隔列表中的文件系统路径,以及分别表示标准输出和标准错误输出流的特殊值 `stdout``stderr`
日志信息通常以友好的格式输出。`--log_as_json` 选项可用于将输出强制转换为 JSON 格式,以便于更简单地被工具处理。
## 日志轮转{#log-rotation}
Istio 组件可以自动管理日志的轮转,将庞大的日志分解为较小的日志文件。`--log_rotate` 选项可以让基于文件名进行轮转。派生名称将用于单个日志文件。
Istio 组件可以自动管理日志的轮转,将庞大的日志分解为较小的日志文件。`--log_rotate` 选项可以让基于文件名进行轮转。派生名称将用于单个日志文件。
`--log_rotate_max_age` 选项可以在日志文件被轮转前指定最大天数,然而 `--log_rotate_max_size` 选项可以指定文件轮转之前的最大 size (以兆字节为单位)。最后,`--log_rotate_max_backups` 选项可以控制要保留的最大轮转文件数,较旧的文件将被自动删除。
## 组件调试{#component-debugging}
`--log_caller``--log_stacktrace_level` 选项可以控制日志信息是否包括程序员级别的信息。当试着查找组件中的错误信息时它是有用的,但是,通常在日常操作中不使用。
`--log_caller``--log_stacktrace_level` 选项可以控制日志信息是否包括程序员级别的信息。当试着查找组件中的错误信息时它是有用的,但是,通常在日常操作中不使用。