Request Logs

portr logs reads the local HTTP request log database written by the Portr client. Use it when you want to inspect recent traffic for a tunnel subdomain without opening the local inspector UI.

What It Reads

Portr stores HTTP request logs in ~/.portr/db.sqlite. The logs command only queries data that has already been captured on the current machine.

Command Shape

portr logs <subdomain> [filter]

• <subdomain> is required.
• [filter] is an optional case-insensitive URL substring filter.
• Results are returned newest first.
• The default result window is 20.

Options

Filters and Dates

The optional positional filter matches against the stored request URL using a case-insensitive substring search.

The --since flag accepts either:

• An RFC3339 timestamp such as 2026-04-04T10:30:00Z
• A date such as 2026-04-04

Examples

Show the latest requests for a subdomain:

portr logs my-app

Filter to matching URLs:

portr logs my-app /api/orders

Increase the result window:

portr logs my-app --count 100

Limit results to a date or timestamp:

portr logs my-app --since 2026-04-04
portr logs my-app --since 2026-04-04T10:30:00Z

Emit full stored records as JSON:

portr logs my-app --json

Combine the filters:

portr logs my-app /webhooks --count 50 --since 2026-04-01

Text Output

The default text output prints one line per request:

2026-04-04T12:00:00Z 3000 POST 200 /api/orders
2026-04-04T12:01:00Z 3000 POST 202 /api/orders [replayed]

Each line includes:

• Logged timestamp in UTC
• Local forwarded port
• HTTP method
• Response status code
• Stored request URL
• [replayed] when the request was created by portr replay

JSON Output

--json returns the full stored request record, including headers, timestamps, response metadata, and replay linkage.

Two fields are important when working with payloads:

• Body and ResponseBody remain base64-encoded
• BodyText and ResponseBodyText are also included when the stored payload is valid UTF-8 text

This makes the JSON safe for binary payloads while still being easy to inspect for normal JSON, HTML, and text responses.

Related Commands

• Use portr replay to resend a stored request.
• Use portr http to start an HTTP tunnel and capture requests in the first place.