Polkadot, Guide
Validator Monitoring Service User Guide
<p>Welcome to the Validator Monitoring Service User Guide. This comprehensive guide is designed to help you effortlessly set up and navigate through our monitoring service, ensuring you have all the tools and knowledge to monitor your validator's performance effectively. Find our Monitoring tool by using a tg <a href="https://t.me/p2pvalidator_monitoring_bot?ref=p2p.org">bot</a>.</p><h2 id="telegram-bot">Telegram bot</h2><p>The heart of the Validator Monitoring System lies within its Telegram <a href="https://t.me/p2pvalidator_monitoring_bot?ref=p2p.org">bot</a>, your direct line to real-time Grafana dashboard insights and blockchain event alerts for your validator. Its intuitive subscription feature stands out for its ease of customization, allowing you to tailor alerts to your needs.</p><h3 id="getting-started"><strong>Getting Started</strong></h3><p>Upon your first interaction with the Telegram bot, initiate the conversation with a "Start" command or refresh your session with <strong><code>/start</code></strong>. This action will reveal the main interface of the monitoring tool.</p><figure class="kg-card kg-image-card"><img src="https://p2p.org/economy/content/images/2024/03/Screenshot-202024-02-29-20at-2017.46.29.png" class="kg-image" alt loading="lazy" width="880" height="1038" srcset="https://p2p.org/economy/content/images/size/w600/2024/03/Screenshot-202024-02-29-20at-2017.46.29.png 600w, https://p2p.org/economy/content/images/2024/03/Screenshot-202024-02-29-20at-2017.46.29.png 880w" sizes="(min-width: 720px) 720px"></figure><p></p><p>The main interface presents three pivotal options:</p><figure class="kg-card kg-image-card"><img src="https://p2p.org/economy/content/images/2024/03/Screenshot-202024-02-29-20at-2012.03.50.png" class="kg-image" alt loading="lazy" width="892" height="486" srcset="https://p2p.org/economy/content/images/size/w600/2024/03/Screenshot-202024-02-29-20at-2012.03.50.png 600w, https://p2p.org/economy/content/images/2024/03/Screenshot-202024-02-29-20at-2012.03.50.png 892w" sizes="(min-width: 720px) 720px"></figure><p></p><ol><li><strong>Open Grafana</strong>: This button grants immediate access to live Grafana dashboards, enabling you to monitor validator performance across various filters.</li><li><strong>Manage Subscriptions</strong>: This option leads to a menu for subscribing to validator-related events, highlighting the service's flexibility in tracking performance metrics.</li><li><strong>Help</strong>: Users can contact our support team here for service-related queries.</li></ol><h3 id="grafana-dashboard">Grafana dashboard</h3><p>Our service encompasses specialized dashboards for networks like Polkadot/Kusama and Moonbeam/Moonriver, among other parachains, providing a comprehensive view of your validator's activities.</p><div class="kg-card kg-callout-card kg-callout-card-blue"><div class="kg-callout-emoji">💡</div><div class="kg-callout-text">General indicators: we track session/era progression and staking data. Validator data per epoch: we provide information on rewards points, active validators, and their position in the active set.</div></div><p></p><figure class="kg-card kg-image-card"><img src="https://p2p.org/economy/content/images/2024/03/Screenshot-202024-03-19-20at-2012.17.46.png" class="kg-image" alt loading="lazy" width="1476" height="788" srcset="https://p2p.org/economy/content/images/size/w600/2024/03/Screenshot-202024-03-19-20at-2012.17.46.png 600w, https://p2p.org/economy/content/images/size/w1000/2024/03/Screenshot-202024-03-19-20at-2012.17.46.png 1000w, https://p2p.org/economy/content/images/2024/03/Screenshot-202024-03-19-20at-2012.17.46.png 1476w" sizes="(min-width: 720px) 720px"></figure><div class="kg-card kg-callout-card kg-callout-card-blue"><div class="kg-callout-emoji">💡</div><div class="kg-callout-text">Era and epoch points for ParaValidators: We monitor ParaValidator points earned and their relation to the network's average, median, and 95th percentile.</div></div><p></p><figure class="kg-card kg-image-card"><img src="https://p2p.org/economy/content/images/2024/03/Screenshot-202024-03-19-20at-2012.18.06.png" class="kg-image" alt loading="lazy" width="2000" height="1263" srcset="https://p2p.org/economy/content/images/size/w600/2024/03/Screenshot-202024-03-19-20at-2012.18.06.png 600w, https://p2p.org/economy/content/images/size/w1000/2024/03/Screenshot-202024-03-19-20at-2012.18.06.png 1000w, https://p2p.org/economy/content/images/size/w1600/2024/03/Screenshot-202024-03-19-20at-2012.18.06.png 1600w, https://p2p.org/economy/content/images/2024/03/Screenshot-202024-03-19-20at-2012.18.06.png 2000w" sizes="(min-width: 720px) 720px"></figure><div class="kg-card kg-callout-card kg-callout-card-blue"><div class="kg-callout-emoji">💡</div><div class="kg-callout-text">Finality metrics (GRANDPA): We track blocks' prevotes and precommits and their ratio to ideally processed blocks.</div></div><figure class="kg-card kg-image-card"><img src="https://p2p.org/economy/content/images/2024/03/Screenshot-202024-03-19-20at-2012.17.52.png" class="kg-image" alt loading="lazy" width="2000" height="1061" srcset="https://p2p.org/economy/content/images/size/w600/2024/03/Screenshot-202024-03-19-20at-2012.17.52.png 600w, https://p2p.org/economy/content/images/size/w1000/2024/03/Screenshot-202024-03-19-20at-2012.17.52.png 1000w, https://p2p.org/economy/content/images/size/w1600/2024/03/Screenshot-202024-03-19-20at-2012.17.52.png 1600w, https://p2p.org/economy/content/images/size/w2400/2024/03/Screenshot-202024-03-19-20at-2012.17.52.png 2400w" sizes="(min-width: 720px) 720px"></figure><p></p><p>Also, a user can easily switch between the parachains dashboard to track the collators' performance. </p><h3 id="mastering-subscriptions"><strong>Mastering Subscriptions</strong></h3><p>Subscribing to on-chain events is simplified through our customizable alerting templates. Begin by adding accounts to monitor under "My accounts" and proceed to "Add account" for specific tracking.</p><figure class="kg-card kg-image-card kg-width-full"><img src="https://p2p.org/economy/content/images/2024/03/Screenshot-202024-02-29-20at-2012.04.58.png" class="kg-image" alt loading="lazy" width="680" height="1498" srcset="https://p2p.org/economy/content/images/size/w600/2024/03/Screenshot-202024-02-29-20at-2012.04.58.png 600w, https://p2p.org/economy/content/images/2024/03/Screenshot-202024-02-29-20at-2012.04.58.png 680w"></figure><p><br><strong>Add accounts to track</strong></p><p>To subscribe to the alerts, the first thing you need to do is to add accounts that you would like to track. Click "My accounts" and "+ Add account" on the next screen to do it.</p><figure class="kg-card kg-image-card"><img src="https://p2p.org/economy/content/images/2024/03/Screenshot-202024-02-29-20at-2012.05.21.png" class="kg-image" alt loading="lazy" width="888" height="620" srcset="https://p2p.org/economy/content/images/size/w600/2024/03/Screenshot-202024-02-29-20at-2012.05.21.png 600w, https://p2p.org/economy/content/images/2024/03/Screenshot-202024-02-29-20at-2012.05.21.png 888w" sizes="(min-width: 720px) 720px"></figure><p><br>Our service covers Polkadot, Kusama, Acala, Karura, Moonbeam, and Moonriver networks, allowing for the addition of up to 15 accounts. Once your accounts are set, delve into specific alert configurations to fine-tune your monitoring needs. When adding new accounts, you can either search the accounts based on the<strong> </strong>first letters or paste the whole address:</p><hr><figure class="kg-card kg-image-card"><img src="https://p2p.org/economy/content/images/2024/03/Polkadot1.jpg" class="kg-image" alt loading="lazy" width="848" height="1601" srcset="https://p2p.org/economy/content/images/size/w600/2024/03/Polkadot1.jpg 600w, https://p2p.org/economy/content/images/2024/03/Polkadot1.jpg 848w" sizes="(min-width: 720px) 720px"></figure><hr><figure class="kg-card kg-image-card"><img src="https://p2p.org/economy/content/images/2024/03/Polkadot2.jpg" class="kg-image" alt loading="lazy" width="848" height="954" srcset="https://p2p.org/economy/content/images/size/w600/2024/03/Polkadot2.jpg 600w, https://p2p.org/economy/content/images/2024/03/Polkadot2.jpg 848w" sizes="(min-width: 720px) 720px"></figure><p>You can scroll your accounts, adding new ones and deleting old ones. When you are ready, press "Back" and continue configuring specific alerts.</p><hr><p><strong>Configure the alert</strong></p><p>Configuring alerts is straightforward. Choose an alert from the list under "My Subscription" and follow the prompts to tailor the alert parameters to your preferences. The system facilitates the testing of alerts to ensure operability and allows for easy management of active or critical alerts through visual indicators.</p><hr><p>Example of Polkadot Finality pre-commits ratio alert:</p><figure class="kg-card kg-image-card"><img src="https://p2p.org/economy/content/images/2024/03/Polkadot3.jpg" class="kg-image" alt loading="lazy" width="848" height="2112" srcset="https://p2p.org/economy/content/images/size/w600/2024/03/Polkadot3.jpg 600w, https://p2p.org/economy/content/images/2024/03/Polkadot3.jpg 848w" sizes="(min-width: 720px) 720px"></figure><hr><p>Example of Moonbeam blocks production metric:</p><figure class="kg-card kg-image-card"><img src="https://p2p.org/economy/content/images/2024/03/Screenshot-202024-03-19-20at-2015.19.03.png" class="kg-image" alt loading="lazy" width="916" height="612" srcset="https://p2p.org/economy/content/images/size/w600/2024/03/Screenshot-202024-03-19-20at-2015.19.03.png 600w, https://p2p.org/economy/content/images/2024/03/Screenshot-202024-03-19-20at-2015.19.03.png 916w" sizes="(min-width: 720px) 720px"></figure><figure class="kg-card kg-image-card"><img src="https://p2p.org/economy/content/images/2024/03/Screenshot-202024-03-19-20at-2015.19.19.png" class="kg-image" alt loading="lazy" width="932" height="584" srcset="https://p2p.org/economy/content/images/size/w600/2024/03/Screenshot-202024-03-19-20at-2015.19.19.png 600w, https://p2p.org/economy/content/images/2024/03/Screenshot-202024-03-19-20at-2015.19.19.png 932w" sizes="(min-width: 720px) 720px"></figure><p>Test alert example (to check if everything works):</p><figure class="kg-card kg-image-card"><img src="https://p2p.org/economy/content/images/2024/03/Screenshot-202024-02-29-20at-2012.07.50.png" class="kg-image" alt loading="lazy" width="990" height="426" srcset="https://p2p.org/economy/content/images/size/w600/2024/03/Screenshot-202024-02-29-20at-2012.07.50.png 600w, https://p2p.org/economy/content/images/2024/03/Screenshot-202024-02-29-20at-2012.07.50.png 990w" sizes="(min-width: 720px) 720px"></figure><figure class="kg-card kg-image-card"><img src="https://p2p.org/economy/content/images/2024/03/Screenshot-202024-02-29-20at-2012.07.56.png" class="kg-image" alt loading="lazy" width="988" height="430" srcset="https://p2p.org/economy/content/images/size/w600/2024/03/Screenshot-202024-02-29-20at-2012.07.56.png 600w, https://p2p.org/economy/content/images/2024/03/Screenshot-202024-02-29-20at-2012.07.56.png 988w" sizes="(min-width: 720px) 720px"></figure><hr><p>After configuring alerts, on the screen with the alerts list, you may see which alerts are active (green button) or fire emoji (meaning that the threshold is violated). </p><figure class="kg-card kg-image-card"><img src="https://p2p.org/economy/content/images/2024/03/Screenshot-202024-03-19-20at-2015.19.55.png" class="kg-image" alt loading="lazy" width="730" height="664" srcset="https://p2p.org/economy/content/images/size/w600/2024/03/Screenshot-202024-03-19-20at-2015.19.55.png 600w, https://p2p.org/economy/content/images/2024/03/Screenshot-202024-03-19-20at-2015.19.55.png 730w" sizes="(min-width: 720px) 720px"></figure><h3 id="emoji-explanations">Emoji explanations:</h3><p>➕ - Set alert<br>⏳ - Waiting for activation<br>🟢 - Alert is ready<br>⁉️ - Alert added, but activation failed for some reasons (<a href="mailto:[email protected]." rel="noreferrer">Contact US</a>)<br>🔥 - Alert expecting<br>🔥🔥🔥 - FIRE!!! You will receive an alert soon</p><div class="kg-card kg-callout-card kg-callout-card-blue"><div class="kg-callout-emoji">💡</div><div class="kg-callout-text">Also, do not forget to unmute the alert by clicking the “Mute/Unmute” button on the main screen.</div></div><p></p><figure class="kg-card kg-image-card"><img src="https://p2p.org/economy/content/images/2024/03/Screenshot-202024-02-29-20at-2012.09.30.png" class="kg-image" alt loading="lazy" width="722" height="250" srcset="https://p2p.org/economy/content/images/size/w600/2024/03/Screenshot-202024-02-29-20at-2012.09.30.png 600w, https://p2p.org/economy/content/images/2024/03/Screenshot-202024-02-29-20at-2012.09.30.png 722w" sizes="(min-width: 720px) 720px"></figure><h3 id="support"><br>Support</h3><p>The feedback section allows users to share their thoughts or issues with the administration team. Although it's a one-way communication channel, rest assured that necessary follow-ups will be made if required.</p><figure class="kg-card kg-image-card"><img src="https://p2p.org/economy/content/images/2024/03/Polkadot4.jpg" class="kg-image" alt loading="lazy" width="848" height="1202" srcset="https://p2p.org/economy/content/images/size/w600/2024/03/Polkadot4.jpg 600w, https://p2p.org/economy/content/images/2024/03/Polkadot4.jpg 848w" sizes="(min-width: 720px) 720px"></figure><p>We eagerly anticipate your feedback and are excited to help you leverage our Validator Monitoring Tool for optimal performance oversight.</p><h2 id="getting-started-with-your-own-instance"><br><strong>Getting Started with Your Own Instance</strong></h2><p>To provide you with a seamless experience, we have developed a fully self-sufficient, dockerized container for you to run your own instance of the monitoring service. Detailed technical instructions are available in the README section of our GitHub repository. Here’s a brief overview to get you started:</p><ol><li><strong>Install Docker and Docker Compose</strong>: Ensure these are set up on your system to proceed with the installation.</li><li><strong>Configure RPC Endpoints</strong>: Verify and adjust the RPC endpoints in the provided <strong><code>.env</code></strong> files to match your setup (for polkadot, kusama, acala, karura, moonbeam, mooriver).</li><li><strong>Set Up the bot .env File</strong>: Create a Telegram bot through @botfather and set up an admin Telegram group, including all team members. This bot will funnel user queries to the admin group.</li><li><strong>Launch the Service</strong>: Use the following command to start the service for the desired networks: You can extend the service to other networks by adding additional <strong><code>.yml</code></strong> files such as <strong><code>-f acala.yml</code></strong>, <strong><code>-f karura.yml</code></strong>, etc.</li></ol><div class="kg-card kg-callout-card kg-callout-card-grey"><div class="kg-callout-text"><b><strong style="white-space: pre-wrap;">docker-compose</strong></b> -f docker-compose.yml -f polkadot.yml -f kusama.yml up</div></div><p></p><ol start="5"><li><strong>Explore the Telegram Bot:</strong> The bot provides access to your Grafana dashboard and allows you to subscribe to events related to validator performance.</li><li><strong>Access the Grafana Dashboard</strong>: Visit <a href="http://127.0.0.1:3000/?ref=p2p.org">http://127.0.0.1:3000</a> to view your dashboard (default credentials: <strong><code>admin</code></strong> / <strong><code>admin</code></strong>, with a prompt to change on the first login).</li></ol><h1 id="about-p2p-validator"><strong>About P2P Validator</strong></h1><p><a href="https://p2p.org/?ref=p2p.org">P2P Validator</a> is a world-leading non-custodial staking provider, securing over $2 billion by over 10,000 delegators/nominators across 25+ high-class networks. We have been actively participating on the Polkadot network since the beginning.</p><hr><p><em>Do not hesitate to ask questions in our </em><a href="https://t.me/P2Pstaking?ref=p2p.org"><em>Telegram chat</em></a><em> or contact Alex via</em> <a href="mailto:[email protected]">[email protected]</a><em>. We are always open for communication.</em></p><hr><p><strong>Web:</strong> <a href="https://p2p.org/?ref=p2p.org">https://p2p.org</a></p><p><strong>Stake DOT with us:</strong> <a href="https://p2p.org/polkadot?ref=p2p.org">https://p2p.org/polkadot</a></p><p><strong>Twitter:</strong> <a href="https://twitter.com/p2pvalidator?ref=p2p.org">@p2pvalidator</a></p><p><strong>Telegram:</strong> <a href="https://t.me/P2Pstaking?ref=p2p.org">https://t.me/P2Pstaking</a></p>
ALL
Agoric
Aptos
Auth
Avalanche
Axelar
Cardano
Celestia
Chainlink
Cosmos
Crescent
Cyberway
DAOBet
DVT
Dymension
Economy
EigenLayer
Elrond
Ethereum
Evmos
Explain Like I'm Five
Guide
HR
Kava
Kusama
Lido
LSP
Manta
Mantle
Marlin
Matic
Mina
Moonbeam
MultiversX
Near
NuCypher
Oasis
Partnership
Persistence
Pocket
Polkadot
Polygon
Quicksilver
Regen
Renzo
restaking
RPC Node
Serum
Solana
SSV.Network
Staking
Sui
Terra
Tezos
TheGraph
Threshold
Update
Vara
Vega
