You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@ozone.apache.org by GitBox <gi...@apache.org> on 2021/08/25 07:16:26 UTC
[GitHub] [ozone] iamabug opened a new pull request #2575: HDDS-5563. feature/Observability.md translation
iamabug opened a new pull request #2575:
URL: https://github.com/apache/ozone/pull/2575
## What changes were proposed in this pull request?
doc translation
## What is the link to the Apache JIRA
https://issues.apache.org/jira/browse/HDDS-5563
## How was this patch tested?
hugo server
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For additional commands, e-mail: issues-help@ozone.apache.org
[GitHub] [ozone] adoroszlai commented on pull request #2575: HDDS-5563. feature/Observability.md translation
Posted by GitBox <gi...@apache.org>.
adoroszlai commented on pull request #2575:
URL: https://github.com/apache/ozone/pull/2575#issuecomment-1063336945
@iamabug @sky76093016 thanks for the patch and review. Seems like there is some merge conflict.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For additional commands, e-mail: issues-help@ozone.apache.org
[GitHub] [ozone] sky76093016 commented on a change in pull request #2575: HDDS-5563. feature/Observability.md translation
Posted by GitBox <gi...@apache.org>.
sky76093016 commented on a change in pull request #2575:
URL: https://github.com/apache/ozone/pull/2575#discussion_r696442850
##########
File path: hadoop-hdds/docs/content/feature/Observability.zh.md
##########
@@ -0,0 +1,222 @@
+---
+title: "可观察性"
+weight: 8
+menu:
+ main:
+ parent: 特性
+summary: 用于增强 Ozone 可观察性的不同工具
+---
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+Ozone 为获取集群运行状态的详细信息提供了多种工具。
+
+## Prometheus
+
+Ozone 原生支持 Prometheus 集成。所有内部指标（通过 Hadoop 指标框架收集的指标）都发布在 `/prom` HTTP 端点下（比如 SCM 的指标发布在 http://localhost:9876/prom 下）。
+
+Prometheus 端点默认开启，但可以通过 `hdds.prometheus.endpoint.enabled` 配置参数关闭。
+
+在页面开启了 SPNEGO 认证的安全环境中，Prometheus 无法直接访问，需要配置特定的认证 token 才可以进行监控。
+
+ `ozone-site.xml` 示例：
+
+```XML
+<property>
+ <name>hdds.prometheus.endpoint.token</name>
+ <value>putyourtokenhere</value>
+</property>
+```
+
+Prometheus 配置示例:
+
+```YAML
+scrape_configs:
+ - job_name: ozone
+ bearer_token: <putyourtokenhere>
+ metrics_path: /prom
+ static_configs:
+ - targets:
+ - "127.0.0.1:9876"
+```
+
+## 分布式追踪
+
+分布式追踪可以通过可视化端到端性能来辅助定位性能瓶颈。
+
+Ozone 使用 [jaeger](https://jaegertracing.io) 追踪库来收集追踪数据并发送到任何兼容的后端（Zipkin等）
Review comment:
Missing symbols
```suggestion
Ozone 使用 [jaeger](https://jaegertracing.io) 追踪库来收集追踪数据并发送到任何兼容的后端（Zipkin等）。
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For additional commands, e-mail: issues-help@ozone.apache.org
[GitHub] [ozone] sky76093016 commented on a change in pull request #2575: HDDS-5563. feature/Observability.md translation
Posted by GitBox <gi...@apache.org>.
sky76093016 commented on a change in pull request #2575:
URL: https://github.com/apache/ozone/pull/2575#discussion_r696436358
##########
File path: hadoop-hdds/docs/content/feature/Observability.zh.md
##########
@@ -0,0 +1,222 @@
+---
+title: "可观察性"
+weight: 8
+menu:
+ main:
+ parent: 特性
+summary: 用于增强 Ozone 可观察性的不同工具
+---
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+Ozone 为获取集群运行状态的详细信息提供了多种工具。
+
+## Prometheus
+
+Ozone 原生支持 Prometheus 集成。所有内部指标（通过 Hadoop 指标框架收集的指标）都发布在 `/prom` HTTP 端点下（比如 SCM 的指标发布在 http://localhost:9876/prom 下）。
+
+Prometheus 端点默认开启，但可以通过 `hdds.prometheus.endpoint.enabled` 配置参数关闭。
+
+在页面开启了 SPNEGO 认证的安全环境中，Prometheus 无法直接访问，需要配置特定的认证 token 才可以进行监控。
+
+ `ozone-site.xml` 示例：
+
+```XML
+<property>
+ <name>hdds.prometheus.endpoint.token</name>
+ <value>putyourtokenhere</value>
+</property>
+```
+
+Prometheus 配置示例:
+
+```YAML
+scrape_configs:
+ - job_name: ozone
+ bearer_token: <putyourtokenhere>
+ metrics_path: /prom
+ static_configs:
+ - targets:
+ - "127.0.0.1:9876"
+```
+
+## 分布式追踪
+
+分布式追踪可以通过可视化端到端性能来辅助定位性能瓶颈。
+
+Ozone 使用 [jaeger](https://jaegertracing.io) 追踪库来收集追踪数据并发送到任何兼容的后端（Zipkin等）
+
+追踪默认是关闭的，但可以通过 `ozone-site.xml` 中的 `hdds.tracing.enabled` 参数开启：
+
+```XML
+<property>
+ <name>hdds.tracing.enabled</name>
+ <value>true</value>
+</property>
+```
+
+根据[此处文档](https://github.com/jaegertracing/jaeger-client-java/blob/master/jaeger-core/README.md)，Jaeger 客户端可以通过环境变量进行配置，例如：
+
+```shell
+JAEGER_SAMPLER_PARAM=0.01
+JAEGER_SAMPLER_TYPE=probabilistic
+JAEGER_AGENT_HOST=jaeger
+```
+
+此配置会记录 1% 的请求来限制性能开销。更多有关 jaeger 采样的信息[请查阅文档](https://www.jaegertracing.io/docs/1.18/sampling/#client-sampling-configuration)
+
+## ozone insight
+
+Ozone insight 是一把查看 Ozone 集群当前状态的瑞士军刀。它可以展示特定组件的日志、指标和配置。
Review comment:
`Swiss-army-knife` may be a slang term, but the use of `瑞士军刀` is not suitable for people to understand.
Or just keep `swiss-army-knife tool`.
```suggestion
Ozone insight 是一个查看 Ozone 集群当前状态的万能工具。它可以展示特定组件的日志、指标和配置。
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For additional commands, e-mail: issues-help@ozone.apache.org
[GitHub] [ozone] iamabug commented on a change in pull request #2575: HDDS-5563. feature/Observability.md translation
Posted by GitBox <gi...@apache.org>.
iamabug commented on a change in pull request #2575:
URL: https://github.com/apache/ozone/pull/2575#discussion_r695471835
##########
File path: hadoop-hdds/docs/content/feature/Observability.zh.md
##########
@@ -0,0 +1,222 @@
+---
+title: "可观察性"
+weight: 8
+menu:
+ main:
+ parent: 特性
+summary: 用于增强 Ozone 可观察性的不同工具
+---
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+Ozone 为获取集群运行状态的详细信息提供了多种工具。
+
+## Prometheus
+
+Ozone 原生支持 Prometheus 集成。所有内部指标（通过 Hadoop 指标框架收集的指标）都发布在 `/prom` HTTP 端点下（比如 SCM 的指标发布在 http://localhost:9876/prom 下）。
+
+Prometheus 端点默认开启，但可以通过 `hdds.prometheus.endpoint.enabled` 配置参数关闭。
+
+在页面开启了 SPNEGO 认证的安全环境中，Prometheus 无法直接访问，需要配置特定的认证 token 才可以进行监控。
+
+ `ozone-site.xml` 示例：
+
+```XML
+<property>
+ <name>hdds.prometheus.endpoint.token</name>
+ <value>putyourtokenhere</value>
+</property>
+```
+
+Prometheus 配置示例:
+
+```YAML
+scrape_configs:
+ - job_name: ozone
+ bearer_token: <putyourtokenhere>
+ metrics_path: /prom
+ static_configs:
+ - targets:
+ - "127.0.0.1:9876"
+```
+
+## 分布式追踪
+
+分布式追踪可以通过可视化端到端性能来辅助定位性能瓶颈。
+
+Ozone 使用 [jaeger](https://jaegertracing.io) 追踪库来收集追踪数据并发送到任何兼容的后端（Zipkin等）
+
+追踪默认是关闭的，但可以通过 `ozone-site.xml` 中的 `hdds.tracing.enabled` 参数开启：
+
+```XML
+<property>
+ <name>hdds.tracing.enabled</name>
+ <value>true</value>
+</property>
+```
+
+根据[此处文档](https://github.com/jaegertracing/jaeger-client-java/blob/master/jaeger-core/README.md)，Jaeger 客户端可以通过环境变量进行配置，例如：
+
+```shell
+JAEGER_SAMPLER_PARAM=0.01
+JAEGER_SAMPLER_TYPE=probabilistic
+JAEGER_AGENT_HOST=jaeger
+```
+
+此配置会记录 1% 的请求来限制性能开销。更多有关 jaeger 采样的信息[请查阅文档](https://www.jaegertracing.io/docs/1.18/sampling/#client-sampling-configuration)
Review comment:
The English sentence is `This configuration will record 1% of the requests to limit the performance overhead`. It is easy to translate but not easy to understand for me. @elek Could you explain a little bit about `limit the performance overhead`?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For additional commands, e-mail: issues-help@ozone.apache.org
[GitHub] [ozone] iamabug commented on pull request #2575: HDDS-5563. feature/Observability.md translation
Posted by GitBox <gi...@apache.org>.
iamabug commented on pull request #2575:
URL: https://github.com/apache/ozone/pull/2575#issuecomment-906179125
cc @sky76093016
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For additional commands, e-mail: issues-help@ozone.apache.org
[GitHub] [ozone] iamabug commented on a change in pull request #2575: HDDS-5563. feature/Observability.md translation
Posted by GitBox <gi...@apache.org>.
iamabug commented on a change in pull request #2575:
URL: https://github.com/apache/ozone/pull/2575#discussion_r702370703
##########
File path: hadoop-hdds/docs/content/feature/Observability.zh.md
##########
@@ -0,0 +1,222 @@
+---
+title: "可观察性"
+weight: 8
+menu:
+ main:
+ parent: 特性
+summary: 用于增强 Ozone 可观察性的不同工具
+---
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+Ozone 为获取集群运行状态的详细信息提供了多种工具。
+
+## Prometheus
+
+Ozone 原生支持 Prometheus 集成。所有内部指标（通过 Hadoop 指标框架收集的指标）都发布在 `/prom` HTTP 端点下（比如 SCM 的指标发布在 http://localhost:9876/prom 下）。
+
+Prometheus 端点默认开启，但可以通过 `hdds.prometheus.endpoint.enabled` 配置参数关闭。
+
+在页面开启了 SPNEGO 认证的安全环境中，Prometheus 无法直接访问，需要配置特定的认证 token 才可以进行监控。
+
+ `ozone-site.xml` 示例：
+
+```XML
+<property>
+ <name>hdds.prometheus.endpoint.token</name>
+ <value>putyourtokenhere</value>
+</property>
+```
+
+Prometheus 配置示例:
+
+```YAML
+scrape_configs:
+ - job_name: ozone
+ bearer_token: <putyourtokenhere>
+ metrics_path: /prom
+ static_configs:
+ - targets:
+ - "127.0.0.1:9876"
+```
+
+## 分布式追踪
+
+分布式追踪可以通过可视化端到端性能来辅助定位性能瓶颈。
+
+Ozone 使用 [jaeger](https://jaegertracing.io) 追踪库来收集追踪数据并发送到任何兼容的后端（Zipkin等）
+
+追踪默认是关闭的，但可以通过 `ozone-site.xml` 中的 `hdds.tracing.enabled` 参数开启：
+
+```XML
+<property>
+ <name>hdds.tracing.enabled</name>
+ <value>true</value>
+</property>
+```
+
+根据[此处文档](https://github.com/jaegertracing/jaeger-client-java/blob/master/jaeger-core/README.md)，Jaeger 客户端可以通过环境变量进行配置，例如：
+
+```shell
+JAEGER_SAMPLER_PARAM=0.01
+JAEGER_SAMPLER_TYPE=probabilistic
+JAEGER_AGENT_HOST=jaeger
+```
+
+此配置会记录 1% 的请求来限制性能开销。更多有关 jaeger 采样的信息[请查阅文档](https://www.jaegertracing.io/docs/1.18/sampling/#client-sampling-configuration)
+
+## ozone insight
Review comment:
This problem exists in many places, English docs use both Ozone and ozone. If we believe this needs to be fixed, maybe we can open a separate ticket to do this.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For additional commands, e-mail: issues-help@ozone.apache.org
[GitHub] [ozone] iamabug commented on a change in pull request #2575: HDDS-5563. feature/Observability.md translation
Posted by GitBox <gi...@apache.org>.
iamabug commented on a change in pull request #2575:
URL: https://github.com/apache/ozone/pull/2575#discussion_r695469530
##########
File path: hadoop-hdds/docs/content/feature/Observability.zh.md
##########
@@ -0,0 +1,222 @@
+---
+title: "可观察性"
+weight: 8
+menu:
+ main:
+ parent: 特性
+summary: 用于增强 Ozone 可观察性的不同工具
+---
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+Ozone 为获取集群运行状态的详细信息提供了多种工具。
+
+## Prometheus
+
+Ozone 原生支持 Prometheus 集成。所有内部指标（通过 Hadoop 指标框架收集的指标）都发布在 `/prom` HTTP 端点下（比如 SCM 的指标发布在 http://localhost:9876/prom 下）。
+
+Prometheus 端点默认开启，但可以通过 `hdds.prometheus.endpoint.enabled` 配置参数关闭。
+
+在页面开启了 SPNEGO 认证的安全环境中，Prometheus 无法直接访问，需要配置特定的认证 token 才可以进行监控。
+
+ `ozone-site.xml` 示例：
+
+```XML
+<property>
+ <name>hdds.prometheus.endpoint.token</name>
+ <value>putyourtokenhere</value>
+</property>
+```
+
+Prometheus 配置示例:
+
+```YAML
+scrape_configs:
+ - job_name: ozone
+ bearer_token: <putyourtokenhere>
+ metrics_path: /prom
+ static_configs:
+ - targets:
+ - "127.0.0.1:9876"
+```
+
+## 分布式追踪
+
+分布式追踪可以通过可视化端到端性能来辅助定位性能瓶颈。
+
+Ozone 使用 [jaeger](https://jaegertracing.io) 追踪库来收集追踪数据并发送到任何兼容的后端（Zipkin等）
+
+追踪默认是关闭的，但可以通过 `ozone-site.xml` 中的 `hdds.tracing.enabled` 参数开启：
+
+```XML
+<property>
+ <name>hdds.tracing.enabled</name>
+ <value>true</value>
+</property>
+```
+
+根据[此处文档](https://github.com/jaegertracing/jaeger-client-java/blob/master/jaeger-core/README.md)，Jaeger 客户端可以通过环境变量进行配置，例如：
+
+```shell
+JAEGER_SAMPLER_PARAM=0.01
+JAEGER_SAMPLER_TYPE=probabilistic
+JAEGER_AGENT_HOST=jaeger
+```
+
+此配置会记录 1% 的请求来限制性能开销。更多有关 jaeger 采样的信息[请查阅文档](https://www.jaegertracing.io/docs/1.18/sampling/#client-sampling-configuration)
+
+## ozone insight
+
+Ozone insight 是一把查看 Ozone 集群当前状态的瑞士军刀。它可以展示特定组件的日志、指标和配置。
+
+使用 `ozone insight list` 命令查看可选组件：
+
+```shell
+> ozone insight list
+
+Available insight points:
Review comment:
I chose not to translation these (shell command and output), but I could use a second opioion.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For additional commands, e-mail: issues-help@ozone.apache.org
[GitHub] [ozone] sky76093016 commented on a change in pull request #2575: HDDS-5563. feature/Observability.md translation
Posted by GitBox <gi...@apache.org>.
sky76093016 commented on a change in pull request #2575:
URL: https://github.com/apache/ozone/pull/2575#discussion_r696442850
##########
File path: hadoop-hdds/docs/content/feature/Observability.zh.md
##########
@@ -0,0 +1,222 @@
+---
+title: "可观察性"
+weight: 8
+menu:
+ main:
+ parent: 特性
+summary: 用于增强 Ozone 可观察性的不同工具
+---
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+Ozone 为获取集群运行状态的详细信息提供了多种工具。
+
+## Prometheus
+
+Ozone 原生支持 Prometheus 集成。所有内部指标（通过 Hadoop 指标框架收集的指标）都发布在 `/prom` HTTP 端点下（比如 SCM 的指标发布在 http://localhost:9876/prom 下）。
+
+Prometheus 端点默认开启，但可以通过 `hdds.prometheus.endpoint.enabled` 配置参数关闭。
+
+在页面开启了 SPNEGO 认证的安全环境中，Prometheus 无法直接访问，需要配置特定的认证 token 才可以进行监控。
+
+ `ozone-site.xml` 示例：
+
+```XML
+<property>
+ <name>hdds.prometheus.endpoint.token</name>
+ <value>putyourtokenhere</value>
+</property>
+```
+
+Prometheus 配置示例:
+
+```YAML
+scrape_configs:
+ - job_name: ozone
+ bearer_token: <putyourtokenhere>
+ metrics_path: /prom
+ static_configs:
+ - targets:
+ - "127.0.0.1:9876"
+```
+
+## 分布式追踪
+
+分布式追踪可以通过可视化端到端性能来辅助定位性能瓶颈。
+
+Ozone 使用 [jaeger](https://jaegertracing.io) 追踪库来收集追踪数据并发送到任何兼容的后端（Zipkin等）
Review comment:
Missing punctuation
```suggestion
Ozone 使用 [jaeger](https://jaegertracing.io) 追踪库来收集追踪数据并发送到任何兼容的后端（Zipkin等）。
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For additional commands, e-mail: issues-help@ozone.apache.org
[GitHub] [ozone] sky76093016 commented on a change in pull request #2575: HDDS-5563. feature/Observability.md translation
Posted by GitBox <gi...@apache.org>.
sky76093016 commented on a change in pull request #2575:
URL: https://github.com/apache/ozone/pull/2575#discussion_r696436358
##########
File path: hadoop-hdds/docs/content/feature/Observability.zh.md
##########
@@ -0,0 +1,222 @@
+---
+title: "可观察性"
+weight: 8
+menu:
+ main:
+ parent: 特性
+summary: 用于增强 Ozone 可观察性的不同工具
+---
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+Ozone 为获取集群运行状态的详细信息提供了多种工具。
+
+## Prometheus
+
+Ozone 原生支持 Prometheus 集成。所有内部指标（通过 Hadoop 指标框架收集的指标）都发布在 `/prom` HTTP 端点下（比如 SCM 的指标发布在 http://localhost:9876/prom 下）。
+
+Prometheus 端点默认开启，但可以通过 `hdds.prometheus.endpoint.enabled` 配置参数关闭。
+
+在页面开启了 SPNEGO 认证的安全环境中，Prometheus 无法直接访问，需要配置特定的认证 token 才可以进行监控。
+
+ `ozone-site.xml` 示例：
+
+```XML
+<property>
+ <name>hdds.prometheus.endpoint.token</name>
+ <value>putyourtokenhere</value>
+</property>
+```
+
+Prometheus 配置示例:
+
+```YAML
+scrape_configs:
+ - job_name: ozone
+ bearer_token: <putyourtokenhere>
+ metrics_path: /prom
+ static_configs:
+ - targets:
+ - "127.0.0.1:9876"
+```
+
+## 分布式追踪
+
+分布式追踪可以通过可视化端到端性能来辅助定位性能瓶颈。
+
+Ozone 使用 [jaeger](https://jaegertracing.io) 追踪库来收集追踪数据并发送到任何兼容的后端（Zipkin等）
+
+追踪默认是关闭的，但可以通过 `ozone-site.xml` 中的 `hdds.tracing.enabled` 参数开启：
+
+```XML
+<property>
+ <name>hdds.tracing.enabled</name>
+ <value>true</value>
+</property>
+```
+
+根据[此处文档](https://github.com/jaegertracing/jaeger-client-java/blob/master/jaeger-core/README.md)，Jaeger 客户端可以通过环境变量进行配置，例如：
+
+```shell
+JAEGER_SAMPLER_PARAM=0.01
+JAEGER_SAMPLER_TYPE=probabilistic
+JAEGER_AGENT_HOST=jaeger
+```
+
+此配置会记录 1% 的请求来限制性能开销。更多有关 jaeger 采样的信息[请查阅文档](https://www.jaegertracing.io/docs/1.18/sampling/#client-sampling-configuration)
+
+## ozone insight
+
+Ozone insight 是一把查看 Ozone 集群当前状态的瑞士军刀。它可以展示特定组件的日志、指标和配置。
Review comment:
`Swiss-army-knife` may be a slang term, but the use of `瑞士军刀` is not suitable for people to understand.
```suggestion
Ozone insight 是一个查看 Ozone 集群当前状态的万能工具。它可以展示特定组件的日志、指标和配置。
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For additional commands, e-mail: issues-help@ozone.apache.org
[GitHub] [ozone] sky76093016 commented on a change in pull request #2575: HDDS-5563. feature/Observability.md translation
Posted by GitBox <gi...@apache.org>.
sky76093016 commented on a change in pull request #2575:
URL: https://github.com/apache/ozone/pull/2575#discussion_r696431459
##########
File path: hadoop-hdds/docs/content/feature/Observability.zh.md
##########
@@ -0,0 +1,222 @@
+---
+title: "可观察性"
+weight: 8
+menu:
+ main:
+ parent: 特性
+summary: 用于增强 Ozone 可观察性的不同工具
+---
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+Ozone 为获取集群运行状态的详细信息提供了多种工具。
+
+## Prometheus
+
+Ozone 原生支持 Prometheus 集成。所有内部指标（通过 Hadoop 指标框架收集的指标）都发布在 `/prom` HTTP 端点下（比如 SCM 的指标发布在 http://localhost:9876/prom 下）。
+
+Prometheus 端点默认开启，但可以通过 `hdds.prometheus.endpoint.enabled` 配置参数关闭。
+
+在页面开启了 SPNEGO 认证的安全环境中，Prometheus 无法直接访问，需要配置特定的认证 token 才可以进行监控。
+
+ `ozone-site.xml` 示例：
+
+```XML
+<property>
+ <name>hdds.prometheus.endpoint.token</name>
+ <value>putyourtokenhere</value>
+</property>
+```
+
+Prometheus 配置示例:
+
+```YAML
+scrape_configs:
+ - job_name: ozone
+ bearer_token: <putyourtokenhere>
+ metrics_path: /prom
+ static_configs:
+ - targets:
+ - "127.0.0.1:9876"
+```
+
+## 分布式追踪
+
+分布式追踪可以通过可视化端到端性能来辅助定位性能瓶颈。
+
+Ozone 使用 [jaeger](https://jaegertracing.io) 追踪库来收集追踪数据并发送到任何兼容的后端（Zipkin等）
+
+追踪默认是关闭的，但可以通过 `ozone-site.xml` 中的 `hdds.tracing.enabled` 参数开启：
+
+```XML
+<property>
+ <name>hdds.tracing.enabled</name>
+ <value>true</value>
+</property>
+```
+
+根据[此处文档](https://github.com/jaegertracing/jaeger-client-java/blob/master/jaeger-core/README.md)，Jaeger 客户端可以通过环境变量进行配置，例如：
+
+```shell
+JAEGER_SAMPLER_PARAM=0.01
+JAEGER_SAMPLER_TYPE=probabilistic
+JAEGER_AGENT_HOST=jaeger
+```
+
+此配置会记录 1% 的请求来限制性能开销。更多有关 jaeger 采样的信息[请查阅文档](https://www.jaegertracing.io/docs/1.18/sampling/#client-sampling-configuration)
+
+## ozone insight
Review comment:
Does `O` need to be capitalized?If you modify it here, the same place as `observability.md` is also needed.
```suggestion
## Ozone insight
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For additional commands, e-mail: issues-help@ozone.apache.org
[GitHub] [ozone] sky76093016 commented on a change in pull request #2575: HDDS-5563. feature/Observability.md translation
Posted by GitBox <gi...@apache.org>.
sky76093016 commented on a change in pull request #2575:
URL: https://github.com/apache/ozone/pull/2575#discussion_r696442850
##########
File path: hadoop-hdds/docs/content/feature/Observability.zh.md
##########
@@ -0,0 +1,222 @@
+---
+title: "可观察性"
+weight: 8
+menu:
+ main:
+ parent: 特性
+summary: 用于增强 Ozone 可观察性的不同工具
+---
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+Ozone 为获取集群运行状态的详细信息提供了多种工具。
+
+## Prometheus
+
+Ozone 原生支持 Prometheus 集成。所有内部指标（通过 Hadoop 指标框架收集的指标）都发布在 `/prom` HTTP 端点下（比如 SCM 的指标发布在 http://localhost:9876/prom 下）。
+
+Prometheus 端点默认开启，但可以通过 `hdds.prometheus.endpoint.enabled` 配置参数关闭。
+
+在页面开启了 SPNEGO 认证的安全环境中，Prometheus 无法直接访问，需要配置特定的认证 token 才可以进行监控。
+
+ `ozone-site.xml` 示例：
+
+```XML
+<property>
+ <name>hdds.prometheus.endpoint.token</name>
+ <value>putyourtokenhere</value>
+</property>
+```
+
+Prometheus 配置示例:
+
+```YAML
+scrape_configs:
+ - job_name: ozone
+ bearer_token: <putyourtokenhere>
+ metrics_path: /prom
+ static_configs:
+ - targets:
+ - "127.0.0.1:9876"
+```
+
+## 分布式追踪
+
+分布式追踪可以通过可视化端到端性能来辅助定位性能瓶颈。
+
+Ozone 使用 [jaeger](https://jaegertracing.io) 追踪库来收集追踪数据并发送到任何兼容的后端（Zipkin等）
Review comment:
Missing symbol
```suggestion
Ozone 使用 [jaeger](https://jaegertracing.io) 追踪库来收集追踪数据并发送到任何兼容的后端（Zipkin等）。
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For additional commands, e-mail: issues-help@ozone.apache.org
[GitHub] [ozone] sky76093016 commented on a change in pull request #2575: HDDS-5563. feature/Observability.md translation
Posted by GitBox <gi...@apache.org>.
sky76093016 commented on a change in pull request #2575:
URL: https://github.com/apache/ozone/pull/2575#discussion_r702371161
##########
File path: hadoop-hdds/docs/content/feature/Observability.zh.md
##########
@@ -0,0 +1,222 @@
+---
+title: "可观察性"
+weight: 8
+menu:
+ main:
+ parent: 特性
+summary: 用于增强 Ozone 可观察性的不同工具
+---
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+Ozone 为获取集群运行状态的详细信息提供了多种工具。
+
+## Prometheus
+
+Ozone 原生支持 Prometheus 集成。所有内部指标（通过 Hadoop 指标框架收集的指标）都发布在 `/prom` HTTP 端点下（比如 SCM 的指标发布在 http://localhost:9876/prom 下）。
+
+Prometheus 端点默认开启，但可以通过 `hdds.prometheus.endpoint.enabled` 配置参数关闭。
+
+在页面开启了 SPNEGO 认证的安全环境中，Prometheus 无法直接访问，需要配置特定的认证 token 才可以进行监控。
+
+ `ozone-site.xml` 示例：
+
+```XML
+<property>
+ <name>hdds.prometheus.endpoint.token</name>
+ <value>putyourtokenhere</value>
+</property>
+```
+
+Prometheus 配置示例:
+
+```YAML
+scrape_configs:
+ - job_name: ozone
+ bearer_token: <putyourtokenhere>
+ metrics_path: /prom
+ static_configs:
+ - targets:
+ - "127.0.0.1:9876"
+```
+
+## 分布式追踪
+
+分布式追踪可以通过可视化端到端性能来辅助定位性能瓶颈。
+
+Ozone 使用 [jaeger](https://jaegertracing.io) 追踪库来收集追踪数据并发送到任何兼容的后端（Zipkin等）
+
+追踪默认是关闭的，但可以通过 `ozone-site.xml` 中的 `hdds.tracing.enabled` 参数开启：
+
+```XML
+<property>
+ <name>hdds.tracing.enabled</name>
+ <value>true</value>
+</property>
+```
+
+根据[此处文档](https://github.com/jaegertracing/jaeger-client-java/blob/master/jaeger-core/README.md)，Jaeger 客户端可以通过环境变量进行配置，例如：
+
+```shell
+JAEGER_SAMPLER_PARAM=0.01
+JAEGER_SAMPLER_TYPE=probabilistic
+JAEGER_AGENT_HOST=jaeger
+```
+
+此配置会记录 1% 的请求来限制性能开销。更多有关 jaeger 采样的信息[请查阅文档](https://www.jaegertracing.io/docs/1.18/sampling/#client-sampling-configuration)
+
+## ozone insight
Review comment:
This is indeed a problem that needs to be improved.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For additional commands, e-mail: issues-help@ozone.apache.org