klion26 commented on a change in pull request #8366:
URL: https://github.com/apache/flink/pull/8366#discussion_r452632484
##########
File path: docs/monitoring/historyserver.zh.md
##########
@@ -22,62 +22,62 @@ specific language governing permissions and limitations
under the License.
-->
-Flink has a history server that can be used to query the statistics of
completed jobs after the corresponding Flink cluster has been shut down.
+Flink 自带的 history server 可以在已执行完作业对应的 Flink 集群关闭之后查询该作业的统计信息。
-Furthermore, it exposes a REST API that accepts HTTP requests and responds
with JSON data.
+除此之外，它还提供了一个 REST API，可以通过 HTTP 以 JSON 格式发送和接收数据。
* This will be replaced by the TOC
{:toc}
-## Overview
+## 概览
-The HistoryServer allows you to query the status and statistics of completed
jobs that have been archived by a JobManager.
+History server 可以查询被 JobManager 存档的已执行完作业的状态和统计信息。
-After you have configured the HistoryServer *and* JobManager, you start and
stop the HistoryServer via its corresponding startup script:
+在配置完 History server 和 JobManager 之后，用户可以通过下面的启动脚本来开启和关停 History server：
{% highlight shell %}
-# Start or stop the HistoryServer
+# 开启或关停 History Server
bin/historyserver.sh (start|start-foreground|stop)
{% endhighlight %}
-By default, this server binds to `localhost` and listens at port `8082`.
+默认情况下，History server 绑定到本机 `localhost` 的 `8082` 端口。
-Currently, you can only run it as a standalone process.
+目前，只能当做单独的进程来运行。
-## Configuration
+## 配置
-The configuration keys `jobmanager.archive.fs.dir` and
`historyserver.archive.fs.refresh-interval` need to be adjusted for archiving
and displaying archived jobs.
+如果要存档和展示已完成的作业 需要调配 `jobmanager.archive.fs.dir` 和
`historyserver.archive.fs.refresh-interval` 这俩配置项。
**JobManager**
-The archiving of completed jobs happens on the JobManager, which uploads the
archived job information to a file system directory. You can configure the
directory to archive completed jobs in `flink-conf.yaml` by setting a directory
via `jobmanager.archive.fs.dir`.
+JobManager 会进行已完成作业的存档，把已存档作业的信息上传到一个文件系统目录上。用户可以通过设置
`jobmanager.archive.fs.dir` 来配置这个存档目录，将 `flink-conf.yaml` 中已完成的作业都存档下来。
{% highlight yaml %}
-# Directory to upload completed job information
+# 已完成作业信息的上传目录
jobmanager.archive.fs.dir: hdfs:///completed-jobs
{% endhighlight %}
**HistoryServer**
-The HistoryServer can be configured to monitor a comma-separated list of
directories in via `historyserver.archive.fs.dir`. The configured directories
are regularly polled for new archives; the polling interval can be configured
via `historyserver.archive.fs.refresh-interval`.
+History Server 可以监控 `historyserver.archive.fs.dir` 配置的用逗号分隔的文件目录列表。History
Server 会定期轮询配置的目录以发现新存档，轮询的间隔可以通过 `historyserver.archive.fs.refresh-interval`
来配置。
{% highlight yaml %}
-# Monitor the following directories for completed jobs
+# 监控已完成作业的目录
historyserver.archive.fs.dir: hdfs:///completed-jobs
-# Refresh every 10 seconds
+# 每10秒刷新一次
historyserver.archive.fs.refresh-interval: 10000
{% endhighlight %}
-The contained archives are downloaded and cached in the local filesystem. The
local directory for this is configured via `historyserver.web.tmpdir`.
+相关的存档都下载和缓存到本地文件系统里。这个本地文件目录可以通过 `historyserver.web.tmpdir` 来配置。
-Check out the configuration page for a [complete list of configuration
options]({{ site.baseurl }}/ops/config.html#history-server).
+这里可以查看[完整的配置项列表]({{ site.baseurl }}/ops/config.html#history-server)。
Review comment:
这里建议使用 `{%link ops/config.zh.md %}#history-server` 的形式来写链接
具体的参考
[邮件列表](http://apache-flink-mailing-list-archive.1008284.n3.nabble.com/Reminder-Prefer-link-tag-in-documentation-td42362.html)
PS：这个你可能需要先 rebase 到最新的 master 才生效
----------------------------------------------------------------
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.
For queries about this service, please contact Infrastructure at:
[email protected]
