trustlines-watch helps monitoring the trustlines cluster. It watches a running parity or geth client via the JSONRPC interface and pushes information to a riemann instance.
trustlines watch requires python 3.6 or up. It also needs the postgresql development files. On a debian based system these can be installed with
apt install libpq-dev
Please run the following command in a python 3 virtualenv:
pip install . -c constraints.txt
This will install a 'tl-watch' executable.
Watches etherscan for the current blockNumber. Run
tl-watch etherscan --help
for available command line options.
Watches a parity or geth client via the JSONRPC interface. Run
tl-watch jsonrpc --help
for available command line options.
Watches a trustlines relay server via the REST API. Run tl-watch relay
--help
for available command line options.
Queries a postgres database. Run tl-watch psql --help
for available command
line options.
The sql query to run is given via the command line option --sqlquery
. It
must return at least the service
and metric
fields.
Here's an example that would monitor the synchronization state of ethindex:
tl-watch psql --sqlquery "select 'sync.' || syncid || '.last_block' service, last_block_number metric from sync"
Calculates the hash of the relevant sources from a specific URL (--url
).
This is meant to be used in combination with tl-watch website
to get the
initial origin hash value. Relevant are sources which can change the content of
the website. Therefore the hash gets calculated over the basic HTML and the
first parity JS scripts. Stylesheets are not relevant for the content. External
JavaScript can't be ensured to not change and must not affect the content on its
own. Run tl-watch get-website-hash --help
for available command line
options.
Watches for changed code of a website. It continuously calculates the hash of
the relevant sources to ensure they haven't changed in comparison to an
initially provided origin hash. That origin hash can be calculated with
tl-watch get-website-hash
. Run tl-watch website --help
for available
command line options.
See CHANGELOG.