Skip to content

Snapshots and the store

proteus fetch writes one snapshot per device. A snapshot is a directory with one XML file per document and a meta.json.

Document Source Used for
config.xml configuration export every question
system-info.xml show system info model, serial, PAN-OS version
interfaces.xml show interface all zones, interfaces, addresses
fib.xml forwarding table zones of an address, routing paths
rib.xml routing table simulate routing --rib
ha.xml high-availability state the active member of a pair
predefined.xml the device's predefined services the ports of service-http and service-https

The store

The store is the directory that holds every snapshot:

~/.local/share/proteus/
  fw01/
    2026-09-27T17-05-00Z/
      config.xml  system-info.xml  interfaces.xml  fib.xml  rib.xml  ha.xml
      predefined.xml
      meta.json
    latest -> 2026-09-27T17-05-00Z
  .content/
    8000-1000.v1.xml.gz

fetch writes each snapshot to a hidden directory and then renames it, so a reader always sees a complete snapshot.

App-ID data

The predefined applications and application containers of a device are its App-ID data. They depend on the content version, so the store keeps them once per version in .content/, and every snapshot with that version shares the file. meta.json names the version as app_version.

.content/ has mode 0700 and each file in it has mode 0600. See snapshot for how to inspect and import the data.

Which snapshot a question reads

Flag Snapshot
none latest
--at <time> the newest snapshot at or before that time
--fresh a new snapshot, fetched first

Retention

The store keeps the newest 20 snapshots with a configuration and the newest 20 without one, per device. Set snapshot_keep in the configuration to change the number.