הגדרה של שמירה לזמן קצוב לתפוגה במעבדי הודעות

מוצג המסמך של Apigee Edge.
עוברים אל מסמכי תיעוד של Apigee X. מידע

המסמך הזה מסביר איך להגדיר את הזמן הקצוב לתפוגה של שמירה במצב פעיל ב-Apigee Edge מעבדי הודעות.

הזמן הקצוב לתפוגה של שמירה פעילה במעבד ההודעות מאפשר לחיבור TCP יחיד לשלוח לקבל מספר בקשות/תגובות HTTP מ/אל שרת הקצה העורפי, במקום לפתוח לכל צמד של בקשה/תגובה.

ערך ברירת המחדל של מאפיין הזמן הקצוב לתפוגה שמוגדר במצב פעיל במעבד ההודעות הוא 60 שניות. פרק הזמן הקצוב לתפוגה חל על שרתי הקצה העורפי שהוגדרו בתצורה של נקודת הקצה (endpoint) של היעד ובמדיניות ServiceCallout של שרת proxy ל-API.

אפשר להגדיל או להקטין את משך הזמן הקצוב לתפוגה שמוגדר במצב פעיל למעבדי הודעות מערך ברירת המחדל של 60 שניות בהתאם לצרכים שלך. אפשר להגדיר אותו בדרכים הבאות:

• ב-proxy ל-API
  • בנקודת הקצה של היעד
  • במדיניות ServiceCallout
• במעבד ההודעות

המאפיינים הבאים קובעים את הזמן הקצוב לתפוגה שמוגדר במצב פעיל במעבדי ההודעות:

שם הנכס	מיקום	תיאור
keepalive.timeout.millis	Proxy ל-API: נקודת קצה כיעד מדיניות אחת (ServiceCallout)	זהו משך הזמן המקסימלי ללא פעילות שבו מעבד ההודעות מאפשר פרוטוקול TCP יחיד חיבור כדי לשלוח ולקבל מספר בקשות/תגובות HTTP, במקום לפתוח לכל צמד של בקשה/תגובה. כברירת מחדל, הנכס הזה מקבל את הערך שהוגדר עבור המאפיין HTTPClient.keepalive.timeout.millis במעבד ההודעות, שבו ערך ברירת המחדל הוא 60 שניות. אם הנכס הזה ישתנה ותציינו ערך חדש של זמן קצוב לתפוגה עבור שרת היעד שמשמש את בנקודת הקצה לטירגוט או במדיניות ServiceCallout בשרת ה-proxy הספציפי ל-API, ואז יש השפעה על משך הזמן לשמירת נתונים רק עבור שרת היעד הספציפי הזה.
HTTPClient.keepalive.timeout.millis	מעבד בקשות	זהו משך הזמן המקסימלי ללא פעילות שבו מעבד ההודעות מאפשר פרוטוקול TCP יחיד חיבור לשליחה ולקבלה של בקשות/תגובות HTTP מרובות, במקום לפתוח חיבור חדש לכל צמד של בקשה/תגובה. המאפיין הזה משמש לכל שרתי ה-proxy ל-API שפועלים במעבד ההודעות הזה. ערך ברירת המחדל של המאפיין הזה הוא 60 שניות. אפשר לשנות את המאפיין הזה כמו שמוסבר ב הגדרת זמן קצוב לתפוגה פעיל במעבדי הודעות למטה, או שאפשר להחליף את הערך הזה על ידי הגדרת המאפיין keepalive.timeout.millis ברמת ה-Proxy ל-API.

לפני שמתחילים

לפני שתשתמשו בשלבים שבמסמך הזה, חשוב שתוודאו שאתם מבינים את הנושאים הבאים:

• אם לא ידוע לך מהו משך הזמן הקצוב לתפוגה של השידור החי, אפשר לעיין בkeepalive.timeout.millis תיאור הנכס ב- מפרט מאפיין התעבורה של נקודת קצה (endpoint).
• אם אתם לא יודעים איך להגדיר נכסים ל-Edge בענן פרטי, אפשר לקרוא את המאמר איך להגדיר את Edge.

הגדרת זמן קצוב לתפוגה של פעילות בשרת proxy ל-API

אפשר להגדיר את הזמן הקצוב לתפוגה של 'שמירה במצב פעיל' בשרת ה-proxy ל-API במקומות הבאים:

• נקודת קצה כיעד
• מדיניות אחת (ServiceCallout)

הגדרת הזמן הקצוב לתפוגה של שמירה בזמן אמת בנקודת הקצה של שרת ה-proxy ל-API

בקטע הזה מוסבר איך להגדיר זמן קצוב לתפוגה בזמן אמת בנקודת הקצה של היעד של שרת proxy ל-API. אפשר להגדיר את הזמן הקצוב לתפוגה של 'שמירה במצב פעיל' דרך הנכס keepalive.timeout.millis, שמייצג את ערך הזמן הקצוב לתפוגה שמוגדר במצב פעיל אלפיות שנייה.

1. בממשק המשתמש של Edge, בוחרים את שרת ה-proxy הספציפי שבו רוצים להגדיר את לשמור ערך פעיל של זמן קצוב לתפוגה.
2. בוחרים את נקודת הקצה הספציפית שרוצים לשנות את היעד שלה.

3. מוסיפים את הנכס keepalive.timeout.millis עם ערך מתאים מתחת רכיב <HTTPTargetConnection> בהגדרה של TargetEndpoint.

   לדוגמה, כדי לשנות את משך הזמן הקצוב לתפוגה שמוגדר לשהייה פעילה ל-30 שניות, צריך להוסיף את התג את בלוק הקוד הבא:

   <Properties>
     <Property name="keepalive.timeout.millis">30000</Property>
   </Properties>
   

   מכיוון שהמאפיין keepalive.timeout.millis נמצא באלפיות שנייה, הערך של הערך של 30 שניות הוא 30000.

   הדוגמאות הבאות מראות איך להגדיר את הזמן הקצוב לתפוגה של 'שמירה במצב פעיל' בנקודת הקצה של היעד של ה-Proxy ל-API:

   דוגמה להגדרה של נקודת קצה ביעד באמצעות כתובת URL של שרת עורפי

   <TargetEndpoint name="default">
     <HTTPTargetConnection>
       <URL>https://mocktarget.apigee.net/json</URL>
       <Properties>
         <Property name="keepalive.timeout.millis">30000</Property>
       </Properties>
     </HTTPTargetConnection>
   </TargetEndpoint>
   

   דוגמה להגדרה של נקודת קצה ליעד באמצעות שרת יעד

   <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>
   

4. שומרים את השינויים שבוצעו בשרת ה-proxy של ה-API.

הגדרת זמן קצוב לתפוגה של פרק זמן פעיל במדיניות ServiceCallout של שרת ה-proxy ל-API

בקטע הזה מוסבר איך להגדיר את הזמן הקצוב לתפוגה של 'שמירה במצב פעיל' המדיניות ServiceCallout של ה-proxy ל-API. הזמן הקצוב לתפוגה של 'שמירה במצב פעיל' יכול להיות שהוגדר באמצעות המאפיין the keepalive.timeout.millis, שמייצג ערך הזמן הקצוב לתפוגה שמוגדר במצב פעיל באלפיות השנייה.

כדי להגדיר את הזמן הקצוב לתפוגה שמוגדר במצב פעיל במדיניות ServiceCallout באמצעות מאפיין keepalive.timeout.millis:

1. בממשק המשתמש של Edge, בוחרים את שרת ה-proxy הספציפי שבו רוצים להגדיר את לשמור את ערך הזמן הקצוב לתפוגה פעיל במדיניות ServiceCallout.
2. בוחרים את המדיניות הספציפית של ServiceCallout שרוצים לשנות.
3. מוסיפים את הנכס keepalive.timeout.millis עם ערך מתאים מתחת רכיב <HTTPTargetConnection> בהגדרה של TargetEndpoint.

   לדוגמה, כדי לשנות את הזמן הקצוב לתפוגה של 'שמירה בזמן אמת' ל-30 שניות, צריך להוסיף את את בלוק הקוד הבא:

   <Properties>
     <Property name="keepalive.timeout.millis">30000</Property>
   </Properties>
   

   מכיוון שהמאפיין keepalive.timeout.millis נמצא באלפיות שנייה, הערך של הערך של 30 שניות הוא 30000.

   הדוגמאות הבאות מראות איך להגדיר את הזמן הקצוב לתפוגה של שמירה במצב פעיל המדיניות ServiceCallout של שרת ה-proxy ל-API:

   דוגמה להגדרה של מדיניות ServiceCallout באמצעות כתובת 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>
   

   דוגמה להגדרה של מדיניות Serviceיתרונות מרכזיים באמצעות שרת יעד

   <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>
   

4. שומרים את השינויים שבוצעו בשרת ה-proxy של ה-API.

הגדרה של השהיית זמן קצוב לתפוגה במעבדי הודעות

בקטע הזה מוסבר איך להגדיר את הזמן הקצוב לתפוגה שמוגדר במצב פעיל במעבדי ההודעות. ניתן להגדיר את הזמן הקצוב לתפוגה שמוגדר במצב פעיל דרך הנכס HTTPClient.keepalive.timeout.millis, שמייצג את הזמן הקצוב לתפוגה שמוגדר במצב פעיל באלפיות השנייה ברכיב מעבד ההודעות. מאחר שהנכס הזה מגיב על במעבד ההודעות, צריך להשתמש בתחביר המיוחד conf/http.properties+HTTPClient.keepalive.timeout.millis כפי שמתואר בקטע הגדרת אסימון שמורשה לגביו תגובה ב- איך להגדיר את Edge.

כדי להגדיר את הזמן הקצוב לתפוגה פעיל במעבדי ההודעות, מבצעים את הפעולות הבאות:

1. במעבד הודעות, פותחים את הקובץ הבא בעורך. אם הוא עדיין לא קיים, יוצרים אותו.

   /opt/apigee/customer/application/message-processor.properties
   

   לדוגמה, כדי לפתוח את הקובץ באמצעות vi, עליך להזין את הפרטים הבאים:

   vi /opt/apigee/customer/application/message-processor.properties
   

2. מוסיפים לקובץ המאפיינים שורה בפורמט הבא, תוך החלפת ערך ב- TIME_IN_MILLISECONDS:

   conf/http.properties+HTTPClient.keepalive.timeout.millis=TIME_IN_MILLISECONDS
   

   לדוגמה, כדי לשנות את הזמן הקצוב לתפוגה שמוגדר במצב פעיל במעבד ההודעות, 30 שניות, יש להוסיף את השורה הבאה:

   conf/http.properties+HTTPClient.keepalive.timeout.millis=30000
   

3. שומרים את השינויים.
4. צריך לוודא שקובץ המאפיינים נמצא בבעלות של המשתמש ב-apigee, כמו שמוצג בהמשך:

   chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
   

5. צריך להפעיל מחדש את מעבד ההודעות כפי שמוצג בהמשך:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
   

6. אם יש לכם יותר ממעבד הודעות אחד, צריך לחזור על השלבים שלמעלה בכל מעבדי הודעות.

האימות של מעבדי ההודעות מושהה בזמן אמת

בקטע הזה מוסבר איך לוודא שהזמן הקצוב לתפוגה של 'שמירה במצב פעיל' שונה בהצלחה במעבדי ההודעות.

גם אם משתמשים בתחביר המיוחד conf/http.properties+HTTPClient.keepalive.timeout.millis כדי להגדיר את ה-Keep זמן קצוב לתפוגה במעבד ההודעות, עליכם לבדוק אם הנכס HTTPClient.keepalive.timeout.millis הוגדר עם הערך החדש.

1. במעבד הודעות, מחפשים את המאפיין. HTTPClient.keepalive.timeout.millis ב- /opt/apigee/edge-message-processor/conf ולבדוק אם היא הוגדר עם הערך החדש כפי שמוצג בהמשך:

   grep -ri "HTTPClient.keepalive.timeout.millis" /opt/apigee/edge-message-processor/conf
   

2. אם הערך החדש של 'המשך פעיל' מוגדר בהצלחה במעבד ההודעות, הפקודה שלמעלה מציגה את הערך החדש בקובץ http.properties.

   התוצאה לדוגמה מהפקודה שלמעלה לאחר שהגדרת את משך הזמן הקצוב לתפוגה שהוגדר לחוסר פעילות ל-30 שניות:

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPClient.keepalive.timeout.millis=30000
   

   בפלט לדוגמה שלמעלה, שימו לב שהמאפיין HTTPClient.keepalive.timeout.millis הוגדר עם הערך החדש 30000 באפליקציית http.properties. זה מצביע על כך הזמן הקצוב לתפוגה הוגדר בהצלחה ל-30 שניות במעבד ההודעות.

3. אם עדיין רואים את הערך הישן של הנכס HTTPClient.keepalive.timeout.millis, לאחר מכן עליך לוודא שמעקב אחר כל הפריטים מהם השלבים שמפורטים הגדרת זמן קצוב לתפוגה פעיל במעבדי הודעות בצורה נכונה. אם פספסתם שלב כלשהו, יש לחזור על השלבים האלה שוב בצורה נכונה.
4. אם עדיין לא הצלחת לשנות את הזמן הקצוב לתפוגה של 'שמירה במצב פעיל', עליך ליצור קשר עם תמיכה ב-Apigee Edge ב-Google Cloud.