יומנים של UDCA

כדי לפתור בעיות ב-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 נתקל בחריגה במהלך מחיקת קובץ אחרי העלאה מוצלחת.
שגיאה Failed to rename file from file_name to file_name. הכלי UDCA נתקל בחריגה במהלך הוספת UUID לקובץ בזמן שינוי השם.
אזהרה 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 נתקלה חריגה.
אזהרה Will attempt to upload api file file_name uncompressed כלי ה-UDCA נתקל בבעיה בניסיון לדחוס את הקובץ לפני ההעלאה. במקרה כזה, הקובץ הלא דחוס יועלה.