apxy traffic

View, filter, query, and manage captured network traffic.

apxy logs

Read and manage captured traffic records.

apxy logs list

List captured HTTP traffic records from the proxy database.

apxy logs list [flags]

Examples:

apxy logs list
apxy logs list --limit 10 --format markdown

apxy logs show

Show the full details of a single captured traffic record.

apxy logs show [flags]

Examples:

apxy logs show --id abc123

apxy logs search

Search captured traffic records by URL, headers, or body content.

apxy logs search [flags]

Examples:

apxy logs search --query "api.example.com"
apxy logs search --query "error" --limit 5 --format markdown

apxy logs search-bodies

Search request and response bodies in captured traffic.

apxy logs search-bodies [flags]

apxy logs stats

Show aggregate statistics for captured traffic, including request counts, status code distribution, and top domains.

apxy logs stats [flags]

Examples:

apxy logs stats
apxy logs stats --format toon

apxy logs clear

Delete ALL captured traffic records from the database.

Warning: This action cannot be undone.

apxy logs clear [flags]

apxy logs diff

Compare two captured traffic records.

apxy logs diff [flags]

apxy logs replay

Replay one captured request against the live upstream.

apxy logs replay [flags]

apxy logs label

Add a color label and free-text comment to a captured traffic record for easy identification.

apxy logs label [flags]

Examples:

apxy logs label --id abc123 --color red --comment "investigate this 500 error"

apxy logs jsonpath

Extract JSON fields from captured traffic bodies.

apxy logs jsonpath [flags]

apxy logs graphql

Search captured GraphQL requests.

apxy logs graphql [flags]

apxy logs export-curl

Export one traffic record as a reusable client snippet.

apxy logs export-curl [flags]

apxy logs export-har

Export captured traffic as a HAR 1.2 file.

apxy logs export-har [flags]

See HAR Import & Export for details.

apxy logs import-har

Import traffic records from a HAR file.

apxy logs import-har [flags]

apxy traffic filter

Create and manage traffic filter rules for the running proxy.

apxy traffic filter set

Add a traffic filter rule that blocks or allows requests matching a domain pattern.

apxy traffic filter set [flags]

Examples:

apxy traffic filter set --type block --target "ads.example.com"
apxy traffic filter set --type allow --target "*.internal.corp"

apxy traffic filter list

List all configured traffic filter rules.

apxy traffic filter list [flags]

apxy traffic filter remove

Remove a traffic filter rule by its unique ID, or remove all filter rules with --all.

apxy traffic filter remove [flags]

Examples:

apxy traffic filter remove --id abc123
apxy traffic filter remove --all

See Filtering for details.

apxy recording

Start or stop traffic recording on the running proxy.

apxy recording start

Start capturing traffic on the running proxy.

apxy recording start [flags]

apxy recording stop

Stop capturing traffic on the running proxy.

apxy recording stop [flags]

apxy sql

Run read-only SQL queries against the APXY database.

apxy sql query

Run a read-only SQL SELECT query against the APXY SQLite database.

Available tables:

• traffic_logs — id, timestamp, method, url, host, path, status_code, duration_ms, tls, mocked, …
• mock_rules — id, name, priority, active, url_pattern, match_type, method, …

apxy sql query [SQL] [flags]

Examples:

apxy sql query "SELECT host, COUNT(*) FROM traffic_logs GROUP BY host"

See SQL Queries for table schemas and examples.

apxy traffic devices

List devices currently using the proxy.

apxy traffic devices list

List all devices currently connected through the proxy, showing IP, platform, client app, and request count.

apxy traffic devices list [flags]

Examples:

apxy devices list --format json
apxy devices list --format toon

See Devices for details.

Inherited Options