Configure Ethereum Clients
Configuration consensus and execution clients to serve metrics and API data
Each consensus and execution client must have the appropriate metrics services and APIs enabled and accessible to the supporting software. Find your clients below and ensure that the required command-line flags/configuration values are present in your startup scripts, configuration files, or service files.
Consensus Clients
In addition to other command-line flags, the following Lighthouse flags may be required to support the dashboard.
Required
--metrics- Enables the Prometheus metrics service
Optional
--metrics-address 0.0.0.0- Authorizes Lighthouse to answer metrics requests from other IP addresses. This is only required if you want to run Prometheus on a separate system
If you would like other IP addresses to have access to Lighthouse's metrics, do not expose Lighthouse's metrics port to the Internet. Keep the metrics port closed at your router.
In addition to other command-line flags, the following flags are required to support the dashboard.
Required
--metrics true- Enables the Prometheus metrics service--rest- Enables the HTTP API
Optional
--metrics.address 0.0.0.0- Authorizes Lodestar to answer metrics requests from other IP addresses. Only required if you want to run Prometheus on a separate system--rest.address '0.0.0.0'- Authorizes Lodestar to answer HTTP API requests from other IP addresses. Only required if you want to run Prometheus on a separate system
If you would like other IP addresses to have access to Lodestar's metrics, do not expose Lodestar's port to the Internet. Keep the metrics port closed at your router.
In addition to other command-line flags, the following Nimbus flags may be required to support the dashboard.
Required
--metrics- Enables the Prometheus metrics service--rest- Enables the REST API
Optional
--metrics-address 0.0.0.0- Authorizes Lighthouse to answer metrics requests from other IP addresses. Only required if you want to run Prometheus on a separate system.--rest-address 0.0.0.0- Authorizes Lighthouse to answer API requests from other IP addresses. Only required if you want to run Prometheus on a separate system.
If you would like other IP addresses to have access to Nimbus' metrics, do not expose Nimbus' port to the Internet. Keep the metrics port closed at your router.
In addition to other command-line flags, the following flags are required to support the dashboard.
Required
--monitoring-host 0.0.0.0- Authorizes Lighthouse to answer metrics requests from other IP addresses. Only required if you want to run Prometheus on a separate system.
Optional
--grpc-gateway-host '0.0.0.0'- Authorizes Prysm to answer API requests from other IP addresses. Only required if you want to run Ethereum Metrics Exporter or json_exporter on systems separate from Prysm.
If you would like other IP addresses to have access to Prysm's metrics, do not expose Prysm's port to the Internet. Keep the metrics port closed at your router
In addition to other command-line flags, the following Teku flags may be required to support the dashboard.
Required
--metrics-enabled- Enables the Prometheus metrics service--rest-api-enabled- Enables the REST API--metrics-categories=JVM,PROCESS,BEACON,DISCOVERY,EVENTBUS,EXECUTOR,LIBP2P,NETWORK,STORAGE,STORAGE_HOT_DB,STORAGE_FINALIZED_DB,REMOTE_VALIDATOR,VALIDATOR,VALIDATOR_PERFORMANCE- Turns on all metrics
Optional
--metrics-interface 0.0.0.0- Authorizes Teku to answer metrics requests from other IP addresses. Only required if you want to run Prometheus on a separate system.--rest-api-interface 0.0.0.0- Authorizes Teku to answer API requests from other IP addresses. Only required if you want to run Prometheus on a separate system.--rest-api-host-allowlist 0.0.0.0- Authorizes Teku to answer API requests from other IP addresses. Only required if you want to run Prometheus on a separate system.--metrics-host-allowlist 0.0.0.0- Authorizes Teku to answer metrics requests from other IP addresses. Only required if you want to run Prometheus on a separate system.
If you would like other IP addresses to have access to Teku's metrics, do not expose Teku's port to the Internet. Keep the metrics port closed at your router
Execution Clients
In addition to other command-line flags, the following Besu flags may be required to support the dashboard.
Required
--metrics-enabled- Enables the Prometheus metrics service--rpc-http-enabled- Enables the HTTP API--rpc-http-api=ETH,NET,WEB3,TXPOOL- These API namespaces are required, in addition to any others you already use.--metrics-protocol=PROMETHEUS- Configures Besu to return metrics in Prometheus format--metrics-category=BLOCKCHAIN,ETHEREUM,EXECUTORS,NETWORK,PEERS,PERMISSIONING,PRUNER,RPC,SYNCHRONIZER,TRANSACTION_POOL,STRATUM,JVM,PROCESS- Turns on all metrics
Optional
--metrics-host=0.0.0.0- Authorizes Besu to answer metrics requests from other IP addresses. Only required if you want to run Prometheus on a separate system.--rpc-http-host=0.0.0.0- Authorizes Besu to answer API requests from other IP addresses. Only required if you want to run Prometheus on a separate system.--host-allowlist="*"- TBD
If you would like other IP addresses to have access to Besu's metrics, do not expose Besu's port to the Internet. Keep the metrics port closed at your router.
In addition to other command-line flags, the following Erigon flags may be required to support the dashboard.
Required
--metrics- Enables the Prometheus metrics service--http- Enables the HTTP API--http.api=eth,net,txpool,web3- These API namespaces are required, in addition to any others you already use.--private.api.addr=0.0.0.0:9091- Required to change the private API port to from its default of 9090 to 9091. It conflicts with Prometheus' use of port 9090.
Optional
--metrics.addr 0.0.0.0- Authorizes Erigon to answer metrics requests from other IP addresses. Only required if you want to run Prometheus on a separate system.--http.addr 0.0.0.0- Authorizes Erigon to answer API requests from other IP addresses. Only required if you want to run Prometheus on a separate system.
If you would like other IP addresses to have access to Erigon's metrics, do not expose Erigon's port to the Internet. Keep the metrics port closed at your router.
In addition to other command-line flags, the following Geth flags may be required to support the dashboard.
Required
--metrics- Enables the Prometheus metrics service--http- Enables the HTTP API--http.api net,web3,eth,txpool- These API namespaces are required, in addition to any others you already use.
Optional
--metrics.addr=0.0.0.0- Authorizes Geth to answer metrics requests from other IP addresses. Only required if you want to run Prometheus on a separate system.--http.addr=0.0.0.0- Authorizes Geth to answer API requests from other IP addresses. Only required if you want to run Prometheus on a separate system.
If you would like other IP addresses to have access to Geth's metrics, do not expose Geth's port to the Internet. Keep the metrics port closed at your router.
In addition to other command-line flags, the following Nethermind flags may be required to support the dashboard.
Required
--Metrics.Enabled true- Enables the Prometheus metrics service--Metrics.ExposePort 8080- Required to open the metrics port
Optional
--JsonRpc.Host 0.0.0.0- Authorizes Nethermind to answer API requests from other IP addresses. Only required if you want to run Prometheus on a separate system.
If you would like other IP addresses to have access to Nethermind's metrics, do not expose Nethermind's port to the Internet. Keep the metrics port closed at your router.
Restart all clients for which the configuration changed. Refer to the guides you originally used to set up your clients for help determining how to restart the clients and whether any configuration changes have taken effect.
Last updated