# Per-peer dump files

Per-peer dump files are MRT files of type TABLE_DUMP_V2, as described in RFC 6396, Section 4.3 (opens new window), similar to the "raw bview" per-RRC dump files. The difference is that each file only contains RIB entries from single peer, and that these files are generated every hour (in contrast with per-RRC files, which are generated every 8 hours). Another difference is that these files are more conformant with the format described in the RFC: they do not contain MP_UNREACH_NLRI attribute in RIB entries, and do not include announced prefix in MP_REACH_NLRI attribute, as Section 4.3.4 of RFC 6396 describes.

# File retention

Per-peer dump files are available for the period of two weeks.

# REST Interface

Per-peer dump files are available through the REST interface at base URL https://www.ris.ripe.net/dumps-per-peer-rest/prototype/ (opens new window).

# List all RRCs

Returns a list of objects with links to individual RRC's dumps.

Request
Relative path /
Methods GET
Response Content-type application/json
Resource's fields
name Resource name
href Resource location
curl https://www.ris.ripe.net/dumps-per-peer-rest/prototype/
Output:
{
  "rrcs" : [ {
    "name" : "rrc00",
    "href" : "/dumps-per-peer-rest/prototype/rrc00"
  }, {
    "name" : "rrc01",
    "href" : "/dumps-per-peer-rest/prototype/rrc01"
  }, {
    "name" : "rrc03",
    "href" : "/dumps-per-peer-rest/prototype/rrc03"
  } ]
}

# List dump times for an RRC

Returns list of objects with links to all available dump times for an RRC.

Relative path {rrcName}
Methods GET
Response Content-type application/json
Resource's fields
name Resource name
href Resource location
time Time (hour) of the dump (ISO8601-formatted)
mtime Time the resource was last updated (ISO8601-formatted)
curl https://www.ris.ripe.net/dumps-per-peer-rest/prototype/rrc01/
Output:
{
  "rrc" : "rrc01",
  "links" : [ {
    "name" : "2022-05-03T10",
    "href" : "/dumps-per-peer-rest/prototype/rrc01/2022-05-03T10",
    "time" : "2022-05-03T10",
    "mtime" : "2022-05-03T10:02:31.033Z"
  }, {
    "name" : "2022-05-03T09",
    "href" : "/dumps-per-peer-rest/prototype/rrc01/2022-05-03T09",
    "time" : "2022-05-03T09",
    "mtime" : "2022-05-03T09:02:31.229Z"
  }, {
    "name" : "2022-05-03T08",
    "href" : "/dumps-per-peer-rest/prototype/rrc01/2022-05-03T08",
    "time" : "2022-05-03T08",
    "mtime" : "2022-05-03T08:03:06.934Z"
  } ]
}

# List dump files for a specific time and RRC

Returns list of objects with links to all available dump files for an RRC and a time.

Relative path {rrcName}/{time}
Methods GET
Response Content-type application/json
Resource's fields
name Dump file name
href Dump file location
mtime Time of the last file modification (ISO8601-formatted)
peerIp IP address of a peer
curl https://www.ris.ripe.net/dumps-per-peer-rest/prototype/rrc01/2022-05-03T10
Output:
{
  "rrc" : "rrc01",
  "time" : "2022-05-03T10",
  "links" : [ {
    "name" : "bview-20220503T1000-053950A5.gz",
    "href" : "/dumps-per-peer-rest/prototype/rrc01/2022-05-03T10/bview-20220503T1000-053950A5.gz",
    "mtime" : "2022-05-03T10:01:02.253Z",
    "peerIp" : "5.57.80.165"
  }, {
    "name" : "bview-20220503T1000-053950AE.gz",
    "href" : "/dumps-per-peer-rest/prototype/rrc01/2022-05-03T10/bview-20220503T1000-053950AE.gz",
    "mtime" : "2022-05-03T10:01:06.304Z",
    "peerIp" : "5.57.80.174"
  }, {
    "name" : "bview-20220503T1000-200107F800040000000000000C8E0001.gz",
    "href" : "/dumps-per-peer-rest/prototype/rrc01/2022-05-03T10/bview-20220503T1000-200107F800040000000000000C8E0001.gz",
    "mtime" : "2022-05-03T10:01:01.886Z",
    "peerIp" : "2001:7f8:4::c8e:1"
  }]
}

# Get dump file

Returns the dump file for one peer at specified time.

Relative path {rrcName}/{time}/{fileName}
Methods GET, HEAD
Response Content-type application/octet-stream
curl -O https://www.ris.ripe.net/dumps-per-peer-rest/prototype/rrc01/2022-05-03T10/bview-20220503T1000-053950A5.gz
Last Updated: 6/3/2022, 4:51:22 PM