Free node telemetry service

Node telemetry

Algorand Algod node has built in telemetry mechanism that sends important events, errors and metrics to a chosen telemetry service.
By default telemetry sending is disabled. Once enabled telemetry is sent to Algorand Technologies operated service and used for network diagnostics.

Note

This page describes Nodely hosted telemetry service. You need extra settings for the node to send events to our infrastructure.

Nodely Telemetry highlights

• Key metrics :
  • Health (overall score based on other metrics)
  • Voting performance
  • Network performance
  • Synchronization issues
• Telemetry events
  • HeartBeats with internal metrics
  • Warnings and Errors
• Leader boards

Individual telemetry

Caution

• Temporary dashboard is a WORK IN PROGRESS
• You have to input your node’s GUID manually in the “Node GUID field” and press enter
• Check out release notes for latest updates and upcoming stuff

Global telemetry

You can compare your node to others on the global dashboard https://g.nodely.io/d/telemetrymain

Quick Setup

OG install

Below instruction will work only on default node install via package manager or updater scrips.

If your Linux/Mac node is installed with package manger or updater script just execute the following commands to make you node start sending telemetry to the service.

  # set telemetry endpoint to Nodely
  sudo diagcfg -d /var/lib/algorand telemetry endpoint -e https://tel.4160.nodely.io

  # anonymize node name in telemery (do not leak hostname)
  sudo diagcfg -d /var/lib/algorand telemetry name -n "anon"

  # Or you can make your name public by prefixing it with @
  # sudo diagcfg -d /var/lib/algorand telemetry name -n "@MyPublicNodeName"

  # enable telemetry
  sudo diagcfg -d /var/lib/algorand telemetry enable

  # restart your nodes
  sudo systemctl restart algorand

You might need to provide -d folder parameter where folder is the location of your node’s data folder.

• Note the random node id (GUID) returned by the first command
• Restart you node for settings to take effect.
• Go to the temporary dashboard and enter your node’s GUID to check out the stats
• You can also visit https://g.nodely.io/d/telemetry/?var-GUID=$nodeid (replacing $nodeid with your GUID) to go to your node’s stats directly.

Note

◯🔴🔴🔴 lights mean your node is not configured properly for sending telemetry but otherwise might be working properly.

Func node

• Please wait for official Nodely telemetry support or ask on #node-runners Discord channel.

A1CN

• Please wait for official Nodely telemetry support or as on #node-runners Discord channel.

Algorun-tui

• Use the install instructions specific to your node.
  TUI only manages participation keys for now.

Docker(compose) install

• Create telemetry config as above
• Make sure logging.config file is mounted in the node’s data dir

Target audience

Telemetry service is designed for any kind of Algorand mainnet node.

• Validator nodes
• API nodes
• P2P Nodes and Relays

Caution

Do not use the service for Relay/Archiver Running Programme (legacy relays)

Data collected

• Node geolocation down to country level
• Node version and 10 minute metrics snapshots
• Telemetry logs including validator’s public address
• Nodely reserves the rights to prune data of nodes inactive for over a week

GDRP / Privacy

• Nodely Telemetry service does not collect PI data.
• Collected dataset is available publicly in context of node’s random unique identifier
• Node’s UUID can be reset at any time by node operator

Pricing

• Node performance data collection and charting is a free, public service.
• API access is part of the Nodely Analytics tier only.