כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של
Apigee X. מידע
מסמך זה מסביר איך להגדיר את הזמן הקצוב לתפוגה של מעבדי הודעות של Apigee Edge.
הזמן הקצוב לתפוגה של 'עיבוד הודעות' מאפשר לחיבור TCP יחיד לשלוח ולקבל מספר בקשות/תגובות HTTP משרת הקצה העורפי, במקום לפתוח חיבור חדש לכל צמד של בקשה/תגובה.
ערך ברירת המחדל של המאפיין 'זמן קצוב לתפוגה של הודעה במצב פעיל' במעבד ההודעות הוא
60
שניות. הזמן הקצוב לתפוגה חל על שרתי הקצה העורפי שהוגדרו בהגדרה של נקודת הקצה (endpoint) של היעד ובמדיניות ServiceCallout
של שרת ה-API של שרת ה-proxy.
לפי הצרכים שלך, אפשר להגדיל או להקטין את הזמן הקצוב לתפוגה של ההגדרה 'לא פעיל' עבור מעבדי הודעות בערך ברירת המחדל
של 60
שניות. אפשר להגדיר אותו בדרכים הבאות:
- בשרת proxy ל-API
- בנקודת הקצה (endpoint) של היעד
- במדיניות
ServiceCallout
- במעבד ההודעות
המאפיינים הבאים שולטים בזמן הקצוב לתפוגה של מעבדי ההודעות:
שם הנכס | מיקום | התיאור |
---|---|---|
keepalive.timeout.millis |
API מסוג proxy:
|
זהו משך הזמן המקסימלי ללא פעילות שבו מעבד ההודעות מאפשר לחיבור TCP יחיד לשלוח ולקבל מספר בקשות/תגובות HTTP, במקום לפתוח חיבור חדש לכל צמד של בקשה/תגובה. כברירת מחדל, המאפיין הזה לוקח את הערך שהוגדר למאפיין אם המאפיין הזה משתנה עם ערך חדש של זמן קצוב לתפוגה של שרת היעד המשמש
בנקודת הקצה של היעד, או במדיניות |
HTTPClient.keepalive.timeout.millis |
מעבד בקשות |
זהו משך הזמן המקסימלי ללא פעילות שבו מעבד ההודעות מאפשר לחיבור TCP יחיד לשלוח ולקבל מספר בקשות/תגובות HTTP, במקום לפתוח חיבור חדש לכל צמד של בקשה/תגובה. המאפיין הזה משמש בכל שרתי ה-proxy של ה-API שפועלים על מעבד ההודעות הזה. ערך ברירת המחדל של המאפיין הזה הוא אפשר לשנות את המאפיין הזה כפי שמוסבר בקטע
הגדרת הזמן הקצוב לתפוגה של מעבדי הודעות שבהמשך, או להחליף את הערך הזה על ידי הגדרת המאפיין |
לפני שמתחילים
לפני שמבצעים את השלבים במסמך הזה, חשוב להבין את הנושאים הבאים:
- אם אתם לא יודעים מה הזמן הקצוב לתפוגה שמוגדר למצב פעיל, תוכלו לעיין בתיאור הנכס
keepalive.timeout.millis
ב מפרט נכס התעבורה של TargetEndpoint. - אם אתם לא יודעים איך להגדיר מאפיינים של Edge ב-Private Cloud, קראו את המאמר איך מגדירים את Edge.
הגדרת הזמן הקצוב לתפוגה של 'שמור בזמן אמת' בשרת proxy של API
אפשר להגדיר את הזמן הקצוב לתפוגה של הישארות פעיל בשרת ה-API במקומות הבאים:
- נקודת הקצה (endpoint) של היעד
- מדיניות
ServiceCallout
הגדרת זמן קצוב לתפוגה של שמירת אירוע פעיל בנקודת קצה (endpoint) של יעד של שרת proxy ל-API
בקטע הזה מוסבר איך להגדיר זמן קצוב לתפוגה של זמן קצוב לתפוגה בנקודת הקצה (endpoint) של היעד של
שרת ה-API של שרת ה-API. ניתן להגדיר את הזמן הקצוב לתפוגה של אירוע פעיל באמצעות המאפיין
keepalive.timeout.millis
, שמייצג את הערך של הזמן הקצוב לתפוגה של
'שמירה על פעיל' באלפיות השנייה.
- בממשק המשתמש של Edge, בוחרים את שרת ה-proxy הספציפי של ה-API שבו רוצים להגדיר את הערך החדש של הזמן הקצוב לתפוגה של שמירה פעילה.
- בוחרים את נקודת הקצה הספציפית של היעד שרוצים לשנות.
-
צריך להוסיף את המאפיין
keepalive.timeout.millis
עם ערך מתאים לרכיב<HTTPTargetConnection>
בהגדרהTargetEndpoint
.לדוגמה, כדי לשנות את הזמן הקצוב לתפוגה של 'שמירת פעיל' ל-
30
שניות, צריך להוסיף את קטע הקוד הבא:<Properties> <Property name="keepalive.timeout.millis">30000</Property> </Properties>
מכיוון שהמאפיין
keepalive.timeout.millis
נמצא באלפיות שנייה, הערך של30
שניות הוא30000
.הדוגמאות הבאות מראות איך להגדיר את הזמן הקצוב לתפוגה של שימור פעיל בהגדרות של נקודת הקצה (endpoint) של היעד בשרת ה-API של שרת ה-API:
דוגמה להגדרה של נקודת קצה (endpoint) של יעד באמצעות כתובת URL של שרת קצה עורפי
<TargetEndpoint name="default"> <HTTPTargetConnection> <URL>https://mocktarget.apigee.net/json</URL> <Properties> <Property name="keepalive.timeout.millis">30000</Property> </Properties> </HTTPTargetConnection> </TargetEndpoint>
דוגמה להגדרה של נקודת קצה (endpoint) של יעד באמצעות שרת יעד
<TargetEndpoint name="default"> <HTTPTargetConnection> <LoadBalancer> <Server name="target1" /> <Server name="target2" /> </LoadBalancer> <Properties> <Property name="keepalive.timeout.millis">30000</Property> </Properties> <Path>/test</Path> </HTTPTargetConnection> </TargetEndpoint>
- שומרים את השינויים שבוצעו בשרת proxy של ממשק ה-API.
הגדרת זמן קצוב לתפוגה של שמירת אירוע פעיל במדיניות ServiceCallout עבור שרת proxy של API
בקטע הזה מוסבר איך להגדיר את הזמן הקצוב לתפוגה
של 'השהייה במצב פעיל' במדיניות ServiceCallout
של שרת ה-API של שרת ה-API. ניתן להגדיר את הזמן הקצוב לתפוגה של אירוע פעיל
באמצעות המאפיין the keepalive.timeout.millis
, שמייצג
את ערך הזמן הקצוב לתפוגה של הקלטה מסוג keep-alive באלפיות שנייה.
כדי להגדיר את הזמן הקצוב לתפוגה של הישארות במצב פעיל במדיניות ServiceCallout
באמצעות
המאפיין keepalive.timeout.millis
:
- בממשק המשתמש של Edge, בוחרים את שרת ה-proxy הספציפי של ה-API שבו רוצים להגדיר את הערך החדש של הזמן הקצוב לתפוגה
של שמירה על פעילות פעילה עבור המדיניות
ServiceCallout
. - בוחרים את המדיניות הספציפית של
ServiceCallout
שרוצים לשנות. - צריך להוסיף את המאפיין
keepalive.timeout.millis
עם ערך מתאים לרכיב<HTTPTargetConnection>
בהגדרהTargetEndpoint
.לדוגמה, כדי לשנות את הזמן הקצוב לתפוגה של 'שמירה על מצב פעיל' ל-
30
שניות, מוסיפים את קטע הקוד הבא:<Properties> <Property name="keepalive.timeout.millis">30000</Property> </Properties>
מכיוון שהמאפיין
keepalive.timeout.millis
נמצא באלפיות שנייה, הערך של30
שניות הוא30000
.הדוגמאות הבאות מראות איך להגדיר את הזמן הקצוב לתפוגה של 'השארת פעיל' במדיניות
ServiceCallout
של שרת ה-API של שרת ה-API:דוגמה להגדרה של מדיניות יתרונות מרכזיים של שירות באמצעות כתובת URL של שרת קצה עורפי
<ServiceCallout name="Service-Callout-1"> <DisplayName>Service Callout-1</DisplayName> <HTTPTargetConnection> <Properties> <Property name="keepalive.timeout.millis">30000</Property> </Properties> <URL>https://mocktarget.apigee.net/json</URL> </HTTPTargetConnection> </ServiceCallout>
דוגמה להגדרה של מדיניות יתרונות מרכזיים של שירות באמצעות שרת יעד
<ServiceCallout enabled="true" name="Service-Callout-1"> <DisplayName>Service Callout-1</DisplayName> <Response>calloutResponse</Response> <HTTPTargetConnection> <LoadBalancer> <Server name="target1" /> <Server name="target2" /> </LoadBalancer> <Properties> <Property name="keepalive.timeout.millis">30000</Property> </Properties> <Path>/test</Path> </HTTPTargetConnection> </ServiceCallout>
- שומרים את השינויים שבוצעו בשרת proxy של ממשק ה-API.
הגדרת הזמן הקצוב לתפוגה של מעבדי הודעות
הקטע הזה מסביר איך להגדיר את הזמן הקצוב לתפוגה של מעבדי ההודעות. ניתן להגדיר את
הזמן הקצוב לתפוגה של
שמירה פעילה באמצעות המאפיין
HTTPClient.keepalive.timeout.millis
, שמייצג את הערך של הזמן הקצוב לתפוגה
של שמירה על פעילות
באלפיות השנייה של הרכיב של מעבד ההודעות. מאחר שהמאפיין הזה מקבל תגובה על
מעבד ההודעות, עליך להשתמש בתחביר המיוחד
conf/http.properties+HTTPClient.keepalive.timeout.millis
כפי שמתואר בקטע
עליך להגדיר אסימון שעם הערות הערה כרגע
ב איך להגדיר את Edge.
כדי להגדיר את הזמן הקצוב לתפוגה של מעבדי ההודעות, בצע את הפעולות הבאות:
- במחשב של מעבד ההודעות, פותחים את הקובץ הבא בעורך. אם אין קטגוריה קיימת, יוצרים אותה.
/opt/apigee/customer/application/message-processor.properties
לדוגמה, כדי לפתוח את הקובץ באמצעות
vi
, מזינים את הפרטים הבאים:vi /opt/apigee/customer/application/message-processor.properties
- מוסיפים שורה בפורמט הבא לקובץ המאפיינים ומחליפים את הערך
TIME_IN_MILLISECONDS:
conf/http.properties+HTTPClient.keepalive.timeout.millis=TIME_IN_MILLISECONDS
לדוגמה, כדי לשנות את הזמן הקצוב לתפוגה של מעבדי ההודעות למשך
30
שניות, מוסיפים את השורה הבאה:conf/http.properties+HTTPClient.keepalive.timeout.millis=30000
- שומרים את השינויים.
- מוודאים שקובץ המאפיינים נמצא בבעלות המשתמש של
apigee
, כפי שמוצג כאן:chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
- מפעילים מחדש את מעבד ההודעות לפי ההוראות הבאות:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- אם יש לכם יותר ממעבד הודעות אחד, צריך לחזור על השלבים שלמעלה בכל מעבדי ההודעות.
אימות של משך הזמן הקצוב לתפוגה של מעבדי הודעות
בקטע הזה מוסבר איך לוודא שהזמן הקצוב לתפוגה של חיסכון בזמן השתנה במעבדי ההודעות.
למרות שמשתמשים בתחביר המיוחד conf/http.properties+HTTPClient.keepalive.timeout.millis
כדי להגדיר את הזמן הקצוב לתפוגה של
'להשאיר פעיל' במעבד ההודעות, צריך לבדוק אם המאפיין HTTPClient.keepalive.timeout.millis
בפועל הוגדר עם הערך החדש.
- במחשב, מחפשים את המאפיין
HTTPClient.keepalive.timeout.millis
בספרייה/opt/apigee/edge-message-processor/conf
ובודקים אם הוא הוגדר עם הערך החדש (כפי שמוצג בהמשך):grep -ri "HTTPClient.keepalive.timeout.millis" /opt/apigee/edge-message-processor/conf
-
אם הערך החדש של הזמן הקצוב לתפוגה של שמירה על פעילות משתמשים הוגדר בהצלחה במעבד ההודעות, הפקודה שלמעלה תציג את הערך החדש בקובץ
http.properties
.התוצאה לדוגמה מהפקודה שלמעלה, לאחר שהגדרת את הזמן הקצוב לתפוגה של שמירה פעילה, ל-
30
שניות:/opt/apigee/edge-message-processor/conf/http.properties:HTTPClient.keepalive.timeout.millis=30000
בפלט לדוגמה שלמעלה, שימו לב שהמאפיין
HTTPClient.keepalive.timeout.millis
הוגדר עם הערך החדש30000
ב-http.properties
. פירוש הדבר הוא שהזמן הקצוב לתפוגה של 'שמירה במצב פעיל' הוגדר בהצלחה ל-30
שניות במעבד ההודעות. - אם הערך הישן של המאפיין
HTTPClient.keepalive.timeout.millis
עדיין מופיע, עליכם לוודא שביצעתם את כל השלבים המפורטים בקטע הגדרה של משך הזמן הקצוב לתפוגה של מעבדי הודעות בצורה תקינה. אם החמצתם שלב כלשהו, יש לחזור על כל השלבים בצורה נכונה. - אם עדיין אין לכם אפשרות לשנות את הזמן הקצוב לתפוגה, תוכלו לפנות לתמיכה של Apigee Edge ב-Google Cloud.