You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@rocketmq.apache.org by vo...@apache.org on 2019/07/22 12:07:30 UTC
[rocketmq-exporter] branch master updated: Polish the doc
This is an automated email from the ASF dual-hosted git repository.
vongosling pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/rocketmq-exporter.git
The following commit(s) were added to refs/heads/master by this push:
new 4676344 Polish the doc
4676344 is described below
commit 4676344c0ef728e06e8908f8570321dbd21df025
Author: vongosling <vo...@apache.org>
AuthorDate: Mon Jul 22 20:07:20 2019 +0800
Polish the doc
---
README.md | 40 ++++++++++------------
...e_example.md => rocketmq_exporter_quickstart.md | 33 ++++--------------
2 files changed, 24 insertions(+), 49 deletions(-)
diff --git a/README.md b/README.md
index 28d236c..463d366 100644
--- a/README.md
+++ b/README.md
@@ -6,33 +6,40 @@ Apache RocketMQ Exporter for Prometheus.
Table of Contents
-----------------
- [Compatibility](#compatibility)
-- [Dependency](#dependency)
-- [Download](#download)
-- [Compile](#compile)
+- [Configuration](#configuration)
+- [Build](#build)
- [Build Binary](#build-binary)
- [Build Docker Image](#build-docker-image)
- [Run](#run)
- [Run Binary](#run-binary)
- [Run Docker Image](#run-docker-image)
-- [Flags](#flags)
- [Metrics](#metrics)
- [Brokers](#brokers)
- [Topics](#topics)
- [Consumer Groups](#consumer-groups)
-- [Grafana Dashboard](#Grafana-Dashboard)
-- [Quick Start](#Use-Example)
+- [Grafana Dashboard](#grafana-dashboard)
+- [Quick Start](#quick-start)
Compatibility
-------------
Support [Apache RocketMQ](https://rocketmq.apache.org) version 4.3.2 (and later).
-Dependency
-----------
-- [Prometheus](https://prometheus.io)
+Configuration
+---
+
+This image is configurable using different properties, See ``application.properties`` for a configuration example.
+
+| name | Default | Description |
+| -----------------------------------|--------------------|----------------------------------------------------|
+| `rocketmq.config.namesrvAddr` | 127.0.0.1:9876 |name server address for broker cluster |
+| `rocketmq.config.webTelemetryPath` | /metrics |Path under which to expose metrics |
+| `server.port` | 5557 |Address to listen on for web interface and telemetry|
+| `rocketmq.config.rocketmqVersion` | V4_3_2 |rocketmq broker version |
+
-Compile
+Build
-------
### Build Binary
@@ -62,17 +69,6 @@ java -jar rocketmq-exporter-0.0.1-SNAPSHOT.jar
docker container run -itd --rm -p 5557:5557 docker.io/rocketmq-exporter
```
-Flags
----
-
-This image is configurable using different flags
-
-|Flag name | Default | Description |
-| -----------------------------------|--------------------|----------------------------------------------------|
-| `rocketmq.config.namesrvAddr` | 127.0.0.1:9876 |name server address for broker cluster |
-| `rocketmq.config.webTelemetryPath` | /metrics |Path under which to expose metrics |
-| `server.port` | 5557 |Address to listen on for web interface and telemetry|
-| `rocketmq.config.rocketmqVersion` | V4_3_2 |rocketmq broker version |
Metrics
-------
@@ -212,4 +208,4 @@ For details of the dashboard please see [RocketMQ Exporter Overview](https://gra
Quick Start
-------------
-For details of the use example please refer to [use example](./rocketmq_exporter_use_example.md)
+This [guide]((./rocketmq_exporter_quickstart.md)) will teach you how to build and run rocketmq exporter from scratch.
diff --git a/rocketmq_exporter_use_example.md b/rocketmq_exporter_quickstart.md
similarity index 76%
rename from rocketmq_exporter_use_example.md
rename to rocketmq_exporter_quickstart.md
index 27a90d4..4ba2863 100644
--- a/rocketmq_exporter_use_example.md
+++ b/rocketmq_exporter_quickstart.md
@@ -1,33 +1,12 @@
# RocketMQ Exporter Quick Start #
-## 1 Start up NameServer and Broker ##
-In order to use the RocketMQ Exporter, firstly make sure that the RocketMQ service is properly downloaded and started. Users can refer to the quick start of the RocketMQ master station for operation. Make sure the NameServer and Broker have started correctly.
+## Start up NameServer and Broker
+To use RocketMQ Exporter, first make sure the RocketMQ is downloaded and started correctly. Users can refer to [quick start](http://rocketmq.apache.org/docs/quick-start/) ensure that the service starts properly.
-## 2 Compile RocketMQ-Exporter ##
-Users currently need to download the git source code and then compile it
+## Build and Run RocketMQ Exporter
-```
-git clone https://github.com/apache/rocketmq-exporter
-cd rocketmq-exporter
-mvn clean install
-```
-
-## 3 Configuration and startup ##
-RocketMQ-Exporter has the following running options
-
-operations | default value | meaning
----|---|---
-rocketmq.config.namesrvAddr | 127.0.0.1:9876 | MQ cluster nameSrv address
-rocketmq.config.webTelemetryPath | /metrics | metric collection path
-server.port | 5557 | HTTP service exposed port
-
-The above running options can be changed either in the configuration file after downloading the code or via the command line. The compiled jar package is called rocketmq-exporter-0.0.1-SNAPSHOT.jar, which can be run as follows.
-
-```
-java -jar rocketmq-exporter-0.0.1-SNAPSHOT.jar [--rocketmq.config.namesrvAddr="127.0.0.1:9876" ...]
-```
-## 4 Install Prometheus ##
+## Install Prometheus
Firstly go to Prometheus official download address: https://prometheus.io/download/ to download the Prometheus installation package, currently using linux installation as an example, the selected installation package is Prometheus-2.7.0-rc.1.linux-amd64.tar.gz, the Prometheus process can be started after the following steps.
```
@@ -65,7 +44,7 @@ global:
-## 5 Create Grafana dashboard for RocketMQ ##
+## Create Grafana dashboard for RocketMQ
Prometheus' own metric display platform is not as good as Grafana. In order to better show RocketMQ's metrics, Grafana can be used to show the metrics that Prometheus gets. Firstly go to the official website https://grafana.com/grafana/download to download installation file. Here is a an example for binary file installation.
@@ -82,7 +61,7 @@ Similarly, in order not to conflict with the ports of other processes, users can
Then, by accessing http:// server ip:55555 through the browser, users can verify whether the Grafana has been successfully installed. The system default username and password are admin/admin. The first time users log in to the system, users will be asked to change the password. In addition, users need to set Grafana's data source to Prometheus. If user have started up Prometheus like above, now the data source address will be http:// server ip:5555. For the convenience of users, RocketM [...]
-## 6 Configure alarms in Prometheus
+## Configure alarms in Prometheus
If users want to configure alarms,there are two things users should do.
Firstly, modify the Prometheus configuration file prometheus.yml and add the following configuration: