כדי לפתור בעיות ב-UDCA ב-Apigee hybrid, צריך לבדוק את קובצי היומן. היומנים של UDCA נכתבים ל-stdout/stderr ואפשר לראות אותם באמצעות הפקודה kubectl logs.
במכונת הניהול של Kubernetes, מריצים את הפקודה הבאה:
kubectl logs pod_name apigee-udca -n namespace
בטבלה הבאה מפורטות הודעות שגיאה נפוצות שעשויות להופיע בקובצי היומן של UDCA והמשמעות שלהן. הודעות ביומן יכללו חותמת זמן ולעתים קרובות גם מעקב אחר מחסנית או מידע אחר שיעזור לכם לאבחן ולפתור את הבעיה.
| סוג הרשומה | הודעה ביומן | משמעות |
|---|---|---|
| שגיאה | Failed to create directory for dataset
dataset_name |
הספרייה שהוגדרה למערך הנתונים הנתון לא הייתה קיימת, והכלי UDCA לא הצליח ליצור אותה. יכול להיות שיש בעיה בהרשאות בהגדרה.
הבעיה הזו מונעת את ההפעלה של UDCA. |
| שגיאה | Shutdown action was interrupted. It is possible that some
data will be lost |
במסגרת ההשבתה, UDCA מנסה להעלות את כל הקבצים בדיסק.
ההודעה הזו מציינת שהכיבוי נמשך יותר זמן מהצפוי, ויכול להיות שחלק מהנתונים לא הועלו ולכן אבדו. |
| שגיאה | Scheduled DatasetHandler for dataset
dataset_name encountered an exception. |
במהלך ניסיון לבצע פעולה במערך הנתונים שצוין, אירעה חריגה לא צפויה בזמן שליחת שאילתות לסקר את הספרייה שהוגדרה או בזמן העלאת הקבצים. |
| שגיאה | Upload failed for file filename. Max Retries
exceeded! Moving dir to failed folder. |
הכלי UDCA נכשל בהעלאת הקובץ שצוין והעביר את הקובץ אל תיקיית המשנה /failed של מערך הנתונים. |
| שגיאה | Re-queuing files from failed directory encountered an exception. |
כלי UDCA מוסיף מחדש קבצים לתור מהספרייה /failed אחרי העלאה מוצלחת. כך מבטיחים שכלי UDCA ינסה שוב להעלות קבצים אחרי שייפתרו בעיות ברשת או בשרת במעלה הזרם.
ההודעה הזו מציינת ש-UDCA נתקל בשגיאה כשניסה להוסיף מחדש את הקובץ לתור. |
| שגיאה | Shutting down datasetHandler encountered an exception. |
הייתה חריגה ב-UDCA במהלך הניסיון לבצע כיבוי. |
| שגיאה | Failed to move file from directory_name to
directory_name. |
הכלי UDCA נתקל בחריגה במהלך העברת קובץ בין תיקיות משנה לצורך ניהול פנימי של מחזור החיים. |
| שגיאה | Failed to delete file filename. |
כלי UDCA נתקל בחריגה במהלך מחיקת קובץ אחרי העלאה מוצלחת. |
| אזהרה | Received 429 - Too many Requests from upstream service.
Skipping remaining files in this iteration and will retry
again |
הכלי UDCA קיבל שגיאה של חריגה מהמכסה משירות במעלה הזרם. כתוצאה מכך, הכלי UDCA דילג על הקבצים שנותרו באיטרציה הזו וינסה שוב במרווח הבא. |
| אזהרה | File upload failed for filename.
error_message |
הכלי UDCA נכשל בהעלאת הקובץ שצוין בגלל השגיאה שהוחזרה:
.
הכלי UDCA ינסה להעלות את הקובץ 3 פעמים לפני שיעביר אותו לספריית המשנה /failed של מערך הנתונים. |
| אזהרה | Request request_URI timed out. Aborting request |
הזמן שהוקצב לבקשה הלא סנכרונית שצוינה להעלאת הקובץ הסתיים והבקשה בוטלה. |
| אזהרה | Request request_URI failed. Exception
exception |
הבקשה הלא סנכרונית שצוינה נכשלה עם חריגה. |
| אזהרה | Metrics Computation Failed:
error_message |
במהלך החישוב התקופתי של מדדי מערכת הקבצים של UDCA נתקלה המערכת בחריג. |