Google Home ইকোসিস্টেমের জন্য Cloud Logging

ক্লাউড-টু-ক্লাউড    Matter

আপনি Google Cloud Logging থেকে আপনার ইন্টিগ্রেশনের জন্য ইভেন্ট লগ অ্যাক্সেস করতে পারবেন। লগ এক্সপ্লোর করতে, মেট্রিক ও অ্যালার্ট তৈরি করতে অথবা Google Cloud Pub/Sub ব্যবহার করে অন্যান্য অ্যাপ্লিকেশনে লগ এক্সপোর্ট করতে Cloud Logging ব্যবহার করুন।

অ্যাক্সেস লগিং

Google Cloud Console থেকে Cloud Logging অ্যাক্সেস করতে, সব প্রোডাক্ট দেখুন বিকল্পে ক্লিক করুন, তারপর অবজার্ভেবিলিটি > লগিং বিকল্পে যান।

Cloud Logging-এ যান

আপনার অ্যাকশন প্রোজেক্টের ব্যবহারকারীদের জন্য পরিচয় ও অ্যাক্সেস ম্যানেজমেন্ট (IAM) এর মাধ্যমে লগিং ডেটা অ্যাক্সেস ম্যানেজ করা হয়। ডেটা লগ করার জন্য ভূমিকা ও অনুমতি সম্পর্কে আরও বিবরণের জন্য, Cloud Logging অ্যাক্সেস কন্ট্রোল দেখুন।

Cloud Logging রেকর্ড রাখা সংক্রান্ত নীতি অনুযায়ী লগ এন্ট্রি ৩০ দিন পর্যন্ত সেভ করা থাকে, তারপরে মুছে ফেলার জন্য শিডিউল করা হয়। এছাড়াও, আপনি লগ এক্সপ্লোরার ইন্টারফেস ব্যবহার করে চাহিদা অনুযায়ী এন্ট্রি মুছে দিতে পারেন।

সমস্যার সমাধান সংক্রান্ত গাইড-এর Searching Logs বিভাগে লগ কীভাবে কার্যকরভাবে ব্যবহার করতে হয় সেই সম্পর্কে আরও জানতে পারবেন।

Cloud Logging নিম্নলিখিত রিসোর্সের ধরন প্রদান করে:

রিসোর্সের ধরন প্রদর্শন নাম বিবরণ লেবেল
assistant_action_project Google Assistant অ্যাকশন প্রোজেক্ট Assistant অ্যাকশনের সাথে যুক্ত Google Cloud প্রোজেক্টের কন্টেনার।
  • project_id: আপনার বর্তমান প্রোজেক্টের শনাক্তকারী যা এই রিসোর্সের সাথে যুক্ত, যেমন my-project.

ইভেন্টের লগ

Cloud-to-cloud প্রোজেক্ট Cloud Logging-এ নিম্নলিখিত ইভেন্টগুলি সমর্থন করে:

Cloud Logging রিসোর্স ইভেন্ট
Google Assistant অ্যাকশন প্রোজেক্ট SYNC ইনটেন্ট সংক্রান্ত সমস্যা
কোয়েরি ইনটেন্ট সংক্রান্ত সমস্যা
EXECUTE ইনটেন্ট সংক্রান্ত সমস্যা
বিজ্ঞপ্তি সমস্যা
অ্যাকাউন্ট লিঙ্ক করা সংক্রান্ত সমস্যা
Local Home SDK HandlerError

সিঙ্ক লগ

নিচের সারণীতে syncLog এন্ট্রির স্কিমা তালিকাভুক্ত করা হয়েছে:

প্রপার্টি বিবরণ
requestId স্মার্ট হোম ইনটেন্ট অনুরোধ আইডি।
httpLatencyMsec উত্তর পাওয়ার আগে কেটে যাওয়া সময়।
status ইনটেন্ট উত্তরের স্ট্যাটাস বোঝায়।

এক্সিকিউশন লগ

নিচের সারণীতে executionLog এন্ট্রির স্কিমা তালিকাভুক্ত করা হয়েছে:

প্রপার্টি বিবরণ
requestId অনন্য অনুরোধ আইডি, যেমন 5325511189174727525.
latencyMsec উত্তর পাওয়ার আগে অতিবাহিত সময়, যেমন, 6000.
executionType আপনার ইন্টিগ্রেশনের উপর নির্ভর করে, অনুরোধের জন্য ব্যবহৃত ট্রান্সপোর্ট, যেমন CLOUD বা MATTER।
actionType ব্যবহারকারীর নেওয়া অ্যাকশনের ঐচ্ছিক সূচক, যেমন QUERY বা EXECUTE. EXECUTE অ্যাকশনের জন্য, এর মধ্যে অন্তর্ভুক্ত হল, যেসব সাপোর্টেড ট্রেটের জন্য পূরণ করার জন্য ইস্যু করা কমান্ড, যেমন ONOFF_OFF
trait এই ব্যবহারকারীর অ্যাকশনের সাথে যুক্ত ঐচ্ছিক ট্রেট।
deviceTypes ইভেন্টের ফলে প্রভাবিত ডিভাইসের ধরনের তালিকা, যেমন LIGHT।
isSuccess অনুরোধের উত্তর সফলভাবে পাওয়া গেছে কিনা।
fallbackToCloud স্থানীয় ফুলফিলমেন্ট থেকে কোনও সমস্যা হওয়ার পরে অনুরোধটি ক্লাউড ফুলফিলমেন্টে রাউট করা হয়েছে কিনা।
statusType ইনটেন্ট উত্তরের স্ট্যাটাস বোঝায়, যেমন SUCCESS, PENDING বা OFFLINE। ERROR উত্তরের ক্ষেত্রে, এই প্রপার্টিতে প্রতিশ্রুতি পূরণের মাধ্যমে প্রদান করা errorCode থাকে।
externalDebugString এই ব্যবহারকারীর অ্যাকশনের সাথে যুক্ত ঐচ্ছিক বিস্তারিত ডিবাগিং মেসেজ।
locale অনুরোধের সাথে যুক্ত ভাষা কোড।

বিজ্ঞপ্তির লগ

নিচের সারণীতে notificationLog এন্ট্রির স্কিমা তালিকাভুক্ত করা হয়েছে:

প্রপার্টি বিবরণ
requestId বিজ্ঞপ্তির অনুরোধ আইডি।
structName বিজ্ঞপ্তি স্ট্রাকচারের নাম, যেমন "ObjectDetection"।
status বিজ্ঞপ্তির স্ট্যাটাস বোঝায়।

লগ লেভেল সেটিং

Cloud-to-cloud প্রোজেক্টে ডিফল্ট হিসেবে সমস্যার লগ পাওয়ার সুবিধা সেট করা থাকে, এবং ডেভেলপাররা চাইলে সাফল্যের লগ পাওয়ার সুবিধাও চালু করতে পারেন। ডেভেলপমেন্ট ফেজে এটি বিশেষভাবে উপযোগী, যখন আপনি কিছু এজেন্ট থেকে সব লগ ক্যাপচার করার পরিকল্পনা করেন। আপনি যদি লগিং কোটা অতিক্রম করেন, তাহলে আপনার প্রোজেক্টে অতিরিক্ত চার্জ প্রযোজ্য হতে পারে।

আপনি এগুলি করে প্রোজেক্টের লগ লেভেল কন্ট্রোল করতে পারবেন:

  1. Actions on Google Console-এ, প্রোজেক্ট পৃষ্ঠায় যান।

    Actions on Google কনসোলে যান

  2. আপনার স্মার্ট হোম প্রোজেক্ট বেছে নিন।

  3. ডেভেলপ ট্যাব বেছে নিন এবং সাইডবারে অ্যাকশন বিকল্পে ক্লিক করুন।

  4. লগ কন্ট্রোল ইনজেশন ড্রপডাউন তালিকা থেকে সব বিকল্প বেছে নিন।

লগ বাদ দেওয়া

ডেভেলপাররা আরও নমনীয় উপায়ে তাদের লগ কাস্টমাইজ করতে, লগিং কোয়েরি ভাষা ব্যবহার করে লগ এক্সক্লুশন তৈরি করতে পারেন। লগিং কোয়েরি ল্যাঙ্গুয়েজ Logs Explorer-এও ব্যবহার করা হয়, তাই আপনি কোয়েরি তৈরি করতে Logs Explorer-এর সাহায্য নিতে পারেন।

আপনি এই নির্দেশিকা থেকে বাদ দেওয়ার ফিল্টার তৈরি করার ধাপগুলি অনুসরণ করতে পারেন (_Default সিঙ্কের জন্য বাদ দেওয়ার ফিল্টার কনফিগার করুন)।

লগ-ভিত্তিক মেট্রিক

ডেভেলপাররা তাদের লগ থেকে প্যাটার্ন ট্র্যাক ও বিশ্লেষণ করতে লগ-ভিত্তিক মেট্রিক ব্যবহার করতে পারেন। এছাড়াও, লগ-ভিত্তিক মেট্রিকের উপর কাস্টম চার্ট তৈরি করা এবং অ্যালার্ট সেট-আপ করা সম্ভব।

স্মার্ট হোমের জন্য লগ-ভিত্তিক মেট্রিক ব্যবহার করা শুরু করতে, কাউন্টার লগ-ভিত্তিক মেট্রিক গাইড তৈরি করা দেখুন।

আপনার প্রোজেক্টে Cloud Logging ব্যবহার করা সম্পর্কে আরও জানতে, নিম্নলিখিত ডকুমেন্টেশন দেখুন:

  • মূল্য: অ্যালটমেন্ট ও অতিরিক্ত ব্যবহারের খরচ সংক্রান্ত বিবরণ।
  • কোটা ও সীমা: লগ ব্যবহারের ক্ষেত্রে সীমা ও রিটেনশন নীতি সংক্রান্ত বিবরণ।
  • লগ কোয়েরি সংক্রান্ত উন্নত কোয়েরি: লগ ডেটা কোয়েরি ও বিশ্লেষণ করার জন্য উন্নত এক্সপ্রেশন ব্যবহার করার ব্যাপারে নির্দেশিকা।