tendermint/tm-monitor
Anton Kaliaev 5a211ff791
[monitor] move to int64 for height
2018-04-03 13:02:09 +02:00
..
eventmeter Rename queries to queryToMetricMap 2018-03-28 18:37:39 +08:00
mock Rename eventType to query 2018-03-28 18:20:00 +08:00
monitor [monitor] move to int64 for height 2018-04-03 13:02:09 +02:00
.dockerignore [monitor] ignore vendor when building docker 2018-04-03 11:08:43 +02:00
Dockerfile [tm-monitor] update docker alpine version 2017-07-29 13:50:09 -04:00
Dockerfile.dev [monitor] switch to dep 2018-04-03 11:08:43 +02:00
Gopkg.lock [monitor] switch to dep 2018-04-03 11:08:43 +02:00
Gopkg.toml [monitor] switch to dep 2018-04-03 11:08:43 +02:00
LICENSE [tm-monitor] update Makefile 2017-12-06 14:21:02 -06:00
Makefile [monitor] update Makefile 2018-04-03 11:05:28 +02:00
README.rst [monitor] bring back readme 2018-04-03 11:55:43 +02:00
main.go update tm-monitor version to 0.3.1 2017-12-07 14:03:24 -06:00
rpc.go [tm-monitor] update WSClient 2017-10-06 11:36:49 +04:00
ton.go [tm-monitor] extract lib to monitor/ dir 2017-03-16 14:53:32 +04:00

README.rst

Monitoring
==========

tm-monitor
----------

Tendermint blockchain monitoring tool; watches over one or more nodes, collecting and providing various statistics to the user: https://github.com/tendermint/tools/tree/master/tm-monitor

Quick Start
^^^^^^^^^^^

Docker
~~~~~~

::

    docker run -it --rm -v "/tmp:/tendermint" tendermint/tendermint init
    docker run -it --rm -v "/tmp:/tendermint" -p "46657:46657" --name=tm tendermint/tendermint

    docker run -it --rm --link=tm tendermint/monitor tm:46657

Binaries
~~~~~~~~

This will be the same as you did for ``tm-bench`` above, except for the last line which should be:

::

    tm-monitor localhost:46657

Usage
^^^^^

::

    tm-monitor [-v] [-no-ton] [-listen-addr="tcp://0.0.0.0:46670"] [endpoints]

    Examples:
            # monitor single instance
            tm-monitor localhost:46657

            # monitor a few instances by providing comma-separated list of RPC endpoints
            tm-monitor host1:46657,host2:46657
    Flags:
      -listen-addr string
            HTTP and Websocket server listen address (default "tcp://0.0.0.0:46670")
      -no-ton
            Do not show ton (table of nodes)
      -v    verbose logging

RPC UI
^^^^^^

Run ``tm-monitor`` and visit http://localhost:46670
You should see the list of the available RPC endpoints:

::

    http://localhost:46670/status
    http://localhost:46670/status/network
    http://localhost:46670/monitor?endpoint=_
    http://localhost:46670/status/node?name=_
    http://localhost:46670/unmonitor?endpoint=_

The API is available as GET requests with URI encoded parameters, or as JSONRPC
POST requests. The JSONRPC methods are also exposed over websocket.

Development
^^^^^^^^^^^

::

    make get_vendor_deps
    make test