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

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

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

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

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

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

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

שם הנכס מיקום תיאור
connect.timeout.millis Proxy ל-API:
  • נקודת קצה כיעד
  • מדיניות אחת (ServiceCallout)

זהו משך הזמן המקסימלי שבו מעבד ההודעות ימתין כדי להתחבר לשרת היעד.

כברירת מחדל, הנכס הזה מקבל את הערך שהוגדר עבור המאפיין HTTPClient.connect.timeout.millis במעבד ההודעות, ערך ברירת המחדל הוא 3 שניות.

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

HTTPClient.connect.timeout.millis מעבד בקשות

זהו משך הזמן המקסימלי שבו מעבד ההודעות ימתין להתחברות לשרת היעד.

המאפיין הזה משמש לכל שרתי ה-proxy ל-API שפועלים במעבד ההודעות הזה.

ערך ברירת המחדל של המאפיין הזה הוא 3 שניות.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. בממשק המשתמש של Edge, בוחרים את שרת ה-proxy הספציפי שבו רוצים להגדיר את הערך של הזמן הקצוב לתפוגת החיבור למדיניות 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 של שרת ה-proxy ל-API:

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

    דוגמה להגדרה של מדיניות 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="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.