Logs push history

Use the ably logs push history command to retrieve push notification log history.

Synopsis

ably logs push history [options]

Options

--direction

The direction to retrieve logs in. Options are backwards or forwards. Defaults to backwards.

--limit

The maximum number of log entries to retrieve. Defaults to 100.

--start

The start of the time range to retrieve logs from. Accepts ISO 8601, Unix milliseconds, or relative time formats.

--end

The end of the time range to retrieve logs from. Accepts ISO 8601, Unix milliseconds, or relative time formats.

--json

Output results as compact JSON. Mutually exclusive with --pretty-json.

--pretty-json

Output results in formatted JSON. Mutually exclusive with --json.

--verbose | -v

Enable verbose logging. Can be combined with --json or --pretty-json.

Examples

Retrieve recent push notification logs:

ably logs push history

Retrieve logs within a time range:

ably logs push history --start "2025-01-01T00:00:00Z" --end "2025-01-02T00:00:00Z"

Retrieve a limited number of push notification logs:

ably logs push history --limit 20

Retrieve push notification logs in forwards direction:

ably logs push history --direction forwards

Retrieve push notification logs from the last hour:

ably logs push history --start 1h

Retrieve push notification logs in JSON format:

ably logs push history --json

Retrieve push notification logs in formatted JSON:

ably logs push history --pretty-json

See also

• Logs — Explore all ably logs commands.
• CLI reference — Full list of available commands.