> For the complete documentation index, see [llms.txt](https://docs.energyweb.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.energyweb.org/ewc-validator-documentation/guides/maintaining-a-validator-node/validator-node-architecture.md).

# Validator Node Architecture

The System architecture of a validator node on the Energy Web Chain is made up of two main components. (Note: the original node architecture featured a node control component, but it was never used and formally deprecated in 2020).&#x20;

![High-level Validator Node Architecture](https://3053852554-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYWg48ihcKhfciND26AxD%2Fuploads%2Fcpd10AzM9zxhmv4PtCFB%2FScreen%20Shot%202022-02-28%20at%202.25.31%20PM.png?alt=media\&token=c5da212c-3168-40c2-b2be-fefaec9e8145)

&#x20;**Client**: The OpenEthereum or Nethermind client that connects the validator to the Energy Web Chain, collects transactions and proposes blocks according to the [AuRa consensus algorithm](https://openethereum.github.io/Aura.html). Read the documentation of the OpenEthereum client [here](https://openethereum.github.io/), and the Nethermind client [here](https://docs.nethermind.io/nethermind/ethereum-client/download-sources). <br>

**Telemetry**: There is a monitoring system on the validator node that uses Telegraf to securely send telemetry to an [InfluxDB](https://www.influxdata.com/) that is connected to [Grafana](https://grafana.com/) and the EWC Validator Data Warehouse & Dashboard. The use of telemetry is opt-in. Validators can disable it if they have their own monitoring system in place that allows for real time tracking of all relevant metrics.

Telemetry data includes:

* CPU usage of the host machine
* Memory usage of the host machine
* Disk usage of the host machine
* Number of connected peers
* List of visible P2P peers
* Current block (latest block synced by the node)
* Network latency to 3 different and major locations (e.g. cloudflare, google, amazon)
* Network throughput
* Network error rate
* Number of SSH keys for the host machine
* Service status for SSH, docker and the parity container
* SHA256 hashes of key system components/binaries
* Current chain specification file (or hash)

As this is sensitive data, we rely on well established industry solutions to transfer these metrics off the validator node. Telegraf is a server agent that plugs into many different services to collect data. Telegraf collects relevant metrics from the host machine and the custom-built parity metrics collector which allows Telegraf to receive the metrics from the parity client. For more information on Telegraf visit: <https://docs.influxdata.com/telegraf/v1.10/>

The collected metrics are then stored in an InfluxDB database and can be visualized using the monitoring tool Grafana. For more information on influxDB visit: <https://docs.influxdata.com/influxdb/v1.7/>

For more information on Grafana visit: <https://grafana.com/docs/>

The use of telemetry is opt-in. Validators can disable it if they have their own monitoring system in place that allows for real time tracking of all relevant metrics.<br>

All components are run in separate docker containers managed by docker compose. For additional information on docker visit: <https://docs.docker.com/> and <https://docs.docker.com/compose/>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.energyweb.org/ewc-validator-documentation/guides/maintaining-a-validator-node/validator-node-architecture.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
