1. আপনি শুরু করার আগে
এই কোডল্যাবে (1) আপনি স্থানীয়ভাবে চেষ্টা এবং বিকাশের জন্য স্থানীয়ভাবে লুকার ড্যাশবোর্ড সংক্ষিপ্তকরণ এক্সটেনশন সেট আপ করবেন। তারপরে (2) আপনি এক্সটেনশনটি উত্পাদনে স্থাপন করবেন যাতে আপনার লুকার উদাহরণের অন্যান্য লুকার ব্যবহারকারীরা এটি ব্যবহার করতে পারে। সবশেষে, (3) আপনি এক্সটেনশনের কার্যকারিতা বাড়ানোর জন্য অতিরিক্ত পদক্ষেপগুলি অনুসরণ করতে পারেন। সমস্ত অ-ঐচ্ছিক বিভাগ ক্রমানুসারে সম্পন্ন করা উচিত।
লুকার ড্যাশবোর্ড সারসংক্ষেপ এক্সটেনশন ওভারভিউ
কার্যকরীভাবে, লুকার ড্যাশবোর্ড সংক্ষিপ্তকরণ এক্সটেনশন আপনার লুকার ড্যাশবোর্ডের ডেটা Vertex AI এর জেমিনি মডেলে পাঠায়। জেমিনি মডেলটি তারপর আপনার ড্যাশবোর্ডের ডেটার সারাংশ এবং পরবর্তী পদক্ষেপগুলির একটি প্রেসক্রিপশন প্রদান করে। এক্সটেনশনটি আপনার ড্যাশবোর্ডে একটি টাইল হিসাবে সারাংশ এবং পরবর্তী পদক্ষেপগুলি প্রদর্শন করে, আপনার ড্যাশবোর্ড অভিজ্ঞতার সাথে একীভূত হয়৷ অতিরিক্তভাবে, এক্সটেনশনটি সারাংশ এবং পরবর্তী পদক্ষেপগুলি স্ল্যাক বা Google চ্যাটে রপ্তানি করতে পারে। এক্সটেনশনটি Vertex AI এর জেমিনি মডেলে এবং থেকে ডেটা পাঠাতে এবং গ্রহণ করতে একটি ওয়েবসকেট ব্যাকএন্ড পরিষেবার সাথে মিলিত একটি প্রতিক্রিয়া ফ্রন্টএন্ড অ্যাপ্লিকেশন ব্যবহার করে।
পূর্বশর্ত
- নোড ডেভেলপমেন্ট, ডকার এবং টেরাফর্মের সাথে প্রাথমিক পরিচিতি
- একটি Looker LookML প্রকল্প স্থাপনের সাথে পরিচিতি
আপনি কি শিখবেন
- কীভাবে স্থানীয়ভাবে এক্সটেনশন সেটআপ এবং বিকাশ করবেন
- কীভাবে প্রোডাকশনে এক্সটেনশন স্থাপন করবেন যাতে আপনার লুকার উদাহরণের অন্যান্য লুকার ব্যবহারকারীরা এটি ব্যবহার করতে পারে
- কিভাবে ঐচ্ছিকভাবে এক্সটেনশনের কার্যকারিতা সূক্ষ্মভাবে সূচিত করা যায় এবং এর কার্যকারিতা প্রসারিত করা যায়।
- উত্পাদনে আপনার নিয়োজিত এক্সটেনশন কীভাবে পরিচালনা করবেন
আপনি কি প্রয়োজন হবে
- একটি লুকার উদাহরণ, হয় একটি লুকার অরিজিনাল লাইসেন্সের মাধ্যমে, সক্রিয় লুকার কোর ট্রায়াল বা একটি সক্রিয় লুকার কোর লাইসেন্সের মাধ্যমে।
- আপনার লুকার উদাহরণে অনুমতিগুলি
develop
এবংdeploy
। - আপনি এক্সটেনশনের সাথে চেষ্টা করতে চান এমন একটি ড্যাশবোর্ড সম্পাদনা করার অনুমতি ৷
- আপনার Looker উদাহরণ থেকে একটি Looker API কী ।
- একটি Google ক্লাউড প্রকল্প যার উপর বিলিং সক্ষম করা আছে।
- Cloud Run API, Vertex AI API, এবং Artifact Registry API প্রকল্পে সক্ষম করা হয়েছে।
- gcloud CLI ইনস্টল সহ একটি স্থানীয় পরিবেশে অ্যাক্সেস। কোডল্যাব ধাপগুলি একটি লিনাক্স শৈলী পরিবেশ অনুমান করে।
2. স্থানীয় উন্নয়নের জন্য ব্যাকএন্ড সেটআপ করুন
এই বিভাগে, আপনি চেষ্টা করে দেখতে এবং স্থানীয়ভাবে বিকাশের জন্য ওয়েবসকেট ব্যাকএন্ড পরিষেবা সেট আপ করবেন। পরিষেবাটি Vertex AI-তে অ্যাক্সেস পাবে।
- আপনার স্থানীয় পরিবেশে নোড সংস্করণ 18 বা উচ্চতর ইনস্টল করুন। নোড ইনস্টল করতে এই নির্দেশাবলী অনুসরণ করুন।
- আপনার স্থানীয় হোম ডিরেক্টরিতে এক্সটেনশনের সংগ্রহস্থল ক্লোন করুন এবং সংগ্রহস্থলের রুট ডিরেক্টরিতে নেভিগেট করুন। এই কোডল্যাবের উদ্দেশ্যে সমস্ত কোড নমুনা অনুমান করবে যে আপনার ক্লোন করা সংগ্রহস্থলটি আপনার স্থানীয় হোম ডিরেক্টরিতে রয়েছে।
cd ~
git clone git@github.com:looker-open-source/dashboard-summarization.git
- ক্লোনড রিপোজিটরির রুট ডিরেক্টরিতে নেভিগেট করুন এবং
.env.example
ফাইলের নাম.env
যাতে আপনি এই কোডল্যাবের পরবর্তী বিভাগে পরিবেশের ভেরিয়েবল সেট করতে পারেন।
cd ~/dashboard-summarization
mv .env.example .env
- ক্লোন করা সংগ্রহস্থলের ওয়েব সকেট ব্যাকএন্ডের
src
ডিরেক্টরিতে নেভিগেট করুন। এই ডিরেক্টরিতে সার্ভারের জন্য সোর্স কোড রয়েছে।
cd ~/dashboard-summarization/websocket-service/src
- NPM এর সাথে পরিষেবার নির্ভরতা ইনস্টল করুন।
npm install
-
looker-example.ini
ফাইলটির নাম পরিবর্তন করেlooker.ini
করুন।
mv looker-example.ini looker.ini
- looker.ini ফাইল আপডেটের ভিতরে:
- আপনার Looker API কী থেকে
client_id
এবংclient_secret
। - আপনার লুকার ইনস্ট্যান্সের URL এর বিন্যাসে
base_url
:https://<YOUR_LOOKER_URL_MINUS_PROTOCOL>:19999
- আপনার লুকার ইনস্ট্যান্সের URL-এর হোস্ট সহ বন্ধনীগুলির মধ্যে পাঠ্য (বিভাগ শিরোনাম)৷
উদাহরণস্বরূপ, যদি আপনার ক্লায়েন্ট আইডি হয় ABC123
, আপনার ক্লায়েন্ট সিক্রেটটি হল XYZ789
, এবং আপনার লুকার ইনস্ট্যান্সের URL হল 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
- আপনার Google ক্লাউড প্রজেক্ট আইডি নির্ধারণ করুন এবং এটি আপনার
PROJECT
এনভায়রনমেন্ট ভেরিয়েবলে সেট করুন। আপনার প্রকল্প আইডি দিয়েYOUR_PROJECT_ID
প্রতিস্থাপন করুন।
export PROJECT="YOUR_PROJECT_ID"
- Vertex AI এখানে তালিকাভুক্ত একাধিক অঞ্চলে জেমিনি মডেল প্রদান করে। আপনার স্থানীয় ব্যাকএন্ড কোন অঞ্চলে ভার্টেক্স এআই এর জেমিনি মডেল থেকে ডেটা পাঠাবে এবং গ্রহণ করবে তা নির্ধারণ করুন। আপনার
REGION
পরিবেশ ভেরিয়েবলে অঞ্চলটি সেট করুন। আপনার অঞ্চলের সাথেYOUR_VERTEX_REGION
প্রতিস্থাপন করুন, যেমনus-central1
।
export REGION="YOUR_VERTEX_REGION"
- এখন আপনার স্থানীয় পরিষেবা শুরু করুন।
npm start
- আপনার স্থানীয় ওয়েবসকেট ব্যাকএন্ড পরিষেবা http://localhost:5000-এ চলবে।
আপনি এখন আপনার স্থানীয় পরিবেশে ওয়েবসকেট ব্যাকএন্ড পরিষেবা সেট আপ করা শেষ করেছেন!!
পরিষেবাটি আপনার ফ্রন্টএন্ড এক্সটেনশন এবং Vertex AI এর জেমিনি মডেলের মধ্যে একটি ইন্টারফেস হিসাবে কাজ করে। পরিষেবাটি লুকার থেকে জিজ্ঞাসা করা ডেটা সহ আপনার ফ্রন্টএন্ড এক্সটেনশন থেকে ড্যাশবোর্ড এবং লুকএমএল ডেটা নেবে এবং ভার্টেক্স এআই-এর জেমিনি মডেলকে প্রম্পট করবে। তারপর পরিষেবাটি আপনার ড্যাশবোর্ডে প্রদর্শিত ফ্রন্টএন্ড এক্সটেনশনে জেমিনীর প্রতিক্রিয়া স্ট্রিম করবে।
আপনি ব্যাকএন্ড পরিষেবার সোর্স কোডেও পরিবর্তন করতে পারেন। আপনাকে প্রথমে পরিষেবা প্রক্রিয়া বন্ধ করতে হবে, কোড পরিবর্তন করতে হবে, তারপর আবার npm start
চালু করতে হবে।
3. স্থানীয় উন্নয়নের জন্য ফ্রন্টএন্ড সেটআপ করুন
আপনি এই বিভাগে স্থানীয়ভাবে চেষ্টা করার এবং বিকাশ করার জন্য ফ্রন্টএন্ড এক্সটেনশন সেট আপ করবেন।
- আগের ধাপগুলি থেকে একই স্থানীয় পরিবেশে, আপনার ক্লোন করা সংগ্রহস্থলের রুট ডিরেক্টরিতে নেভিগেট করুন এবং আপনার ফ্রন্টএন্ডের জন্য ফ্রন্টএন্ড সার্ভারের নির্ভরতা ইনস্টল করুন।
cd ~/dashboard-summarization
npm install
- আপনার স্থানীয় ফ্রন্টএন্ড ডেভেলপমেন্ট সার্ভার শুরু করুন
npm run develop
- আপনার স্থানীয় ফ্রন্টএন্ড সার্ভার এখন http://localhost:8080/bundle.js এ এক্সটেনশনের জাভাস্ক্রিপ্ট পরিবেশন করছে।
- একটি ওয়েব ব্রাউজার খুলুন এবং আপনার লুকার ইনস্ট্যান্সে লগইন করুন।
- একটি ফাঁকা LookML প্রকল্প সেট আপ করতে এই নির্দেশাবলী অনুসরণ করুন। প্রকল্পের ড্যাশবোর্ড-সারাংশের নাম দিন। এখন আপনার বর্তমান ব্রাউজার ট্যাবে লুকার IDE-তে ফাঁকা LookML প্রকল্প স্বয়ংক্রিয়ভাবে খোলা থাকা উচিত।
- LookML প্রকল্পের রুটে একটি প্রজেক্ট ম্যানিফেস্ট ফাইল তৈরি করুন। ফাইলটিকে manifest.lkml বলা হবে। আপনি যদি না জানেন কিভাবে, একটি LookML প্রকল্পে একটি ফাইল যোগ করার জন্য এই নির্দেশাবলী অনুসরণ করুন৷
- আপনার বন্ধ সংগ্রহস্থলের রুট ডিরেক্টরিতে manifest.lkml এর বিষয়বস্তু দিয়ে নতুন manifest.lkml ফাইলের বিষয়বস্তু প্রতিস্থাপন করুন। ফাইলে পরিবর্তনগুলি সংরক্ষণ করতে উপরের ডানদিকে কোণায় "পরিবর্তনগুলি সংরক্ষণ করুন" বোতামটি নির্বাচন করুন৷
- একটি পৃথক ব্রাউজার ট্যাবে, আপনার লুকার ইনস্ট্যান্সে ডাটাবেস সংযোগের তালিকায় নেভিগেট করুন। আপনি কিভাবে জানেন না যদি এই নির্দেশাবলী অনুসরণ করুন.
- একটি লুকার ডাটাবেস সংযোগের নাম চয়ন করুন। আপনি কোন সংযোগ চয়ন করেন তা বিবেচ্য নয়। আপনার যদি ডাটাবেস সংযোগগুলি দেখার অনুমতি না থাকে তবে আপনার লুকার অ্যাডমিনের সাথে যোগাযোগ করুন এবং একটি লুকার ডাটাবেস সংযোগের নাম জিজ্ঞাসা করুন৷
- একটি Looker IDE তে খোলা আপনার LookML প্রকল্পের সাথে ব্রাউজার ট্যাবে ফিরে যান। আপনার LookML প্রোজেক্টে একটি মডেল ফাইল তৈরি করুন এবং ফাইলটির নাম ড্যাশবোর্ড-সারাংশ দিন।
- নিচের কোড নমুনা দিয়ে আপনার ড্যাশবোর্ড-summarization.model.lkml ফাইলের বিষয়বস্তু প্রতিস্থাপন করুন। ধাপ 9 এ আপনি যে ডাটাবেস সংযোগ নামটি বেছে নিয়েছেন তার সাথে ডবল কোটগুলির মধ্যে স্ট্রিংটি প্রতিস্থাপন করা নিশ্চিত করুন৷ ফাইলে পরিবর্তনগুলি সংরক্ষণ করুন৷
connection: "<YOUR_CONNECTION_NAME>"
- আপনার প্রকল্প সংরক্ষণ করতে একটি সংগ্রহস্থল সেটআপ করুন। উপরের ডানদিকে "গিট কনফিগার করুন" বোতামটি নির্বাচন করুন। "এর পরিবর্তে একটি বেয়ার রিপোজিটরি সেট আপ করুন" নির্বাচন করুন। "রিপোজিটরি তৈরি করুন" নির্বাচন করুন।
- লুকএমএল প্রকল্প ফাইলগুলি সংরক্ষণ করার জন্য আপনার কাছে এখন একটি মৌলিক সংগ্রহস্থল রয়েছে৷ "প্রজেক্টে ফিরে যান" নির্বাচন করে বা ম্যানুয়ালি ফিরে নেভিগেট করে লুকার IDE-তে প্রকল্পে ফিরে যান৷
- উপরের ডানদিকে কোণায় "Validate LookML" বোতামটি নির্বাচন করুন। বোতামটি "কমিট চেঞ্জ এবং পুশ" এ পরিবর্তিত হবে।
- ""কমিট পরিবর্তন এবং পুশ" বোতামটি নির্বাচন করুন৷ আপনি যে কোনো বার্তা যোগ করুন এবং "কমিট" নির্বাচন করুন৷
- লুকার IDE-এর উপরের ডানদিকে কোণায় "উৎপাদনে স্থাপন করুন" নির্বাচন করুন। আপনি এখন আপনার লুকার ইনস্ট্যান্সে এক্সটেনশন যোগ করেছেন!
- একটি লুকার ড্যাশবোর্ডে নেভিগেট করুন যাতে আপনি এক্সটেনশন যোগ করতে চান।
- আপনার ড্যাশবোর্ডে একটি এক্সটেনশন টাইল যোগ করতে নির্দেশাবলী অনুসরণ করুন। একটি টাইল হিসাবে আপনার ড্যাশবোর্ডে আপনার নতুন এক্সটেনশন যোগ করুন।
- নিশ্চিত করুন আপনার স্থানীয় ওয়েবসকেট ব্যাকএন্ড পরিষেবা যা আপনি আগে সেট করেছেন তা চলছে।
অভিনন্দন! আপনি এখন আপনার ড্যাশবোর্ডে লুকার ড্যাশবোর্ড সংক্ষিপ্তকরণ এক্সটেনশন ব্যবহার করে দেখতে পারেন। আপনার এক্সটেনশন আপনার ড্যাশবোর্ডের মেটাডেটা আপনার স্থানীয় ওয়েবসকেট ব্যাকএন্ড পরিষেবাতে পাঠাবে এবং আপনার ড্যাশবোর্ড এক্সটেনশন টাইলের মধ্যেই আপনার ব্যাকএন্ড পরিষেবা থেকে জেমিনি আউটপুট প্রদর্শন করবে।
আপনার স্থানীয় ফ্রন্টএন্ড সার্ভার চলাকালীন, আপনি এক্সটেনশনের জাভাস্ক্রিপ্ট সোর্স কোডে পরিবর্তন করতে পারেন এবং সার্ভার স্বয়ংক্রিয়ভাবে পরিবর্তনগুলি তৈরি করবে এবং পরিবেশন করবে৷ পরিবর্তনগুলি দেখতে আপনাকে আপনার এক্সটেনশন বা ড্যাশবোর্ড পৃষ্ঠা পুনরায় লোড করতে হবে৷
4. উৎপাদনে ব্যাকএন্ড স্থাপন করুন
এই বিভাগে, আপনি এখন আপনার লুকার ইনস্ট্যান্সে যেকোন ড্যাশবোর্ডে আপনার ড্যাশবোর্ড সংক্ষিপ্তকরণ এক্সটেনশনের যেকোনো উদাহরণ পরিবেশন করতে ওয়েবসকেট ব্যাকএন্ড পরিষেবা সেট আপ করবেন। এটি অন্যান্য লুকার ব্যবহারকারীদের তাদের নিজস্ব ব্যাকএন্ড পরিষেবা সেট আপ করার প্রয়োজন ছাড়াই তাদের নিজস্ব ড্যাশবোর্ডে এক্সটেনশন চেষ্টা করার অনুমতি দেবে। এই পদক্ষেপগুলি অনুমান করে যে আপনি ইতিমধ্যে একই স্থানীয় পরিবেশে স্থানীয় উন্নয়নের জন্য ব্যাকএন্ড সফলভাবে স্থাপন করেছেন।
- পরবর্তী পদক্ষেপের জন্য আপনার প্রকল্প আইডি সহ আপনার স্থানীয় পরিবেশে একটি অ্যাপ্লিকেশন ডিফল্ট শংসাপত্র সেট আপ করতে এই নির্দেশাবলী অনুসরণ করুন।
- আপনার ব্যাকএন্ড পরিষেবার ডকার চিত্রগুলির জন্য একটি আর্টিফ্যাক্ট রেজিস্ট্রি সংগ্রহস্থল তৈরি করুন। আপনি যে অঞ্চলে আপনার সংগ্রহস্থল রাখতে চান তার সাথে
YOUR_REGION
প্রতিস্থাপন করুন।
gcloud artifacts repositories create dashboard-summarization-repo \
--repository-format=docker \
--location=YOUR_REGION \
- আপনার ক্লোন করা সংগ্রহস্থলের ওয়েব সকেট ব্যাকএন্ডের
src
ডিরেক্টরিতে নেভিগেট করুন।
cd ~/dashboard-summarization/websocket-service/src
-
cloudbuild.yaml
ফাইলটি সম্পাদনা করুন এবংYOUR_REGION
এবংYOUR_PROJECT_ID
এর সমস্ত দৃষ্টান্ত আপনার অঞ্চল এবং প্রকল্প আইডি দিয়ে প্রতিস্থাপন করুন। ফাইলে পরিবর্তনগুলি সংরক্ষণ করুন। - ক্লাউড বিল্ড ব্যবহার করে একটি বিল্ড জমা দিন যা ব্যাকএন্ড পরিষেবা ডকার ইমেজ তৈরি করবে এবং এটিকে আপনার তৈরি করা আর্টিফ্যাক্ট রেজিস্ট্রি রেপোতে পুশ করবে। আপনি যে অঞ্চলে ক্লাউড বিল্ড পরিষেবা ব্যবহার করতে চান তার সাথে
YOUR_REGION
প্রতিস্থাপন করুন৷
gcloud builds submit --region=YOUR_REGION --config cloudbuild.yaml
- মনে রাখবেন, আপনার নতুন নির্মিত ডকার ইমেজ ইউআরএলটি
YOUR_REGION-docker.pkg.dev/YOUR_PROJECT_ID/dashboard-summarization-repo/websocketserviceimage:latest
এ রয়েছে। আপনার প্রকল্প আইডি দিয়েYOUR_PROJECT_ID
প্রতিস্থাপন করুন। আপনার আর্টিফ্যাক্ট রেজিস্ট্রি রিপোজিটরি তৈরি করার জন্য ধাপ 2 থেকে অঞ্চলের সাথেYOUR_REGION
প্রতিস্থাপন করুন। - আপনার ক্লোন করা সংগ্রহস্থলে
websocket-service/terraform
ডিরেক্টরিতে নেভিগেট করুন।
cd ~/dashboard-summarization/websocket-service/terraform
- Google ক্লাউড রানের কোন অবস্থানে আপনি আপনার ওয়েবসকেট ব্যাকএন্ড পরিষেবা চালাতে চান তা নির্ধারণ করুন। এই অবস্থান থেকে চয়ন করুন.
- variables.tf ফাইলটি সম্পাদনা করুন এবং উপযুক্ত মান দিয়ে
YOUR_PROJECT_ID
এবংYOUR_DOCKER_IMAGE_URL
প্রতিস্থাপন করুন। আপনার ডকার ইমেজ ইউআরএলের জন্য ধাপ 6 চেক করুন। পূর্ববর্তী ধাপ 8-এ আপনার বেছে নেওয়া অঞ্চলের সাথেYOUR_REGION
প্রতিস্থাপন করুন। ফাইলে আপনার পরিবর্তনগুলি সংরক্ষণ করুন। - আপনার ব্যাকএন্ড পরিষেবা টেরাফর্ম ব্যবহার করে যে সংস্থানগুলি ব্যবহার করবে তা স্থাপন করুন৷
terraform init
terraform plan
terraform apply
- পরবর্তী বিভাগের জন্য স্থাপন করা ক্লাউড রান URL এন্ডপয়েন্ট সংরক্ষণ করুন।
অভিনন্দন! আপনি আপনার ওয়েবসকেট ব্যাকএন্ড পরিষেবা স্থাপন করেছেন এবং এটি এখন Google ক্লাউড রানে চলছে৷ এখন আপনার লুকার ড্যাশবোর্ড সামারাইজেশন এক্সটেনশনের যেকোন উদাহরণ আপনার ব্যাকএন্ড পরিষেবার সাথে যোগাযোগ করতে পারে। আমরা আপনাকে সবসময় ক্লাউড রানে আপনার ওয়েবসকেট ব্যাকএন্ড পরিষেবার অন্তত একটি উদাহরণ দেওয়ার পরামর্শ দিই। আপনার ব্যাকএন্ড পরিষেবার অধ্যবসায় আপনার ওয়েবসকেট ব্যাকএন্ড পরিষেবা এবং আপনার এক্সটেনশন ফ্রন্টএন্ডের মধ্যে ডেটা স্ট্রিমিংয়ের অখণ্ডতা বজায় রাখে এবং প্রতিটি ব্যবহারকারীর সেশন বজায় রাখতে সহায়তা করে যখন তারা আপনার এক্সটেনশন ব্যবহার করে।
5. উৎপাদনে ফ্রন্টএন্ড স্থাপন করুন
এই শেষ বিভাগের জন্য, আপনি আপনার লুকার উদাহরণে সমস্ত লুকার ব্যবহারকারীদের জন্য উপলব্ধ হওয়ার জন্য এক্সটেনশন ফ্রন্টএন্ড স্থাপনের চূড়ান্ত পদক্ষেপগুলি করবেন৷
- আপনার ক্লোন করা সংগ্রহস্থলের রুট ডিরেক্টরিতে নেভিগেট করুন।
cd ~/dashboard-summarization
- সম্পাদনা করুন।
env
ফাইল। পূর্ববর্তী বিভাগ থেকেYOUR_CLOUD_RUN_URL
ক্লাউড রান URL এন্ডপয়েন্ট দিয়ে প্রতিস্থাপন করুন। আপনার ফাইল পরিবর্তন সংরক্ষণ করুন. এটি ক্লাউড রানে চলমান আপনার ওয়েবসকেট ব্যাকএন্ড পরিষেবাতে প্রোডাকশন এক্সটেনশন ফ্রন্টএন্ড নির্দেশ করবে। - এক্সটেনশনের জাভাস্ক্রিপ্ট তৈরি করুন। একটি
bundle.js
ফাইল এবং অন্যান্য ফাইল সহ একটিdist
ডিরেক্টরি স্বয়ংক্রিয়ভাবে তৈরি হবে।
npm run build
- একটি ওয়েব ব্রাউজার খুলুন এবং আপনার লুকার ইনস্ট্যান্সে লগইন করুন। পাশের বাম নেভিটি খুলুন এবং নীচে "ডেভেলপমেন্ট মোড" টগলটি চালু করুন।
- পাশের বাম নেভি খোলার সাথে, "বিকাশ" নির্বাচন করুন, তারপরে নীচে স্ক্রোল করুন এবং "ড্যাশবোর্ড-সারাংশ" নির্বাচন করুন, আপনার এক্সটেনশনের LookML প্রকল্প৷ আপনি এখন LookML প্রকল্পের জন্য Looker IDE-তে থাকা উচিত।
- "ফাইল ব্রাউজার"-এ প্রোজেক্টের রুট ডিরেক্টরিতে পূর্বে জেনারেট করা ডিস্ট ডিরেক্টরির সমস্ত ফাইল টেনে আনুন এবং ফেলে দিন। আপনার আরও সাহায্যের প্রয়োজন হলে এই নির্দেশাবলী অনুসরণ করুন।
- Looker IDE এর ভিতরে
manifest.lkml
ফাইলটি খুলুন। ফাইলের ভিতরে, লাইনটি প্রতিস্থাপন করুন
url: "http://localhost:8080/bundle.js"
সঙ্গে
file: "bundle.js"
শেষ বিভাগের শেষ থেকে YOUR_CLOUD_RUN_URL
ক্লাউড রান URL এন্ডপয়েন্ট দিয়ে প্রতিস্থাপন করুন। ফাইলে পরিবর্তনগুলি সংরক্ষণ করুন।
- উপরের ডানদিকে কোণায় "Validate LookML" বোতামটি নির্বাচন করুন। বোতামটি "কমিট চেঞ্জ এবং পুশ" এ পরিবর্তিত হবে।
- ""কমিট পরিবর্তন এবং পুশ" বোতামটি নির্বাচন করুন৷ আপনি যে কোনো বার্তা যোগ করুন এবং "কমিট" নির্বাচন করুন৷
- লুকার IDE-এর উপরের ডানদিকে কোণায় "উৎপাদনে স্থাপন করুন" নির্বাচন করুন।
অভিনন্দন! আপনি এখন আপনার লুকার ইনস্ট্যান্সের সমস্ত লুকার ব্যবহারকারীদের তাদের ড্যাশবোর্ডে লুকার ড্যাশবোর্ড সংক্ষিপ্তকরণ এক্সটেনশন যোগ করতে সক্ষম করেছেন৷ যেহেতু অন্যান্য লুকার ব্যবহারকারীরা এক্সটেনশন ব্যবহার করে, এক্সটেনশনের সমস্ত দৃষ্টান্ত Google ক্লাউড রানে চলমান আপনার নিয়োজিত ওয়েবসকেট ব্যাকএন্ড পরিষেবাতে কল করবে৷
মনে রাখবেন, আপনি যদি সোর্স কোডে কোনো পরিবর্তন করেন তাহলে আপনাকে অবশ্যই:
- আবার আপনার এক্সটেনশনের জাভাস্ক্রিপ্ট তৈরি করুন
- আপনি লুকএমএল প্রজেক্টে যোগ করা উত্পন্ন ফাইলগুলিকে
dist
ডিরেক্টরি থেকে নতুন তৈরি করা ফাইলগুলির সাথে প্রতিস্থাপন করুন। - উত্পাদনে LookML প্রকল্পের পরিবর্তনগুলি যাচাই করুন, প্রতিশ্রুতিবদ্ধ করুন এবং স্থাপন করুন
লুকার ড্যাশবোর্ড সামারাইজেশন এক্সটেনশন ব্যবহার করে দেখুন! আমরা আপনাকে এক্সটেনশনে অবদান রাখতে এবং লুকার সম্প্রদায়ের চাহিদাগুলিকে আরও ভালভাবে পরিবেশন করতে সহায়তা করতে উত্সাহিত করি৷ অনুগ্রহ করে সংগ্রহস্থলে একটি টান অনুরোধ তৈরি করতে দ্বিধা বোধ করুন।
স্ল্যাক/গুগল চ্যাট রপ্তানি সক্ষম করতে, মিথুনের সারাংশ এবং পরবর্তী পদক্ষেপগুলিকে সুন্দরভাবে সুরক্ষিত করতে এবং জেমিনি লগিং সেট আপ করতে নিম্নলিখিত ঐচ্ছিক বিভাগগুলি দেখুন৷
6. [ঐচ্ছিক] সেটআপ রপ্তানি ক্ষমতা
এখন আপনি এবং আপনার লুকার ব্যবহারকারীরা লুকার ড্যাশবোর্ড সংক্ষিপ্তকরণ এক্সটেনশনটি ব্যবহার করে দেখেছেন যাতে আরও বেশি দর্শকদের সাথে এক্সটেনশনের অন্তর্দৃষ্টি ভাগ করা যায়৷ Google চ্যাট বা স্ল্যাকে সারাংশ এবং পরবর্তী পদক্ষেপগুলি পাঠাতে আপনার এক্সটেনশন সক্ষম করতে এই বিভাগটি অনুসরণ করুন৷ কোডল্যাবের এই বিভাগটি চালিয়ে যেতে আপনার Oauth সেটআপের সাথে পরিচিত হওয়া উচিত।
Google Chat রপ্তানি সক্ষম করুন
- আপনার Google ক্লাউড প্রকল্পে চ্যাট API সক্ষম করুন।
- Google Workspace OAuth সেটআপ নির্দেশাবলীর ১ম ধাপ অনুসরণ করুন। স্কোপের জন্য আপনাকে অবশ্যই
spaces.messages.create
অন্তর্ভুক্ত করতে হবে। - Google Workspace OAuth সেটআপ নির্দেশাবলীর ২য় ধাপ অনুসরণ করুন। "অনুমোদিত জাভাস্ক্রিপ্ট অরিজিনস" এর অধীনে একটি URI হিসাবে আপনার লুকার ইনস্ট্যান্সের url যোগ করুন, উদাহরণস্বরূপ
https://mycompany.cloud.looker.com
। জেনারেট হওয়া ক্লায়েন্ট আইডি নোট করুন। - আপনি যে Google চ্যাট স্পেসের সারাংশ এক্সপোর্ট করতে চান তার আইডি নির্ধারণ করুন। আপনি যদি নিশ্চিত না হন কিভাবে, এই নির্দেশাবলী অনুসরণ করুন.
- সম্পাদনা করুন।
env
ফাইল। ক্লায়েন্ট আইডি দিয়েYOUR_GOOGLE_CLIENT_ID
প্রতিস্থাপন করুন।YOUR_GOOGLE_SPACE_ID
Google Chat স্পেস আইডি দিয়ে প্রতিস্থাপন করুন। আপনার ফাইল পরিবর্তন সংরক্ষণ করুন. এটি আপনার এক্সটেনশনের ফ্রন্টএন্ডকে কনফিগার করবে যাতে আপনি যে Google চ্যাট স্পেসে চান তার অন্তর্দৃষ্টি পাঠাতে পারবেন। - আপনি যদি স্থানীয়ভাবে আপনার এক্সটেনশনের ফ্রন্টএন্ড চালাচ্ছেন, আপনার এক্সটেনশন পুনরায় তৈরি করুন। অন্যথায় আপনি যদি আপনার এক্সটেনশনের ফ্রন্টএন্ড স্থাপন করেন, আপনার এক্সটেনশনের ফ্রন্টএন্ড পুনরায় স্থাপন করুন।
স্ল্যাক এক্সপোর্ট সক্ষম করুন
- একটি OAuth অ্যাপ্লিকেশন সেটআপ করতে অফিসিয়াল স্ল্যাক ডেভেলপার ডক্সের ধাপ 1 এবং 2 অনুসরণ করুন৷ স্কোপের জন্য আপনাকে অবশ্যই
chat:write
এবংchannels:read
অন্তর্ভুক্ত করতে হবে। জেনারেট করা ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট নোট করুন। - আপনি যে স্ল্যাক চ্যানেলে সারাংশ রপ্তানি করতে চান তার আইডি নির্ধারণ করুন।
- সম্পাদনা করুন।
env
ফাইল। ক্লায়েন্ট আইডি দিয়েYOUR_SLACK_CLIENT_ID
প্রতিস্থাপন করুন। ক্লায়েন্ট সিক্রেট দিয়েYOUR_SLACK_CLIENT_SECRET
প্রতিস্থাপন করুন। চ্যানেল আইডি দিয়েYOUR_SLACK_CHANNEL_ID
প্রতিস্থাপন করুন। আপনার ফাইল পরিবর্তন সংরক্ষণ করুন. এটি আপনার এক্সটেনশনের ফ্রন্টএন্ডকে কনফিগার করবে যাতে আপনি যে স্ল্যাক চ্যানেলে চান তার অন্তর্দৃষ্টি পাঠাতে পারবেন। - আপনি যদি স্থানীয়ভাবে আপনার এক্সটেনশনের ফ্রন্টএন্ড চালাচ্ছেন, আপনার এক্সটেনশন পুনরায় তৈরি করুন। অন্যথায় আপনি যদি আপনার এক্সটেনশনের ফ্রন্টএন্ড স্থাপন করেন, আপনার এক্সটেনশনের ফ্রন্টএন্ড পুনরায় স্থাপন করুন।
এখন আপনার এক্সটেনশন তার সারাংশ সরাসরি স্ল্যাক বা Google চ্যাটে রপ্তানি করতে পারে। মনে রাখবেন, এক্সটেনশন শুধুমাত্র একটি নির্দিষ্ট হার্ডকোড করা Google চ্যাট স্পেস বা স্ল্যাক চ্যানেলে সারসংক্ষেপ পাঠাতে পারে। আপনি অতিরিক্ত Oauth স্কোপ যোগ করতে পারেন এবং সারাংশ পাঠানোর জন্য স্পেস এবং চ্যানেলগুলির একটি তালিকা আনতে এবং প্রদর্শন করতে কোডটি পরিবর্তন করতে পারেন।
7. [ঐচ্ছিক] সারাংশ এবং পরবর্তী ধাপগুলিকে সূক্ষ্ম করুন
এক্সটেনশনটি ড্যাশবোর্ডের সমস্ত মেটাডেটা এবং ক্যোয়ারী ডেটা সহ জেমিনি মডেলকে অনুরোধ করে৷ আপনি ড্যাশবোর্ডে যতটা মেটাডেটা এবং প্রসঙ্গ যোগ করে সারাংশ এবং প্রেসক্রিপটিভ পদক্ষেপের সঠিকতা, বিশদ বিবরণ এবং গভীরতা উন্নত করতে পারেন। প্রতিটি ড্যাশবোর্ডের জন্য এই পদক্ষেপগুলি চেষ্টা করে দেখুন আপনার এক্সটেনশানটি এর একটি অংশ:
- ড্যাশবোর্ডে ড্যাশবোর্ডের বিবরণ যোগ করতে এই নির্দেশাবলী অনুসরণ করুন। এটি ড্যাশবোর্ডের সাধারণ প্রেক্ষাপট সম্পর্কে এলএলএমকে জানাতে সাহায্য করবে।
- প্রতিটি ড্যাশবোর্ডের টাইলে নোট যোগ করতে এই নির্দেশাবলী অনুসরণ করুন। এটি ড্যাশবোর্ডে প্রতিটি পৃথক প্রশ্নের প্রসঙ্গে এলএলএমকে জানাতে সাহায্য করবে। ছোট প্রাসঙ্গিক নোটগুলি উত্পন্ন সারাংশগুলিতে ফ্যাক্টর করবে।
আপনি আপনার ড্যাশবোর্ডে যত বেশি তথ্য যোগ করতে পারবেন এক্সটেনশনের সারাংশ এবং পরবর্তী পদক্ষেপগুলি তত ভাল হবে৷ আপনি জেমিনি মডেলের প্রম্পটে অতিরিক্ত ড্যাশবোর্ড মেটাডেটা অন্তর্ভুক্ত করতে কোডটি পরিবর্তন করতে পারেন।
8. [ঐচ্ছিক] সেটআপ মিথুন মডেল লগিং
যখনই একজন ব্যবহারকারী এক্সটেনশনকে ড্যাশবোর্ডের জন্য সারাংশ তৈরি করতে বলে, এক্সটেনশনটি ড্যাশবোর্ডের প্রতিটি প্রশ্নের জন্য Vertex AI-তে কল করবে এবং সমস্ত সারাংশ ফর্ম্যাট করার জন্য একটি চূড়ান্ত কল করবে। Vertex AI আপনার এক্সটেনশনের কল লগ করতে এই বিভাগটি অনুসরণ করুন যাতে আপনি Vertex AI খরচ এবং ট্র্যাফিকের অনুমান এবং নিরীক্ষণ করতে পারেন। আপনি যদি ওয়েবসকেট ব্যাকএন্ড পরিষেবা স্থাপন করেন তবেই আপনাকে এই নির্দেশাবলী অনুসরণ করা উচিত।
- আপনার স্থাপন করা ওয়েবসকেট ব্যাকএন্ড পরিষেবার ক্লাউড রান অবস্থান নির্ধারণ করুন।
- একটি লগ সিঙ্ক সেট আপ করতে এই নির্দেশাবলী অনুসরণ করুন যা লগগুলিকে বিগ কোয়েরিতে রুট করবে৷ সিঙ্কের গন্তব্য BigQuery হওয়া উচিত। পূর্ববর্তী ধাপের ক্লাউড রান অবস্থানের সাথে প্রতিস্থাপিত
YOUR_CLOUD_RUN_LOCATION
সহ নিম্নলিখিত কোড নমুনা সহ অন্তর্ভুক্তি ফিল্টার সেট করুন৷
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. অভিনন্দন!
আপনি চেষ্টা করার জন্য স্থানীয়ভাবে লুকার ড্যাশবোর্ড সংক্ষিপ্তকরণ এক্সটেনশন সেট আপ করেছেন। আপনি Google ক্লাউডে এক্সটেনশনটি স্থাপন করেছেন যাতে অন্যান্য ব্যবহারকারীরাও এটি ব্যবহার করে দেখতে পারেন! এখন আপনি এবং অন্যান্য ব্যবহারকারীরা আপনার ড্যাশবোর্ডের মধ্যে থেকেই জেমিনি চালিত সারাংশ এবং পরবর্তী পদক্ষেপগুলি অ্যাক্সেস করতে পারবেন।
10. পরবর্তী কি
- আপনার সংস্থার প্রয়োজন অনুসারে এর কার্যকারিতা তৈরি করতে আপনার এক্সটেনশনের কোডবেস পরিবর্তন করুন৷
- এক্সটেনশনের সংগ্রহস্থলে অবদান রাখুন এবং আপনার এবং আপনার লুকার সম্প্রদায়ের জন্য এক্সটেনশন উন্নত করুন।
- আপনার লুকার অভিজ্ঞতা বাড়াতে আপনার নিজস্ব এক্সটেনশন বিকাশ করুন
- আপনার ড্যাশবোর্ড অভিজ্ঞতা উন্নত করতে একটি টাইল হিসাবে একটি ড্যাশবোর্ডে আপনার এক্সটেনশন একত্রিত করুন ৷