Usage & Logs

The Dwellir CLI provides two command groups for monitoring your API activity: dwellir usage for request analytics and dwellir logs for error inspection.

Usage#

Billing cycle summary#

View your total requests for the current billing cycle:

dwellir usage summary

dwellir usage summary --json

Usage history#

View request counts grouped by endpoint:

dwellir usage history

Flag	Default	Description
`--interval`	`hour`	Aggregation interval: `minute`, `hour`, or `day`
`--from`	start of billing cycle	Start time in RFC 3339 format
`--to`	now	End time in RFC 3339 format
`--api-key`		Filter by API key value
`--fqdn`		Filter by endpoint hostname (FQDN)
`--method`		Filter by RPC method

Examples:

# Daily usage grouped by endpoint
dwellir usage history --interval day --from 2026-02-19T00:00:00Z

# Filter to a specific endpoint
dwellir usage history --fqdn api-ethereum-mainnet.n.dwellir.com --interval day

# Filter by RPC method
dwellir usage history --method eth_call --from 2026-02-01T00:00:00Z

Usage by RPC method#

View request counts grouped by RPC method:

dwellir usage methods

Flag	Default	Description
`--interval`	`hour`	Aggregation interval: `minute`, `hour`, or `day`
`--from`	start of billing cycle	Start time in RFC 3339 format
`--to`	now	End time in RFC 3339 format
`--api-key`		Filter by API key value
`--fqdn`		Filter by endpoint hostname (FQDN)

Requests per second#

View RPS over time across all endpoints:

dwellir usage rps

Flag	Default	Description
`--interval`	`hour`	Aggregation interval: `minute`, `hour`, or `day`
`--from`	past 24 hours	Start time in RFC 3339 format
`--to`	now	End time in RFC 3339 format
`--api-key`		Filter by API key value
`--fqdn`		Filter by endpoint hostname (FQDN)

dwellir usage rps --json

Estimated costs#

View estimated cost breakdown for a usage window (requires Developer plan or higher):

dwellir usage costs

Flag	Default	Description
`--interval`	`hour`	Aggregation interval: `minute`, `hour`, or `day`
`--from`	start of billing cycle	Start time in RFC 3339 format
`--to`	now	End time in RFC 3339 format
`--api-key`		Filter by API key value
`--fqdn`		Filter by endpoint hostname (FQDN)
`--method`		Filter by RPC method

Usage query limits#

Check your plan's usage query limits (max lookback, supported intervals):

dwellir usage limits

dwellir usage limits --json

Logs#

Error logs#

List recent error responses with optional filters:

dwellir logs errors

Flag	Description
`--key`	Filter by API key
`--endpoint`	Filter by endpoint FQDN
`--status-code`	Filter by HTTP status code
`--rpc-method`	Filter by RPC method name
`--from`	Start time (RFC 3339)
`--to`	End time (RFC 3339)
`--limit`	Maximum results (default: 50)
`--cursor`	Pagination cursor for next page

Examples:

# Show rate-limit errors
dwellir logs errors --status-code 429

# Errors for a specific key in the last hour
dwellir logs errors --key abc12345-... --from 2026-02-26T11:00:00Z

# Filter by RPC method
dwellir logs errors --rpc-method eth_call --limit 20

# Combine filters
dwellir logs errors --endpoint api-ethereum-mainnet.n.dwellir.com --status-code 500 --limit 100

Error stats#

View error counts grouped by status code:

dwellir logs stats

Filter the same way as errors:

dwellir logs stats --key abc12345-... --from 2026-02-20T00:00:00Z

Get aggregated breakdowns of error activity across four dimensions:

dwellir logs facets

The output is grouped into four sections:

FQDNs -- which endpoints see the most errors
RPC Methods -- which methods generate the most errors
Origins -- traffic origin breakdown (e.g., backend vs gateway)
API Keys -- error counts per key

dwellir logs facets --from 2026-02-01T00:00:00Z --to 2026-02-28T00:00:00Z --json

This is useful for identifying which endpoints or methods generate the most errors.

Pagination#

The logs errors command supports cursor-based pagination. When more results are available, the response includes a cursor in the metadata:

# Get the first page
dwellir logs errors --limit 50 --json

# Use the cursor from the response to get the next page
dwellir logs errors --limit 50 --cursor <cursor-from-previous-response> --json

Next steps#

Manage API keys to adjust quotas when you see rate-limit errors
Discover endpoints to check available networks
Run dwellir usage --help or dwellir logs --help for the full list of flags