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-এর রেকর্ড রাখা সংক্রান্ত নীতি অনুযায়ী লগ এন্ট্রি ৩০ দিন পর্যন্ত রাখা হয়, তারপর মুছে ফেলার জন্য শিডিউল করা হয়। এছাড়াও, আপনি Logs Explorer ইন্টারফেস ব্যবহার করে চাহিদা অনুযায়ী এন্ট্রি মুছে ফেলতে পারবেন।

সমস্যার সমাধানকরণ গাইডের লগ সার্চ করা বিভাগে আপনি লগ কীভাবে কার্যকরভাবে ব্যবহার করবেন সেই সম্পর্কে আরও জানতে পারবেন।

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 ব্যবহার করার ব্যাপারে আরও জানতে, নিম্নলিখিত ডকুমেন্টেশন দেখুন:

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