This data call represents the scenario of what occurred to the BGP routes of a resource over a period of time.
It includes data that defines the initial BGP state at the start time of the query, and all the BGP updates observed from then until the end time, as well as a description of all the AS nodes, and RIS BGP peers involved in the result.
https://stat.ripe.net/data/bgplay/data.<format>?<parameters>
e.g. https://stat.ripe.net/data/bgplay/data.json?resource=140.78/16&starttime=2012-12-21T07:00&endtime=2012-12-21T12:00
Parameters
Key
|
Value
|
Info
|
Required
|
resource
|
Prefix, IP address, AS or a list of valid comma-separated resources
|
Defines the resource that the query is performed for. If a list of resources is supplied, the results will be combined for all of them.
|
YES
|
starttime
|
ISO8601 or Unix timestamp
|
Defines the starttime for the query
|
NO - default: (endtime - 8h)
|
endtime
|
ISO8601 or Unix timestamp
|
Defines the endtime for the query
|
NO - default: latest time there is BGP data available
|
rrcs
|
Single-value or comma-separated values of RRC numbers (4 or 0,4,12,15)
|
The list of Route Collectors (RRCs) to get the results from.
|
NO - default behaviour: all RRCs
|
unix_timestamps
|
TRUE or FALSE
|
If TRUE, will format the timestamps in the result as Unix timestamp.
|
NO - default: FALSE
|
Output
Data
Key
|
Info
|
initial_state
|
The state of the BGP routes for this resource at the starttime. Formatted as defined in the "bgp_state" section of bgp-state.
|
events
|
The BGP updates observed for this resource during the query time interval. Formatted as defined in the "updates" section of bgp-updates.
|
nodes
|
Descriptive information of all the ASes present in the AS paths of the BGP routes/updates.
as-number |
The AS number. |
owner |
The name of the organisation estimated to hold this AS number. |
|
targets
|
List of all the unique target prefixes present in the results.
|
sources
|
Descriptive information of all the RIS collectors neighbouring peers through which the BGP routes/updates were observed.
id |
Id of the source peer, as referred to in the BGP entries found in the "initial_state" and "events" sections. |
rrc |
The number of the RIS route collector with which this source is peering. |
ip |
Peering IP address of this RIS neighbour. |
as_number |
AS number of this RIS neighbour. |
|
query_starttime
|
Defines the start of the time interval covered in the query.
|
query_endtime
|
Defines the end of the time interval covered in the query.
|
resource
|
Defines the resource used in the query.
|
Example
"data": {
"events": [
{
"attrs": {
"source_id": "13-193.232.244.15",
"target_prefix": "140.78.0.0/16"
},
"timestamp": "2012-12-21T07:27:56",
"type": "W"
},
{
"attrs": {
"community": [
"9002:9002",
"9002:64605"
],
"path": [
39821,
9002,
1853,
1205
],
"source_id": "13-193.232.244.15",
"target_prefix": "140.78.0.0/16"
},
"timestamp": "2012-12-21T07:28:46",
"type": "A"
},
(...)
],
"initial_state": [
{
"community": [
"174:1001",
"174:21000",
"174:22013",
"45896:1001"
],
"path": [
45896,
174,
3356,
1853,
1205
],
"source_id": "00-111.91.233.1",
"target_prefix": "140.78.0.0/16"
},
(...)
],
"nodes": [
{
"as_number": 174,
"owner": "COGENT Cogent/PSI"
},
{
"as_number": 286,
"owner": "KPN KPN Internet Backbone"
},
(...)
],
"query_endtime": "2012-12-21T12:00:00",
"query_starttime": "2012-12-21T07:00:00",
"resource": "140.78.0.0/16",
"sources": [
{
"as_number": 45896,
"id": "00-111.91.233.1",
"ip": "111.91.233.1",
"rrc": "00"
},
(...)
],
"targets": [
{
"prefix": "140.78.0.0/16"
}
]
}