การแก้ปัญหาข้อผิดพลาดในการผสานรวม

ระบบคลาวด์ต่อระบบคลาวด์    Matter

Google Cloud มีเครื่องมือให้คุณตรวจสอบความน่าเชื่อถือของโปรเจ็กต์ ด้วย Google Cloud Monitoring และแก้ไขข้อบกพร่องด้วยบันทึกข้อผิดพลาด Google Cloud Logging เมื่อใดก็ตามที่เกิดความล้มเหลวในการตอบสนองความตั้งใจของผู้ใช้ ไปป์ไลน์ข้อมูลวิเคราะห์ Google Home จะบันทึกความล้มเหลวนั้นในเมตริกของคุณ และ เผยแพร่บันทึกข้อผิดพลาดในบันทึกของโปรเจ็กต์

การแก้ปัญหาข้อผิดพลาดมี 2 ขั้นตอนดังนี้

  1. ตรวจสอบสถานะของโปรเจ็กต์ด้วยเมตริกสมาร์ทโฮม
  2. ตรวจสอบปัญหาโดยดูคำอธิบายข้อผิดพลาดโดยละเอียดใน บันทึกข้อผิดพลาด

กระบวนการนี้จะคล้ายกับการผสานรวมในเครื่องโดยใช้ Local Home SDK เมื่อเชี่ยวชาญขั้นตอนการแก้ปัญหาแล้ว คุณจะสลับไปมาระหว่างเมตริกและบันทึกได้อย่างง่ายดายเพื่อรับข้อมูลเชิงลึกเกี่ยวกับข้อผิดพลาด

คุณเลือกทดสอบ Action ได้โดยแชร์กับผู้ใช้รายอื่น โปรดจัดการข้อผิดพลาดและข้อยกเว้น อย่างเหมาะสม

การตรวจสอบข้อผิดพลาด

คุณสามารถใช้ Google Cloud Monitoring dashboards เพื่อเข้าถึงเมตริกของโปรเจ็กต์ แผนภูมิที่สำคัญบางส่วนซึ่งมีประโยชน์อย่างยิ่ง ในการตรวจสอบคุณภาพและแก้ไขข้อบกพร่องมีดังนี้

  • แผนภูมิอัตราความสำเร็จเป็นแผนภูมิแรกที่ควรเริ่มดูเมื่อคุณ ตรวจสอบความน่าเชื่อถือของโปรเจ็กต์ การลดลงในแผนภูมินี้อาจ บ่งบอกถึงการหยุดทำงานสำหรับผู้ใช้บางส่วนหรือทั้งหมด เราขอแนะนำให้ ติดตามแผนภูมินี้อย่างใกล้ชิดเพื่อดูความผิดปกติหลังจากการเปลี่ยนแปลง หรือการอัปเดตโปรเจ็กต์แต่ละครั้ง
  • แผนภูมิเวลาในการตอบสนองเปอร์เซ็นไทล์ที่ 95 เป็นตัวบ่งชี้ที่สำคัญว่าการผสานรวม Cloud-to-cloud ทำงานได้ดีเพียงใดสำหรับผู้ใช้ ความผันผวนอย่างฉับพลันในแผนภูมินี้อาจบ่งบอกว่าระบบของคุณอาจ ไม่สามารถรับคำขอได้ เราขอแนะนำให้ตรวจสอบแผนภูมินี้เป็นระยะๆ เพื่อดูพฤติกรรมที่ไม่คาดคิด
  • แผนภูมิรายละเอียดข้อผิดพลาดจะมีประโยชน์มากที่สุดเมื่อต้อง แก้ปัญหาในการผสานรวม สำหรับข้อผิดพลาดทุกรายการที่ไฮไลต์ในแผนภูมิเปอร์เซ็นต์ความสำเร็จ รหัสข้อผิดพลาดจะแสดงในรายละเอียดข้อผิดพลาด คุณดูข้อผิดพลาดที่Google Home platformแจ้งและวิธีแก้ปัญหาได้ในตารางด้านล่าง

รหัสข้อผิดพลาดของแพลตฟอร์มที่พบบ่อย

รหัสข้อผิดพลาดที่พบบ่อยบางส่วนที่คุณอาจเห็นในบันทึกของโปรเจ็กต์เพื่อ ระบุปัญหาที่ Google Home platform ตรวจพบ ดูข้อมูลการแก้ปัญหาได้ใน ตารางต่อไปนี้ ดูรายการรหัสข้อผิดพลาดทั้งหมดได้ที่ ข้อผิดพลาดและข้อยกเว้น

รหัสข้อผิดพลาด คำอธิบาย พาร์ทเนอร์ดำเนินการได้
ACTION_NOT_AVAILABLE คำสั่งไม่ถูกต้องสำหรับสถานะปัจจุบันของอุปกรณ์ (เช่น "ตั้งอุณหภูมิ" ขณะที่อุปกรณ์ปิดอยู่)

ยืนยันตรรกะลักษณะของอุปกรณ์และสถานะปัจจุบันในการดำเนินการตามคำสั่ง 		ใช่
AGENT_ISSUE เกิดปัญหาทั่วไปกับตัวแทนระบบคลาวด์ของพาร์ทเนอร์

ตรวจสอบข้อยกเว้นที่ไม่ได้จัดการหรือข้อขัดข้องในบันทึกการดำเนินการตามคำสั่ง 		ใช่
AGENT_UNAVAILABLE_ERROR Google เข้าถึง URL การปฏิบัติตามคำสั่งของพาร์ทเนอร์ไม่ได้

ตรวจสอบว่าเซิร์ฟเวอร์ออนไลน์ ไฟร์วอลล์ไม่ได้บล็อก Google และ URL ถูกต้อง 		ใช่
APP_LAUNCH_FAILED เปิดแอปของบุคคลที่สามในอุปกรณ์เป้าหมายไม่สำเร็จ

ยืนยัน appId และตรวจสอบว่าฮาร์ดแวร์เป้าหมายรองรับแอป 		ใช่
AUTH_EXPIRED โทเค็นเพื่อการเข้าถึง OAuth หมดอายุและรีเฟรชไม่ได้

ตรวจสอบการหมุนเวียนโทเค็นการรีเฟรชและตรวจสอบว่าผู้ใช้ไม่ได้เพิกถอนสิทธิ์เข้าถึง 		ใช่
BACKEND_FAILURE_URL_TIMEOUT คำขอของ Google หมดเวลาเมื่อพยายามเข้าถึงบริการของคุณ

ตรวจสอบว่าบริการของคุณออนไลน์ รับการเชื่อมต่อ และไม่ได้มีผู้ใช้เกินความจุ นอกจากนี้ ให้ตรวจสอบว่าอุปกรณ์เป้าหมาย เปิดอยู่ ออนไลน์ และซิงค์แล้ว
BACKEND_FAILURE_URL_UNREACHABLE Google ได้รับรหัสข้อผิดพลาด HTTP 5xx จากบริการของคุณ

ใช้ requestId ใน Google Cloud Logging เพื่อตรวจสอบ บันทึกบริการสมาร์ทโฮม
CHANNEL_SWITCH_FAILED อุปกรณ์เปลี่ยนไปใช้ช่องสื่อที่ขอไม่ได้

ยืนยันชื่อ/หมายเลขช่องและสถานะการติดตามสำหรับผู้ใช้ 		ใช่
CHARGER_ISSUE อุปกรณ์รายงานปัญหาเกี่ยวกับฮาร์ดแวร์ของระบบการชาร์จ

พาร์ทเนอร์ควรตรวจสอบการวัดและส่งข้อมูลทางไกลระดับฮาร์ดแวร์และ ประสิทธิภาพแบตเตอรี่ 		ใช่
CHECK_PARTNER_APP ข้อผิดพลาดกำหนดให้ผู้ใช้เปิดแอปของพาร์ทเนอร์เพื่อแก้ไข

ใช้รหัสนี้สำหรับข้อผิดพลาดที่ต้องมีการโต้ตอบ UI ที่ซับซ้อน (เช่น การอัปเดตเฟิร์มแวร์) 		ใช่
COMMAND_FAILED เกิดข้อผิดพลาดทั่วไปในระหว่างการดำเนินการคำสั่ง

ตรวจสอบบันทึกการดำเนินการตามคำสั่งซื้อเพื่อดู requestId ที่เฉพาะเจาะจงเพื่อหาสาเหตุที่แท้จริง 		ใช่
COMMAND_INSERT_FAILED Google ไม่สามารถจัดคิวหรือประมวลผลคำสั่งสำหรับอุปกรณ์ได้

ตรวจสอบประสิทธิภาพการเขียนฐานข้อมูลหรือตรรกะการจัดคิวคำสั่งภายใน 		ใช่
DEVICE_NOT_FOUND ไม่มีรหัสอุปกรณ์ในคำขอในฝั่งพาร์ทเนอร์

ตรวจสอบว่าระบบคลาวด์ทริกเกอร์ requestSync เมื่อผู้ใช้ เพิ่มหรือลบอุปกรณ์ 		ใช่
ERROR_STATUS การตอบกลับระบุสถานะ "ERROR" ที่ไม่เฉพาะเจาะจงโดยไม่มีรหัส

ใส่errorCodeสตริงที่เฉพาะเจาะจงเสมอเพื่อปรับปรุง ข้อมูล TTS และแดชบอร์ดของผู้ใช้ 		ใช่
EXECUTION_BACKEND_FAILURE_URL_ERROR Google ได้รับข้อผิดพลาด HTTP 4xx (นอกเหนือจาก 401) จาก Fulfillment ของคุณ

ตรวจสอบบันทึกของเว็บเซิร์ฟเวอร์เพื่อหาการตอบกลับ 403, 404 หรือ 400 		ใช่
EXECUTION_BACKEND_FAILURE_URL_ROBOTED URL การปฏิบัติตามคำสั่งถูกบล็อกโดย robots.txt หรือตัวกรองความปลอดภัย

ตรวจสอบว่า Crawler/บริการของ Google เข้าถึงปลายทางการดำเนินการตามคำสั่งได้ 		ใช่
EXECUTION_BACKEND_FAILURE_URL_UNREACHABLE Google ได้รับข้อผิดพลาด HTTP 5xx จากบริการจัดการคำสั่งซื้อของคุณ

ตรวจสอบเซิร์ฟเวอร์ขัดข้อง หมดเวลา หรือข้อผิดพลาดของเกตเวย์ 502/503 		ใช่
EXECUTION_BAILOUT_INVALID_RESPONSE การตอบกลับ JSON มีรูปแบบไม่ถูกต้องมากจนต้องยกเลิกการประมวลผล

ใช้เครื่องมือตรวจสอบ JSON เพื่อให้มั่นใจว่าการตอบกลับเป็นไปตาม สคีมา Intent อย่างเคร่งครัด 		ใช่
EXECUTION_GAL_BAD_3P_RESPONSE การลิงก์บัญชีไม่สำเร็จเนื่องจากรูปแบบในการตอบกลับโทเค็นไม่ถูกต้อง

ตรวจสอบว่ารูปแบบการตอบกลับของเซิร์ฟเวอร์ OAuth ตรงกับข้อกำหนดของ Google 		ใช่
EXECUTION_GAL_INSUFFICIENT_CAPABILITIES บัญชีของผู้ใช้ไม่มีสิทธิ์ที่จำเป็นสำหรับการดำเนินการนี้

ตรวจสอบขอบเขตที่ขอระหว่าง OAuth และตรวจสอบว่าตรงกับลักษณะที่จำเป็น 		ใช่
EXECUTION_GAL_MAYBE_UNLINKED_BY_3P ระบบคลาวด์ของพาร์ทเนอร์จะระบุว่าผู้ใช้ได้ยกเลิกการลิงก์บัญชีแล้ว

ตรวจสอบว่าagentUserIdการแมปมีความเสถียรและไม่ได้ ถูกล้าง 		ใช่
EXECUTION_GAL_READ_ONLY_MODE_FOR_3P การผสานรวมอยู่ในสถานะอ่านอย่างเดียวในฝั่งพาร์ทเนอร์

ตรวจสอบว่าบัญชีของผู้ใช้ถูกระงับหรืออยู่ในโหมดการบำรุงรักษา "ดูอย่างเดียว" หรือไม่ 		ใช่
EXECUTION_GAL_UNLINKED_BY_3P บริการของบุคคลที่สามยกเลิกการลิงก์บัญชีโดยอัตโนมัติ

ตรวจสอบสาเหตุที่ระบบตัดการเชื่อมต่อผู้ใช้ (เช่น การรีเซ็ต ด้านความปลอดภัย) 		ใช่
EXECUTION_INVALID_JSON Google แยกวิเคราะห์เพย์โหลดการตอบกลับ JSON ไม่ได้

ตรวจสอบข้อผิดพลาดทางไวยากรณ์ วงเล็บที่ขาดหายไป หรืออักขระที่ไม่ถูกต้องใน คำตอบของคุณ 		ใช่
FAULTY_BATTERY ฮาร์ดแวร์ของอุปกรณ์รายงานว่าแบตเตอรี่เสื่อมหรือหมด

สั่งให้ผู้ใช้เปลี่ยนแบตเตอรี่จริงโดยใช้ TTS หรือแอป 		ใช่
FUNCTION_NOT_SUPPORTED อุปกรณ์ไม่รองรับโหมดหรือฟังก์ชันที่ขอ

ตรวจสอบว่าการตอบกลับของ SYNC แสดงถึง ความสามารถของอุปกรณ์อย่างถูกต้อง 		ใช่
HARD_ERROR ความล้มเหลวที่ไม่ใช่แบบชั่วคราวซึ่งจะไม่ได้รับการแก้ไขหากไม่มีการแทรกแซงด้วยตนเอง

ใช้ในกรณีที่ฮาร์ดแวร์ล้มเหลวอย่างถาวรหรือบัญชีอยู่ในสถานะที่กู้คืนไม่ได้ 		ใช่
INVALID_AUTH_TOKEN Google ได้รับรหัสข้อผิดพลาด HTTP 401 จากบริการของคุณ

โทเค็นเพื่อการเข้าถึงยังไม่หมดอายุ แต่บริการของคุณทำให้โทเค็นดังกล่าวไม่ถูกต้อง ใช้ requestId ใน Cloud Logging ของ Google เพื่อตรวจสอบบันทึกบริการสมาร์ทโฮม
INVALID_JSON โครงสร้างการตอบกลับไม่ถูกต้อง (เช่น ไม่มีช่องที่บังคับ )

ตรวจสอบการตอบกลับกับ สคีมา JSON ของ Intent 		ใช่
LOCK_FAILURE ล็อกอัจฉริยะเปลี่ยนไปอยู่ในสถานะที่ขอไม่ได้

ตรวจสอบการติดขัดทางกายภาพ ไฟเหลือน้อย หรือมอเตอร์ขัดข้องในฮาร์ดแวร์ ของล็อก 		ใช่
MALFORMED_JSON โครงสร้าง JSON เสีย (เช่น สตริงหรือออบเจ็กต์ที่ไม่ได้ปิด)

ตรวจสอบว่าการดำเนินการตามคำสั่งใช้ไลบรารี JSON มาตรฐานเพื่อทำการซีเรียลไลซ์ การตอบกลับ 		ใช่
MISSING_STATE การตอบกลับ QUERY ไม่มีสถานะอุปกรณ์ที่ขอ

ตรวจสอบว่าลักษณะทั้งหมดที่กำหนดไว้ใน SYNC มีอยู่ใน การตอบกลับ QUERY ทุกครั้ง 		ใช่
NETWORK_PROFILE_NOT_RECOGNIZED อุปกรณ์ไม่รู้จักโปรไฟล์เครือข่ายที่ขอ

ยืนยันว่าสตริงชื่อโปรไฟล์ตรงกับโปรไฟล์ที่รองรับในคำตอบของ SYNC 		ใช่
NOT_IMPLEMENTED พาร์ทเนอร์ไม่ได้ใช้ Intent หรือลักษณะที่ขอ

รวมเฉพาะลักษณะในคำตอบ SYNC ที่คุณได้ นำไปใช้จนครบถ้วนแล้ว 		ใช่
OAUTH_RECONNECT_CALL_TO_ACTION ทริกเกอร์การแจ้งเตือนให้ผู้ใช้ลิงก์บัญชีอีกครั้ง

ใช้เมื่อเซสชันของผู้ใช้ไม่ถูกต้องและต้องมีการ ตรวจสอบสิทธิ์ OAuth อีกครั้งด้วยตนเอง 		ใช่
OPEN_AUTH_FAILURE โทเค็นเพื่อการเข้าถึงของผู้ใช้หมดอายุแล้วและ Google รีเฟรชไม่ได้ หรือ Google ได้รับรหัสข้อผิดพลาด HTTP 401 จากบริการของคุณ

หากเห็นว่าอัตราของรหัสนี้เพิ่มขึ้น ให้ตรวจสอบว่าคุณเห็นอัตราข้อผิดพลาดที่เพิ่มขึ้น ซึ่งเกี่ยวข้องกับเจตนาของสมาร์ทโฮมหรือคำขอโทเค็นการรีเฟรชด้วยหรือไม่
PARTNER_RESPONSE_INVALID_ERROR_CODE สตริง errorCode ที่แสดงผลไม่ได้อยู่ในรายการที่ Google รองรับ

แมปข้อผิดพลาดภายในกับ รายการข้อผิดพลาดอย่างเป็นทางการ 		ใช่
PARTNER_RESPONSE_INVALID_PAYLOAD ฟิลด์ payload ในการตอบกลับไม่ใช่ออบเจ็กต์ JSON ที่ถูกต้อง

ยืนยันโครงสร้างรูทของการตอบกลับการดำเนินการตามคำสั่ง 		ใช่
PARTNER_RESPONSE_INVALID_STATUS การตอบกลับ status ไม่ใช่ SUCCESS, ERROR หรือ OFFLINE

ตรวจสอบว่าผลลัพธ์ของอุปกรณ์ทุกรายการในคำตอบมีสตริงสถานะที่ถูกต้อง 		ใช่
PARTNER_RESPONSE_MISSING_COMMANDS_AND_DEVICES การตอบกลับไม่มีผลลัพธ์สำหรับคำสั่ง/อุปกรณ์ที่ขอทั้งหมด

สินค้าทุกรายการในอาร์เรย์ commands ของคำขอต้องมีรายการคำตอบที่สอดคล้องกัน 		ใช่
PARTNER_RESPONSE_MISSING_DEVICE ระบบได้ละเว้นอุปกรณ์บางอย่างที่ Google ร้องขอจากคำตอบ

ตรวจสอบว่าการตอบกลับมี ID ทุกรายการที่ระบุไว้ใน เพย์โหลดคำขอ 		ใช่
PARTNER_RESPONSE_MISSING_PAYLOAD การตอบกลับไม่มีช่อง payload ที่บังคับ

ตรวจสอบว่าออบเจ็กต์ JSON ระดับบนสุดมีคีย์ payload 		ใช่
PARTNER_RESPONSE_NOT_OBJECT แยกวิเคราะห์การตอบกลับทั้งหมดเป็นออบเจ็กต์ JSON ไม่ได้

ตรวจสอบอักขระต่อท้ายหรือเนื้อหาที่ไม่ใช่ JSON ในเนื้อความการตอบกลับ HTTP 		ใช่
PROTOCOL_ERROR เกิดข้อผิดพลาดในโปรโตคอลการสื่อสารพื้นฐาน

ตรวจสอบปัญหาเกี่ยวกับส่วนหัว HTTP หรือการแฮนด์เชค SSL/TLS ที่ล้มเหลว 		ใช่
RELINK_REQUIRED ผู้ใช้ต้องลิงก์บัญชีอีกครั้งเพื่อใช้การผสานรวมต่อไป

ตรวจสอบว่าเซิร์ฟเวอร์แสดงรหัสนี้เมื่อโทเค็นสำหรับรีเฟรช ไม่ถูกต้องอย่างถาวร 		ใช่
REQUEST_ID_NOT_FOUND Google ไม่พบรหัสการติดตามภายในสำหรับคำขอ

โดยปกติจะเป็นข้อผิดพลาดภายในแพลตฟอร์ม ให้ตรวจสอบการเพิ่มขึ้นอย่างรวดเร็วและติดต่อ ทีมสนับสนุน 		ใช่
RESOURCE_UNAVAILABLE ทรัพยากรที่ขอ (อุปกรณ์หรือลักษณะ) ไม่พร้อมใช้งาน

ตรวจสอบว่าอุปกรณ์ "ไม่ว่าง" หรือถูกปิดใช้ชั่วคราว 		ใช่
RESPONSE_TIMEOUT บริการจัดการคำสั่งซื้อไม่ตอบกลับภายใน 9 วินาที

เพิ่มประสิทธิภาพเวลาในการตอบสนองของแบ็กเอนด์ ตรวจสอบการค้นหา DB ที่ช้าหรือ ความหน่วงของเครือข่ายระดับภูมิภาค 		ใช่
RESPONSE_UNAVAILABLE ไม่ได้รับการตอบกลับจาก URL การปฏิบัติตามข้อกำหนดของพาร์ทเนอร์

ตรวจสอบว่าบริการทำงานอยู่และปลายทางไม่ขัดข้อง 		ใช่
SCENE_CANNOT_BE_APPLIED เปิดใช้งานฉากที่ขอไม่ได้ (เช่น ไม่มีอุปกรณ์)

ตรวจสอบสถานะภายในของฉากของผู้ใช้ในระบบคลาวด์ของพาร์ทเนอร์ 		ใช่
STREAM_UNPLAYABLE เริ่มสตรีมกล้องไม่ได้หรือสตรีมล้มเหลว

ยืนยันการส่งสัญญาณ WebRTC/HLS และตรวจสอบว่า URL ของสตรีมถูกต้อง 		ใช่
TIMEOUT เกิดการหมดเวลาทั่วไปขณะประมวลผลความตั้งใจ

ตรวจสอบบันทึกการหมดเวลาของบริการภายในระหว่างระบบคลาวด์กับ ฮับอุปกรณ์ 		ใช่
TRANSIENT_ERROR ข้อผิดพลาดชั่วคราวคือข้อผิดพลาดที่จะได้รับการแก้ไขเอง

โดยปกติแล้ว ข้อผิดพลาดเหล่านี้จะแสดงเป็นการเชื่อมต่อกับอุปกรณ์หรือ บริการที่ถูกตัด รวมถึงหากเปิดการเชื่อมต่อใหม่กับเซิร์ฟเวอร์ไม่ได้
UNABLE_TO_LOCATE_DEVICE ไม่พบอุปกรณ์โดยใช้ลักษณะ Locator (เช่น ping ไม่สำเร็จ)

ตรวจสอบการเชื่อมต่อในพื้นที่ของอุปกรณ์ (Wi-Fi/บลูทูธ) 		ใช่
UNABLE_TO_RING_DEVICE เข้าถึงอุปกรณ์ได้ แต่เรียกใช้ฟังก์ชันการแจ้งเตือน/การสั่น ไม่ได้

ตรวจสอบสถานะการแจ้งเตือน/ลำโพงและระดับเสียงของฮาร์ดแวร์ 		ใช่
UNABLE_TO_SILENCE_DEVICE อุปกรณ์หยุดการแจ้งเตือน/การส่งเสียงที่ใช้งานอยู่ไม่ได้

ตรวจสอบความล้มเหลวในการสื่อสารระหว่างระบบคลาวด์กับอุปกรณ์จริง 		ใช่
UNEXPECTED_ERROR_CHECK_DEVICE_APP เกิดข้อผิดพลาดที่ไม่คาดคิด ผู้ใช้ควรตรวจสอบแอปพาร์ทเนอร์

ใช้เป็นข้อผิดพลาดแบบครอบคลุมสำหรับข้อผิดพลาดที่ไม่มี ข้อผิดพลาดที่เทียบเท่าซึ่ง Google รองรับ 		ใช่
UNKNOWN_ERROR ข้อผิดพลาดทั่วไปที่ไม่มีรายละเอียดเพิ่มเติม

ตั้งเป้าที่จะแทนที่ด้วยรหัสข้อผิดพลาดที่เฉพาะเจาะจงมากขึ้นเพื่อปรับปรุง การแก้ปัญหา 		ใช่
UNLOCK_FAILURE สมาร์ทล็อกเปลี่ยนเป็นสถานะ "ปลดล็อก" ไม่ได้

ตรวจสอบการติดขัดของฮาร์ดแวร์ แบตเตอรี่เหลือน้อย หรือการป้อน PIN ไม่ถูกต้อง 		ใช่

ข้อมูลบันทึกการค้นหา

เมื่อคุ้นเคยกับการตรวจสอบการผสานรวมโดยใช้เมตริกแล้ว ขั้นตอนถัดไปคือการแก้ปัญหาข้อผิดพลาดที่เฉพาะเจาะจงโดยใช้ Cloud Logging บันทึกข้อผิดพลาดคือ รายการที่คล้ายกับ JSON ซึ่งมีฟิลด์ที่มีข้อมูลที่เป็นประโยชน์ เช่น เวลา รหัสข้อผิดพลาด และรายละเอียดเกี่ยวกับเจตนาสมาร์ทโฮมต้นทาง

Google Cloud มีหลายระบบที่ส่งบันทึกไปยังโปรเจ็กต์ของคุณตลอดเวลา คุณต้องเขียนการค้นหาเพื่อกรองบันทึก และค้นหาบันทึกที่ต้องการ ข้อความค้นหาอาจอิงตามช่วงเวลา ทรัพยากร ความรุนแรงของบันทึก หรือรายการที่กำหนดเอง

ค้นหาบันทึกของระบบคลาวด์

คุณสามารถใช้ปุ่มการค้นหาเพื่อช่วยสร้างตัวกรองที่กำหนดเอง

สร้างการค้นหาใน Cloud Logs

หากต้องการระบุช่วงเวลา ให้คลิกปุ่มเลือกช่วงเวลา แล้วเลือกตัวเลือกที่ต้องการ ซึ่งจะกรองบันทึกและแสดงบันทึกที่มาจาก ช่วงเวลาที่เลือก

หากต้องการระบุทรัพยากร ให้คลิกเมนูแบบเลื่อนลงทรัพยากร แล้วเลือกโปรเจ็กต์การดำเนินการของ Google Assistant ซึ่งจะเพิ่มตัวกรองในคำค้นหาเพื่อแสดงบันทึกที่มาจากโปรเจ็กต์

ใช้ปุ่มความรุนแรงเพื่อกรองตามฉุกเฉิน ข้อมูล แก้ไขข้อบกพร่อง และระดับบันทึกความรุนแรงอื่นๆ

นอกจากนี้ คุณยังใช้ช่องคำค้นหาใน 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 ซึ่งจะแนะนําคุณตลอดการทดสอบการเปลี่ยนแปลง อย่างมีประสิทธิภาพ

แหล่งข้อมูลการเรียนรู้

เอกสารนี้จะแสดงขั้นตอนในการแก้ปัญหาข้อผิดพลาดในสมาร์ทโฮม แอ็กชัน นอกจากนี้ คุณยังดูข้อมูลเพิ่มเติมเกี่ยวกับการแก้ไขข้อบกพร่องได้ที่ Codelab ของเรา

ก่อนหน้า
Cloud Logging