diff --git a/docs/metrics.md b/docs/metrics.md
index 71a632e04..1cd758b94 100644
--- a/docs/metrics.md
+++ b/docs/metrics.md
@@ -1,29 +1,35 @@
 # Metrics
 
-Tendermint can serve metrics under `/metrics` RPC endpoint, which can be
-consumed by Prometheus server.
+Tendermint can report and serve the Prometheus metrics, which in their turn can
+be consumed by Prometheus collector(s).
 
-This functionality is disabled by default. Set `monitoring=true` if your config
-to enable it.
+This functionality is disabled by default.
+
+To enable the Prometheus metrics, set `instrumentation.prometheus=true` if your
+config file. Metrics will be served under `/metrics` on 26660 port by default.
+Listen address can be changed in the config file (see
+`prometheus_listen_addr`).
 
 ## List of available metrics
 
-| Name                                    | Type    | Description                                                                   |
-| --------------------------------------- | ------- | ----------------------------------------------------------------------------- |
-| consensus_height                        | Gauge   | Height of the chain                                                           |
-| consensus_validators                    | Gauge   | Number of validators                                                          |
-| consensus_validators_power              | Gauge   | Total voting power of all validators                                          |
-| consensus_missing_validators            | Gauge   | Number of validators who did not sign                                         |
-| consensus_missing_validators_power      | Gauge   | Total voting power of the missing validators                                  |
-| consensus_byzantine_validators          | Gauge   | Number of validators who tried to double sign                                 |
-| consensus_byzantine_validators_power    | Gauge   | Total voting power of the byzantine validators                                |
-| consensus_block_interval                | Timing  | Time between this and last block (Block.Header.Time)                          |
-| consensus_rounds                        | Gauge   | Number of rounds                                                              |
-| consensus_num_txs                       | Gauge   | Number of transactions                                                        |
-| mempool_size                            | Gauge   | Number of uncommitted transactions                                            |
-| consensus_total_txs                     | Gauge   | Total number of transactions committed                                        |
-| consensus_block_size                    | Gauge   | Block size in bytes                                                           |
-| p2p_peers                               | Gauge   | Number of peers node's connected to                                           |
+The following metrics are available:
+
+| Name                                    | Type      | Since     | Description                                                                   |
+| --------------------------------------- | -------   | --------- | ----------------------------------------------------------------------------- |
+| consensus_height                        | Gauge     | 0.20.1    | Height of the chain                                                           |
+| consensus_validators                    | Gauge     | 0.20.1    | Number of validators                                                          |
+| consensus_validators_power              | Gauge     | 0.20.1    | Total voting power of all validators                                          |
+| consensus_missing_validators            | Gauge     | 0.20.1    | Number of validators who did not sign                                         |
+| consensus_missing_validators_power      | Gauge     | 0.20.1    | Total voting power of the missing validators                                  |
+| consensus_byzantine_validators          | Gauge     | 0.20.1    | Number of validators who tried to double sign                                 |
+| consensus_byzantine_validators_power    | Gauge     | 0.20.1    | Total voting power of the byzantine validators                                |
+| consensus_block_interval_seconds        | Histogram | 0.20.1    | Time between this and last block (Block.Header.Time) in seconds               |
+| consensus_rounds                        | Gauge     | 0.20.1    | Number of rounds                                                              |
+| consensus_num_txs                       | Gauge     | 0.20.1    | Number of transactions                                                        |
+| mempool_size                            | Gauge     | 0.20.1    | Number of uncommitted transactions                                            |
+| consensus_total_txs                     | Gauge     | 0.20.1    | Total number of transactions committed                                        |
+| consensus_block_size_bytes              | Gauge     | 0.20.1    | Block size in bytes                                                           |
+| p2p_peers                               | Gauge     | 0.20.1    | Number of peers node's connected to                                           |
 
 ## Useful queries