এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

সমস্যা সমাধান বিষয় একীকরণ ত্রুটি

রিফ্রেশ_তারিখ: ২০২৩-০১-০৬

Google Cloud আপনাকে Google Cloud Monitoring মাধ্যমে আপনার প্রকল্পের নির্ভরযোগ্যতা পর্যবেক্ষণ এবং Google Cloud Logging এরর লগের সমস্যাগুলি ডিবাগ করার জন্য সরঞ্জাম সরবরাহ করে। ব্যবহারকারীর ইচ্ছা পূরণ করার সময় যখনই কোনও ব্যর্থতা ঘটে, গুগল হোম অ্যানালিটিক্স পাইপলাইন আপনার মেট্রিক্সে সেই ব্যর্থতা রেকর্ড করে এবং আপনার প্রকল্প লগে একটি ত্রুটি লগ প্রকাশ করে।

আপনার ত্রুটিগুলি সমাধানের জন্য দুটি ধাপ রয়েছে:

স্মার্ট হোম মেট্রিক্সের সাহায্যে আপনার প্রকল্পগুলির অবস্থা পর্যবেক্ষণ করুন।
ত্রুটি লগে ত্রুটির বিস্তারিত বিবরণ পরীক্ষা করে সমস্যাগুলি তদন্ত করুন।

ত্রুটি পর্যবেক্ষণ

আপনার প্রকল্পের মেট্রিক্স অ্যাক্সেস করতে আপনি Google Cloud Monitoring dashboard ব্যবহার করতে পারেন। কিছু মূল চার্ট রয়েছে যা বিশেষভাবে মান পর্যবেক্ষণ এবং ডিবাগিংয়ের জন্য কার্যকর:

আপনার প্রকল্পের নির্ভরযোগ্যতা পর্যবেক্ষণ করার সময় সাফল্যের হারের চার্ট হল প্রথম চার্ট যা থেকে শুরু করা হয়। এই চার্টে কিছু হ্রাস আপনার ব্যবহারকারীর একটি অংশ বা সম্পূর্ণরূপে বিভ্রাট নির্দেশ করতে পারে। আপনার প্রকল্পের প্রতিটি পরিবর্তন বা আপডেটের পরে কোনও অনিয়মের জন্য আমরা এই চার্টটি নিবিড়ভাবে পর্যবেক্ষণ করার পরামর্শ দিচ্ছি।
আপনার ইন্টিগ্রেশনের সমস্যা সমাধানের ক্ষেত্রে ত্রুটি ভাঙ্গন চার্টগুলি সবচেয়ে কার্যকর। আপনার সাফল্যের শতাংশ চার্টে হাইলাইট করা প্রতিটি ত্রুটির জন্য, আপনার ত্রুটি ভাঙ্গনে একটি ত্রুটি কোড প্রদর্শিত হবে। আপনি নীচের টেবিলে Google Home platform দ্বারা চিহ্নিত ত্রুটিগুলি এবং সেগুলি কীভাবে সমাধান করবেন তা দেখতে পারেন।

প্ল্যাটফর্ম ত্রুটি কোড

Google Home platform সমস্যাগুলি সনাক্ত করার জন্য আপনার প্রোজেক্ট লগে আপনি দেখতে পারেন এমন কিছু সাধারণ ত্রুটি কোড এখানে দেওয়া হল। সমস্যা সমাধানের তথ্যের জন্য অনুগ্রহ করে নিম্নলিখিত টেবিলটি দেখুন।

ত্রুটি কোড	বিবরণ
`BACKEND_FAILURE_URL_ERROR`	Google আপনার পরিষেবা থেকে 401 ছাড়া অন্য একটি HTTP 4xx ত্রুটি কোড পেয়েছে। আপনার স্মার্ট হোম পরিষেবা লগগুলি পরীক্ষা করতে GCP লগিং-এ `requestId` ব্যবহার করুন।
`BACKEND_FAILURE_URL_TIMEOUT`	আপনার পরিষেবার সাথে যোগাযোগ করার চেষ্টা করার সময় Google-এর অনুরোধের সময়সীমা শেষ হয়ে গেছে। আপনার পরিষেবা অনলাইনে আছে কিনা, সংযোগ গ্রহণ করছে কিনা এবং ধারণক্ষমতার বেশি নয় কিনা তা যাচাই করুন। অতিরিক্তভাবে, লক্ষ্য ডিভাইসটি চালু আছে কিনা, অনলাইন আছে কিনা এবং সিঙ্ক করা আছে কিনা তা যাচাই করুন।
`BACKEND_FAILURE_URL_UNREACHABLE`	Google আপনার পরিষেবা থেকে একটি HTTP 5xx ত্রুটি কোড পেয়েছে। আপনার স্মার্ট হোম পরিষেবা লগগুলি পরীক্ষা করতে GCP লগিং-এ `requestId` ব্যবহার করুন।
`DEVICE_NOT_FOUND`	ডিভাইসটি অংশীদার পরিষেবার পক্ষ থেকে বিদ্যমান নেই। এটি সাধারণত ডেটা সিঙ্ক্রোনাইজেশনে ব্যর্থতা বা রেসের অবস্থা নির্দেশ করে।
`GAL_BAD_3P_RESPONSE`	পেলোডে ভুল ফর্ম্যাট বা মান থাকার কারণে Google আপনার অ্যাকাউন্ট লিঙ্কিং পরিষেবা থেকে প্রাপ্ত প্রতিক্রিয়া পার্স করতে পারছে না। আপনার অ্যাকাউন্ট লিঙ্কিং পরিষেবার ত্রুটি লগগুলি পরীক্ষা করতে GCP লগিং-এ `requestId` ব্যবহার করুন।
`GAL_INTERNAL`	গুগল যখন একটি অ্যাক্সেস টোকেন পুনরুদ্ধার করার চেষ্টা করেছিল তখন একটি গুগল অভ্যন্তরীণ ত্রুটি ঘটেছে। যদি আপনি GCP লগিং-এ এই ত্রুটির হার বৃদ্ধি দেখতে পান, তাহলে আরও তথ্যের জন্য আমাদের সাথে যোগাযোগ করুন।
`GAL_INVALID_ARGUMENT`	গুগল যখন একটি অ্যাক্সেস টোকেন পুনরুদ্ধার করার চেষ্টা করেছিল তখন একটি গুগল অভ্যন্তরীণ ত্রুটি ঘটেছে। যদি আপনি GCP লগিং-এ এই ত্রুটির হার বৃদ্ধি দেখতে পান, তাহলে আরও তথ্যের জন্য আমাদের সাথে যোগাযোগ করুন।
`GAL_NOT_FOUND`	Google-এ সংরক্ষিত ব্যবহারকারীর অ্যাক্সেস টোকেন এবং রিফ্রেশ টোকেনগুলি অবৈধ এবং আর রিফ্রেশ করা যাবে না। আপনার পরিষেবা ব্যবহার চালিয়ে যেতে ব্যবহারকারীকে তাদের অ্যাকাউন্ট পুনরায় লিঙ্ক করতে হবে। যদি আপনি GCP লগিং-এ এই ত্রুটির হার বৃদ্ধি দেখতে পান, তাহলে আরও তথ্যের জন্য আমাদের সাথে যোগাযোগ করুন।
`GAL_PERMISSION_DENIED`	টোকেন শেয়ারিং অনুমোদিত না থাকায় গুগলের একটি অভ্যন্তরীণ ত্রুটি ঘটেছে। যদি আপনি GCP লগিং-এ এই ত্রুটির হার বৃদ্ধি দেখতে পান, তাহলে আরও তথ্যের জন্য আমাদের সাথে যোগাযোগ করুন।
`GAL_REFRESH_IN_PROGRESS`	ব্যবহারকারীর অ্যাক্সেস টোকেনের মেয়াদ শেষ হয়ে গেছে এবং এটি রিফ্রেশ করার আরেকটি সমসাময়িক প্রচেষ্টা ইতিমধ্যেই চলছে। এটি কোনও সমস্যা নয় এবং কোনও পদক্ষেপের প্রয়োজন নেই।
`INVALID_AUTH_TOKEN`	Google আপনার পরিষেবা থেকে একটি HTTP 401 ত্রুটি কোড পেয়েছে। অ্যাক্সেস টোকেনের মেয়াদ শেষ হয়নি কিন্তু আপনার পরিষেবা এটিকে অবৈধ করে দিয়েছে। আপনার স্মার্ট হোম পরিষেবা লগগুলি পরীক্ষা করতে GCP লগিং-এ `requestId` ব্যবহার করুন।
`INVALID_JSON`	JSON প্রতিক্রিয়া পার্স করা বা বোঝা যাবে না। আপনার JSON প্রতিক্রিয়ার কাঠামোতে অবৈধ বাক্য গঠন পরীক্ষা করুন, যেমন অমিল বন্ধনী, অনুপস্থিত কমা, অবৈধ অক্ষর।
`OPEN_AUTH_FAILURE`	ব্যবহারকারীর অ্যাক্সেস টোকেনের মেয়াদ শেষ হয়ে গেছে এবং Google এটি রিফ্রেশ করতে পারছে না, অথবা Google আপনার পরিষেবা থেকে একটি HTTP 401 ত্রুটি কোড পেয়েছে। যদি আপনি এই কোডের বর্ধিত হার দেখতে পান, তাহলে স্মার্ট হোম ইন্টেন্ট বা রিফ্রেশ টোকেন অনুরোধ সম্পর্কিত ত্রুটির বর্ধিত হারও দেখতে পাচ্ছেন কিনা তা পরীক্ষা করে দেখুন।
`PARTNER_RESPONSE_INVALID_ERROR_CODE`	উত্তরটি একটি অচেনা ত্রুটি কোড নির্দেশ করে। যদি আপনার অনুরোধের প্রতিক্রিয়ায় কোনও ত্রুটি দেখা যায়, তাহলে আমাদের সমর্থিত ত্রুটি কোড থেকে প্রদত্ত একটি ব্যবহার করতে ভুলবেন না।
`PARTNER_RESPONSE_INVALID_PAYLOAD`	রেসপন্স `payload` ফিল্ডকে JSON অবজেক্ট হিসেবে পার্স করা যাবে না। আপনার অনুরোধের প্রতিক্রিয়ার পেলোড ফিল্ডটিতে মিলিত বন্ধনী আছে কিনা এবং এটি সঠিকভাবে JSON ফিল্ড হিসাবে গঠন করা হয়েছে কিনা তা পরীক্ষা করুন।
`PARTNER_RESPONSE_INVALID_STATUS`	উত্তরটি কোনও স্ট্যাটাস নির্দেশ করে না, অথবা কোনও ভুল স্ট্যাটাস নির্দেশ করে না। উদ্দেশ্য পূরণের অনুরোধের প্রতিক্রিয়াগুলিতে `SUCCESS, OFFLINE, ERROR, EXCEPTIONS` লেখা থাকা উচিত। ত্রুটি এবং ব্যতিক্রম পরিচালনা সম্পর্কে আপনি আরও তথ্য পেতে পারেন।
`PARTNER_RESPONSE_MISSING_COMMANDS_AND_DEVICES`	অনুরোধে উপস্থিত এক বা একাধিক উদ্দেশ্য প্রতিক্রিয়ায় অনুপস্থিত। আপনার এক্সিকিউশন রেসপন্স সঠিকভাবে গঠন করা হয়েছে কিনা এবং অনুরোধের সমস্ত উদ্দেশ্যের ফলাফল আপনার রেসপন্সে উপস্থিত আছে কিনা তা যাচাই করুন।
`PARTNER_RESPONSE_MISSING_DEVICE`	অনুরোধে উপস্থিত এক বা একাধিক ডিভাইস প্রতিক্রিয়ায় অনুপস্থিত। আপনার এক্সিকিউশন রেসপন্স সঠিকভাবে গঠন করা হয়েছে কিনা এবং অনুরোধের সমস্ত ডিভাইস আইডি আপনার রেসপন্সে উপস্থিত আছে কিনা তা যাচাই করুন।
`PARTNER_RESPONSE_MISSING_PAYLOAD`	প্রতিক্রিয়াতে কোনও `payload` ক্ষেত্র নেই। আপনার অনুরোধের প্রতিক্রিয়ায় একটি পেলোড ক্ষেত্র অন্তর্ভুক্ত করতে ভুলবেন না। আপনি কীভাবে সঠিকভাবে একটি কার্যকর প্রতিক্রিয়া তৈরি করবেন সে সম্পর্কে আরও জানতে পারেন।
`PARTNER_RESPONSE_NOT_OBJECT`	প্রতিক্রিয়াটিকে JSON অবজেক্ট হিসেবে পার্স করা যাবে না। আপনার অনুরোধের প্রতিক্রিয়ার সমস্ত ক্ষেত্রে অপ্রত্যাশিত অক্ষর, অমিল বন্ধনী বা ফর্ম্যাটিং ত্রুটির জন্য পরীক্ষা করুন। কিছু ইউনিকোড অক্ষর অসমর্থিত হতে পারে। এছাড়াও নিশ্চিত করুন যে আপনার প্রতিক্রিয়াটি JSON অবজেক্ট হিসাবে সঠিকভাবে গঠন করা হয়েছে।
`PROTOCOL_ERROR`	অনুরোধ প্রক্রিয়াকরণে ব্যর্থতা। আপনার স্মার্ট হোম পরিষেবা লগগুলি পরীক্ষা করতে Google Cloud Logging-এ `requestId` ব্যবহার করুন।
`RELINK_REQUIRED`	উত্তরে একটি `relinkRequired` ত্রুটি দেখানো হয়েছে, যা ব্যবহারকারীকে তাদের Google এবং অংশীদার অ্যাকাউন্টগুলি পুনরায় লিঙ্ক করতে অনুরোধ করে। আরও তথ্যের জন্য সমর্থিত ত্রুটি কোডগুলি দেখুন।
`RESPONSE_TIMEOUT`	প্রতিক্রিয়ার জন্য অপেক্ষা করার সময় অনুরোধের সময় শেষ হয়ে গেছে। অনুরোধ পাঠানোর পর থেকে উত্তর পাঠানোর সময়সীমা ৯ সেকেন্ড। এই সময়ের মধ্যে উত্তর পাঠাতে ভুলবেন না।
`RESPONSE_UNAVAILABLE`	কোন প্রতিক্রিয়া পাওয়া যায়নি, অথবা প্রতিক্রিয়াটি স্থিতি নির্দেশ করে না। উদ্দেশ্য পূরণের অনুরোধের প্রতিক্রিয়াগুলি স্মার্ট হোম ডক্স অনুসারে গঠন করা উচিত এবং স্থিতি নির্দেশ করে।
`TRANSIENT_ERROR`	একটি ক্ষণস্থায়ী ত্রুটি হল এমন একটি ত্রুটি যা নিজেই সমাধান হয়ে যাবে। সাধারণত এই ত্রুটিগুলি কোনও ডিভাইস বা পরিষেবার সাথে সংযোগ বাদ দেওয়ার সময় প্রকাশ পায়। এছাড়াও যদি কোনও সার্ভারে নতুন সংযোগ খোলা না যায়।

অনুসন্ধান লগ

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

Google Cloud মধ্যে একাধিক সিস্টেম রয়েছে যা আপনার প্রোজেক্টে সর্বদা লগ পাঠায়। আপনার লগগুলি ফিল্টার করার জন্য এবং আপনার প্রয়োজনীয়গুলি খুঁজে পেতে আপনাকে কোয়েরি লিখতে হবে। কোয়েরিগুলি একটি সময়সীমা , সম্পদ , লগ তীব্রতা বা কাস্টম এন্ট্রির উপর ভিত্তি করে হতে পারে।

আপনার কাস্টম ফিল্টার তৈরি করতে আপনি কোয়েরি বোতামগুলি ব্যবহার করতে পারেন।

একটি সময়সীমা নির্দিষ্ট করতে, সময়সীমা নির্বাচন বোতামে ক্লিক করুন এবং প্রদত্ত বিকল্পগুলির মধ্যে একটি নির্বাচন করুন। এটি লগগুলিকে ফিল্টার করবে এবং নির্বাচিত সময়সীমার মধ্যে উৎপন্ন লগগুলি দেখাবে।

একটি রিসোর্স নির্দিষ্ট করতে, রিসোর্স ড্রপডাউনে ক্লিক করুন, তারপর Google Assistant Action Project নির্বাচন করুন। এটি আপনার কোয়েরিতে একটি ফিল্টার যোগ করে যা আপনার প্রকল্প থেকে উদ্ভূত লগগুলি দেখায়।

জরুরি অবস্থা , তথ্য , ডিবাগ এবং অন্যান্য তীব্রতা লগ স্তর অনুসারে ফিল্টার করতে তীব্রতা বোতামটি ব্যবহার করুন।

আপনি কাস্টম এন্ট্রি প্রবেশের জন্য Logs Explorer কোয়েরি ফিল্ডটিও ব্যবহার করতে পারেন। এই ফিল্ড দ্বারা ব্যবহৃত কোয়েরি ইঞ্জিন স্ট্রিং ম্যাচিংয়ের মতো মৌলিক কোয়েরি এবং তুলনাকারী ( <, >=, != ) এবং বুলিয়ান অপারেটর ( AND, OR, NOT ) সহ আরও উন্নত ধরণের কোয়েরি উভয়কেই সমর্থন করে।

উদাহরণস্বরূপ, নীচের কাস্টম এন্ট্রিটি LIGHT ডিভাইসের ধরণ থেকে উদ্ভূত ত্রুটিগুলি ফেরত দেবে:

resource.type = "assistant_action_project" AND severity = ERROR AND jsonPayload.executionLog.executionResults.actionResults.device.deviceType = "LIGHT"

কার্যকরভাবে লগ কোয়েরি করার জন্য আরও উদাহরণ পেতে কোয়েরি লাইব্রেরি দেখুন।

পরীক্ষার সংশোধন

একবার আপনি ত্রুটিগুলি শনাক্ত করে সেগুলি ঠিক করার জন্য আপডেটগুলি প্রয়োগ করলে, আমরা Google Home Test Suite ব্যবহার করে আপনার সংশোধনগুলি পুঙ্খানুপুঙ্খভাবে পরীক্ষা করার পরামর্শ দিচ্ছি। আমরা Test Suite কীভাবে ব্যবহার করবেন সে সম্পর্কে একটি ব্যবহারকারী নির্দেশিকা প্রদান করি, যা আপনাকে আপনার পরিবর্তনগুলি কার্যকরভাবে পরীক্ষা করার ক্ষেত্রে সহায়তা করে।

শেখার সম্পদ

এই ডকুমেন্টে আপনার স্মার্ট হোম অ্যাকশনের ত্রুটিগুলি সমাধানের পদক্ষেপগুলি দেওয়া হয়েছে। ডিবাগিং সম্পর্কে আরও জানতে আপনি আমাদের কোডল্যাবগুলিও দেখতে পারেন:

স্মার্ট হোম কোডল্যাব ডিবাগিং : স্মার্ট হোম ক্লাউড ইন্টিগ্রেশন ডিবাগ করার জন্য দ্রুত শুরু করার নির্দেশিকা।
লোকাল হোম কোডল্যাব ডিবাগিং : স্মার্ট হোম লোকাল ইন্টিগ্রেশন ডিবাগ করার জন্য দ্রুত শুরু করার নির্দেশিকা।