SmartNodeMonitorBot
smartcash·@dustinface·
0.000 HBDSmartNodeMonitorBot
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.
<center></center>
# 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👍 dustinface, msg768, smartbot, primerz, proteus, popcornpopper, cknr7, hedge-x, killbill2018, nitego, semptly, bernsb, swiftpain, bitcoinzeus, hockleyj, putts, steemiest, eithor, neverforg1ve, alexvd, cryptoiskey, bleujay, krustenviech, controllinghand, bluephoenix, zephuros, doc-momo, heavycream, mela65, j12d,