אפשר להשתמש ביומני זמן הריצה כדי לאבחן בעיות בתרמילי ה-apigee-runtime. כל תרמיל זמן ריצה מכיל מעבד בקשות שאחראי על עיבוד תעבורת נתונים של proxy ל-API, על הפעלת מדיניות, על ניתוב בקשות ועוד.
שימוש ביומנים של סביבת זמן הריצה
יומנים הם דרך טובה לפתור בעיות בהתקנה. פרטים נוספים זמינים במאמר בנושא רישום ביומן.
שימוש בפקודה logs
אפשר להציג את יומני המערכת של זמן הריצה באמצעות הפקודה kubectl logs. לדוגמה:
kubectl logs -f -n apigee apigee-runtime-apigee-gcp-prod1-test-blue-hd77q
פרטי גרסת החוזה
בטבלה הבאה מתוארות בקצרה רשומות ביומן שקשורות לטעינת החוזה ממישור הניהול:
| רשומה ביומן | משמעות |
hybrid-runtime Apigee-Timer-9 INFO RUNTIME-SYNC-SERVICE -
RuntimeSyncServiceImpl.updateToVersion() : Switched to newer version
750 from version null
|
ה-MP השתנה לגרסה חדשה יותר של חוזה ההגדרות. |
hybrid-runtime Apigee-Timer-6 INFO RUNTIME-SYNC-SERVICE -
RuntimeSyncServiceImpl.loadLatestVersionIfAvailable() : Found a newer
version 750
|
ה-MP טען את הגרסה האחרונה של הגדרות החוזה מ-version.properties.
|
hybrid-runtime Apigee-Timer-6 INFO RUNTIME-SYNC-SERVICE -
RuntimeSyncServiceImpl.updateToVersion() : Attempting to update to a newer version 750
|
ה-MP מתעדכן לגרסה חדשה יותר של חוזה ההגדרות. |
hybrid-runtime Apigee-Timer-6 INFO RUNTIME-SYNC-SERVICE -
RuntimeSyncServiceImpl.updateToVersion() : Switched to newer version 751 from version 750
|
ה-MP טען את הגרסה האחרונה של הגדרות החוזה מ-version.properties.
|
שגיאות בהטמעה
שגיאות זמן הריצה הבאות קשורות לפריסות של שרתי proxy:
| רשומה ביומן | משמעות |
hybrid-runtime org:hybrid env:prod Apigee-Main-6 ERROR i.a.h.e.i.HermesEngineImpl
- HermesEngineImpl.handleHermesException() : Keyspace cache_hybrid_hybrid does not exist
|
לא הוקצה Keyspace cache_orgname_hybrid ב-Cassandra.
|
hybrid-runtime org:hybrid Apigee-Timer-9 ERROR c.a.s.e.k.HybridEncryptionKeyServiceImpl
- HybridEncryptionKeyServiceImpl.getEncryptionKey() : Encryption key does not exist for
organization hybrid and type KmsKey
|
לא הוקצה Keyspace kms_orgname_hybrid ב-Cassandra.
|
יומני שגיאות של פריסת מעבד הודעות
מחפשים ביומני מעבד ההודעות את רשומות שגיאות הפריסה הבאות:
| רשומה ביומן | תיאור |
|---|---|
hybrid-runtime org:hybrid env:prod Apigee-Main-6 ERROR i.a.h.e.i.HermesEngineImpl - HermesEngineImpl.handleHermesException() : Keyspace cache_hybrid_hybrid does not exist |
מרחב מפתחות cache_orgname_hybrid is not provisioned in Cassandra. |
hybrid-runtime org:hybrid Apigee-Timer-9 ERROR c.a.s.e.k.HybridEncryptionKeyServiceImpl - HybridEncryptionKeyS erviceImpl.getEncryptionKey() : Encryption key does not exist for organization hybrid and type KmsKey |
לא הוקצה Keyspace kms_orgname_hybrid ב-Cassandra.
|
קודי שגיאה של מעבד ההודעות
קודי השגיאה של מעבד ההודעות מתחילים ב-runtime.sync.error-name.
לדוגמה:
| רשומה ביומן | משמעות |
runtime.sync.ContractLoadFailedMessage: Error loading spec file
|
הסיבה: יכול להיות שהשגיאה נגרמת בגלל סכימה לא תקינה, קובץ מפרט חוזה פגום או חוזה לא תקין. כל אחת מהבעיות האלה יכולה למנוע מטפל ההודעות לטעון את קובץ המפרט. פתרון: מוודאים שקובץ מפרט החוזה זמין, שמערכת הקבצים לא פגומה או שהסכימה/החוזה תקפים. |