CoreDash Uptime-API ja MCP-työkalut: monitorit ja tarkistukset

Uptime-monitorit CoreDash-API:n kautta

Lue ja muokkaa CoreDash-projektiesi uptime-monitoreja REST:in kautta samalla API-avaimella, jota käytät jo RUM-datalle. AI-agentti lukee ne MCP:n kautta.

curl https://app.coredash.app/api/uptime/monitors \
  -H "Authorization: Bearer cdk_your_key"

Uptime-monitorien API-avaimet

Uptime-endpointit hyväksyvät CoreDash API:n ja Agency API:n avaimet.

Luo projektiavain projektisi sivupalkin Connect Your AI -sivulla: anna sille nimi ja klikkaa Generate API key. Samat avaimet löytyvät projektin asetuksista kohdasta API Keys (MCP). Vain projektin omistajat voivat luoda niitä. Master-avaimen saa sivupalkin Agency API -sivulta agency-tileillä. Kun projekti on vanhentunut, sen projektiavain saa koodin 401 jokaisella kutsulla.

Projektin vierailija voi vain lukea sen monitoreja. Niiden lisääminen, muuttaminen, siirtäminen ja poistaminen vaatii omistamasi projektin.

AI-yhteyden, kuten Clauden, OAuth-tokenilla (mcp_at_) on vain lukuoikeus. Kutsut POST, PATCH ja DELETE saavat sen kanssa koodin 403.

Uptime-endpointit

Origin-IP ja headerien arvot ovat salaisia. Ne palautetaan kutsuista POST, PATCH ja GET /api/uptime/monitors/:id. Listaus ja MCP-työkalut jättävät kentän origin_ip pois ja näyttävät jokaisen headerin arvona ••••.

Monitor-objekti

Kentät summary ja rum

Sekä listaus että yksittäinen monitori sisältävät kentän summary. Siinä rounds_7d ja down_rounds_7d laskevat viimeisen 7 päivän kierrokset, ja uptime_7d on niiden kierrosten prosenttiosuus, joissa ei ollut yhtään down-tarkistusta. Kenttä recent sisältää viimeiset 48 kierrosta vanhimmasta alkaen, kunkin kyseisen kierroksen huonoimmalla tuloksella. Jos monitorilla ei ole tarkistuksia viimeisen 7 päivän ajalta, arvo on summary: null.

Yksittäinen monitori sisältää myös kentän rum: oikeiden kävijöiden viimeisen 7 päivän TTFB p75-tasolla projektin RUM-datasta, jota voi verrata tarkistimen arvoon ttfb_ms. Arvo on null, kun projektilla ei ole RUM-dataa.

GET /api/uptime/monitors/:id

curl "https://app.coredash.app/api/uptime/monitors/6ad68c7a844fad80b752fd16?limit=2" \
  -H "Authorization: Bearer cdk_your_key"

{
  "monitor": {
    "id": "6ad68c7a844fad80b752fd16",
    "name": "Checkout",
    "url": "https://www.example.com/checkout/",
    "project_id": "655f1f77bcf86cd799439011",
    "paused": false,
    "expect_status": 200,
    "origin_check": true,
    "origin_ip": "203.0.113.10",
    "headers": [{ "name": "X-Staging-Auth", "value": "k7Qp2vX9mR4tL8wZ" }],
    "state": "up",
    "last_check_at": "2026-10-20T08:00:09.000Z",
    "last_up_at": "2026-10-20T08:00:09.000Z",
    "down_since": null,
    "last_down": { "from": "2026-10-18T19:00:11.000Z", "to": "2026-10-18T20:00:10.000Z" },
    "check_requested_at": null,
    "last": {
      "edge": { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "edge", "outcome": "up", "status": 200, "ttfb_ms": 212, "total_ms": 388, "connect_ms": 14, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": true, "cache_status": "DYNAMIC" },
      "origin": { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "origin", "outcome": "up", "status": 200, "ttfb_ms": 640, "total_ms": 702, "connect_ms": 9, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": false, "cache_status": null },
      "origin_is_cdn": false
    },
    "cert_expires": "2027-01-02T23:59:59.000Z",
    "created_at": "2026-10-06T09:12:41.000Z"
  },
  "summary": {
    "rounds_7d": 336,
    "down_rounds_7d": 2,
    "uptime_7d": 99.4,
    "recent": [
      { "at": "2026-10-20T07:30:10.000Z", "outcome": "up" },
      { "at": "2026-10-20T08:00:09.000Z", "outcome": "up" }
    ]
  },
  "checks": [
    { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "edge", "outcome": "up", "status": 200, "ttfb_ms": 212, "total_ms": 388, "connect_ms": 14, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": true, "cache_status": "DYNAMIC" },
    { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "origin", "outcome": "up", "status": 200, "ttfb_ms": 640, "total_ms": 702, "connect_ms": 9, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": false, "cache_status": null }
  ],
  "rum": { "ttfb_p75": 1920, "rating": "poor", "period": "last 7 days" }
}

Oikeassa vastauksessa recent sisältää 48 kierrosta; tässä esimerkissä näytetään kaksi viimeisintä.

Check-objekti ja sen tulokset

Kaikki monitorit tarkistetaan 30 minuutin välein kahdelta palvelimelta vuorotellen: scan1 ajassa :00 ja scan2 ajassa :30. Kierros tarkistaa URL-osoitteen aina niin kuin kävijät sen avaavat, DNS:n ja CDN:n kautta (edge). Jos origin-IP on määritetty, se tarkistaa myös palvelimesi suoraan (origin). API:ssa ei ole kutsua monitorin tarkistamiseen kierrosten välillä. Tarkistukset säilytetään 30 päivää.

Jokainen tarkistus lähettää user agentin CoreDash/1.0 (uptime; +https://www.coredash.app/bot). Kun monitorin URL on projektisi omalla sivustolla (sen host-osoitteessa www-etuliitteellä tai ilman, tai aliverkkotunnuksessa), tarkistus lähettää myös headerin X-CoreDash-Bot projektisi salaisella arvolla, joka löytyy projektin asetuksista CoreDash bot token -välilehdeltä. Muiden sivustojen monitorit eivät saa tokenia. Uudelleenohjauksessa token noudattaa samaa sääntöä kuin asettamasi headers: se kulkee mukana vain niin kauan kuin uudelleenohjaus pysyy monitorin host-osoitteessa. Oma X-CoreDash-Bot-niminen headerisi pudotetaan pois. Molemmista kerrotaan lisää CoreDash bot -sivulla.

Miten tarkistuksen tulos määräytyy

Kierroksen tarkistusten huonoin tulos määrää monitorin tilan järjestyksessä huonoimmasta parhaaseen: down, blocked, warn, up.

Monitorin tilat

Jos projektin tilaus on päättynyt, monitori säilyttää asetuksensa ja viimeisimmän tilansa. Sitä ei tarkisteta ennen kuin projekti on jälleen maksettu.

Lisää, muuta ja poista monitori

POST /api/uptime/monitors

curl -X POST https://app.coredash.app/api/uptime/monitors \
  -H "Authorization: Bearer cdk_master_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.example.com/checkout/",
    "name": "Checkout",
    "project_id": "655f1f77bcf86cd799439011",
    "origin_ip": "203.0.113.10",
    "headers": [{ "name": "X-Staging-Auth", "value": "k7Qp2vX9mR4tL8wZ" }],
    "expect_status": 200
  }'

Vastaus on 201 uuden monitorin kera, mukaan lukien origin-IP ja headerien arvot:

{
  "monitor": {
    "id": "6ad68c7a844fad80b752fd16",
    "name": "Checkout",
    "url": "https://www.example.com/checkout/",
    "project_id": "655f1f77bcf86cd799439011",
    "paused": false,
    "expect_status": 200,
    "origin_check": true,
    "origin_ip": "203.0.113.10",
    "headers": [{ "name": "X-Staging-Auth", "value": "k7Qp2vX9mR4tL8wZ" }],
    "state": "pending",
    "last_check_at": null,
    "last_up_at": null,
    "down_since": null,
    "last_down": null,
    "check_requested_at": "2026-10-20T09:12:41.000Z",
    "last": {},
    "cert_expires": null,
    "created_at": "2026-10-20T09:12:41.000Z"
  }
}

PATCH /api/uptime/monitors/:id

Lähetä vain ne kentät, joita muutat. headers korvaa koko listan, joten lähetä kaikki säilytettävät headerit. Tämä asettaa monitorin tauolle:

curl -X PATCH https://app.coredash.app/api/uptime/monitors/6ad68c7a844fad80b752fd16 \
  -H "Authorization: Bearer cdk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "paused": true }'

Master-avaimella project_id siirtää monitorin samojen sääntöjen mukaan kuin POST-kutsussa.

DELETE /api/uptime/monitors/:id

curl -X DELETE https://app.coredash.app/api/uptime/monitors/6ad68c7a844fad80b752fd16 \
  -H "Authorization: Bearer cdk_your_key"

Toimintoa ei voi kumota. Jos haluat pysäyttää tarkistukset ja säilyttää historian, lähetä { "paused": true } PATCH-kutsulla.

Uptime API:n virheet ja rajoitukset

Virheet palautetaan muodossa { "error": "..." } jollakin näistä tilakoodeista:

Rajoitukset: 25 monitoria projektia kohden, 5 ylimääräistä headeria monitoria kohden, 2100 tarkistusta yksittäisen monitorin GET-kutsussa ja 30 päivän tarkistushistoria.

Uptime MCP -työkalut

CoreDash MCP -palvelin osoitteessa https://app.coredash.app/api/mcp tarjoaa RUM-työkalujen rinnalla kaksi uptime-työkalua sekä työkalun list_projects niille projekteille, joihin avaimellasi on pääsy. Kaikki kolme ovat vain lukemiseen. Jos haluat lisätä, muuttaa tai poistaa monitorin, käytä sovellusta tai yllä olevia REST-endpointteja CoreDash API -avaimella. Työkalut eivät tarvitse kenttää project_id: projektiavain lukee omaa projektiaan, ja master-avain tai OAuth-yhteys (kuten Claude) lukee kaikkia projekteja, jotka omistat tai joihin sinut on kutsuttu.

curl -X POST https://app.coredash.app/api/mcp \
  -H "Authorization: Bearer cdk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_uptime_monitor",
      "arguments": { "monitor_id": "6ad68c7a844fad80b752fd16", "limit": 48 }
    }
  }'

Vastaus on CoreDash API:n JSON-RPC-kääre, jossa tulos on JSON-merkkijonona kentässä result.content[0].text. Tuntematon monitori antaa siinä arvon { "error": "Monitor not found" }, ja result.isError on true.

Lisää uptimesta ja CoreDash API:sta

• Uptime-seuranta: mitä CoreDash tarkistaa ja mitä näet sovelluksessa.
• CoreDash API: projektiavaimet, JSON-RPC-muoto ja RUM-työkalut.
• Agency API: master-avaimet ja projektit RESTin kautta.
• CoreDash bot: user agent, X-CoreDash-Bot-header ja osoitteet.
• Päästä CoreDash palomuurisi läpi: monitorille, jonka tilana on Estetty.