כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של
Apigee X. מידע
בקשות ה-API שנשלחות על ידי אפליקציות הלקוח עוברות דרך רכיבים שונים ב-Apigee Edge, לפני שהן מגיעות לשירותים לקצה העורפי. רוב אפליקציות הלקוח מצפים שהתגובות לבקשות האלה יתקבלו תוך זמן קצר.
כדי לקבל תגובות בזמן, ערכי הזמן הקצוב לתפוגה של קלט/פלט מוגדרים בכל אחד מהרכיבים שדרכם עוברות בקשות ה-API. אם לרכיבים כלשהם בתהליך נדרש זמן רב יותר מהרכיב הקודם, הזמן הקצוב לתפוגה של הרכיב הקודם יפוג והוא יגיב שוב עם שגיאות זמן קצוב לתפוגה של 504 ב-Gateway.
כשמגדירים את הזמן הקצוב לתפוגה, יש להגדיר בזהירות את הערכים בכל אחד מהרכיבים, אחרת הדבר עלול לגרום לשגיאות זמן קצוב לתפוגה של 504 Gateway.
במסמך הזה מתוארות שיטות מומלצות להגדרת זמן קצוב לתפוגה של קלט/פלט ברכיבים שונים, שדרכם עוברות בקשות ה-API ב-Apigee Edge.
שיטות מומלצות להגדרת זמן קצוב לתפוגה של קלט/פלט
כשמגדירים את הזמן הקצוב לתפוגה של קלט/פלט, כדאי להביא בחשבון את השיטות המומלצות הבאות:
- רכיב ראשון: יש להשתמש תמיד בזמן הקצוב לתפוגה הגבוה ביותר ברכיב הראשון בתהליך הבקשה של ה-API, שהוא אפליקציית הלקוח ב-Apigee Edge.
- הרכיב האחרון: תמיד יש להשתמש בזמן הקצוב לתפוגה הנמוך ביותר ברכיב האחרון בתהליך הבקשה של ה-API, שהוא השירות לקצה העורפי ב-Apigee Edge.
- בין רכיבים: יש לוודא שקיים הפרש של לפחות 2-3 שניות בערך הזמן הקצוב לתפוגה שהוגדר בכל רכיב בין הרכיב הראשון לרכיב האחרון בתהליך.
- נתב: תמיד מומלץ להגדיר (לשנות) את ערך הזמן הקצוב לתפוגה של קלט/פלט אצל מארח וירטואלי ספציפי, במקום להגדיר אותו בנתב. הפעולה הזו מבטיחה שהערך החדש של הזמן הקצוב לתפוגה ישפיע רק על שרתי proxy של ה-API שמשתמשים במארח הווירטואלי הספציפי, ולא על כל שרתי ה-proxy של ה-API שמוצגים על ידי הנתב.
הגדר (שנה) את הזמן הקצוב לתפוגה של קלט/פלט בנתב רק כאשר אתה בטוח לחלוטין שהערך החדש של הזמן הקצוב לתפוגה של קלט/פלט נדרש או רלוונטי לכל שרתי ה-proxy של ה-API שפועלים בנתב.
- מעבד הודעות: תמיד מומלץ להגדיר (לשנות) את ערך הזמן הקצוב לתפוגה של קלט/פלט עבור API ספציפי של שרת proxy, במקום להגדיר אותו במעבד ההודעות. הפעולה הזו מבטיחה שהערך החדש של הזמן הקצוב ישפיע רק על שרת ה-proxy הספציפי של ה-API, ולא על כל שרתי ה-proxy של ממשק ה-API שמוצגים על ידי מעבד ההודעות.
ניתן להגדיר (לשנות) את הזמן הקצוב לתפוגה של קלט/פלט במעבד ההודעות, רק כשבטוחים לחלוטין שהערך החדש של הזמן הקצוב לתפוגה של קלט/פלט הוא נדרש או רלוונטי לכל שרתי ה-API של ממשקי ה-API שפועלים במעבד ההודעות.
תרחישים לדוגמה
התרחישים בקטע הזה יכולים לעזור לך להבין איך להגדיר בצורה נכונה את ערכי הזמן הקצוב לתפוגה של קלט/פלט.
תרחיש 1: בקשות ל-Apigee Edge ישירות מאפליקציות לקוח
בקטע הזה מתוארות השיטות המומלצות שיש לפעול לפיהן כשמגדירים את הערכים של הזמן הקצוב לתפוגה בהגדרה של Apigee Edge, שבה אין רכיבי ביניים בין אפליקציית הלקוח ל-Apigee Edge ובין Apigee Edge לשרת הקצה העורפי שלך.
הגדרה לדוגמה של Apigee ללא מרכיבי ביניים
אם Apigee Edge מוגדר כפי שמוצג בתרשים שלמעלה, ללא רכיבי ביניים, כדאי להשתמש בשיטות המומלצות הבאות:
- אפליקציית הלקוח היא הרכיב הראשון בזרימה. יש להגדיר בלקוח את הערך של הזמן הקצוב לתפוגה הגבוה ביותר.
- שרת הקצה העורפי הוא הרכיב האחרון בתהליך. יש להגדיר את הערך של הזמן הקצוב לתפוגה הנמוך ביותר בשרת הקצה העורפי.
- מגדירים את ערכי הזמן הקצוב לתפוגה של כל אחד מהרכיבים לפי הסדר הבא:
כדי למנוע בעיות, בדוגמה הבאה מוצגים ערכי זמן קצוב לתפוגה שהוגדרו ברכיבים השונים בהתאם להנחיות שלמעלה:
תרחיש 2: בקשות ל-Apigee Edge מיישומי לקוח דרך רכיבי ביניים
בקטע הזה מתוארות השיטות המומלצות שיש לפעול לפיהן כשמגדירים את ערכי הזמן הקצוב לתפוגה בהגדרה של Apigee Edge, שבה יש רכיב ביניים אחד או יותר בין אפליקציית הלקוח ל-Apigee Edge וגם בין Apigee Edge לשרת הקצה העורפי שלך.
רכיבי הביניים יכולים להיות מאזן עומסים, רשת להעברת תוכן (CDN), NGINX וכו'.
הגדרת Apigee לדוגמה עם רכיב ביניים אחד בין Client ו-Apigee Edge לבין Apigee Edge לשרת קצה עורפי
אם Apigee Edge מוגדר כפי שמוצג בתרשים שלמעלה, עם רכיב ביניים אחד או יותר, כדאי להשתמש בשיטות המומלצות הבאות:
- אפליקציית הלקוח היא הרכיב הראשון בזרימה. יש להגדיר בלקוח את הערך הגבוה ביותר למשך הזמן הקצוב לתפוגה.
- שרת הקצה העורפי הוא הרכיב האחרון בתהליך. יש להגדיר את הערך הקצר ביותר של הזמן הקצוב לתפוגה בשרת הקצה העורפי.
- יש להגדיר את ערכי הזמן הקצוב לתפוגה בכל אחד מהרכיבים, כולל רכיבי הביניים, לפי הסדר הבא:
כדי למנוע בעיות, בדוגמה הבאה מוצגים ערכי זמן קצוב לתפוגה שהוגדרו ברכיבים השונים בהתאם להנחיות שלמעלה:
