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

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

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

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

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

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

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

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

שם הנכס מיקום התיאור
keepalive.timeout.millis API מסוג proxy:
  • נקודת הקצה (endpoint) של היעד
  • מדיניות 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.

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

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

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

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

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

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

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

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

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

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

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

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