Monitoring

Live sensors and stored graphs for bandwidth and sensors.

5 endpoints

Live sensors

#

GET/api/v1/servers/{id}/sensors/live

Temperatures, fans and power read from the BMC now.

Path parameters

  • id integer> 0

Example

curl "https://panel.example.com/api/v1/servers/42/sensors/live" \
  -H "Authorization: Bearer $TRIXOS_TOKEN"

Bandwidth graph

#

GET/api/v1/servers/{id}/graphs/bandwidth

5-minute samples between from and to, with totals and 95th percentiles.

Path parameters

  • id integer> 0

Query parameters

  • from stringdate-time
  • to stringdate-time

Example

curl "https://panel.example.com/api/v1/servers/42/graphs/bandwidth" \
  -H "Authorization: Bearer $TRIXOS_TOKEN"

Sensor graph

#

GET/api/v1/servers/{id}/graphs/sensors

Stored sensor samples between from and to.

Path parameters

  • id integer> 0

Query parameters

  • from stringdate-time
  • to stringdate-time

Example

curl "https://panel.example.com/api/v1/servers/42/graphs/sensors" \
  -H "Authorization: Bearer $TRIXOS_TOKEN"

Power history of a PDU

#

GET/api/v1/pdus/{id}/graphs/power

Admin only

5-minute totals of the whole PDU ([time, watts, amps]) and the energy in kWh for the range (default: the last 24 hours).

Path parameters

  • id integer> 0

Query parameters

  • from stringdate-time
  • to stringdate-time

Example

curl "https://panel.example.com/api/v1/pdus/42/graphs/power" \
  -H "Authorization: Bearer $TRIXOS_TOKEN"

Power draw of a server

#

GET/api/v1/servers/{id}/graphs/power

From the PDU outlets mapped to the server (sum of the metered outlets), otherwise from the BMC power sensor; the server's power usage measurement setting can fix the source or switch it off. source is pdu, bmc or null; points are [time, watts], kwh the energy in the range (default: the last 24 hours), outlets the mapped outlets with state.

Path parameters

  • id integer> 0

Query parameters

  • from stringdate-time
  • to stringdate-time

Example

curl "https://panel.example.com/api/v1/servers/42/graphs/power" \
  -H "Authorization: Bearer $TRIXOS_TOKEN"