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

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

Requests per second

View RPS over time across all endpoints:

dwellir usage rps

dwellir usage rps --json

Estimated costs

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

dwellir usage costs

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

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

Error facets

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