این راهنما نحوه پرسوجو از گزارشهای خطای برنامه Chat در Google Cloud Logs Explorer را شرح میدهد. گزارش های درخواست به:
- بیاموزید که آیا کاربران با خطا مواجه می شوند.
- ببینید چند وقت یکبار خطاها اتفاق میافتند و کدام یک بیشتر هستند.
- پیام های خطای توصیفی و داده های گزارش را بخوانید که به شما در رفع خطاها کمک می کند.
پیش نیازها
- یک حساب Google Workspace با دسترسی به Google Chat.
- یک برنامه چت برای ایجاد یک برنامه چت، این شروع سریع را دنبال کنید.
- ثبت خطا برای برنامه چت را روشن کنید .
گزارش های خطای پرس و جو
در کنسول Google Cloud، محصولات بیشتر > ورود به سیستم > Logs Explorer کلیک کنید.
>در صورت لزوم، برای نمایش سازنده پرس و جو، Show query را روشن کنید.
برای گزارش های خطای برنامه چت، عبارت زیر را وارد کنید:
severity=ERROR resource.type="chat.googleapis.com/Project"
برای مشاهده خطاهای اخیر، روی اجرای پرس و جو کلیک کنید. یا برای دیدن خطاها در حین وقوع، روی گزارشهای جریان کلیک کنید. گزارش های خطای برنامه چت در قسمت «نتایج پرس و جو» ظاهر می شود.
برای کسب اطلاعات بیشتر در مورد Google Cloud Logs Explorer و نوشتن عبارتهای جستجو، به این راهنماها در مستندات Logs Explorer مراجعه کنید:
پیام خطا را از یک گزارش بخوانید
پس از جستجوی گزارش خطا، میتوانید گزارشهای جداگانه را مشاهده کنید که شامل یک بار JSON است که گزارش را توصیف میکند. برای خطاهای برنامه گپ، JSON شامل پیام خطا در jsonPayload.error.message
است. به عنوان مثال، در گزارش نمونه زیر، پیام خطا می گوید که یک تابع Apps Script اجرا نشد:
JSON
{
"insertId": "INSERT_ID",
"jsonPayload": {
"@type": "type.googleapis.com/google.chat.logging.v1.ChatAppLogEntry",
"error": {
"code": 9,
"message": "An Apps Script function failed to execute. To review AppsScript error logs, see \"Logging\" (https://developers.google.com/apps-script/guides/logging)."
},
"deployment": "DEPLOYMENT_ID"
},
"resource": {
"type": "chat.googleapis.com/Project",
"labels": {
"project_id": "PROJECT_ID"
}
},
"timestamp": "2022-12-06T05:24:18.697255Z",
"severity": "ERROR",
"logName": "projects/PROJECT_ID/logs/chat.googleapis.com%2Ferrors",
"receiveTimestamp": "2022-12-06T05:24:19.207936968Z"
}
ملاحظات
هنگام کار با گزارش های خطای برنامه Chat در Google Cloud Logs Explorer، به این نکات توجه داشته باشید:
برای برنامههای چت Google، Logs Explorer در حال حاضر شامل گزارشهایی با شدتهای زیر است که به عیبیابی یک برنامه ناکارآمد کمک میکند:
-
ERROR
گزارشهای سرویسهای مرتبط نیز میتوانند به اشکالزدایی یک برنامه چت کمک کنند. برای مثال، اگر یک برنامه چت با استفاده از Google Cloud Functions مستقر شده است، بهتر است Logs Explorer را برای گزارشهای Cloud Functions نیز بررسی کنید.
-
پیام های خطا همیشه به زبان انگلیسی نوشته می شوند.
Cloud Logging هزینه دارد. برای اطلاعات بیشتر در مورد قیمتگذاری Cloud Logging، به قیمتگذاری مجموعه عملیات Google Cloud مراجعه کنید.
موضوعات مرتبط
پس از جستجو در گزارش های خطا، در صورت یافتن خطا، راهنمای زیر را برای کمک به رفع خطاها مشاهده کنید:
- با نحوه رفع خطاهای برنامه گپ Google مانند «برنامه پاسخ نمیدهد»، «Google Chat API فقط برای کاربران Google Workspace در دسترس است» یا «کاربران را میتوان از فضاها حذف کرد» آشنا شوید .
- با نحوه رفع خطاهای کارت مانند پیامهای کارت، گفتگوها یا پیشنمایش پیوندها که مطابق انتظار اجرا نمیشوند یا کار نمیکنند، بیاموزید .
- نحوه اشکال زدایی را بیاموزید.
این راهنما نحوه پرسوجو از گزارشهای خطای برنامه Chat در Google Cloud Logs Explorer را شرح میدهد. گزارش های درخواست به:
- بیاموزید که آیا کاربران با خطا مواجه می شوند.
- ببینید چند وقت یکبار خطاها اتفاق میافتند و کدام یک بیشتر هستند.
- پیام های خطای توصیفی و داده های گزارش را بخوانید که به شما در رفع خطاها کمک می کند.
پیش نیازها
- یک حساب Google Workspace با دسترسی به Google Chat.
- یک برنامه چت برای ایجاد یک برنامه چت، این شروع سریع را دنبال کنید.
- ثبت خطا برای برنامه چت را روشن کنید .
گزارش های خطای پرس و جو
در کنسول Google Cloud، محصولات بیشتر > ورود به سیستم > Logs Explorer کلیک کنید.
>در صورت لزوم، برای نمایش سازنده پرس و جو، Show query را روشن کنید.
برای گزارش های خطای برنامه چت، عبارت زیر را وارد کنید:
severity=ERROR resource.type="chat.googleapis.com/Project"
برای مشاهده خطاهای اخیر، روی اجرای پرس و جو کلیک کنید. یا برای دیدن خطاها در حین وقوع، روی گزارشهای جریان کلیک کنید. گزارش های خطای برنامه چت در قسمت «نتایج پرس و جو» ظاهر می شود.
برای کسب اطلاعات بیشتر در مورد Google Cloud Logs Explorer و نوشتن عبارتهای جستجو، به این راهنماها در مستندات Logs Explorer مراجعه کنید:
پیام خطا را از یک گزارش بخوانید
پس از جستجوی گزارش خطا، میتوانید گزارشهای جداگانه را مشاهده کنید که شامل یک بار JSON است که گزارش را توصیف میکند. برای خطاهای برنامه گپ، JSON شامل پیام خطا در jsonPayload.error.message
است. به عنوان مثال، در گزارش نمونه زیر، پیام خطا می گوید که یک تابع Apps Script اجرا نشد:
JSON
{
"insertId": "INSERT_ID",
"jsonPayload": {
"@type": "type.googleapis.com/google.chat.logging.v1.ChatAppLogEntry",
"error": {
"code": 9,
"message": "An Apps Script function failed to execute. To review AppsScript error logs, see \"Logging\" (https://developers.google.com/apps-script/guides/logging)."
},
"deployment": "DEPLOYMENT_ID"
},
"resource": {
"type": "chat.googleapis.com/Project",
"labels": {
"project_id": "PROJECT_ID"
}
},
"timestamp": "2022-12-06T05:24:18.697255Z",
"severity": "ERROR",
"logName": "projects/PROJECT_ID/logs/chat.googleapis.com%2Ferrors",
"receiveTimestamp": "2022-12-06T05:24:19.207936968Z"
}
ملاحظات
هنگام کار با گزارش های خطای برنامه Chat در Google Cloud Logs Explorer، به این نکات توجه داشته باشید:
برای برنامههای چت Google، Logs Explorer در حال حاضر شامل گزارشهایی با شدتهای زیر است که به عیبیابی یک برنامه ناکارآمد کمک میکند:
-
ERROR
گزارشهای سرویسهای مرتبط نیز میتوانند به اشکالزدایی یک برنامه چت کمک کنند. برای مثال، اگر یک برنامه چت با استفاده از Google Cloud Functions مستقر شده است، بهتر است Logs Explorer را برای گزارشهای Cloud Functions نیز بررسی کنید.
-
پیام های خطا همیشه به زبان انگلیسی نوشته می شوند.
Cloud Logging هزینه دارد. برای اطلاعات بیشتر در مورد قیمتگذاری Cloud Logging، به قیمتگذاری مجموعه عملیات Google Cloud مراجعه کنید.
موضوعات مرتبط
پس از جستجو در گزارش های خطا، در صورت یافتن خطا، راهنمای زیر را برای کمک به رفع خطاها مشاهده کنید:
- با نحوه رفع خطاهای برنامه گپ Google مانند «برنامه پاسخ نمیدهد»، «Google Chat API فقط برای کاربران Google Workspace در دسترس است» یا «کاربران را میتوان از فضاها حذف کرد» آشنا شوید .
- با نحوه رفع خطاهای کارت مانند پیامهای کارت، گفتگوها یا پیشنمایش پیوندها که مطابق انتظار اجرا نمیشوند یا کار نمیکنند، بیاموزید .
- نحوه اشکال زدایی را بیاموزید.