יומנים של 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 נכשל בהעלאת הקובץ שצוין בגלל השגיאה שהוחזרה:

הכלי להעלאת נתונים ינסה להעלות את הקובץ 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 נתקל בבעיה בניסיון לדחוס את הקובץ לפני ההעלאה. במקרה כזה, הקובץ הלא דחוס יועלה.