การรายงานข้อผิดพลาดโดยอัตโนมัติ
คุณสามารถส่งข้อผิดพลาดจากฟังก์ชันไปยัง Error Reporting ได้ดังที่แสดงด้านล่าง
Node.js
// These WILL be reported to Error Reporting
throw new Error('I failed you'); // Will cause a cold start if not caught
Python
@functions_framework.http
def hello_error_1(request):
# This WILL be reported to Error Reporting,
# and WILL NOT show up in logs or
# terminate the function.
from google.cloud import error_reporting
client = error_reporting.Client()
try:
raise RuntimeError("I failed you")
except RuntimeError:
client.report_exception()
# This WILL be reported to Error Reporting,
# and WILL terminate the function
raise RuntimeError("I failed you")
@functions_framework.http
def hello_error_2(request):
# These errors WILL NOT be reported to Error
# Reporting, but will show up in logs.
import logging
import sys
print(RuntimeError("I failed you (print to stdout)"))
logging.warning(RuntimeError("I failed you (logging.warning)"))
logging.error(RuntimeError("I failed you (logging.error)"))
sys.stderr.write("I failed you (sys.stderr.write)\n")
# This is considered a successful execution and WILL NOT be reported
# to Error Reporting, but the status code (500) WILL be logged.
from flask import abort
return abort(500)
หากต้องการรายงานข้อผิดพลาดแบบละเอียดมากขึ้น คุณสามารถใช้ Client Library ของ Error Reporting ได้
คุณสามารถดูข้อผิดพลาดที่รายงานใน Error Reporting ในคอนโซล Google Cloud ได้ นอกจากนี้ คุณยังดูข้อผิดพลาดที่รายงานจากฟังก์ชันที่เฉพาะเจาะจงได้เมื่อเลือกฟังก์ชันดังกล่าวจากรายการฟังก์ชันใน Google Cloud Console
ข้อยกเว้นที่ไม่ได้จัดการซึ่งฟังก์ชันสร้างขึ้นจะปรากฏใน Error Reporting โปรดทราบว่าข้อยกเว้นที่ไม่ได้จัดการบางประเภท (เช่น ข้อยกเว้นที่เกิดขึ้นแบบไม่พร้อมกัน) จะทำให้เกิดการเริ่มต้นแบบเย็นเมื่อมีการเรียกใช้ฟังก์ชันในอนาคต ซึ่งจะเพิ่มระยะเวลาที่ฟังก์ชันใช้ในการทำงาน
การรายงานข้อผิดพลาดด้วยตนเอง
การนำเข้าทรัพยากร Dependency
หากต้องการรายงานข้อผิดพลาดไปยัง Error Reporting จากฟังก์ชัน ให้นำเข้าฟังก์ชัน error จาก Cloud Functions
logger
SDK ดังนี้
// All available logging functions
const {
log,
info,
debug,
warn,
error,
write,
} = require("firebase-functions/logger");
การส่งไปยัง Cloud Logging
ฟังก์ชัน error จาก Cloud Functions
logger
SDK จะรายงานข้อผิดพลาดไปยังทั้ง Cloud Logging และ Error Reporting หากต้องการรวมบริบทเพิ่มเติมจากข้อผิดพลาดเป็น ข้อมูลที่มีโครงสร้าง ให้ส่งออบเจ็กต์ข้อผิดพลาดเป็นอาร์กิวเมนต์ที่ 2 ดังนี้
} catch (err) {
// Attach an error object as the second argument
error("Unable to read quote from Firestore, sending default instead",
err);