As result of my approved proposal

https://vote.smartcash.cc/Proposal/Details/SmartNode-Monitor-Telegram-Discord

i developed two bots to give SmartNode owners an easy way to monitor their SmartNodes (one for telegram and one for discord). This article will give you an insight to the features and the usage of the bots.



Features

The most important feature of the bots, at least in my opinion, is Timeout Notifications. If they are enabled you will receive a notification from the bot if one of your nodes could not be discovered from the node network longer than 30 minutes. This means in the most cases something is wrong with your node. If this happens you will have 30 minutes to solve the issue before your node gets kicked out to the end the payout queue. Save your rewards!

Check the current number of created/enabled nodes in the network

Add/edit/remove your nodes in a private chat with the bot.

Display a detailed summary of all your added nodes. Metrics include: Status Public address Uptime Last seen Last payout block and time Protocol Rank

Check the current balance of your nodes

Enable/disable several notifications in a private chat with the bot: Reward notifications – Receive a notification when one of your nodes receives a reward. Status notifications – Receive a notification if one of your nodes changes its status.

Why this is important - If your bot’s status is anything but Enabled, you will lose your payout positioning until you manually check and resolve the issue. Enabling notifications removes the need to constantly check each node’s status manually and allows you to address the issue in a quick and timely manner. Network notifications – You will receive a notification each time a new node joins/leaves the SmartNode network. Timeout notifications – You will receive a notification when the lastSeen timestamp of your node is greater then 30 minutes.



QuickStart

To access the telegram bot you just need to PM: https://t.me/SmartNodeMonitorBot

The discord bot is available on the SmartCash discord server: https://discord.gg/8zTBZ73 just PM @SmartNodeMonitor#5083 there.

The left aligned screens in the guide will show you the usage in telegram, the right aligned are for discord.

1. Add your nodes

At first you need to add your nodes by their IP-Adresses. The command to add nodes is /add in telegram or add for discord.

Add a single node

If you want to add just one node you need to call the add command with 1 parameter: ip;name where ip is the IP-Address of the node to add and name the name you want to give it. I would recommend to use the same as you used in your desktop wallet as alias.

The full command - /add ip;name for telegram, add ip;name for discord. Here is an example:

Add multiple nodes

If you plan to add multiple nodes you can just line them up in one command line by adding multiple parameters of the form ip;name .

The command to add two more nodes would be: /add ip1;name1 ip2;name2 in telegram or add ip1;name1 ip2;name2 for discord.

2. Setup your desired notifications

Once you added your nodes you can check your notification states with the /me command in telegram or me for discord.

The example above shows the default state. If you want to change any of the notification states you can use the following commands:

Telegram Discord Description /state 1/0 state 1/0 To enable/disable node state change notifications /reward 1/0 reward 1/0 To enable/disable payout notifications /timeout 1/0 timeout 1/0 To enable/disable timeout notifications /network 1/0 network 1/0 To enable/disable network update notifications

Below you see how to enable/disable network notifications.

Notification examples

Status

If the status of one of your nodes changes you will receive a notification like in the example below. This includes all state changes.

Reward

If one of your nodes receives a payout you will receive a notification like in the example below.

Warning: At the time of writing the nodelist in the smartcashd has an known issue that not all paid blocks are assigned to to node which got paid. As result you may miss some payout notifications at the moment. This should become more accurate with the next SmartCash wallet update.

Timeout

Like you see in the example below you receive a notification once your node was not seen for 30 minutes and also if it has recovered.

Network

Network notifications means you will receive a notification if a node joined/left the SmartNode network.

3. Enjoy it!

As soon as you added your nodes and set your desired notification states you are ready to go. From now on you can simply wait for any notifications or check the stats of your nodes with the following commands:

Detail view

To print a list with all available metrics of your node you can use the /detail command for telegram or just detail for discord.

Summary

To print a shortened list of your nodes states, lastpaids and lastseens attributes you can use the /nodes command for telegram or just node for discord.

Balances

The /balance command in telegram or balance for discord allows you to checkup the balances of all your nodes addresses. This relies on the official SmartCash explorers.

Additional commands

Get the current count of created/enabled nodes in the network with /info in telegram or info for discord.

Change the name of one of your nodes with /update ip;name in telegram or update ip;name for discord. Where ip is the IP-Address of the node you want to give a new name and name the new name.

To update the names of multiple nodes use the same process like to adding multiple nodes. /update ip1;name1 ip2;name2 ip3;name3 in telegram or update ip1;name1 ip2;name2 ip3;name3 for discord.

If you got rid of one of your nodes, hell...why you would do this, you can remove it with /remove ip in telegram or remove ip for discord. Where ip is the IP-Address of the node you want to remove.

If you got rid of multpile nodes remove them with /remove ip0 ip1 ... ipN in telegram or remove ip0 ip1 ... ipN for discord. Where ip0 - ipN are the IP-Address of the nodes you want to remove.

And finally to remove all your nodes just use /remove all in telegram or remove all for discord.

To just print all available commands send /help in telegram or help for discord.

Have fun!

If you have any problems or questions feel free to contact me in the SmartCash Discord @dustinface#6318

The source code of the bots is hosted on GitHub https://github.com/xdustinface/SmartNodeMonitorBot