[hadoop-ozone] branch master updated: HDDS-2810. recipe/Prometheus.md translation (#796)

[ad...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

adoroszlai pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/hadoop-ozone.git


The following commit(s) were added to refs/heads/master by this push:
     new fa3aaf1  HDDS-2810. recipe/Prometheus.md translation (#796)
fa3aaf1 is described below

commit fa3aaf1a83f668da6383b39eeb5c9f19e0087f1b
Author: Xiang Zhang <mm...@mail.ustc.edu.cn>
AuthorDate: Thu Apr 23 01:26:59 2020 +0800

    HDDS-2810. recipe/Prometheus.md translation (#796)
---
 hadoop-hdds/docs/content/recipe/Prometheus.zh.md | 93 ++++++++++++++++++++++++
 1 file changed, 93 insertions(+)

diff --git a/hadoop-hdds/docs/content/recipe/Prometheus.zh.md b/hadoop-hdds/docs/content/recipe/Prometheus.zh.md
new file mode 100644
index 0000000..a235cd5
--- /dev/null
+++ b/hadoop-hdds/docs/content/recipe/Prometheus.zh.md
@@ -0,0 +1,93 @@
+---
+title: 使用 Prometheus 监控
+summary: 使用 Prometheus 监控 Ozone 的简要说明
+linktitle: Prometheus
+---
+<!---
+  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.
+-->
+
+[Prometheus](https://prometheus.io/)是在[云原生计算基金会](https://www.cncf.io/)管理下开发的一款开源监控软件。
+
+Ozone 原生支持 Prometheus，各个组件会启动一个兼容 Prometheus 的指标端点，将所有可用的 hadoop 指标以 Prometheus 的格式导出发布。
+
+## 准备
+
+ 1. [安装启动]({{< ref "start/RunningViaDocker.zh.md" >}})一个 Ozone 集群。
+ 2. [下载](https://prometheus.io/download/#prometheus) Prometheus 二进制包。
+
+## 使用 Prometheus 进行监控
+
+* 你需要在 `ozone-site.xml` 文件中添加配置才可以启用 Prometheus 指标端点。
+
+ ```xml
+  <property>
+    <name>hdds.prometheus.endpoint.enabled</name>
+    <value>true</value>
+  </property>
+```
+
+_注意_: 对于基于 docker-compose 方式的伪集群，在 `docker-config` 文件中添加 `OZONE-SITE.XML_hdds.prometheus.endpoint.enabled=true`。
+
+* 重启 OM 和 SCM，检查端点：
+
+ * http://scm:9874/prom
+
+ * http://ozoneManager:9876/prom
+
+* 根据这两个端点，创建 prometheus.yaml 配置文件：
+
+```yaml
+global:
+  scrape_interval: 15s
+
+scrape_configs:
+  - job_name: ozone
+    metrics_path: /prom
+    static_configs:
+     - targets:
+        - "scm:9876"
+        - "ozoneManager:9874"
+```
+
+* 在 prometheus.yaml 文件所在目录启动 Prometheus：
+
+```bash
+prometheus
+```
+
+* 在 Prometheus 的 web ui 中查看目标：
+
+http://localhost:9090/targets
+
+![Prometheus 目标页面示例](prometheus.png)
+
+
+* 在 Prometheus web ui 中查看任意的指标，例如：
+For example:
+
+http://localhost:9090/graph?g0.range_input=1h&g0.expr=om_metrics_num_key_allocate&g0.tab=1
+
+![Prometheus 指标页面示例](prometheus-key-allocate.png)
+
+## 注意事项
+
+Ozone 发行包中包含了一个即开即用的容器化环境来试用 Ozone 和 Prometheus，在 `compose/ozoneperf` 目录下。
+
+```bash
+cd compose/ozoneperf
+docker-compose up -d
+```


---------------------------------------------------------------------
To unsubscribe, e-mail: ozone-commits-unsubscribe@hadoop.apache.org
For additional commands, e-mail: ozone-commits-help@hadoop.apache.org