Converting YAML to JSON when configuring RTView

Knowledge Base

Converting YAML to JSON when configuring RTView

Nov 8, 2020, by Chris

RTView is a new monitoring tool released by IOHK. When configuring or installing RTView, you might need the help of yaml to json converters.

Since LiveView will get removed from future releases, IOHK released a new tool called RTView which helps monitoring your nodes. It is available on GitHub. It is still in the very beginning and therefore don't expect too much of it. What's a bit of a burden is, that in most cases you also have to install apache2 or nginx as reverse proxy to access the statistics of RTView from client machines connected to your network.

After you completed the installation wizzard of RTView you will see a prompt like this:

Great, RTView is ready to run! Its configuration was saved at /home/ada/.config/rt-view.yaml. Press <Enter> to continue...

Now you have to make the following changes in your node's configuration file:

1. Find setupBackends and add TraceForwarderBK in it:

   setupBackends:
     - TraceForwarderBK

2. Find TurnOnLogMetrics and set it to True:

   TurnOnLogMetrics: True

3. Find options -> mapBackends and redirect required metrics to TraceForwarderBK, for example:

   options:
     mapBackends:
       cardano.node.metrics:
         - TraceForwarderBK
       cardano.node.Forge.metrics:
         - TraceForwarderBK

   For more info about supported metrics please read the documentation.

4. Since you have 3 nodes, add following traceForwardTo sections in the root of their configuration files:

   traceForwardTo:
     tag: RemoteSocket
     contents:
       - "IP.OF.YOUR.NODE1"
       - "PORT1"

   traceForwardTo:
     tag: RemoteSocket
     contents:
       - "IP.OF.YOUR.NODE2"
       - "PORT2"

   traceForwardTo:
     tag: RemoteSocket
     contents:
       - "IP.OF.YOUR.NODE3"
       - "PORT3"

After you are done, press <Enter> to run RTView...


In case you wonder how to integrate the above mentioned configs to your config json file, a simple yaml to json converter might help. There are plenty of them in the web. Here's one: https://dataconverter.curiousconcept.com/ . Just paste your code in there and convert it from yaml to json. I hope this makes things easier for you!

Have a great start with RTView!


written by: Chris     published at: Nov 8, 2020
Further articles you might be interested in

Update grafana metrics when updating to cardano-node 1.25.1

Feb 2, 2021 by Chris

Cardano's [CAFE] and [CAFE2] are updated to newest version 1.25.1. For all stake pool operators (SPOs) it is important to know that with release of 1.25.1 the mainnet-config.json in the repository of CF / IOHK was consolidated and is a lot slimmer than previous! Some names of statistic variables have changed. In most cases the wording "ChainDB_" was removed. So be sure to update your grafana dashboard so that you can still enjoy your statistics after update to 1.25.1.


How to setup prometheus and grafana on a dedicated machine to monitor your cardano nodes

Nov 21, 2020 by Chris

Prometheus and grafana are helpful tools to monitor your nodes. They have a built-in alert function which notifies you about arising problems. This guide will show how to setup your infrastructure to do this monitoring with a separate machine thus not requiring additional installations on your vital cardano nodes.


Cardano Stake Pool Course

Oct 3, 2020 by Chris

A great way to help new stake pool operators in setting up their own stake pool is learning from the docs of the official Cardano Stake Pool School. It was launched by the Cardano Foundation in August 2020.


Security Tipps for Stake Pool Operators (SPOs)

Sep 21, 2020 by Chris

This article aims to provide an additional layer of security to your nodes according to swiss cheese model by preventing SSH login via public WAN. Using VPN and (V)LANs both relay- and block-producing nodes get isolated from the web.