درحال فعال کردن G1GC در «پردازشگرهای پیام»

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

این سند توضیح می‌دهد که چگونه Garbage First Garbage Collector (G1GC) را در «پردازشگرهای پیام» Apigee Edge فعال کنید.

‫Message Processor در Apigee Edge روی «ماشین مجازی جاوا» (JVM) اجرا می‌شود و از Garbage Collector پیش‌فرض استفاده می‌کند—سریال یا موازی بسته به پیکربندی‌های سخت‌افزار و سیستم‌عامل. تحت شرایط خاص و براساس نیازهایتان، ممکن است بخواهید نوع «زباله‌روب» مورداستفاده در «پردازشگر پیام» را تغییر دهید.

‫G1GC زباله‌روب نسلی با وقفه کم و سبک سرور برای Java HotSpot VM است که عملکرد کلی «پردازشگر پیام» را بهبود می‌بخشد. معمولاً برای برنامه‌هایی با مجموعه‌های داده متوسط تا بزرگ طراحی شده است که در آن‌ها زمان پاسخ‌دهی از گذردهی کلی مهم‌تر است. برای مثال: اگر اندازه توده بزرگ است (بیشتر از ۳ گیگابایت)، می‌توانید از G1GC استفاده کنید.

به‌طورکلی توصیه می‌شود پارامتر JVM دیگری را UseStringDeduplicationهمراه با G1GC تنظیم کنید. این پارامتر با وادار کردن مقادیر تکراری یا یکسان «رشته» به استفاده از آرایه نویسه یکسان، استفاده از حافظه پشته جاوا را بهینه‌سازی می‌کند.

قبل‌از شروع

درحال فعال کردن G1GC در «پردازشگرهای پیام»

این بخش نحوه فعال کردن G1GC را در «پردازشگر پیام Edge» توضیح می‌دهد. G1GC را می‌توان ازطریق ویژگی useG1GC در مؤلفه «پردازشگر پیام» فعال کرد. به‌طور پیش‌فرض، این ویژگی روی false در «پردازشگرهای پیام» تنظیم شده است. برای پیکربندی هر ویژگی در «پردازشگر پیام»، از توکن مطابق با نحوی که در نحوه پیکربندی Edge شرح داده شده است استفاده کنید.

برای فعال کردن G1GC در «پردازشگرهای پیام»، مراحل زیر را انجام دهید:

  1. یافتن مکان رمز برای استفاده از دارایی G1GC
  2. فعال کردن G1GC در «پردازشگر پیام»

توکن مکان‌یابی برای ویژگی useG1GC

مراحل زیر نحوه پیدا کردن کد برای ویژگی useG1GC را شرح می‌دهد:

  1. بااستفاده از فرمان زیر، ویژگی useG1GC را در دایرکتوری منبع «پردازشگر پیام» /opt/apigee/edge-message-processor/source جستجو کنید:
    grep -ri "useG1GC" /opt/apigee/edge-message-processor/source
  2. برونداد این فرمان نشان‌دهنده نشان برای دارایی «پردازشگر پیام» useG1GC به‌صورت زیر است:
    /opt/apigee/edge-message-processor/source/conf/system.properties:useG1GC={T}conf_system_useG1GC{/T}

    که در آن رشته بین برچسب‌های {T}{/T} نام توکنی است که می‌توانید در فایل .properties «پردازشگر پیام» تنظیم کنید. بنابراین، کد دارایی useG1GC به‌صورت زیر است:

    conf_system_useG1GC

فعال کردن G1GC در «پردازشگرهای پیام»

مراحل زیر نحوه فعال کردن G1GC را در «پردازشگرهای پیام Apigee» شرح می‌دهد:

  1. فایل /opt/apigee/customer/application/message-processor.properties را در دستگاه «پردازشگر پیام» در ویرایشگر باز کنید. اگر فایل ازقبل وجود ندارد، آن را ایجاد کنید. برای مثال:
    vi /opt/apigee/customer/application/message-processor.properties
  2. خط زیر را به این فایل اضافه کنید:
    conf_system_useG1GC=true
  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. اگر بیش از یک «پردازشگر پیام» دارید، این مراحل را در همه «پردازشگرهای پیام» تکرار کنید.

درستی‌سنجی پیکربندی G1GC در پردازشگرهای پیام

این بخش توضیح می‌دهد که چگونه تأیید کنید پیکربندی G1GC باموفقیت در «پردازشگرهای پیام» اصلاح شده است.

Even though you use the token conf_system_useG1GC to enable G1GC on the Message Processor, you need to verify that the actual property useG1GC has been set with the new value as follows:

  1. دارایی useG1GC را در فهرست راهنمای /opt/apigee/edge-message-processor/conf جستجو کنید و بررسی کنید که با مقدار جدید تنظیم شده باشد. برای مثال:
    grep -ri "useG1GC" /opt/apigee/edge-message-processor/conf
  2. اگر G1GC با موفقیت در «پردازشگر پیام» فعال شود، فرمان قبلی مقدار جدید را در فایل system.properties نشان می‌دهد.

    نتیجه نمونه از فرمان قبلی، پس‌از فعال کردن G1GC در «پردازنده پیام»، به‌صورت زیر است:

    /opt/apigee/edge-message-processor/conf/system.properties:useG1GC=true

    در خروجی نمونه، توجه داشته باشید که ویژگی useG1GC با مقدار جدید true در system.properties تنظیم شده است. این نشان می‌دهد که G1GC باموفقیت در «پردازشگر پیام» فعال شده است.

  3. اگر هنوز مقدار قدیمی دارایی useG1GC را می‌بینید، بررسی کنید که همه مراحل ذکرشده در فعال کردن G1GC در «پردازشگرهای پیام» را به‌درستی دنبال کرده باشید. اگر مرحله‌ای را ازدست داده‌اید، همه مراحل را دوباره به‌درستی تکرار کنید.
  4. اگر همچنان نمی‌توانید G1GC را فعال کنید، با پشتیبانی Apigee Edge تماس بگیرید.

گام بعدی چیست؟

فعال کردن حذف تکراری رشته در پردازنده‌های پیام