Monitoring

The HTTP server in Routinator provides endpoints for monitoring the application. To launch Routinator in server mode on 192.0.2.13 with RTR running on port 3323 and HTTP on 9556, use the following command:

routinator server --rtr 192.0.2.13:3323 --http 192.0.2.13:9556

The HTTP service has these monitoring endpoints on the following paths:

/version
Returns the version of the Routinator instance
/metrics
Exposes a data format specifically for Prometheus, for which dedicated port 9556 is reserved.
/status
Returns the information from the /metrics endpoint in a more concise format
/log

Returns the logging output of the last validation run. The log level matches that set upon start.

Note that the output is collected after each validation run and is therefore only available after the initial run has concluded.

Metrics

Update metrics
  • When the last update started and finished
  • The total duration of the last update
  • The retrieval duration and exit code for each rsync publication point
  • The retrieval duration and HTTP status code for each RRDP publication point
Object metrics
  • The number of valid ROAs per Trust Anchor
  • The number of Validated ROA Payloads (VRPs) per Trust Anchor
  • The number of stale objects found
  • The number of VRPs added locally
RTR server
  • The current RTR serial number
  • The current and total number of RTR connections
  • The total amount of bytes sent and received over the RTR connection
HTTP server
  • The current and total number of HTTP connections
  • The total amount of bytes sent and received over the HTTP connection
  • The number of HTTP requests

Grafana

Using the Prometheus endpoint it’s possible to build a detailed dashboard using for example Grafana. We provide a template to get started.

Grafana dashboard

Fig. 22 A sample Grafana dashboard