Looker डैशबोर्ड की खास जानकारी देने वाला एक्सटेंशन कोडलैब

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

इस कोडलैब (1) में, Looker डैशबोर्ड की खास जानकारी वाला एक्सटेंशन स्थानीय तौर पर सेट अप किया जा सकता है. इसके बाद, इसे स्थानीय तौर पर आज़माया जा सकता है और डेवलप किया जा सकता है. इसके बाद (2) आपको एक्सटेंशन को प्रोडक्शन में डिप्लॉय करना होगा, ताकि आपके Looker इंस्टेंस में मौजूद दूसरे उपयोगकर्ता इसका इस्तेमाल कर सकें. आखिर में, (3) एक्सटेंशन के फ़ंक्शन को बेहतर बनाने और उसे बेहतर करने के लिए, कुछ और तरीके भी अपनाए जा सकते हैं. जो सेक्शन ज़रूरी नहीं हैं उन्हें एक क्रम में पूरा किया जाना चाहिए.

Looker डैशबोर्ड की खास जानकारी देने वाले एक्सटेंशन की खास जानकारी

Looker डैशबोर्ड की खास जानकारी देने वाला एक्सटेंशन, फ़ंक्शन के तौर पर आपके Looker डैशबोर्ड के डेटा को Vertex AI के Gemini मॉडल को भेजता है. इसके बाद, Gemini मॉडल आपके डैशबोर्ड के डेटा की खास जानकारी और अगले चरणों के बारे में जानकारी देता है. यह एक्सटेंशन, खास जानकारी और अगले चरणों को आपके डैशबोर्ड में एक टाइल के तौर पर दिखाता है. इसे आपके डैशबोर्ड के अनुभव के साथ इंटिग्रेट किया जाता है. इसके अलावा, यह एक्सटेंशन खास जानकारी और अगले चरणों को Slack या Google Chat में एक्सपोर्ट कर सकता है. यह एक्सटेंशन, Vertex AI के Gemini मॉडल से डेटा भेजने और पाने के लिए, Websocket बैकएंड सेवा के साथ React फ़्रंटएंड ऐप्लिकेशन का इस्तेमाल करता है.

ज़रूरी शर्तें

• नोड डेवलपमेंट, Docker, और Teraform के बारे में बुनियादी जानकारी
• Looker LookML प्रोजेक्ट सेट अप करने के बारे में जानकारी

आपको इनके बारे में जानकारी मिलेगी

• एक्सटेंशन को स्थानीय तौर पर सेट अप और डेवलप करने का तरीका
• एक्सटेंशन को प्रोडक्शन में कैसे डिप्लॉय करें, ताकि आपके Looker इंस्टेंस में दूसरे Looker उपयोगकर्ता इसका इस्तेमाल कर सकें
• एक्सटेंशन के परफ़ॉर्मेंस को बेहतर बनाने और उसकी सुविधाओं को बढ़ाने का तरीका.
• प्रोडक्शन में डिप्लॉय किए गए एक्सटेंशन को मैनेज करने का तरीका

आपको इन चीज़ों की ज़रूरत होगी

• Looker इंस्टेंस, जो Looker के ओरिजनल लाइसेंस, चालू Looker Core ट्रायल या चालू Looker Core लाइसेंस की मदद से हो सकता है.
• आपके Looker इंस्टेंस पर develop और deploy की अनुमतियां.
• डैशबोर्ड में बदलाव करने की अनुमतियां, जिसे आपको एक्सटेंशन इस्तेमाल करके आज़माना है.
• आपके Looker इंस्टेंस से मिली Looker API कुंजी.
• ऐसा Google Cloud प्रोजेक्ट जिस पर बिलिंग की सुविधा चालू हो.
• प्रोजेक्ट के लिए Cloud Run API, Vertex AI API, और Artifact Registry API चालू किए गए थे.
• ऐसे लोकल एनवायरमेंट का ऐक्सेस जिनमें gcloud सीएलआई इंस्टॉल किया गया हो. कोडलैब के चरण, Linux स्टाइल एनवायरमेंट के होते हैं.

2. लोकल डेवलपमेंट के लिए बैकएंड सेटअप करें

इस सेक्शन में, आपको अपने लिए वेबसॉकेट बैकएंड सेवा सेट अप करनी होगी. साथ ही, उसे स्थानीय तौर पर डेवलप करना होगा. सेवा के पास Vertex AI का ऐक्सेस होगा.

1. आपको अपने लोकल एनवायरमेंट में, नोड का 18 या उसके बाद का वर्शन इंस्टॉल करना होगा. Node इंस्टॉल करने के लिए इन दिशा-निर्देशों का पालन करें.
2. एक्सटेंशन की डेटा स्टोर करने की जगह को अपनी लोकल होम डायरेक्ट्री में क्लोन करें और डेटा स्टोर करने की जगह की रूट डायरेक्ट्री पर जाएं. इस कोडलैब के लिए, सभी कोड सैंपल को यह मान लिया जाएगा कि आपकी क्लोन की गई रिपॉज़िटरी (डेटा स्टोर करने की जगह) आपकी लोकल होम डायरेक्ट्री में मौजूद है.

cd ~
git clone [e-mail]:looker-open-source/dashboard-summarization.git

3. क्लोन किए गए रिपॉज़िटरी की रूट डायरेक्ट्री पर जाएं और .env.example फ़ाइल का नाम बदलकर .env करें, ताकि आप इस कोडलैब के बाद के सेक्शन में एनवायरमेंट वैरिएबल सेट कर सकें.

cd ~/dashboard-summarization
mv .env.example .env

4. क्लोन किए गए रिपॉज़िटरी के वेब सॉकेट बैकएंड की src डायरेक्ट्री में जाएं. इस डायरेक्ट्री में सर्वर का सोर्स कोड होता है.

cd ~/dashboard-summarization/websocket-service/src   

5. NPM के साथ सेवा की डिपेंडेंसी इंस्टॉल करें.

npm install  

6. looker-example.ini फ़ाइल का नाम बदलकर looker.ini करें.

mv looker-example.ini looker.ini  

7. Looker.ini फ़ाइल अपडेट के अंदर:
8. client_id और client_secret, जो आपके Looker API पासकोड से जुड़े हैं.
9. base_url आपके Looker इंस्टेंस के यूआरएल के साथ: https://<YOUR_LOOKER_URL_MINUS_PROTOCOL>:19999
10. आपके Looker इंस्टेंस के यूआरएल के होस्ट के साथ ब्रैकेट (सेक्शन हेडर) के बीच का टेक्स्ट.

उदाहरण के लिए, अगर आपका क्लाइंट आईडी ABC123 है, आपका क्लाइंट सीक्रेट XYZ789 है, और आपके Looker इंस्टेंस का यूआरएल https://mycompany.cloud.looker.com है, तो आपकी looker.ini फ़ाइल कुछ ऐसी दिखेगी:

[mycompany]
base_url=https://mycompany.cloud.looker.com:19999
client_id=ABC123
client_secret=XYZ789
verify_ssl=true 

8. अपना Google Cloud प्रोजेक्ट आईडी तय करें और उसे अपने PROJECT एनवायरमेंट वैरिएबल पर सेट करें. YOUR_PROJECT_ID की जगह अपना प्रोजेक्ट आईडी डालें.

export PROJECT="YOUR_PROJECT_ID"

9. Vertex AI में Gemini मॉडल को यहां दिए गए कई इलाकों में इस्तेमाल किया जा सकता है. तय करें कि आपका लोकल बैकएंड, Vertex AI के Gemini मॉडल से किस इलाके का डेटा भेजेगा और किस इलाके में डेटा भेजेगा. क्षेत्र को अपने REGION एनवायरमेंट वैरिएबल पर सेट करें. YOUR_VERTEX_REGION को अपने देश या इलाके, जैसे कि us-central1 से बदलें.

export REGION="YOUR_VERTEX_REGION"

10. अब अपनी स्थानीय सेवा शुरू करें.

npm start

11. आपकी स्थानीय websocket बैकएंड सेवा, http://localhost:5000 पर चलेगी.

अब आपने अपने लोकल एनवायरमेंट में websocket बैकएंड सेवा को सेट अप कर लिया है!!

यह सेवा, आपके फ़्रंटएंड एक्सटेंशन और Vertex AI के Gemini मॉडल के बीच इंटरफ़ेस की तरह काम करती है. यह सेवा, आपके फ़्रंटएंड एक्सटेंशन से डैशबोर्ड और LookML डेटा लेकर, Looker से क्वेरी किए गए डेटा को ऐक्सेस कर सकती है. साथ ही, Vertex AI के Gemini मॉडल को प्रॉम्प्ट भेज देगी. इसके बाद, वह सेवा आपके डैशबोर्ड पर दिखने वाले फ़्रंटएंड एक्सटेंशन के लिए, Gemini के जवाब को स्ट्रीम करेगी.

बैकएंड सेवा के सोर्स कोड में भी बदलाव किए जा सकते हैं. आपको सबसे पहले सेवा की प्रोसेस को रोकना होगा, कोड में बदलाव करना होगा. इसके बाद, npm start को फिर से चलाना होगा.

ध्यान दें: आपकी स्थानीय Websocket बैकएंड सेवा, Vertex AI को कॉल करेगी.

3. लोकल डेवलपमेंट के लिए फ़्रंटएंड सेटअप करें

इस सेक्शन में फ़्रंटएंड एक्सटेंशन को स्थानीय तौर पर आज़माने और डेवलप करने के लिए सेट अप किया जा सकता है.

1. पिछले चरणों वाले उसी स्थानीय एनवायरमेंट में, अपने क्लोन किए गए डेटा स्टोर करने की जगह की रूट डायरेक्ट्री पर जाएं और अपने फ़्रंटएंड के लिए फ़्रंटएंड सर्वर की डिपेंडेंसी इंस्टॉल करें.

cd ~/dashboard-summarization
npm install

2. अपना लोकल फ़्रंटएंड डेवलपमेंट सर्वर शुरू करें

npm run develop

3. आपका स्थानीय फ़्रंटएंड सर्वर अब http://localhost:8080/bundle.js पर एक्सटेंशन की JavaScript सेवा दे रहा है.
4. वेब ब्राउज़र खोलें और अपने Looker इंस्टेंस में लॉगिन करें.
5. खाली LookML प्रोजेक्ट सेट अप करने के लिए, इन निर्देशों का पालन करें. प्रोजेक्ट के डैशबोर्ड की खास जानकारी को नाम दें. अब आपके मौजूदा ब्राउज़र टैब के Looker IDE में, LookML प्रोजेक्ट अपने-आप खाली हो जाएगा.
6. LookML प्रोजेक्ट के रूट में प्रोजेक्ट मेनिफ़ेस्ट फ़ाइल बनाएं. इस फ़ाइल को Manifest.lKML कहा जाएगा. अगर आपको इसका तरीका नहीं पता है, तो LookML प्रोजेक्ट में कोई फ़ाइल जोड़ने के लिए इन निर्देशों का पालन करें.
7. अपनी बंद डेटा स्टोर करने की जगह की रूट डायरेक्ट्री में, नई Manifest.lKML फ़ाइल के कॉन्टेंट को Manifest.lKML के कॉन्टेंट से बदलें. "बदलाव सेव करें" चुनें बटन क्लिक करें.
8. किसी अलग ब्राउज़र टैब में, अपने Looker इंस्टेंस में डेटाबेस कनेक्शन की सूची पर जाएं. अगर आपको इसका तरीका नहीं पता है, तो इन निर्देशों का पालन करें.
9. Looker डेटाबेस के एक कनेक्शन का नाम चुनें. इससे कोई फ़र्क़ नहीं पड़ता कि आपने कौनसा कनेक्शन चुना है. अगर आपके पास डेटाबेस कनेक्शन देखने की अनुमति नहीं है, तो अपने Looker एडमिन से संपर्क करें और एक Looker डेटाबेस कनेक्शन का नाम पूछें.
10. Looker IDE में खोले गए अपने LookML प्रोजेक्ट के साथ ब्राउज़र टैब पर वापस जाएं. अपने LookML प्रोजेक्ट में एक मॉडल फ़ाइल बनाएं और फ़ाइल के डैशबोर्ड का नाम रखें.
11. अपनी डैशबोर्ड-summarization.model.lKML फ़ाइल के कॉन्टेंट को नीचे दिए गए कोड सैंपल से बदलें. डबल कोट में मौजूद स्ट्रिंग को, नौवें चरण में चुने गए डेटाबेस कनेक्शन के नाम से बदलना न भूलें. फ़ाइल में किए गए बदलावों को सेव करें.

connection: "<YOUR_CONNECTION_NAME>"

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

12. अपना प्रोजेक्ट सेव करने के लिए, डेटा स्टोर करने की जगह सेट अप करें. "Git कॉन्फ़िगर करें" चुनें बटन पर क्लिक करें. "इसके बजाय, डेटा स्टोर करने की जगह सेट अप करें" को चुनें. "डेटा स्टोर करने की जगह बनाएं" चुनें.
13. अब आपके पास LookML प्रोजेक्ट की फ़ाइलों को सेव करने के लिए, एक बुनियादी डेटा स्टोर करने की जगह है. Looker IDE में प्रोजेक्ट पर वापस जाने के लिए, "प्रोजेक्ट पर वापस जाएं" चुनें या मैन्युअल तरीके से वापस नेविगेट करें.
14. " LookML की पुष्टि करें" चुनें बटन पर क्लिक करें. बटन "बदलाव लागू करें और पुश करें" में बदल जाएगा.
15. ""बदलाव लागू करें और पुश करें" चुनें बटन. कोई भी मैसेज जोड़ें और "समीक्षा करें" चुनें.
16. "प्रोडक्शन के लिए डिप्लॉय करें" चुनें Looker IDE के ऊपरी दाएं कोने में मौजूद है. अब आपने अपने Looker इंस्टेंस में एक्सटेंशन जोड़ लिया है!
17. उस Looker डैशबोर्ड पर जाएं जिसमें आपको एक्सटेंशन जोड़ना है.
18. अपने डैशबोर्ड में एक्सटेंशन टाइल जोड़ने के लिए, निर्देशों का पालन करें. अपने नए एक्सटेंशन को डैशबोर्ड पर टाइल के तौर पर जोड़ें.
19. पक्का करें कि आपने पहले जो लोकल WebSocket बैकएंड सेवा सेट अप की थी वह काम कर रही हो.

बधाई हो! अब अपने डैशबोर्ड में, Looker डैशबोर्ड की खास जानकारी देने वाले एक्सटेंशन का इस्तेमाल किया जा सकता है. आपका एक्सटेंशन, आपके डैशबोर्ड का मेटाडेटा, आपकी स्थानीय वेबसॉकेट बैकएंड सेवा को भेजेगा. साथ ही, आपकी बैकएंड सेवा से मिले Gemini के आउटपुट को डैशबोर्ड के एक्सटेंशन टाइल में दिखाएगा.

जब आपका लोकल फ़्रंटएंड सर्वर चल रहा हो, तो आप एक्सटेंशन के JavaScript सोर्स कोड में बदलाव कर सकते हैं. इससे सर्वर अपने-आप बदलावों को तैयार करके दिखाएगा. बदलाव देखने के लिए, आपको अपने एक्सटेंशन या डैशबोर्ड पेज को फिर से लोड करना होगा.

ध्यान दें: इस कोडलैब के आखिर में दिए गए 'ज़रूरी नहीं' सेक्शन को फ़ॉलो करके, एक्सटेंशन को Slack या GChat पर एक्सपोर्ट करने के लिए, अपने एक्सटेंशन की खास जानकारी को एक्सपोर्ट करने की सुविधा चालू की जा सकती है.

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

4. प्रोडक्शन में बैकएंड डिप्लॉय करें

इस सेक्शन में, अब आपको अपने Looker इंस्टेंस में किसी भी डैशबोर्ड पर, डैशबोर्ड की खास जानकारी देने वाले एक्सटेंशन के किसी भी इंस्टेंस को दिखाने के लिए, websocket बैकएंड सेवा सेट अप करनी होगी. इससे Looker के अन्य उपयोगकर्ता, अपने डैशबोर्ड में एक्सटेंशन को आज़मा सकेंगे. इसके लिए, उन्हें अपनी बैकएंड सेवा सेट अप करने की ज़रूरत नहीं होगी. इन चरणों का मतलब है कि आपने पहले ही उसी लोकल एनवायरमेंट में बैकएंड को लोकल डेवलपमेंट के लिए डिप्लॉय किया है.

1. अगले चरणों में जाने के लिए, अपने प्रोजेक्ट आईडी की मदद से अपने डिवाइस में ऐप्लिकेशन का डिफ़ॉल्ट क्रेडेंशियल सेट अप करें. इसके लिए, इन निर्देशों का पालन करें.
2. अपनी बैकएंड सेवा की Docker इमेज के लिए, Artifact Registry का रिपॉज़िटरी बनाएं. YOUR_REGION को उस देश या इलाके से बदलें जहां आपको अपना डेटा स्टोर करना है.

gcloud artifacts repositories create dashboard-summarization-repo \
    --repository-format=docker \
    --location=YOUR_REGION \

3. क्लोन किए गए रिपॉज़िटरी के वेब सॉकेट बैकएंड की src डायरेक्ट्री में जाएं.

cd ~/dashboard-summarization/websocket-service/src

4. cloudbuild.yaml फ़ाइल में बदलाव करें. साथ ही, YOUR_REGION और YOUR_PROJECT_ID के सभी इंस्टेंस को, अपने क्षेत्र और प्रोजेक्ट आईडी से बदलें. फ़ाइल में किए गए बदलावों को सेव करें.
5. Cloud Build का इस्तेमाल करके बिल्ड सबमिट करें. इससे बैकएंड सेवा की Docker इमेज बनेगी. साथ ही, उसे अभी बनाए गए Artifact Registry के रेपो में भेज दिया जाएगा. YOUR_REGION की जगह उस देश या इलाके का नाम चुनें जहां आपको Cloud Build की सेवा का इस्तेमाल करना है.

gcloud builds submit --region=YOUR_REGION --config cloudbuild.yaml

6. याद रखें कि आपका नया बनाया गया Docker इमेज यूआरएल, YOUR_REGION-docker.pkg.dev/YOUR_PROJECT_ID/dashboard-summarization-repo/websocketserviceimage:latest पर है. YOUR_PROJECT_ID की जगह अपना प्रोजेक्ट आईडी डालें. YOUR_REGION की जगह वह क्षेत्र डालें जो आपने Artifact Registry का डेटा स्टोर करने की जगह बनाने के लिए दूसरे चरण में इस्तेमाल किया था.
7. अपनी क्लोन की गई रिपॉज़िटरी में websocket-service/terraform डायरेक्ट्री पर जाएं.

cd ~/dashboard-summarization/websocket-service/terraform

8. तय करें कि आप अपनी वेबसॉकेट बैकएंड सेवा को Google Cloud Run के किस स्थान पर चलाना चाहते हैं. इन जगहों में से चुनें.
9. वैरिएबल.tf फ़ाइल में बदलाव करें. साथ ही, YOUR_PROJECT_ID और YOUR_DOCKER_IMAGE_URL को सही वैल्यू से बदलें. अपने डॉकर इमेज यूआरएल के लिए छठा चरण देखें. YOUR_REGION को उस देश या इलाके से बदलें जिसे आपने पिछले चरण 8 में चुना था. फ़ाइल में किए गए बदलावों को सेव करें.
10. टेराफ़ॉर्म का इस्तेमाल करके उन संसाधनों को डिप्लॉय करें जिन्हें आपकी बैकएंड सेवा इस्तेमाल करेगी.

terraform init
terraform plan
terraform apply

11. अगले सेक्शन के लिए, डिप्लॉय किए गए Cloud Run यूआरएल एंडपॉइंट को सेव करें.

बधाई हो! आपने अपनी websocket बैकएंड सेवा को डिप्लॉय कर लिया है और अब यह Google Cloud Run पर चल रही है. अब Looker डैशबोर्ड की खास जानकारी वाले एक्सटेंशन का कोई भी इंस्टेंस, आपकी बैकएंड सेवा से संपर्क कर सकता है. हमारा सुझाव है कि आप हमेशा अपनी Websocket बैकएंड सेवा का कम से कम एक इंस्टेंस, Cloud Run पर चालू रखें. आपकी बैकएंड सेवा लगातार बनी रहती है. इससे आपकी Websocket बैकएंड सेवा और एक्सटेंशन के फ़्रंटएंड के बीच डेटा स्ट्रीमिंग में कोई रुकावट नहीं आती. साथ ही, जब उपयोगकर्ता आपके एक्सटेंशन का इस्तेमाल करता है, तो उसके सेशन को बनाए रखने में भी मदद मिलती है.

ध्यान दें: इस कोड लैब में, क्लाउड पर चलने वाली वेबसॉकेट बैकएंड सेवा को सार्वजनिक तौर पर दिखाया जाता है.

ध्यान दें: जब भी कोई उपयोगकर्ता, एक्सटेंशन फ़्रंटएंड को डैशबोर्ड के लिए खास जानकारी बनाने के लिए कहेगा, तब बैकएंड सेवा, डैशबोर्ड में हर क्वेरी के लिए Vertex AI को कॉल करेगी. साथ ही, सारे जवाब को फ़ॉर्मैट करने के लिए एक फ़ाइनल कॉल भी करेगी. Vertex AI की मदद से, अपनी बैकएंड सेवा के लिए कॉल की जानकारी को लॉग किया जा सकता है. इससे, लागत का अनुमान लगाने और उसे मॉनिटर करने में मदद मिलती है. "Gemini मॉडल में लॉग इकट्ठा करने की सुविधा सेट अप करें" पर जाएं का एक वैकल्पिक सेक्शन देखें और जानें कि कैसे.

5. प्रोडक्शन में फ़्रंटएंड डिप्लॉय करना

इस आखिरी सेक्शन में, एक्सटेंशन फ़्रंटएंड को डिप्लॉय करने के आखिरी चरण को पूरा किया जाएगा, ताकि यह आपके Looker इंस्टेंस में सभी Looker उपयोगकर्ताओं के लिए उपलब्ध हो.

1. क्लोन किए गए रिपॉज़िटरी की रूट डायरेक्ट्री पर जाएं.

cd ~/dashboard-summarization

2. किसी दस्तावेज़ में बदलाव करने के लिए, .env फ़ाइल. YOUR_CLOUD_RUN_URL को पिछले सेक्शन के Cloud Run यूआरएल एंडपॉइंट से बदलें. फ़ाइल में किए गए बदलावों को सेव करें. इससे प्रोडक्शन एक्सटेंशन फ़्रंटएंड, Cloud Run पर चल रही आपकी Websocket बैकएंड सेवा से कनेक्ट हो जाएगा.
3. एक्सटेंशन की JavaScript बनाएं. bundle.js फ़ाइल और अन्य फ़ाइलों के साथ, dist डायरेक्ट्री अपने-आप जनरेट हो जाएगी.

npm run build

4. वेब ब्राउज़र खोलें और अपने Looker इंस्टेंस में लॉगिन करें. साइड में बाईं ओर मौजूद नेविगेशन खोलें और "डेवलपमेंट मोड" चालू करें नीचे टॉगल करें.
5. बाईं ओर मौजूद नेविगेशन पैनल खोलने के बाद, "डेवलप करें" चुनें. इसके बाद, नीचे की ओर स्क्रोल करें और अपने एक्सटेंशन के LookML प्रोजेक्ट, "डैशबोर्ड-समरीाइज़ेशन" को चुनें. अब आपको LookML प्रोजेक्ट के लिए, Looker IDE में होना चाहिए.
6. पहले से जनरेट की गई डिस्ट डायरेक्ट्री की सभी फ़ाइलों को खींचकर "फ़ाइल ब्राउज़र" में, प्रोजेक्ट की रूट डायरेक्ट्री में छोड़ें. अगर आपको और मदद चाहिए, तो इन निर्देशों का पालन करें.
7. Looker IDE में manifest.lkml फ़ाइल खोलें. फ़ाइल के अंदर, लाइन को बदलें

url: "http://localhost:8080/bundle.js"

के साथ

file: "bundle.js"

YOUR_CLOUD_RUN_URL को आखिरी सेक्शन के आखिर से, Cloud Run यूआरएल एंडपॉइंट से बदलें. फ़ाइल में किए गए बदलावों को सेव करें.

8. " LookML की पुष्टि करें" चुनें बटन पर क्लिक करें. बटन "बदलाव लागू करें और पुश करें" में बदल जाएगा.
9. ""बदलाव लागू करें और पुश करें" चुनें बटन. कोई भी मैसेज जोड़ें और "समीक्षा करें" चुनें.
10. "प्रोडक्शन के लिए डिप्लॉय करें" चुनें Looker IDE के ऊपरी दाएं कोने में मौजूद है.

बधाई हो! अब आपने अपने Looker इंस्टेंस के सभी Looker उपयोगकर्ताओं को, अपने डैशबोर्ड में Looker डैशबोर्ड की खास जानकारी देने वाला एक्सटेंशन जोड़ने की सुविधा चालू कर दी है. जब Looker के अन्य उपयोगकर्ता इस एक्सटेंशन का इस्तेमाल करेंगे, तो एक्सटेंशन के सभी इंस्टेंस से Google Cloud Run पर चल रही आपकी डिप्लॉय की गई Websocket बैकएंड सेवा को कॉल किया जाएगा.

ध्यान रखें, अगर आपको सोर्स कोड में कोई बदलाव करना है, तो:

1. अपने एक्सटेंशन की JavaScript फिर से बनाएं
2. LookML प्रोजेक्ट में आपने जनरेट की गई जिन फ़ाइलों को जोड़ा है उन्हें dist डायरेक्ट्री से जनरेट की गई नई फ़ाइलों से बदलें.
3. LookML प्रोजेक्ट में किए गए बदलावों की पुष्टि करना, उन्हें लागू करना, और प्रोडक्शन में लागू करना

Looker डैशबोर्ड की खास जानकारी देने वाला एक्सटेंशन आज़माएं! हमारा सुझाव है कि आप एक्सटेंशन में योगदान दें, ताकि यह Looker कम्यूनिटी की ज़रूरतों को बेहतर तरीके से पूरा कर सके. कृपया डेटा स्टोर करने की जगह पर पुल का अनुरोध करें.

Slack/Google Chat से डेटा एक्सपोर्ट करने की सुविधा चालू करने, Gemini से मिलने वाली ख़ास जानकारी और अगले चरणों को बेहतर बनाने, और Gemini में लॉग इन करने की सुविधा सेट अप करने के लिए, इन सेक्शन को देखें. हालांकि, ऐसा करना ज़रूरी नहीं है.

6. [ज़रूरी नहीं] एक्सपोर्ट की सुविधाएं सेटअप करें

आपने और Looker के आपके उपयोगकर्ताओं ने, Looker डैशबोर्ड की खास जानकारी देने वाले एक्सटेंशन को आज़माया है. अब इस एक्सटेंशन की अहम जानकारी को ज़्यादा ऑडियंस के साथ शेयर किया जा सकता है. इस सेक्शन में दिए गए एक्सटेंशन को चालू करके, Google Chat या Slack पर खास जानकारी भेजें. साथ ही, यह भी जानें कि आगे क्या करना है. कोडलैब के इस सेक्शन का इस्तेमाल जारी रखने के लिए, आपको OAuth के सेटअप के बारे में जानकारी होनी चाहिए.

Google Chat में एक्सपोर्ट करने की सुविधा चालू करना

1. अपने Google Cloud प्रोजेक्ट में Chat API को चालू करें.
2. Google Workspace के OAuth सेट अप करने के निर्देशों के पहले चरण का पालन करें. दायरों के लिए, आपको spaces.messages.create को शामिल करना होगा.
3. Google Workspace OAuth को सेटअप करने के निर्देशों के दूसरे चरण का पालन करें. "अनुमति वाले JavaScript ऑरिजिन" में जाकर, अपने लुकर इंस्टेंस के यूआरएल को यूआरआई के तौर पर जोड़ें, जैसे कि https://mycompany.cloud.looker.com. जनरेट किए गए Client-ID को नोट करें.
4. Google Chat के उस स्पेस का आईडी तय करें जिसमें आपको खास जानकारी एक्सपोर्ट करनी है. अगर आपको इसका तरीका नहीं पता है, तो इन दिशा-निर्देशों का पालन करें.
5. किसी दस्तावेज़ में बदलाव करने के लिए, .env फ़ाइल. YOUR_GOOGLE_CLIENT_ID को Client-ID से बदलें. YOUR_GOOGLE_SPACE_ID की जगह Google Chat पर मौजूद स्पेस का आईडी डालें. फ़ाइल में किए गए बदलावों को सेव करें. इससे आपके एक्सटेंशन का फ़्रंटएंड कॉन्फ़िगर हो जाएगा, ताकि वह अपनी अहम जानकारी Google Chat पर मौजूद आपकी पसंद के स्पेस को भेज सके.
6. अगर आप अपने एक्सटेंशन का फ़्रंटएंड स्थानीय तौर पर चला रहे हैं, तो अपना एक्सटेंशन फिर से बनाएं. अगर आप अपने एक्सटेंशन के फ़्रंटएंड को डिप्लॉय कर रहे हैं, तो अपने एक्सटेंशन के फ़्रंटएंड को फिर से डिप्लॉय करें.

Slack एक्सपोर्ट चालू करें

1. OAuth ऐप्लिकेशन सेट अप करने के लिए, Slack डेवलपर के आधिकारिक दस्तावेज़ में दिए गए पहले और दूसरे चरण को अपनाएं. दायरों के लिए, आपको chat:write और channels:read को शामिल करना होगा. जनरेट किया गया क्लाइंट आईडी और क्लाइंट सीक्रेट नोट करें.
2. उस Slack चैनल का आईडी तय करें जिसमें आपको खास जानकारी एक्सपोर्ट करनी है.
3. किसी दस्तावेज़ में बदलाव करने के लिए, .env फ़ाइल. YOUR_SLACK_CLIENT_ID को Client-ID से बदलें. YOUR_SLACK_CLIENT_SECRET को क्लाइंट सीक्रेट से बदलें. YOUR_SLACK_CHANNEL_ID को चैनल आईडी से बदलें. फ़ाइल में किए गए बदलावों को सेव करें. इससे आपके एक्सटेंशन का फ़्रंटएंड कॉन्फ़िगर हो जाएगा, ताकि वह आपकी पसंद के Slack चैनल पर इनसाइट भेज सके.
4. अगर आप अपने एक्सटेंशन का फ़्रंटएंड स्थानीय तौर पर चला रहे हैं, तो अपना एक्सटेंशन फिर से बनाएं. अगर आप अपने एक्सटेंशन के फ़्रंटएंड को डिप्लॉय कर रहे हैं, तो अपने एक्सटेंशन के फ़्रंटएंड को फिर से डिप्लॉय करें.

अब आपका एक्सटेंशन, अपनी खास जानकारी को सीधे Slack या Google Chat में एक्सपोर्ट कर सकता है. ध्यान रखें कि एक्सटेंशन सिर्फ़ हार्डकोड किए गए Google चैट स्पेस या Slack चैनल पर खास जानकारी भेज सकता है. आपके पास अतिरिक्त OAuth दायरे जोड़ने और कोड में बदलाव करने का विकल्प होता है. ऐसा करके, उन स्पेस और चैनलों की सूची को फ़ेच किया जा सकता है और दिखाया जा सकता है जिन पर आपको खास जानकारी भेजनी है.

7. [ज़रूरी नहीं] खास जानकारी और अगले चरणों को बेहतर बनाएं

यह एक्सटेंशन, Gemini मॉडल को डैशबोर्ड का पूरा मेटाडेटा और क्वेरी का पूरा डेटा दिखाता है. डैशबोर्ड में ज़्यादा से ज़्यादा मेटाडेटा और संदर्भ जोड़कर, जवाबों को ज़्यादा सटीक, जानकारी, और गहराई से तैयार किया जा सकता है. इन चरणों को हर उस डैशबोर्ड के लिए आज़माएं जिसका इस्तेमाल आपका एक्सटेंशन करता है:

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

डैशबोर्ड में जितनी ज़्यादा जानकारी जोड़ी जा सकती है, एक्सटेंशन के सारांश और अगले चरण उतने ही बेहतर होते हैं. कोड में बदलाव करके, Gemini मॉडल के प्रॉम्प्ट में डैशबोर्ड का अन्य मेटाडेटा भी शामिल किया जा सकता है.

8. [ज़रूरी नहीं] Gemini मॉडल में लॉग इकट्ठा करने की सुविधा सेटअप करें

जब भी कोई उपयोगकर्ता, एक्सटेंशन को डैशबोर्ड के लिए खास जानकारी बनाने के लिए कहेगा, तब वह एक्सटेंशन, डैशबोर्ड में हर क्वेरी के लिए Vertex AI को कॉल करेगा. साथ ही, सारे जवाब को फ़ॉर्मैट करने के लिए एक फ़ाइनल कॉल करेगा. Vertex AI की मदद से अपने एक्सटेंशन के किए गए कॉल को लॉग करने के लिए, इस सेक्शन में दिए गए निर्देशों का पालन करें. इससे Vertex AI की लागत और ट्रैफ़िक का अनुमान लगाने और उन पर नज़र रखने में मदद मिलती है. आपको इन निर्देशों का पालन सिर्फ़ तब करना चाहिए, जब आपने websocket बैकएंड सेवा को डिप्लॉय किया हो.

1. डिप्लॉय की गई अपनी WebSocket बैकएंड सेवा की क्लाउड रन लोकेशन तय करें.
2. इन निर्देशों का पालन करके लॉग सिंक सेट अप करें, जो Big Query पर लॉग को रूट करेगा. सिंक का डेस्टिनेशन, BigQuery होना चाहिए. शामिल किए जाने वाले फ़िल्टर को, नीचे दिए गए कोड सैंपल के साथ सेट करें. इसके लिए, YOUR_CLOUD_RUN_LOCATION को पिछले चरण की Cloud Run लोकेशन से बदल दिया गया.

resource.type = "cloud_run_revision"
resource.labels.service_name = "websocket-service"
resource.labels.location = "YOUR_CLOUD_RUN_LOCATION"
 severity>=DEFAULT
jsonPayload.component="dashboard-summarization-logs"

9. बधाई हो!

आपने Looker डैशबोर्ड की खास जानकारी देने वाला एक्सटेंशन स्थानीय तौर पर सेट अप किया है, ताकि आप इसे आज़मा सकें. आपने इस एक्सटेंशन को Google Cloud पर भी डिप्लॉय किया है, ताकि दूसरे लोग भी इसे आज़मा सकें! अब आपको और अन्य लोगों को सीधे आपके डैशबोर्ड से, Gemini से मिलने वाली खास जानकारी और अगले चरणों को ऐक्सेस करने की सुविधा मिलती है.

10. आगे क्या करना है

• अपने एक्सटेंशन के कोड बेस में बदलाव करें, ताकि उसकी सुविधाओं को आपके संगठन की ज़रूरतों के मुताबिक बनाया जा सके.
• एक्सटेंशन को स्टोर करने की जगह में योगदान दें और अपने और अपनी Looker कम्यूनिटी के लिए एक्सटेंशन को बेहतर बनाएं.
• Looker के अपने अनुभव को बेहतर बनाने के लिए, अपना एक्सटेंशन डेवलप करें
• अपना डैशबोर्ड अनुभव बेहतर बनाने के लिए अपने एक्सटेंशन को टाइल के रूप में डैशबोर्ड में एकीकृत करें.