diff --git a/doc/images/plugin/prometheus01.png b/doc/images/plugin/prometheus01.png
new file mode 100644
index 000000000000..f5c1ee12c06a
Binary files /dev/null and b/doc/images/plugin/prometheus01.png differ
diff --git a/doc/images/plugin/prometheus02.png b/doc/images/plugin/prometheus02.png
new file mode 100644
index 000000000000..94934a90301e
Binary files /dev/null and b/doc/images/plugin/prometheus02.png differ
diff --git a/lua/apisix/plugins/prometheus.md b/lua/apisix/plugins/prometheus.md
new file mode 100644
index 000000000000..d2a309aabf51
--- /dev/null
+++ b/lua/apisix/plugins/prometheus.md
@@ -0,0 +1,103 @@
+# prometheus
+
+This plugin exposes metrics in Prometheus Exposition format.
+
+<!-- [中文](prometheus-cn.md) [英文](prometheus.md) -->
+
+## Attributes
+
+none.
+
+## How to enable it
+
+`prometheus` plugin can be enable with empty table, If you want to disable it,
+you can not configure it.
+
+For example:
+
+```
+curl http://127.0.0.1:2379/v2/keys/apisix/routes/1 -X PUT -d value='
+{
+    "methods": ["GET"],
+    "uri": "/hello",
+    "id": 1,
+    "plugin_config": {
+        "prometheus":{}
+    },
+    "upstream": {
+        "type": "roundrobin",
+        "nodes": {
+            "127.0.0.1:80": 1
+        }
+    }
+}'
+```
+
+## How to fetch the metric data
+
+We fetch the metric data from the specified url `/apisix.com/prometheus/metrics`.
+
+You can put this uri address into prometheus, and it will automatically get these metric data.
+
+For example like this:
+
+```yaml
+scrape_configs:
+  - job_name: 'apisix'
+    metrics_path: '/apisix.com/prometheus/metrics'
+    static_configs:
+    - targets: ['127.0.0.1:9080']
+```
+
+And we can check the status at prometheus console:
+
+![](../../../doc/images/plugin/prometheus01.jpg)
+
+![](../../../doc/images/plugin/prometheus02.jpg)
+
+
+### Grafana dashboard
+
+Metrics exported by the plugin can be graphed in Grafana using a drop in dashboard: https://grafana.com/dashboards/7424 .
+
+
+### Available metrics
+
+* `Status codes`: HTTP status codes returned by upstream services. These are available per service and across all services.
+* `Bandwidth`: Total Bandwidth (egress/ingress) flowing through apisix. This metric is available per service and as a sum across all services.
+* `etcd reachability`: A gauge type with a value of 0 or 1, representing if etcd can be reached by a apisix or not.
+* `Connections`: Various Nginx connection metrics like active, reading, writing, and number of accepted connections.
+
+Here is the original metric data of apisix:
+
+```
+$ curl http://127.0.0.2:9080/apisix.com/prometheus/metrics
+# HELP apisix_bandwidth Total bandwidth in bytes consumed per service in Apisix
+# TYPE apisix_bandwidth counter
+apisix_bandwidth{type="egress",service="127.0.0.2"} 183
+apisix_bandwidth{type="egress",service="bar.com"} 183
+apisix_bandwidth{type="egress",service="foo.com"} 2379
+apisix_bandwidth{type="ingress",service="127.0.0.2"} 83
+apisix_bandwidth{type="ingress",service="bar.com"} 76
+apisix_bandwidth{type="ingress",service="foo.com"} 988
+# HELP apisix_etcd_reachable Config server etcd reachable from Apisix, 0 is unreachable
+# TYPE apisix_etcd_reachable gauge
+apisix_etcd_reachable 1
+# HELP apisix_http_status HTTP status codes per service in Apisix
+# TYPE apisix_http_status counter
+apisix_http_status{code="200",service="127.0.0.2"} 1
+apisix_http_status{code="200",service="bar.com"} 1
+apisix_http_status{code="200",service="foo.com"} 13
+# HELP apisix_nginx_http_current_connections Number of HTTP connections
+# TYPE apisix_nginx_http_current_connections gauge
+apisix_nginx_http_current_connections{state="accepted"} 11994
+apisix_nginx_http_current_connections{state="active"} 2
+apisix_nginx_http_current_connections{state="handled"} 11994
+apisix_nginx_http_current_connections{state="reading"} 0
+apisix_nginx_http_current_connections{state="total"} 1191780
+apisix_nginx_http_current_connections{state="waiting"} 1
+apisix_nginx_http_current_connections{state="writing"} 1
+# HELP apisix_nginx_metric_errors_total Number of nginx-lua-prometheus errors
+# TYPE apisix_nginx_metric_errors_total counter
+apisix_nginx_metric_errors_total 0
+```