יש שתי דרכים לשלוח שגיאות מהאפליקציות שלכם ב-Compute Engine אל Error Reporting:
על ידי רישום ביומן ב-Cloud Logging. אם אתם כבר משתמשים ב-Cloud Logging, הדרישה הנוספת היחידה היא שרשומות היומן יהיו מזוהות על ידי Error Reporting. מידע נוסף על דרישות הפורמט של שגיאות זמין במאמר עיצוב שגיאות ב-Cloud Logging.
באמצעות Error Reporting API. האפליקציה יכולה לשלוח בקשות HTTP באמצעות API בארכיטקטורת REST, או להשתמש בספריות ניסיוניות בכמה שפות.
שימוש ברישום ביומן כדי לדווח על שגיאות
כדי לקשר את האפליקציות של Compute Engine אל Error Reporting, צריך לשלוח את החריגים או שגיאות אחרות אל Logging.
לדוגמה:
- מתקינים את סוכן הרישום
google-fluentdבהתאם לסביבה שלכם. הוראות מפורטות מופיעות במאמר בנושא התקנת סוכן Logging. משנים את האפליקציה כך שהיא תתעד חריגים ואת עקבות המחסנית שלהם ב-Logging.
צריך לכלול את כל המידע לגבי שגיאה או חריג אחד באותה רשומה ביומן, כולל כל המסגרות של כל דוח קריסות. אם כל המידע לא נמצא ביחד, יכול להיות שהתכונה 'דיווח על שגיאות' לא תזהה את השגיאה. אתם יכולים להשתמש בפורמט JSON מובנה עבור מטען הייעודי (payload) של רשומות ביומן כדי לכלול סוגים שונים של מידע לכל שגיאה.
Java
מוסיפים לקובץ pom.xml את הנתונים הבאים:
לאחר מכן משתמשים בקוד כמו זה שבהמשך כדי לשלוח את נתוני החריגה:
Python
קודם כול, מתקינים את ספריית fluent-logger-python:
sudo pip install fluent-logger
לאחר מכן משתמשים בקוד כמו זה שבהמשך כדי לשלוח את נתוני החריגה:
Node.js
קודם כול, מתקינים את ספריית fluent-logger-node:
npm install fluent-logger
לאחר מכן משתמשים בקוד כמו זה שבהמשך כדי לשלוח את נתוני החריגה:
המשך
קודם כול, מתקינים את חבילת fluent-logger-golang:
go get github.com/fluent/fluent-logger-golang/
אחר כך משתמשים בקוד כמו זה שבהמשך כדי לשלוח נתוני שגיאות:
שימוש ב-Error Reporting API כדי לכתוב שגיאות
Error Reporting API מספק נקודת קצה report לכתיבת מידע על שגיאות לשירות.
מפעילים את Error Reporting API.
תפקידים שנדרשים להפעלת ממשקי API
כדי להפעיל ממשקי API, צריך את תפקיד ה-IAM 'אדמין של Service Usage' (
roles/serviceusage.serviceUsageAdmin), שכולל את ההרשאהserviceusage.services.enable. איך מקצים תפקידיםאפשר לדווח על שגיאות ל-API באמצעות API בארכיטקטורת REST או ספריית לקוח.
דוגמאות
ASP.NET
חבילת ה-NuGet של ASP.NET מדווחת על חריגים שלא זוהו מאפליקציות אינטרנט של ASP.NET אל Error Reporting.
התקנת חבילת NuGet
כדי להתקין את חבילת Stackdriver ASP.NET NuGet ב-Visual Studio:
- לוחצים לחיצה ימנית על הפתרון ובוחרים באפשרות Manage NuGet packages for solution (ניהול חבילות NuGet לפתרון).
- מסמנים את תיבת הסימון Include prerelease (הכללת גרסת טרום-הפצה).
- מחפשים את החבילה בשם
Google.Cloud.Diagnostics.AspNetומתקינים אותה.
Usage
אחרי שמתקינים את חבילת Stackdriver ASP.NET NuGet, מוסיפים את ההצהרה הבאה לקוד האפליקציה כדי להתחיל לשלוח שגיאות ל-Stackdriver:
using Google.Cloud.Diagnostics.AspNet;
כדי להפעיל את הדיווח על חריגים, מוסיפים את הקוד HttpConfiguration הבא לשיטה Register של אפליקציית האינטרנט שלכם ב-.NET אחרי שמחליפים את your-project-id במזהה הפרויקט בפועל:
אחרי שמוסיפים את השיטה הזו לאפליקציית ASP.NET, אפשר לראות את כל החריגים שלא נתפסו שמתרחשים בזמן שהם מדווחים ל- Google Cloudבקטע Error Reporting במסוף Google Cloud .
C#
הדוגמה הבאה מופיעה במאגר GoogleCloudPlatform/dotnet-docs-samples. כדי להשתמש בו, אחרי שיוצרים את הפרויקט, מציינים את מזהה הפרויקט:
C:\...\bin\Debug> set GOOGLE_PROJECT_ID=[YOUR_PROJECT_ID]
חשוב להקפיד להחליף את [YOUR_PROJECT_ID] בערך הנכון מהמסוףGoogle Cloud .
לאחר מכן, שולחים נתוני חריגים באמצעות קוד שדומה לקוד הבא:
המשך
Java
Node.js
Ruby
אפשר לקרוא על הגדרת Error Reporting עבור Ruby.
Python
PHP
הצגת קבוצות של שגיאות
נכנסים לדף Error Reporting במסוף Google Cloud :
אפשר גם להשתמש בסרגל החיפוש כדי למצוא את הדף הזה.