הגדרה של גודל הזיכרון (heap) במעבדי ההודעות

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע

מעבד ההודעות של Apigee Edge הוא רכיב מבוסס-Java, והוא משתמש בגודל זיכרון ערימה (heap) שמוגדר כברירת מחדל של 512 MB. עם זאת, גודל הזיכרון המוקצה (heap) שמוגדר כברירת מחדל עשוי שלא להספיק לכל תרחישי השימוש ב-Apigee Edge. יכול להיות שתצטרכו לשנות את גודל הזיכרון של הערימה עבור מעבדי ההודעות, בהתאם לדרישות התנועה והעיבוד שלכם או כדי לפתור בעיות שקשורות לזיכרון.

גודל הזיכרון של הערימה באפליקציית Java נשלט באמצעות הפרמטרים של שורת הפקודה של Java:‏ -Xms (גודל הערימה המינימלי) ו--Xmx (גודל הערימה המקסימלי). במעבדי ההודעות של Apigee Edge, ההגדרות האלה נקבעות באמצעות המאפיינים bin_setenv_min_mem ו-bin_setenv_max_mem. מידע נוסף על הנכסים האלה זמין במאמר בנושא שינוי הגדרות הזיכרון של Java.

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

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

שינוי הגודל של זיכרון הערימה (heap) במעבדי ההודעות

בקטע הזה מוסבר איך לשנות את גודל הזיכרון של הערימה במעבדי ההודעות. אפשר להגדיר זיכרון Heap מינימלי ומקסימלי באמצעות המאפיינים bin_setenv_min_mem ו-bin_setenv_max_mem ברכיב מעבד בקשות.

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

  1. פותחים את הקובץ /opt/apigee/customer/application/message-processor.properties במכונה של מעבד ההודעות בעורך. אם הקובץ לא קיים, יוצרים אותו. לדוגמה: 
    vi /opt/apigee/customer/application/message-processor.properties
  2. מוסיפים את השורות הבאות לקובץ: 
    bin_setenv_min_mem=minimum_heap_in_megabytes
bin_setenv_max_mem=maximum_heap_in_megabytes

    לדוגמה, אם רוצים לשנות את גודל ה-heap המינימלי והמקסימלי ב-מעבד בקשות ל-‎1 GB ו-‎2 GB בהתאמה, צריך להוסיף את השורות הבאות לקובץ הזה: 

    bin_setenv_min_mem=1024m
bin_setenv_max_mem=2048m
  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. אם יש לכם יותר ממעבד הודעות אחד, צריך לחזור על השלבים האלה בכל מעבדי ההודעות.

אימות גודל הזיכרון של Heap במעבדי ההודעות

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

למרות שהשתמשתם במאפיינים bin_setenv_min_mem ו-bin_setenv_max_mem כדי לשנות את גודל הזיכרון של הערימה במעבד ההודעות, אתם צריכים לוודא שפרמטרי שורת הפקודה בפועל של Java‏, -Xms ו--Xmx, הוגדרו עם הערכים החדשים באופן הבא:

  1. מחפשים כדי לראות אם הפרמטרים של שורת הפקודה -Xms ו--Xmx הוגדרו עם הערכים החדשים של מעבד ההודעות באמצעות הפקודה הבאה: 
    ps -ef | grep message-processor | egrep -o 'Xms[0-9a-z]+|Xmx[0-9a-z]+' | tr '\r' ' '
  2. אם שונו ערכי הזיכרון המינימלי והמקסימלי של הערימה במעבד ההודעות, הפקודה הקודמת תציג את הערך החדש שמופיע עבור -Xms ו--Xmx.

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

    Xms1024m
Xmx2048m

    בפלט לדוגמה, אפשר לראות שהערכים החדשים של ערימת המינימום והמקסימום הוגדרו.

  3. אם עדיין מוצגים הערכים הישנים של -Xms ו--Xmx, צריך לוודא שביצעתם את כל השלבים שמפורטים במאמר שינוי גודל הזיכרון של הערימה במעבדי ההודעות בצורה נכונה. אם פספסתם שלב כלשהו, צריך לחזור על כל השלבים בצורה נכונה.
  4. אם עדיין לא הצלחתם לשנות את הזיכרון של הערימה, פנו אל התמיכה של Apigee Edge.

מה הלאה?