Genkit मॉनिटरिंग का इस्तेमाल शुरू करना

इस शुरुआती गाइड में, डिप्लॉय की गई Genkit सुविधाओं के लिए, Firebase Genkit मॉनिटरिंग को सेट अप करने का तरीका बताया गया है. इससे, रीयल-टाइम में टेलीमेट्री डेटा इकट्ठा और देखा जा सकता है. Firebase Genkit मॉनिटरिंग की मदद से, आपको यह जानकारी मिलती है कि Genkit की सुविधाएं प्रोडक्शन में कैसा परफ़ॉर्म कर रही हैं.

Firebase Genkit मॉनिटरिंग की मुख्य सुविधाएं:

• Genkit की सुविधा के इंतज़ार का समय, गड़बड़ियां, और टोकन के इस्तेमाल जैसी संख्या वाली मेट्रिक देखना.
• Genkit की सुविधा के चरणों, इनपुट, और आउटपुट को देखने के लिए ट्रेस की जांच करना, ताकि डीबग करने और क्वालिटी को बेहतर बनाने में मदद मिल सके.
• Genkit में आकलन करने के लिए, प्रोडक्शन ट्रैक एक्सपोर्ट करना.

Genkit मॉनिटरिंग को सेट अप करने के लिए, आपको अपने कोडबेस और Google Cloud Console, दोनों में टास्क पूरे करने होंगे.

शुरू करने से पहले

1. अगर आपने पहले से कोई Firebase प्रोजेक्ट नहीं बनाया है, तो एक प्रोजेक्ट बनाएं.

   Firebase कंसोल में, प्रोजेक्ट जोड़ें पर क्लिक करें. इसके बाद, स्क्रीन पर दिए गए निर्देशों का पालन करें. आपके पास नया प्रोजेक्ट बनाने या किसी मौजूदा Google Cloud प्रोजेक्ट में Firebase की सेवाएं जोड़ने का विकल्प है.

2. पक्का करें कि आपका प्रोजेक्ट, Blaze के प्लान पर हो.

   Genkit Monitoring, Google Cloud के लॉगिंग, मेट्रिक, और ट्रेस में रिकॉर्ड किए गए टेलीमेट्री डेटा पर निर्भर करती है. ये सेवाएं पैसे चुकाकर ली जाती हैं. कीमत की जानकारी और बिना शुल्क वाले टीयर की सीमाओं के बारे में जानने के लिए, Google Cloud की निगरानी की सुविधा की कीमत पेज देखें.

3. शुरू करने की गाइड का पालन करके, Genkit की सुविधा लिखें. इसके बाद, इनमें से किसी एक गाइड का इस्तेमाल करके, अपने कोड को डिप्लॉयमेंट के लिए तैयार करें:

   1. Firebase के लिए Cloud Functions का इस्तेमाल करके फ़्लो डिप्लॉय करना
   2. Cloud Run का इस्तेमाल करके फ़्लो डिप्लॉय करना
   3. किसी भी Node.js प्लैटफ़ॉर्म पर फ़्लो डिप्लॉय करना

पहला चरण. Firebase प्लग इन जोड़ना

अपने प्रोजेक्ट में @genkit-ai/firebase प्लग इन इंस्टॉल करें:

npm i –save @genkit-ai/firebase

enableFirebaseTelemetry को अपनी Genkit कॉन्फ़िगरेशन फ़ाइल (वह फ़ाइल जहां genkit(...) को शुरू किया जाता है) में इंपोर्ट करें और इसे इस तरह से कॉल करें:

import { enableFirebaseTelemetry } from '@genkit-ai/firebase';

enableFirebaseTelemetry();

दूसरा चरण. ज़रूरी एपीआई चालू करना

पक्का करें कि आपके Google Cloud प्रोजेक्ट के लिए, ये एपीआई चालू हों:

• Cloud Logging API
• Cloud Trace API
• Cloud Monitoring API

ये एपीआई, आपके प्रोजेक्ट के लिए एपीआई डैशबोर्ड में मौजूद होने चाहिए.

चरण 3. अनुमतियां सेट अप करना

Firebase प्लग इन को Google Cloud की लॉगिंग, मेट्रिक, और ट्रैक सेवाओं की पुष्टि करने के लिए, सेवा खाते का इस्तेमाल करना होगा.

Google Cloud IAM Console में, अपने कोड को चलाने के लिए कॉन्फ़िगर किए गए सेवा खाते को ये भूमिकाएं दें. Firebase के लिए Cloud Functions और Cloud Run के लिए, आम तौर पर डिफ़ॉल्ट कंप्यूट सेवा खाता इस्तेमाल किया जाता है.

• मॉनिटरिंग मेट्रिक राइटर (roles/monitoring.metricWriter)
• Cloud Trace एजेंट (roles/cloudtrace.agent)
• लॉग लेखक (roles/logging.logWriter)

चौथा चरण. (ज़रूरी नहीं) अपने कॉन्फ़िगरेशन की स्थानीय तौर पर जांच करना

डिप्लॉय करने से पहले, अपने Genkit कोड को लोकल तौर पर चलाकर यह पुष्टि की जा सकती है कि टेलीमेट्री डेटा इकट्ठा किया जा रहा है और वह Genkit मॉनिटरिंग डैशबोर्ड में दिख रहा है.

1. अपने स्थानीय एनवायरमेंट से टेलीमेट्री भेजने के लिए, अपने Genkit कोड में forceDevExport को true पर सेट करें.

2. अपने कॉन्फ़िगरेशन की पुष्टि करने और उसकी जांच करने के लिए, अपने सेवा खाते का इस्तेमाल करें.

   सलाह: सेवा खाते के नाम पर काम करने के लिए, आपके उपयोगकर्ता खाते पर roles/iam.serviceAccountTokenCreator आईएएम भूमिका लागू होनी चाहिए.

   Google Cloud CLI टूल की मदद से, सेवा खाते का इस्तेमाल करके पुष्टि करें:

   gcloud auth application-default login --impersonate-service-account SERVICE_ACCT_EMAIL

3. Genkit की सुविधा को चलाएं और चालू करें. इसके बाद, Genkit मॉनिटरिंग डैशबोर्ड पर मेट्रिक देखें. पहली मेट्रिक इकट्ठा होने में पांच मिनट लग सकते हैं. टेलीमेट्री कॉन्फ़िगरेशन में metricExportIntervalMillis सेट करके, इस देरी को कम किया जा सकता है.

4. अगर Genkit मॉनिटरिंग डैशबोर्ड में मेट्रिक नहीं दिख रही हैं, तो डीबग करने के लिए, समस्या हल करने से जुड़ी गाइड देखें.

पांचवां चरण. कोड को फिर से बनाना और डिप्लॉय करना

डेटा इकट्ठा करना शुरू करने के लिए, अपनी Genkit सुविधा को फिर से बनाएं, डिप्लॉय करें, और उसे चालू करें. Genkit Monitoring को आपकी मेट्रिक मिलने के बाद, उन्हें देखने के लिए Genkit Monitoring डैशबोर्ड पर जाएं

ध्यान दें: पहली मेट्रिक इकट्ठा करने में पांच मिनट लग सकते हैं. यह समय, टेलीमेट्री कॉन्फ़िगरेशन में डिफ़ॉल्ट metricExportIntervalMillis सेटिंग के आधार पर तय होता है.