Skip to main content
Reports → Archives, under Queues. A read-only report, from 0.12.19, of everything a queue clean archived and every run that wrote to the archive. Anyone who may read reports may open it; cleaning happens on the Queues page, on a vendor’s or listener’s page, or on the command line, and deleting archive months is command-line only. Every archived message was ended, not parked: refunded if it was charged, sent a failed receipt where the customer asked for one, and recorded as refused with reason operatorPurge. The archive is the record of what was ended, who did it and why.
Against a gateway older than 0.12.19 the page says Available from gateway 0.12.19 and shows nothing else. That is not an error: the archive arrives with that release’s database update.

​
Latest runs, and the Batches tab

The strip at the top lists the newest runs; the Batches tab lists them all and filters by kind: Each run shows when it started (and whether it is still running), who ran it, the selector it was given, how many matched, were archived, refunded and sent a receipt, how many failed, and the note. Choose the time to see that run’s entries.

​
Partitions

One row per month: the rows held, the first and last archive time, and the size on disk. A month whose detail was purged shows purged on <date>, <n> rows — the entries are gone, and the summary kept for that month says how many there were.

​
By account — the reconciliation view

Per account, over an optional range of days (in the billing zone, both ends included): messages archived, refunded, receipts sent, price total, first and last, and how much of the total is still held in detail versus purged. CSV downloads what is shown.
This tab reads the per-day summary the gateway keeps forever, never the detail rows. Its totals are what fireflo queue archive summary --by account prints, and they do not change when old months are purged — Held falls and Purged rises by the same number.

​
Entries

The archived entries themselves, newest first, filtered by period, account, vendor or listener (the list offers the configured ones), system id, store, batch and message id; the filters live in the address, so a filtered view can be shared. Each row shows the store and sub-store, who archived it and why, its batch, whether it was refunded and whether a receipt was sent, and links to the message’s own page by its message id. A Text column appears only when the gateway kept message text when it was archived — the same Keep message text switch that governs call records. All time is offered only together with an identifier — an account, vendor, listener, login, batch or message id. Otherwise a period of at most 92 days.

​
Deleting archive months

Command line only, with FIREFLO_QUEUE_ARCHIVE_PURGE=true:
Only whole months go, never the current one, and each month is reconciled against the summary first — a month that does not add up is refused and nothing is deleted. Or set Gateway settings → Call records → Keep queue archive months for (smsg.queue.archive.retention.days, default 0 = never), and the gateway runs the same reconciled purge on its own.

Queues

What is waiting, and the Clean up card.

Inspecting a queue

What a clean does to each message, from the command line.