فعال کردن تکرار رشته در پردازشگرهای پیام

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

این سند نحوه فعال‌سازی حذف داده‌های تکراری از رشته‌ها (String Deduplication) را در پردازنده‌های پیام Apigee Edge توضیح می‌دهد.

حذف داده‌های تکراری از رشته‌ها (String Deduplication) یک ویژگی جاوا است که به شما کمک می‌کند تا در برنامه‌های جاوا، حافظه اشغال شده توسط اشیاء رشته‌ای تکراری را ذخیره کنید. این ویژگی با ایجاد آرایه کاراکتری مشترک برای مقادیر رشته‌ای تکراری یا یکسان، میزان اشغال حافظه توسط اشیاء رشته‌ای در حافظه هیپ جاوا را کاهش می‌دهد.

پردازشگر پیام Apigee Edge یک کامپوننت مبتنی بر جاوا است. استفاده از String Deduplication در پردازشگر پیام می‌تواند با کاهش استفاده از حافظه، عملکرد API Proxies شما را بهبود بخشد، به خصوص اگر API Proxies از Strings زیاد استفاده کنند.

ویژگی String Deduplication فقط می‌تواند با G1 Garbage Collector (G1GC) در برنامه‌های جاوا استفاده شود. اگر می‌خواهید این ویژگی را در Message Processor فعال کنید، باید G1GC را از قبل فعال کرده باشید یا G1GC و String Deduplication را با هم در Message Processor فعال کنید.

قبل از اینکه شروع کنی

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

این بخش نحوه فعال‌سازی ویژگی String Deduplication در Edge Message Processors را توضیح می‌دهد. String Deduplication را می‌توان از طریق ویژگی useStringDeduplication در کامپوننت Message Processor فعال کرد. به طور پیش‌فرض، این ویژگی در Message Processors روی false تنظیم شده است. برای پیکربندی هر ویژگی در Message Processor، از توکن مطابق با سینتکس شرح داده شده در نحوه پیکربندی Edge استفاده کنید.

برای فعال کردن String Deduplication در پردازنده‌های پیام، مراحل زیر را انجام دهید:

  1. یافتن توکن برای ویژگی useStringDeduplication
  2. فعال کردن useStringDeduplication در پردازشگر پیام

یافتن توکن برای ویژگی useStringDeduplication

مراحل زیر نحوه‌ی یافتن توکن برای useStringDeduplication را شرح می‌دهد:

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

    که در آن رشته بین تگ‌های {T}{/T} نام توکنی است که می‌توانید در فایل .properties پردازنده پیام تنظیم کنید. بنابراین، توکن مربوط به ویژگی useStringDeduplication به شرح زیر است:

    conf_system_useStringDeduplication

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

مراحل زیر نحوه فعال‌سازی String Deduplication در پردازنده‌های پیام Apigee را شرح می‌دهد:

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

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

این بخش توضیح می‌دهد که چگونه تأیید کنیم که String Deduplication با موفقیت در پردازنده‌های پیام فعال شده است.

حتی اگر از توکن conf_system_useStringDeduplication برای فعال کردن String Deduplication در پردازشگر پیام استفاده می‌کنید، باید تأیید کنید که ویژگی واقعی useStringDeduplication با مقدار جدید به شرح زیر تنظیم شده است:

  1. در دایرکتوری /opt/apigee/edge-message-processor/conf به دنبال ویژگی useStringDeduplication بگردید و بررسی کنید که آیا با مقدار جدید تنظیم شده است یا خیر. برای مثال: 
    grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/conf
  2. اگر String Deduplication با موفقیت در Message Processor فعال شده باشد، دستور قبلی مقدار جدید را در فایل system.properties نشان می‌دهد.

    نتیجه نمونه از دستور قبلی پس از فعال کردن String Deduplication در Message Processor به شرح زیر است: 

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

    در خروجی مثال، توجه داشته باشید که ویژگی useStringDeduplication با مقدار جدید true در system.properties تنظیم شده است. این نشان می‌دهد که String Deduplication با موفقیت در پردازنده پیام فعال شده است.

  3. اگر هنوز مقدار قدیمی برای ویژگی useStringDeduplication را مشاهده می‌کنید، تأیید کنید که تمام مراحل ذکر شده در فعال کردن String Deduplication در پردازنده‌های پیام را به درستی دنبال کرده‌اید. اگر هر مرحله‌ای را از دست داده‌اید، تمام مراحل را دوباره به درستی تکرار کنید.
  4. اگر هنوز قادر به فعال کردن String Deduplication نیستید، با پشتیبانی Apigee تماس بگیرید.

بعدش چی؟

فعال کردن G1GC روی پردازنده‌های پیام