8.1 Software Preparation
Node monitoring ensures that operators can solve issues ahead of time, maintain uptime, and optimize performance by providing real-time insight into system health, client status, and network usage. This page will walk you through the software installs and configurations needed to get your monitoring environment up and running. All the monitoring tooling, regardless of the client configurations, generally follows a modular approach of software modules.
| Step | Name | Description |
|---|---|---|
| 1 | Install Core Tools & Port Configuration | Install required packages and expose monitoring ports. |
| 2 | Create Exporter Services | Export metrics like system, consensus, and execution data. |
| 3 | Setup Prometheus | Scrape and process metrics from exporter services. |
| 4 | Configure Grafana | Visualizing metrics and creating dashboards. |
| 5 | Configure Dashboard | Load dashboards and configure alerts. |
Further details about node analytics can be found on the Monitoring Tools page in the 🧠 Theory section.
As the table suggests, exporter services and clients should be set up before configuring Prometheus or Grafana, so all data sources are set in place. Setting up the underlaying software first has the following benefits:
- Problem Encapsulation: By installing exporters beforehand, you can verify that the metrics are accessible and correctly exposed. Separated installation helps troubleshoot potential issues with the exporters or the services themselves.
- No Idle Rotation Problems: With the exporters already installed and configured, Prometheus can immediately start scraping the endpoints and collecting metrics. Having data endpoints running ensures that you have data available for monitoring as soon as Prometheus is up, excluding errors where configurations need to be reloaded and updated.
- 👾 LUKSO CLI
- 🎨 DAppNode
- 🐳 Docker
The LUKSO CLI does not restrict the use of additional tools and monitoring solutions, but it also doesn’t include any monitoring tools out of the box. That means the setup must be done manually and will dock onto the already running clients. The following six tools are essential to install before setting up Prometheus, Grafana, and the required Exporters:
| Tool | Description |
|---|---|
| Utility for downloading files to fetch resources directly from the terminal. | |
| Automation tool used to compile software, required for compiling some exporter tools. | |
| Version control system used to clone repositories for exporter services. | |
| Allows to securely download packages over HTTPS, required for third-party software. | |
Provides useful tools like add-apt-repository to manage software sources. | |
| Standard for secure encryption and signing, required for verifying package signatures. |
The following step is performed on your 📟 node server.
sudo apt install wget make git apt-transport-https software-properties-common gnupg2
DAppNode provides an integrated monitoring solution called DAppNode Monitoring Service. The software solution includes all necessary tools such as node exporters, Prometheus, and Grafana out of the box. The dashboards come pre-configured, and services are automatically hooked into the DAppNode-managed blockchain clients without custom installation.
The LUKSO team provides a separate Docker Monitoring Setup, designed to work alongside their default Docker repositories for node operators. The configuration includes all necessary exporter services, Prometheus, and Grafana within one single container.