בדיקת סטטוס ההעלאה ושגיאות

אפשר לבדוק את הסטטוס של העלאות מטא-נתונים ונתוני זמן ריצה בכל שלב על ידי שליחת שאילתה לנקודת הקצה המקומית של הסטטוס של מחבר Apigee API Hub לענן פרטי.

בדיקת סטטוס ההעלאה

מריצים את פקודת ה-curl הבאה במכונה הווירטואלית שבה פועל המחבר Apigee API Hub for Private Cloud: 

curl localhost:8080/v1/uapim/status
 תגובה מוצלחת מחזירה אובייקט JSON שדומה לזה: 
    {
      "APIMetadata": [
        {
          "organization": "test",
          "environment": "dev",
          "stage": "BULK_TRANSFER",
          "totalDeployments": 100,
          "completed": 10,
          "lastUpdated": "04-16-2025 00:56:45",
          "errors": 0
        },
        {
          "organization": "test",
          "environment": "prod",
          "stage": "STREAMING",
          "pendingUploads": 10,
          "errors": 1,
          "lastUpdated": "04-16-2025 00:56:45"
        },
        {
          "organization": "test1",
          "environment": "staging",
          "stage": "Yet to Start",
          "lastUpdated": "04-16-2025 00:56:45"
        }
      ],
      "RuntimeData": [
        {
          "organization": "test",
          "environment": "dev",
          "errorCount": 2,
          "lastUpdated": "04-16-2025 00:56:45"
        },
        {
          "organization": "test",
          "environment": "prod",
          "errorCount": 4,
          "lastUpdated": "04-16-2025 00:56:45"
        },
        {
          "organization": "test1",
          "environment": "staging",
          "errorCount": 0,
          "lastUpdated": "04-16-2025 00:56:45"
        }
      ]
    }

הפלט מספק תובנות לגבי:

  • מטא-נתונים של API: סטטוס ההעלאות של מטא-נתונים של API, כולל ארגון, סביבה, שלב נוכחי (לדוגמה, 'העברה בכמות גדולה', 'סטרימינג', 'עדיין לא התחיל'), סך ההעלאות, ההעלאות שהושלמו וההעלאות בהמתנה, מספר השגיאות וזמן העדכון האחרון.
  • מטא-נתונים של זמן ריצה: סטטוס של העלאות נתוני זמן ריצה, כולל ארגון, סביבה, מספר השגיאות ושעת העדכון האחרון.

בעיות נפוצות ושלבים לפתרון בעיות

אם נתקלים בבעיות, כדאי לעיין ביומני המחבר ובנקודת הקצה של הסטטוס. קובץ היומן הראשי של מחבר Apigee Hub נמצא במיקום /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

  1. המחבר של Apigee API Hub לענן פרטי לא מופעל:
    • בדיקת יומנים: בודקים את /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log אם יש הודעות שגיאה שקשורות להגדרה.
    • בדיקת ההגדרות: בודקים שוב את כל ההגדרות שהוגדרו ב-uapim-connector.properties ובמשתני הסביבה.
    • גישה ל-Pub/Sub: בודקים ביומנים אם ל-opdk-connector יש גישה לנושאים שצוינו ב-Pub/Sub.
    • גישה לשרת הניהול: בדיקת היומנים כדי לראות אם opdk-connector יכול להתקשר בהצלחה לשרת הניהול של Apigee עם כתובת ה-URL והאישורים שצוינו.
    • זמן אתחול: אם יש אלפי פריסות בסביבת Apigee שלכם, יכול להיות שיחלפו כ-20-30 דקות עד שהמחבר של Apigee Hub יתחיל לפעול.
  2. נתוני המטא של ה-API לא מוצגים ב-API Hub:
    • יומנים של מחבר: בודקים את היומנים של opdk-connector כדי לראות אם יש לו גישה לנושא Pub/Sub של מטא-נתוני ה-API ואם הוא יכול לקרוא לשרת הניהול.
    • סטטוס ההעלאה: בודקים את הפלט curl localhost:8080/v1/uapim/status. מחפשים את הקטע APIMetadata.
      • האם הערך של lastUpdated הוא עדכני?
      • האם הערך של errorCount עולה באופן עקבי?
      • באיזה שלב זה נמצא?
    • חריגים/שגיאות: מחפשים ביומנים חריגים או שגיאות שקשורים לעיבוד המטא-נתונים.
  3. נתוני זמן ריצה לא מוצגים ב-API hub:
    • יומני מחבר: בודקים אם המחבר opdk יכול לגשת לנושא Pub/Sub של זמן הריצה ולקרוא לשרת הניהול.
    • סטטוס ההעלאה: משתמשים בפקודה curl localhost:8080/v1/uapim/status. מתמקדים בקטע RuntimeData.
      • האם הערך של lastUpdated הוא עדכני?
      • האם הערך של errorCount עולה באופן עקבי?
    • חריגים או שגיאות: מחפשים ביומנים חריגים או שגיאות שקשורים לעיבוד נתונים בזמן ריצה.
    • הגדרת מעבד ההודעות: מוודאים ש-message-processor-communication.properties מוגדר בצורה נכונה בכל מעבדי ההודעות לטובת כתיבה כפולה, ושמעבדי ההודעות הופעלו מחדש.
    • NFS mount: מוודאים שה-NFS mount מוגדר בצורה נכונה ושיש לו גישה גם ל-MPs וגם למחבר UAPIM.
  4. ה-proxy נפרס, אבל המידע במרכז ה-API לא מדויק:
    • זמן המתנה: צריך לחכות כמה דקות עד שהנתונים יתעדכנו.
    • יומנים: בודקים את היומנים של opdk-connector כדי לקבל מידע על שרתי proxy שהועלו. כך תוכלו לדעת אם המחבר מעבד את אירועי הפריסה.