Skip to main content
Use the push log to check whether a device got its call push and what the push service answered. pgw stores each push that it sends, skips, or holds back as a push event in its database.

List the newest push events

Call the API with your tenant’s API key.
pgw returns the tenant’s newest events first, as {"items": [...]}. limit is from 1 to 1000, and 100 by default. The endpoint has no cursor, so it returns at most the newest limit events. Each event has the following fields. pgw stores an event within about a second of the push. A push that pgw didn’t send because the device reached call_push_rate_per_binding has no event. It counts in pgw_pushes_total with the result limited. When a call ends while its call push still waits in pgw’s queue, pgw drops the push and sends no missed-call push. The log line for the push shows err="push: call ended".

Set how long pgw keeps push events

pgw keeps push events for push_event_retention_days days, 7 by default, and deletes older events every 5 minutes. Set 0 to keep events forever. The largest value is 36500.
1

Set the retention

Set the number of days in the configuration file, or set PGW_PUSH_EVENT_RETENTION_DAYS.
2

Restart pgw

Next steps

Push lines in the logs

Find the log line for a push, with the device that it went to.

Push metrics

Watch push results and queue depth across all devices.