विश्वासार्हता निरीक्षण

निरीक्षण एका collection ला एका पाहिल्या जाणाऱ्या रूटिंग चेनमध्ये बदलते. जेव्हा एखाद्या collection चे निरीक्षण केले जाते, तेव्हा गेटवे एका शेड्यूलवर प्रत्येक स्टेपच्या विरुद्ध एक छोटा सर्व्हर-साइडcanary चालवतो — साधारण दर 5 मिनिटांनी — आणि नोंदवतो की प्रत्येक स्टेप चालू आहे की नाही आणि त्याने किती लवकर उत्तर दिले. हा इतिहास collection पेजवर दाखवल्या जाणाऱ्या प्रति-स्टेप uptime आणि latency ला चालवतो, आणि तुम्ही कॉन्फिगर केलेल्या अलर्ट थ्रेशोल्डला फीड करतो.

बीटा दरम्यान निःशुल्क. Canaries गेटवे-अंतर्गत चालतात — प्रति स्टेप एक सिंगल वन-टोकन ping — आणि तुमच्या वॉलेटमधून कधीही डेबिट करत नाहीत.

निरीक्षण चालू करा

तुमच्या मालकीच्या एखाद्या collection (owner/admin) साठी निरीक्षण टॉगल करा. पहिला canary लगेच चालतो जेणेकरून पेज रिकामे राहू नये; ठरवलेल्या तपासण्या त्यानंतर सुरू राहतात.

POST /me/collections/:slug/monitor
{ "monitored": true }                 // omit or false to turn off
→ { "ok": true, "monitored": true,
    "note": "Monitoring on — first canary running now; scheduled checks follow." }

प्रति-स्टेप आरोग्य

प्रत्येक canary तोच रूट निवडतो जो एक खरी रिक्वेस्ट निवडते आणि स्टेपच्या model/provider ला एक वन-टोकन pingपाठवतो, जो up/down आणि latency नोंदवतो. GET /me/collections/:slug/healthप्रति स्टेप, एका विंडोवर (डिफॉल्ट 7 दिवस; ?days= 1–90) uptime आणि p95 latencyआणि शेवटचा canary वेळ परत करतो. कोणताही सदस्य हे वाचू शकतो.

GET /me/collections/india-first-llama/health?days=7
→ { "monitored": true,
    "health": [
      { "model": "llama-3.1-8b-instruct", "provider": "bharatrouter",
        "uptime": 0.998, "p95_ms": 820, "checks": 2014,
        "last_check": "2026-06-15T09:35:00Z" },
      { "model": "llama-3.1-8b-instruct", "provider": "krutrim",
        "uptime": 1.0, "p95_ms": 540, "checks": 2014, "last_check": "..." }
    ] }

uptime हा 0–1 मधील एक अंश आहे (यशस्वी canaries ÷ एकूण) आणि p95_ms विंडोवरील 95व्या-शतमानाची latency; दोन्ही पहिली तपासणी येईपर्यंत null राहतात.POST /me/collections/:slug/check सह ऑन-डिमांड तपासणी चालवा, जी आता प्रत्येक स्टेप canary करते, अलर्टचे मूल्यमापन करते, आणि ताजे आरोग्य परत करते.

अलर्ट

एखादे मीट्रिक अलीकडच्या विंडोमध्ये तुमचा थ्रेशोल्ड ओलांडल्यावर एक अलर्ट ट्रिगर होतो. उल्लंघनावर BharatRouter एक email पाठवतो आणि/किंवा एक webhook POST करतो, मग त्या अलर्टसाठी 24 तास शांत राहतो (dedupe). Owners/admins अलर्ट व्यवस्थापित करतात; तुम्हाला notify_email आणि/किंवा webhook_url प्रदान करावे लागते.

POST /me/collections/:slug/alerts
{
  "metric": "error_rate",         // or "latency_p95"
  "threshold": 0.1,               // error_rate: 0–1   |   latency_p95: ms
  "window_min": 60,               // window in minutes, 5–1440 (default 60)
  "notify_email": "[email protected]",
  "webhook_url": "https://hooks.acme.in/br"   // optional, public http(s) only
}
→ { "ok": true, "alert": { "id": 3, "metric": "error_rate", "threshold": 0.1,
      "window_min": 60, "notify_email": "[email protected]", "webhook_url": null } }

webhook_url हा एक सार्वजनिक http(s) एंडपॉइंट असला पाहिजे — तोच SSRF गार्ड जो BYOE मध्ये आहे, loopback, खाजगी आणि क्लस्टर-अंतर्गत होस्ट नाकारतो. उल्लंघनावर गेटवे एक कॉम्पॅक्ट JSON इव्हेंट POST करतो जो तुम्ही Slack, Discord किंवा कोणत्याही कस्टम इनजेस्टवर रूट करू शकता:

POST <your webhook>   Content-Type: application/json
{ "event": "alert", "collection": "india-first-llama", "name": "India-first Llama",
  "metric": "error_rate", "threshold": 0.1,
  "breach": "error rate 22% ≥ 10% (last 60m)",
  "at": "2026-06-15T09:40:00Z",
  "text": "⚠ BharatRouter: \"India-first Llama\" — error rate 22% ≥ 10% (last 60m)" }

एजंट्सकडून (MCP)

हीच सरफेस एजंट्ससाठी MCP वर उपलब्ध आहे: