טלמטריית אבחון וניתוח שגיאות מאפשרים לכם לזהות ולפתור כשלים בבקשות ב-Google APIs ובממשקי ה-API של Cloud de Confiance by S3NS . כדי לאבחן את שורש הבעיה באפליקציות, אתם יכולים לבדוק את מדדי השימוש ב-API, את היומנים בצד הלקוח, את יומני הביקורת של Cloud ואת התגובות המובְנות לשגיאות.
רקע
Google APIs הם ממשקי API ברשת שמסופקים על ידי שירותי Google. אפליקציות יכולות לגשת לממשקי Google API דרך JSON HTTP ו-gRPC מסביבות שונות. אנחנו ממליצים למפתחים להשתמש בספריות לקוח שסופקו על ידי Google באפליקציות שלהם. הספריות האלה מטמיעות לוגיקה נפוצה של קוד חוזר, כמו אימות וחלוקה לדפים של רשימות, וכך מצמצמות באופן משמעותי את העלויות הנלוות לפיתוח ואת הטעויות הנפוצות.
מידע נוסף זמין במאמר הסבר על ספריות לקוח.
תחילת העבודה
אם אתם משתמשים חדשים ב-Google APIs, כדאי לפעול לפי ההוראות בדף תחילת העבודה כדי להשלים את שלבי ההכנה של האפליקציה. קודם צריך להשתמש בפקודה curl -v כדי לשלוח בקשות בדיקה ל-Google APIs שרוצים להשתמש בהם.
הוא מאפשר להתנסות ב-Google APIs בלי לכתוב קוד.
במקרים רבים, אפשר לפתור הרבה בעיות לפני שמתחילים לפתח את האפליקציה בפועל.
מידע נוסף זמין במאמר תחילת העבודה.
פתרון בעיות באמצעות מדדים
ממשקי ה-API של Google מספקים מדדי API בחינם, שכוללים היבטים נפוצים של השימוש ב-API, כולל מספר הבקשות, שגיאות, זמני אחזור, גודל הבקשות והתגובות. הם מספקים מימדים מפורטים מבחינת אפליקציות ומיקומים. מפתחים יכולים לגלות שימוש חריג ב-API ולזהות את שורש הבעיה האפשרי. לדוגמה, שגיאות 400 גבוהות יכולות להצביע על כך שיש באגים לוגיים באפליקציה שעברה עדכון לאחרונה, או שגדלים גדולים יותר של בקשות ותגובות יכולים לגרום לביצועים איטיים יותר של האפליקציה.
מידע נוסף זמין במאמר מעקב אחרי השימוש ב-API.
פתרון בעיות באמצעות יומנים
מטעמי אבטחה ופרטיות, Google APIs בדרך כלל לא מספקים יומני API למפתחי אפליקציות. אנחנו ממליצים מאוד למפתחי אפליקציות לתעד שגיאות API בצד הלקוח. אפשר לתעד את השגיאות ביומן באחסון מקומי או ב-API מרוחק לרישום ביומן, כמו Cloud Logging API.
בדרך כלל, היומנים מכילים יותר מידע על שגיאות מאשר המדדים, כמו הודעות שגיאה ופרטי שגיאה. הן מאוד שימושיות ולעתים קרובות נחוצות כדי לפתור בעיות שקשורות לשגיאות API. אם מפתחים מזהים בעיה בשימוש שלהם ב-API, הם יכולים לשלוח שאילתה ליומנים כדי למצוא הודעות שגיאה ופרטים על השגיאות, ולהשתמש במידע כדי לפתור את השגיאות או ליצור קשר עם התמיכה.
יומני ביקורת של Cloud
בפעילויות שקשורות לאבטחה, מוצרי Google Cloud עשויים ליצור יומני ביקורת שמכילים מידע מפורט על הפעילויות. הם מקור מצוין למידע שיעזור לכם לפתור בעיות בשימוש בממשקי Google Cloud API. לדוגמה, התכונה "הרצה לניסיון" של VPC Service Controls יוצרת יומני ביקורת שמאפשרים לאדמינים להעריך את השינויים הקרובים במדיניות.
מידע נוסף זמין במאמר בנושא יומני ביקורת של Cloud.
השגיאות בתהליך תיקון
אם נתקלתם בבעיות בשימוש ב-Google API ומצאתם את המדדים והיומנים המתאימים, תוכלו לפעול לפי ההוראות בדף שגיאות במדריך לעיצוב API כדי לפתור את השגיאות.
בדרך כלל, כל שגיאה ב-API כוללת 3 חלקי מידע: קוד שגיאה, הודעת שגיאה ופרטי שגיאה:
- קוד השגיאה מאפשר לאפליקציות לטפל בשגיאה ברמה גבוהה יותר, כמו ניסיון חוזר אחרי שגיאות
503או אימות מחדש של משתמשים אחרי שגיאות401. הודעת השגיאה מאפשרת למפתחי האפליקציה להבין את השגיאה ולתקן את הלוגיקה של האפליקציה.
פרטי השגיאה מכילים מידע נוסף שהאפליקציות יכולות להשתמש בו כדי לטפל בשגיאה באופן פרוגרמטי.
מידע נוסף זמין בדף שגיאות.