मुख्य सामग्री पर जाएं
हेल्थ और मॉनिटरिंग

क्या probe करना है, क्या देखना है और probes आपको क्या नहीं बता सकते।

Markdown

Probes​

Endpointउत्तरउपयोग
GET /health/liveजब तक process अनुरोध सर्व कर रहा है, 200 {"status":"ok"}Liveness
GET /health/readyPostgreSQL के उत्तर देने पर 200 {"status":"ok"}, अन्यथा 503 {"status":"unavailable"}Readiness: ट्रैफ़िक केवल तैयार होने के बाद भेजें
livenessProbe:
httpGet: { path: /health/live, port: 8080 }
readinessProbe:
httpGet: { path: /health/ready, port: 8080 }
timeoutSeconds: 5

Readiness probe पर timeoutSeconds सेट करें। यदि PostgreSQL कनेक्शन स्वीकार करता है लेकिन उत्तर देना बंद कर देता है, तो जाँच उससे कहीं अधिक देर तक प्रतीक्षा कर सकती है, और timeout probe को अटकने के बजाय विफल कर देता है।

Readiness क्या नहीं जाँचता​

Readiness केवल डेटाबेस जाँचता है। यह नहीं जाँचता कि access key वैध है या Unico तक पहुँचा जा सकता है। गलत access key create पर errors के रूप में दिखती है, विफल probe के रूप में नहीं। अपनी post-deployment जाँचों में एक वास्तविक create अनुरोध शामिल करें।

लॉग​

लॉग standard output पर JSON lines होते हैं, जिनमें timestamp, severity, service और message होते हैं। किसी संग्रहीत process से जुड़ी विफलताओं में उसका id शामिल होता है। कॉलर की गलतियाँ (400, 404, 409, 422) लॉग नहीं की जातीं।

स्वस्थ स्टार्ट PostgreSQL कनेक्शन संदेशों के बीच ये लाइनें इसी क्रम में लॉग करता है (catalog का version और count हर catalog release के साथ बदलते हैं):

{"severity":"INFO","timestamp":"2026-11-03T14:02:11.482913407Z","message":"attribute catalog loaded","service":"human-plugin","version":"2026-10-29.1","count":53,"url":"https://human-token-assets.unico.app/attribute-catalog.json"}
{"severity":"INFO","timestamp":"2026-11-03T14:02:11.731050212Z","message":"database schema ready","service":"human-plugin"}
{"severity":"INFO","timestamp":"2026-11-03T14:02:11.733418901Z","message":"human plugin listening","service":"human-plugin","addr":":8080"}

किन पर alert लगाएँ​

  • Readiness विफल हो रहा है: डेटाबेस पहुँच से बाहर है।
  • आपके back-end के कॉल्स पर बार-बार 503 DATABASE_UNAVAILABLE या 502 UPSTREAM_UNAVAILABLE उत्तर।
  • Container रीस्टार्ट: रीस्टार्ट लूप का मतलब आमतौर पर कोई सेटिंग गायब है, catalog पहुँच से बाहर है या डेटाबेस की समस्या है। लॉग बताता है कि कौन सी।
  • Error-level लॉग लाइनें, जैसे creating process या retrieving process।

Human Plugin metrics export नहीं करता। अनुरोध दरों और latency के लिए अपने gateway या service mesh का उपयोग करें।