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

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X. מידע

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

הזמן הקצוב לתפוגת החיבור מייצג את הזמן שבו מעבד ההודעות ממתין ליצירת חיבור עם שרת היעד. ערך ברירת המחדל של המאפיין 'זמן קצוב לתפוגה של חיבור' במעבד ההודעות הוא 3 שניות. הזמן הקצוב לתפוגה חל על שרתי הקצה העורפי שהוגדרו בהגדרה של היעד של נקודת הקצה ובמדיניות ServiceCallout של שרת ה-API של שרת ה-API.

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

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

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

שם הנכס	מיקום	התיאור
connect.timeout.millis	API מסוג proxy: נקודת הקצה (endpoint) של היעד מדיניות ServiceCallout	זהו הזמן המקסימלי שבו מעבד ההודעות ימתין כדי להתחבר לשרת היעד. כברירת מחדל, המאפיין הזה לוקח את הערך שהוגדר למאפיין HTTPClient.connect.timeout.millis במעבד ההודעות, כאשר ערך ברירת המחדל הוא 3 שניות. אם המאפיין הזה משתנה עם ערך חדש של זמן קצוב לתפוגה של שרת היעד המשויך לשרת proxy של API, השפעה על זמן ההתחברות רק של שרת היעד הזה.
HTTPClient.connect.timeout.millis	מעבד בקשות	זהו הזמן המקסימלי שבו מעבד ההודעות ימתין עד שיתחבר לשרת היעד. המאפיין הזה משמש בכל שרתי ה-proxy של ה-API שפועלים על מעבד ההודעות הזה. ערך ברירת המחדל של המאפיין הזה הוא 3 שניות. אפשר לשנות את המאפיין הזה כפי שמוסבר בקטע הגדרת זמן קצוב לתפוגה של חיבור במעבדי הודעות שבהמשך, או לשנות את הערך הזה על ידי הגדרת המאפיין connect.timeout.millis ברמת שרת ה-proxy של ה-API.

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

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

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

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

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

• נקודת הקצה (endpoint) של היעד
• מדיניות ServiceCallout

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

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

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

   לדוגמה, כדי לשנות את הזמן הקצוב לתפוגה של החיבור ל-5 שניות, מוסיפים את קטע הקוד הבא:

   <Properties>
     <Property name="connect.timeout.millis">5000</Property>
   </Properties>
   

   מכיוון שהמאפיין connect.timeout.millis נמצא באלפיות שנייה, הערך של 5 שניות הוא 5000.

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

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

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

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

   <TargetEndpoint name="default">
     <HTTPTargetConnection>
       <LoadBalancer>
         <Server name="target1" />
         <Server name="target2" />
       </LoadBalancer>
       <Properties>
         <Property name="connect.timeout.millis">5000</Property>
       </Properties>
       <Path>/test</Path>
     </HTTPTargetConnection>
   </TargetEndpoint>
   

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

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

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

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

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

   לדוגמה, כדי לשנות את הזמן הקצוב לתפוגה של החיבור ל-5 שניות, מוסיפים את קטע הקוד הבא:

   <Properties>
     <Property name="connect.timeout.millis">5000</Property>
   </Properties>
   

   מכיוון שהמאפיין connect.timeout.millis נמצא באלפיות שנייה, הערך של 5 שניות הוא 5000.

   הדוגמאות הבאות מראות כיצד להגדיר את הזמן הקצוב לחיבור במדיניות ServiceCallout של שרת ה-API של ה-API:

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

   <ServiceCallout name="Service-Callout-1">
     <DisplayName>Service Callout-1</DisplayName>
     <HTTPTargetConnection>
       <Properties>
         <Property name="connect.timeout.millis">5000</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="connect.timeout.millis">5000</Property>
       </Properties>
     <Path>/test</Path>
     </HTTPTargetConnection>
   </ServiceCallout>
   

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

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

הקטע הזה מסביר איך להגדיר את הזמן הקצוב לחיבור במעבדי ההודעות. ניתן להגדיר את הזמן הקצוב לתפוגה של החיבור באמצעות המאפיין conf_http_HTTPClient.connect.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_HTTPClient.connect.timeout.millis=TIME_IN_MILLISECONDS
   

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

   conf_http_HTTPClient.connect.timeout.millis=5000
   

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_HTTPClient.connect.timeout.millis כדי להגדיר את הזמן הקצוב לחיבור במעבד ההודעות, עדיין צריך לבדוק אם המאפיין HTTPClient.connect.timeout.millis הוגדר בפועל עם הערך החדש.

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

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

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

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

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

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

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