Does PeakNode have an API, and what do I need it for?
Yes. The PeakNode REST API lets you retrieve and manage uptime monitors, heartbeats, server monitors, DNS monitors, domains, status pages, notification channels, projects, maintenance windows and incidents, for example for your own reports or to create monitors automatically. It requires a plan with API access. The reference with all parameters is in the API documentation.
How do alerts get into our ticket system?
Via the webhook notification channel: when an event occurs, PeakNode sends a POST request to your URL with the event’s fields as form data. For an uptime monitor these include name, target, state, reason, start and the address of the incident, and for the all-clear also end and duration. All times are UTC. PeakNode does not include a signature for verifying the origin.
How does a ticket system acknowledge an incident?
With a POST to /api/incidents/{incident_id}/acknowledge. The incident then shows the owner of the API key as the person and “via the API” as the way. If the incident has already been acknowledged or has ended, the API responds with 409.
How do I authenticate with the API?
With your account’s API key, sent as the header Authorization: Bearer. You find the key in the account under “API”. It applies to the whole account; a two-factor requirement does not affect it.
Is there a rate limit?
Yes, 60 requests in 60 seconds per API key. Every response states the limit and the remainder in the headers X-RateLimit-Limit and X-RateLimit-Remaining. Beyond that, the API responds with status code 429. The Prometheus export also has its own limit of 30 requests per minute and account.
Can I pull the metrics into Prometheus?
Yes. The endpoint /api/metrics returns your account’s current values in the Prometheus text format, authenticated with the API key. It includes utilization, memory, temperature and power per GPU, CPU and RAM per server, the state of monitors and heartbeats and the remaining validity of certificates, among other things. A scrape interval of 60 seconds matches the rhythm of the checks.
Can I retrieve metrics from the last few weeks via the API?
No. For each server monitor the API returns the state of the latest report, not a time series. For history there are two options: scrape the Prometheus export regularly and store it yourself, or export the data for a period from the portal as CSV or JSON.
Can I show PeakNode metrics in Grafana?
Yes, through Prometheus: a Prometheus server pulls /api/metrics with the API key and stores the values, and Grafana displays them with Prometheus as the data source. PeakNode does not ship a ready-made Grafana dashboard. Without Grafana, the metrics are in the portal, for example in GPU server monitoring.