op-reth configuration options

This page provides detailed documentation for all available op-reth configuration options, organized by functionality. The following options are from v1.10.1

​

General Options

options for configuring the node instance and chain.

​

config

The path to the configuration file to use.

​

chain

The chain this node is running. Possible values are either a built-in chain or the path to a chain specification file. Built-in chains: optimism, optimism_sepolia, base, base_sepolia, dev, etc.

​

instance

Add a new instance of a node. Configures the ports of the node to avoid conflicts with the defaults.

​

with-unused-ports

Sets all ports to unused, allowing the OS to choose random unused ports when sockets are bound. Mutually exclusive with --instance.

​

Metrics

Options for Prometheus metrics.

​

metrics

Enable Prometheus metrics. The metrics will be served at the given interface and port.

​

metrics.prometheus.push.url

URL for pushing Prometheus metrics to a push gateway.

​

metrics.prometheus.push.interval

Interval in seconds for pushing metrics to push gateway.

​

Datadir

Options for data storage.

​

datadir

The path to the data dir for all reth files and subdirectories. Defaults to the OS-specific data directory:

• Linux: $XDG_DATA_HOME/reth/ or $HOME/.local/share/reth/
• Windows: {FOLDERID_RoamingAppData}/reth/
• macOS: $HOME/Library/Application Support/reth/

​

datadir.static-files

The absolute path to store static files in.

​

datadir.rocksdb

The absolute path to store RocksDB database in.

​

datadir.pprof-dumps

The absolute path to store pprof dumps in.

​

Networking

Options for P2P networking and discovery.

​

disable-discovery

Disable the discovery service.

​

disable-dns-discovery

Disable the DNS discovery.

​

disable-discv4-discovery

Disable Discv4 discovery.

​

enable-discv5-discovery

Enable Discv5 discovery.

​

disable-nat

Disable NAT discovery.

​

discovery.addr

The UDP address to use for devp2p peer discovery version 4.

​

discovery.port

The UDP port to use for devp2p peer discovery version 4.

​

discovery.v5.addr

The UDP IPv4 address to use for devp2p peer discovery version 5.

​

discovery.v5.addr.ipv6

The UDP IPv6 address to use for devp2p peer discovery version 5.

​

discovery.v5.port

The UDP IPv4 port to use for devp2p peer discovery version 5.

​

discovery.v5.port.ipv6

The UDP IPv6 port to use for devp2p peer discovery version 5.

​

discovery.v5.lookup-interval

The interval in seconds at which to carry out periodic lookup queries, for the whole run of the program

​

discovery.v5.bootstrap.lookup-interval

The interval in seconds at which to carry out boost lookup queries, for a fixed number of times, at bootstrap

​

discovery.v5.bootstrap.lookup-countdown

The number of times to carry out boost lookup queries at bootstrap

​

trusted-peers

Comma separated enode URLs of trusted peers for P2P connections.

​

trusted-only

Connect to or accept from trusted peers only.

​

bootnodes

Comma separated enode URLs for P2P discovery bootstrap.

​

dns-retries

Amount of DNS resolution requests retries to perform when peering

​

peers-file

The path to the known peers file. Connected peers are dumped to this file on nodes shutdown, and read on startup. Cannot be used with --no-persist-peers.

​

identity

Custom node identity.

​

p2p-secret-key

Secret key to use for this node.

​

p2p-secret-key-hex

Hex encoded secret key to use for this node. This will also deterministically set the peer ID. Cannot be used together with --p2p-secret-key.

​

no-persist-peers

Do not persist peers.

​

nat

NAT resolution method (any|none|upnp|publicip|extip:<IP>)

​

addr

Network listening address.

​

port

Network listening port.

​

max-outbound-peers

Maximum number of outbound peers.

​

max-inbound-peers

Maximum number of inbound peers. default: 30

​

max-peers

Maximum number of total peers (inbound + outbound).

​

max-tx-reqs

Max concurrent GetPooledTransactions requests.

​

max-tx-reqs-peer

Max concurrent GetPooledTransactions requests per peer.

​

max-seen-tx-history

Max number of seen transactions to remember per peer.

​

max-pending-imports

Max number of transactions to import concurrently.

​

pooled-tx-response-soft-limit

Experimental, for usage in research. Sets the max accumulated byte size of transactions to pack in one response.

​

pooled-tx-pack-soft-limit

Experimental, for usage in research. Sets the max accumulated byte size of transactions to request in one request.

​

max-tx-pending-fetch

Max capacity of cache of hashes for transactions pending fetch.

​

net-if.experimental

Name of network interface used to communicate with peers.

​

tx-propagation-policy

Transaction Propagation Policy The policy determines which peers transactions are gossiped to.

​

tx-ingress-policy

Transaction ingress policy Determines which peers’ transactions are accepted over P2P.

​

disable-tx-gossip

Disable transaction pool gossip.

​

tx-propagation-mode

Sets the transaction propagation mode by determining how new pending transactions are propagated to other peers in full.

​

required-block-hashes

Comma separated list of required block hashes or block number=hash pairs. Peers that don’t have these blocks will be filtered out.

​

network-id

Optional network ID to override the chain specification’s network ID for P2P connections.

​

netrestrict

Restrict network communication to the given IP networks (CIDR masks). Comma separated list of CIDR network specifications. Only peers with IP addresses within these ranges will be allowed to connect.

​

RPC

Options for HTTP, WebSocket, and IPC RPC servers.

​

http

Enable the HTTP-RPC server.

​

http.addr

Http server address to listen on.

​

http.port

Http server port to listen on.

​

http.disable-compression

Disable compression for HTTP responses

​

http.api

Rpc Modules to be configured for the HTTP server.

​

http.corsdomain

Http Corsdomain to allow request from.

​

ws

Enable the WS-RPC server.

​

ws.addr

Ws server address to listen on.

​

ws.port

Ws server port to listen on.

​

ws.origins

Origins from which to accept WebSocket requests

​

ws.api

Rpc Modules to be configured for the WS server.

​

ipcdisable

Disable the IPC-RPC server

​

ipcpath

Filename for IPC socket/pipe within the datadir

​

ipc.permissions

Set the permissions for the IPC socket file, in octal format. If not specified, the permissions will be set by the system’s umask.

​

authrpc.addr

Auth server address to listen on.

​

authrpc.port

Auth server port to listen on.

​

authrpc.jwtsecret

Path to a JWT secret to use for the authenticated engine-API RPC server.

​

auth-ipc

Enable auth engine API over IPC.

​

auth-ipc.path

Filename for auth IPC socket/pipe within the datadir.

​

disable-auth-server

Disable the auth/engine API server. This will prevent the authenticated engine-API server from starting. Use this if you’re running a node that doesn’t need to serve engine API requests.

​

rpc.jwtsecret

Hex encoded JWT secret to authenticate the regular RPC server(s), see —http.api and —ws.api. This is not used for the authenticated engine-API RPC server (see —authrpc.jwtsecret).

​

rpc.max-request-size

Set the maximum RPC request payload size for both HTTP and WS in megabytes.

​

rpc.max-response-size

Set the maximum RPC response payload size for both HTTP and WS in megabytes. Alias: --rpc.returndata.limit

​

rpc.max-subscriptions-per-connection

Set the maximum concurrent subscriptions per connection.

​

rpc.max-connections

Maximum number of RPC server connections.

​

rpc.max-tracing-requests

Maximum number of concurrent tracing requests. By default this chooses a sensible value based on the number of available cores. Tracing requests are generally CPU bound. Choosing a value that is higher than the available CPU cores can have a negative impact on the performance of the node and affect the node’s ability to maintain sync.

​

rpc.max-blocking-io-requests

Maximum number of concurrent blocking IO requests. Blocking IO requests include eth_call, eth_estimateGas, and similar methods that require EVM execution. These are spawned as blocking tasks to avoid blocking the async runtime.

​

rpc.max-trace-filter-blocks

Maximum number of blocks for trace_filter requests.

​

rpc.max-blocks-per-filter

Maximum number of blocks that could be scanned per filter request. (0 = entire chain)

​

rpc.max-logs-per-response

Maximum number of logs that can be returned in a single response. (0 = no limit)

​

rpc.gascap

Maximum gas limit for eth_call and call tracing RPC methods.

​

rpc.evm-memory-limit

Maximum memory the EVM can allocate per RPC request.

​

rpc.txfeecap

Maximum eth transaction fee (in ether) that can be sent via the RPC APIs (0 = no cap).

​

rpc.max-simulate-blocks

Maximum number of blocks for eth_simulateV1 call.

​

rpc.eth-proof-window

The maximum proof window for historical proof generation. This value allows for generating historical proofs up to configured number of blocks from current tip (up to tip - window).

​

rpc.proof-permits

Maximum number of concurrent getproof requests.

​

rpc.pending-block

Configures the pending block behavior for RPC responses. Options: full (include all transactions), empty (header only), none (disable pending blocks).

​

rpc.forwarder

Endpoint to forward transactions to.

​

Builder

Options for the payload builder.

​

builder.disallow

Path to file containing disallowed addresses, json-encoded list of strings. Block validation API will reject blocks containing transactions from these addresses.

​

builder.extradata

Block extra data set by the payload builder.

​

builder.gaslimit

Target gas limit for built blocks.

​

builder.interval

The interval at which the job should build a new payload after the last. Interval is specified in seconds or in milliseconds if the value ends with ms.

​

builder.deadline

The deadline for when the payload builder job should resolve.

​

builder.max-tasks

Maximum number of tasks to spawn for building a payload.

​

builder.max-blobs

Maximum number of blobs to include per block.

​

RPC State Cache

Options for the RPC state cache.

​

rpc-cache.max-blocks

Max number of blocks in cache.

​

rpc-cache.max-receipts

Max number receipts in cache.

​

rpc-cache.max-headers

Max number of headers in cache.

​

rpc-cache.max-concurrent-db-requests

Max number of concurrent database requests.

​

Gas Price Oracle

Options for the Gas Price Oracle.

​

gpo.blocks

Number of recent blocks to check for gas price.

​

gpo.ignoreprice

Gas Price below which gpo will ignore transactions.

​

gpo.maxprice

Maximum transaction priority fee (or gasprice before London Fork) to be recommended by gpo.

​

gpo.percentile

The percentile of gas prices to use for the estimate.

​

gpo.default-suggested-fee

The default gas price to use if there are no blocks to use for estimation.

​

rpc.send-raw-transaction-sync-timeout

Timeout for the send_raw_transaction_sync RPC method.

​

testing.skip-invalid-transactions

Skip invalid transactions in testing_buildBlockV1 instead of failing. When enabled, transactions that fail execution will be skipped, and all subsequent transactions from the same sender will also be skipped.

​

TxPool

Options for the Transaction Pool.

​

txpool.pending-max-count

Max number of transaction in the pending sub-pool.

​

txpool.pending-max-size

Max size of the pending sub-pool in megabytes.

​

txpool.basefee-max-count

Max number of transaction in the basefee sub-pool.

​

txpool.basefee-max-size

Max size of the basefee sub-pool in megabytes. Max number of transaction in the basefee sub-pool.

​

txpool.queued-max-count

Max number of transaction in the queued sub-pool.

​

txpool.queued-max-size

Max size of the queued sub-pool in megabytes.

​

txpool.blobpool-max-count

Max number of transactions in the blobpool.

​

txpool.blobpool-max-size

Max size of the blobpool in megabytes.

​

txpool.blob-cache-size

Max number of entries for the in-memory cache of the blob store.

​

txpool.disable-blobs-support

Disable EIP-4844 blob transaction support.

​

txpool.max-account-slots

Max number of executable transaction slots guaranteed per account.

​

txpool.pricebump

Price bump (in %) for the transaction pool underpriced check.

​

txpool.minimal-protocol-fee

Minimum base fee required by the protocol.

​

txpool.minimum-priority-fee

Minimum priority fee required for transaction acceptance into the pool. Transactions with a priority fee below this value will be rejected.

​

txpool.gas-limit

The default enforced gas limit for transactions entering the pool.

​

txpool.max-tx-gas

Maximum gas limit for individual transactions. Transactions exceeding this limit will be rejected.

​

blobpool.pricebump

Price bump percentage to replace an already existing blob transaction.

​

txpool.max-tx-input-bytes

Max size in bytes of a single transaction allowed to enter the pool.

​

txpool.max-cached-entries

The maximum number of blobs to keep in the in-memory blob cache.

​

txpool.nolocals

Flag to disable local transaction exemptions.

​

txpool.locals

Flag to allow certain addresses as local.

​

txpool.no-local-transactions-propagation

Flag to toggle local transaction propagation.

​

txpool.additional-validation-tasks

Number of additional transaction validation tasks to spawn.

​

txpool.max-pending-txns

Maximum number of pending transactions from the network to buffer.

​

txpool.max-new-txns

Maximum number of new transactions to buffer.

​

txpool.max-new-pending-txs-notifications

How many new pending transactions to buffer and send to in-progress pending transaction iterators.

​

txpool.lifetime

Maximum amount of time (in seconds) non-executable transactions are queued.

​

txpool.transactions-backup

Path to store the local transaction backup at, to survive node restarts.

​

txpool.disable-transactions-backup

Disables transaction backup to disk on node shutdown.

​

txpool.max-batch-size

Max batch size for transaction pool insertions.

​

Debug

Options for debugging.

​

debug.terminate

Flag indicating whether the node should be terminated after the pipeline sync.

​

debug.tip

Set the chain tip manually for testing purposes. NOTE: This is a temporary flag.

​

debug.max-block

Runs the sync only up to the specified block.

​

debug.etherscan

Runs a fake consensus client that advances the chain using recent block hashes on Etherscan. If specified, requires an ETHERSCAN_API_KEY environment variable.

​

debug.rpc-consensus-url

Runs a fake consensus client using blocks fetched from an RPC endpoint. Supports both HTTP and WebSocket endpoints.

​

debug.skip-fcu

If provided, the engine will skip n consecutive FCUs.

​

debug.skip-new-payload

If provided, the engine will skip n consecutive new payloads.

​

debug.reorg-frequency

If provided, the chain will be reorged at specified frequency.

​

debug.reorg-depth

The reorg depth for chain reorgs.

​

debug.engine-api-store

The path to store engine API messages at. If specified, all of the intercepted engine API messages will be written to specified location.

​

debug.invalid-block-hook

Determines which type of invalid block hook to install. Possible values: witness, pre-state, opcode.

​

debug.healthy-node-rpc-url

The RPC URL of a healthy node to use for comparing invalid block hook results against.

​

ethstats

The URL of the ethstats server to connect to. Example: nodename:secret@host:port.

​

debug.startup-sync-state-idle

Set the node to idle state when the backfill is not running. This makes the eth_syncing RPC return “Idle” when the node has just started or finished the backfill, but did not yet receive any new blocks.

​

Database

Options for the database.

​

db.log-level

Database logging level. Levels higher than “notice” require a debug build. Possible values: fatal, error, warn, notice, verbose, debug, trace, extra.

​

db.exclusive

Open environment in exclusive/monopolistic mode. Makes it possible to open a database on an NFS volume.

​

db.max-size

Maximum database size (e.g., 4TB, 8TB). This sets the “map size” of the database. If the database grows beyond this limit, the node will stop with an “environment map size limit reached” error.

​

db.page-size

Database page size (e.g., 4KB, 8KB, 16KB). Specifies the page size used by the MDBX database. The page size determines the maximum database size. MDBX supports up to 2^31 pages, so with the default 4KB page size, the maximum database size is 8TB. To allow larger databases, increase this value to 8KB or higher. WARNING: This setting is only configurable at database creation; changing it later requires re-syncing.

​

db.growth-step

Database growth step (e.g., 4GB, 4KB).

​

db.read-transaction-timeout

Read transaction timeout in seconds, 0 means no timeout.

​

db.max-readers

Maximum number of readers allowed to access the database concurrently.

​

db.sync-mode

Controls how aggressively the database synchronizes data to disk.

​

Dev testnet

Options for running a local development testnet.

​

dev

Start the node in dev mode. This mode uses a local proof-of-authority consensus engine with either fixed block times or automatically mined blocks. Disables network discovery and enables local http server. Prefunds 20 accounts derived by mnemonic “test test test test test test test test test test test junk” with 10 000 ETH each.

​

dev.block-max-transactions

How many transactions to mine per block.

​

dev.block-time

Interval between blocks. Parses strings using humantime::parse_duration. Example: --dev.block-time 12s

​

dev.mnemonic

Derive dev accounts from a fixed mnemonic instead of random ones.

​

Pruning

Options for data pruning.

​

full

Run full node. Only the most recent MINIMUM_PRUNING_DISTANCE block states are stored.

​

minimal

Run minimal storage mode with maximum pruning and smaller static files. This mode configures the node to use minimal disk space by:

• Fully pruning sender recovery, transaction lookup, receipts
• Leaving 10,064 blocks for account, storage history and block bodies
• Using 10,000 blocks per static file segment

​

prune.block-interval

Minimum pruning interval measured in blocks.

​

prune.sender-recovery.full

Prunes all sender recovery data.

​

prune.sender-recovery.distance

Prune sender recovery data before the head-N block number. In other words, keep the last $N + 1$ blocks.

​

prune.sender-recovery.before

Prune sender recovery data before the specified block number. The specified block number is not pruned.

​

prune.transaction-lookup.full

Prunes all transaction lookup data.

​

prune.transaction-lookup.distance

Prune transaction lookup data before the head-N block number. In other words, keep the last $N + 1$ blocks.

​

prune.transaction-lookup.before

Prune transaction lookup data before the specified block number. The specified block number is not pruned.

​

prune.receipts.full

Prunes all receipt data.

​

prune.receipts.pre-merge

Prune receipts before the merge block.

​

prune.receipts.distance

Prune receipts before the head-N block number. In other words, keep the last $N + 1$ blocks.

​

prune.receipts.before

Prune receipts before the specified block number. The specified block number is not pruned.

​

prune.receiptslogfilter

Configure receipts log filter. Format: <address>:<prune_mode>... where <prune_mode> can be full, distance:<blocks>, or before:<block_number>.

​

prune.account-history.full

Prunes all account history.

​

prune.account-history.distance

Prune account history before the head-N block number. In other words, keep the last $N + 1$ blocks.

​

prune.account-history.before

Prune account history before the specified block number. The specified block number is not pruned.

​

prune.storage-history.full

Prunes all storage history data.

​

prune.storage-history.distance

Prune storage history before the head-N block number. In other words, keep the last $N + 1$ blocks.

​

prune.storage-history.before

Prune storage history before the specified block number. The specified block number is not pruned.

​

prune.bodies.pre-merge

Prune bodies before the merge block.

​

prune.bodies.distance

Prune bodies before the head-N block number. In other words, keep the last $N + 1$ blocks.

​

prune.bodies.before

Prune body history before the specified block number. The specified block number is not pruned.

​

Engine

Engine API options.

​

engine.persistence-threshold

Configure persistence threshold for the engine. This determines how many canonical blocks must be in-memory, ahead of the last persisted block, before flushing canonical blocks to disk again. To persist blocks as fast as the node receives them, set this value to zero. This will cause more frequent DB writes.

​

engine.memory-block-buffer-target

Configure the target number of blocks to keep in memory.

​

engine.legacy-state-root

Enable legacy state root calculation.

​

engine.disable-state-cache

Disable the state cache.

​

engine.disable-prewarming

Disable parallel prewarming of the state.

​

engine.disable-parallel-sparse-trie

Disable the parallel sparse trie in the engine.

​

engine.state-provider-metrics

Enable state provider latency metrics. This allows the engine to collect and report stats about how long state provider calls took during execution, but introduces slight overhead.

​

engine.cross-block-cache-size

Configure the size of the cross-block cache in megabytes.

​

engine.state-root-task-compare-updates

Enable comparing trie updates from the state root task to the trie updates from the regular state root calculation.

​

engine.accept-execution-requests-hash

Enables accepting a requests hash instead of an array of requests in engine_newPayloadV4.

​

engine.multiproof-chunking

Whether the multiproof task should chunk proof targets.

​

engine.multiproof-chunk-size

Multiproof task chunk size for proof targets.

​

engine.reserved-cpu-cores

Configure the number of reserved CPU cores for non-reth processes.

​

engine.disable-precompile-cache

Disable the precompile cache.

​

engine.state-root-fallback

Enable state root fallback. Primarily used for testing purposes.

​

engine.always-process-payload-attributes-on-canonical-head

Always process payload attributes and begin a payload build process even if forkchoiceState.headBlockHash is already the canonical head or an ancestor. See TreeConfig::always_process_payload_attributes_on_canonical_head for more details. Note: This is a no-op on OP Stack.

​

engine.allow-unwind-canonical-header

Allow unwinding canonical header to ancestor during forkchoice updates. See TreeConfig::unwind_canonical_header for more details.

​

engine.storage-worker-count

Configure the number of storage proof workers in the Tokio blocking pool. If not specified, defaults to 2x available parallelism, clamped between 2 and 64.

​

engine.account-worker-count

Configure the number of account proof workers in the Tokio blocking pool. If not specified, defaults to the same count as storage workers.

​

engine.enable-proof-v2

Enable V2 storage proofs for state root calculations.

​

ERA

Options for ERA1 file import.

​

era.enable

Enable import from ERA1 files.

​

era.path

The path to a directory for import. The ERA1 files are read from the local directory parsing headers and bodies.

​

era.url

The URL to a remote host where the ERA1 files are hosted. The ERA1 files are read from the remote host using HTTP GET requests parsing headers and bodies.

​

Static Files

Options for static file storage configuration.

​

static-files.blocks-per-file.headers

Number of blocks per file for the headers segment.

​

static-files.blocks-per-file.transactions

Number of blocks per file for the transactions segment.

​

static-files.blocks-per-file.receipts

Number of blocks per file for the receipts segment.

​

static-files.blocks-per-file.transaction-senders

Number of blocks per file for the transaction senders segment.

​

static-files.blocks-per-file.account-change-sets

Number of blocks per file for the account changesets segment.

​

static-files.receipts

Store receipts in static files instead of the database. When enabled, receipts will be written to static files on disk instead of the database. Note: This setting can only be configured at genesis initialization. Once the node has been initialized, changing this flag requires re-syncing from scratch.

​

static-files.transaction-senders

Store transaction senders in static files instead of the database. When enabled, transaction senders will be written to static files on disk instead of the database. Note: This setting can only be configured at genesis initialization. Once the node has been initialized, changing this flag requires re-syncing from scratch.

​

static-files.account-change-sets

Store account changesets in static files. When enabled, account changesets will be written to static files on disk instead of the database. Note: This setting can only be configured at genesis initialization. Once the node has been initialized, changing this flag requires re-syncing from scratch.

​

Rollup

Options for Rollup configuration.

​

rollup.sequencer

Endpoint for the sequencer mempool (can be both HTTP and WS). Aliases: --rollup.sequencer-http, --rollup.sequencer-ws

​

rollup.disable-tx-pool-gossip

Disable transaction pool gossip.

​

rollup.compute-pending-block

By default the pending block equals the latest block to save resources and not leak txs from the tx-pool, this flag enables computing of the pending block from the tx-pool instead. If compute_pending_block is not enabled, the payload builder will use the payload attributes from the latest block. Note that this flag is not yet functional.

​

rollup.discovery.v4

Enables discovery v4 if provided.

​

rollup.enable-tx-conditional

Enable transaction conditional support on sequencer.

​

rollup.supervisor-http

HTTP endpoint for the supervisor.

​

rollup.supervisor-safety-level

Safety level for the supervisor.

​

rollup.sequencer-headers

Optional headers to use when connecting to the sequencer.

​

rollup.historicalrpc

RPC endpoint for historical data.

​

min-suggested-priority-fee

Minimum suggested priority fee (tip) in wei.

​

flashblocks-url

A URL pointing to a secure websocket subscription that streams out flashblocks. If given, the flashblocks are received to build pending block. All request with “pending” block tag will use the pending state based on flashblocks.

​

flashblock-consensus

Enable flashblock consensus client to drive the chain forward. When enabled, the flashblock consensus client will process flashblock sequences and submit them to the engine API to advance the chain. Requires flashblocks_url to be set.

​

Logging

Options for logging.

​

log.stdout.format

The format to use for logs written to stdout. Possible values: json, log-fmt, terminal.

​

log.stdout.filter

The filter to use for logs written to stdout.

​

log.file.format

The format to use for logs written to the log file. Possible values: json, log-fmt, terminal.

​

log.file.filter

The filter to use for logs written to the log file.

​

log.file.directory

The path to put log files in.

​

log.file.name

The prefix name of the log files.

​

log.file.max-size

The maximum size (in MB) of one log file.

​

log.file.max-files

The maximum amount of log files that will be stored. If set to 0, background file logging is disabled.

​

log.journald

Write logs to journald.

​

log.journald.filter

The filter to use for logs written to journald.

​

color

Sets whether or not the formatter emits ANSI terminal escape codes for colors and other text formatting. Possible values: always, auto, never.

​

logs-otlp

Enable Opentelemetry logs export to an OTLP endpoint. If no value provided, defaults based on protocol:

• HTTP: http://localhost:4318/v1/logs
• gRPC: http://localhost:4317

​

logs-otlp.filter

Set a filter directive for the OTLP logs exporter. This controls the verbosity of logs sent to the OTLP endpoint. It follows the same syntax as the RUST_LOG environment variable. Defaults to INFO if not specified.

​

Display

Options for display and verbosity.

​

verbosity

Set the minimum log level.

• -v: Errors
• -vv: Warnings
• -vvv: Info
• -vvvv: Debug
• -vvvvv: Traces (warning: very verbose!)

​

quiet

Silence all log output.

​

Tracing

Options for OpenTelemetry tracing.

​

tracing-otlp

Enable Opentelemetry tracing export to an OTLP endpoint. If no value provided, defaults based on protocol:

• HTTP: http://localhost:4318/v1/traces
• gRPC: http://localhost:4317

​

tracing-otlp-protocol

OTLP transport protocol to use for exporting traces and logs.

• http: expects endpoint path to end with /v1/traces or /v1/logs
• grpc: expects endpoint without a path Defaults to HTTP if not specified.

Possible values:

• http: HTTP/Protobuf transport, port 4318, requires /v1/traces path
• grpc: gRPC transport, port 4317

​

tracing-otlp.filter

Set a filter directive for the OTLP tracer. This controls the verbosity of spans and events sent to the OTLP endpoint. It follows the same syntax as the RUST_LOG environment variable. Example: --tracing-otlp.filter=info,reth=debug,hyper_util=off Defaults to TRACE if not specified.

​

tracing-otlp.sample-ratio

Trace sampling ratio to control the percentage of traces to export. Valid range: 0.0 to 1.0 (1.0 = Sample all, 0.0 = Disable).

• 1.0, default: Sample all traces
• 0.01: Sample 1% of traces
• 0.0: Disable sampling

Example: --tracing-otlp.sample-ratio=0.0.