İleti İşleyicilerde Dize Tekilleştirmeyi Etkinleştirme

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Bu belgede, Apigee Edge'in mesaj işlemcilerinde dize tekilleştirmenin nasıl etkinleştirileceği açıklanmaktadır.

Dize tekilleştirme, Java uygulamalarındaki yinelenen Dize nesnelerinin kapladığı belleği tasarruf etmenize yardımcı olan bir Java özelliğidir. Yinelenen veya aynı dize değerlerinin aynı karakter dizisini paylaşmasını sağlayarak Java yığın belleğindeki dize nesnelerinin bellekte kapladığı yeri azaltır.

Apigee Edge Mesaj İşleyici, Java tabanlı bir bileşendir. Bir mesaj işlemcisinde dize tekilleştirme kullanmak, özellikle API proxy'leri dizeleri yoğun bir şekilde kullanıyorsa bellek kullanımını azaltarak API proxy'lerinizin performansını artırabilir.

Dize Tekrarını Kaldırma özelliği yalnızca Java uygulamalarında G1 Garbage Collector (G1GC) ile kullanılabilir. Bu özelliği Mesaj İşleyici'de etkinleştirmek istiyorsanız G1GC'nin zaten etkinleştirilmiş olması veya G1GC ile Dize Tekrarını Kaldırma'nın Mesaj İşleyici'de birlikte etkinleştirilmesi gerekir.

Başlamadan önce

Mesaj işleyicilerde dize tekilleştirmeyi etkinleştirme

Bu bölümde, Edge Message Processors'da String Deduplication özelliğinin nasıl etkinleştirileceği açıklanmaktadır. Dize Tekrarını Kaldırma, Mesaj İşleyici bileşenindeki useStringDeduplication özelliği aracılığıyla etkinleştirilebilir. Bu özellik, varsayılan olarak Mesaj İşleyiciler'de false (yanlış) olarak ayarlanır. Mesaj İşleyici'deki herhangi bir özelliği yapılandırmak için Edge nasıl yapılandırılır? başlıklı makalede açıklanan söz dizimine göre jetonu kullanın.

İleti işlemcilerinde dize tekilleştirmeyi etkinleştirmek için aşağıdaki adımları uygulayın:

  1. useStringDeduplication özelliği için jetonu bulma
  2. useStringDeduplication'ı Mesaj İşleyici'de etkinleştirme

useStringDeduplication özelliği için jetonu bulma

Aşağıdaki adımlarda, useStringDeduplication için jetonun nasıl bulunacağı açıklanmaktadır:

  1. Aşağıdaki komutu kullanarak Mesaj İşleyici kaynak dizininde useStringDeduplication özelliğini arayın:/opt/apigee/edge-message-processor/source 
    grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/source
  2. Bu komutun çıktısı, Message Processor'ın mülkü için jetonu aşağıdaki gibi gösterir: useStringDeduplication 
    /opt/apigee/edge-message-processor/source/conf/system.properties:useStringDeduplication={T}conf_system_useStringDeduplication{/T}

    {T}{/T} etiketleri arasındaki dize, Message Processor'ın .properties dosyasında ayarlayabileceğiniz jetonun adıdır. Bu nedenle, useStringDeduplication özelliği için jeton şu şekildedir: 

    conf_system_useStringDeduplication

Mesaj işlemcilerinde dize tekilleştirmeyi etkinleştirme

Aşağıdaki adımlarda, Apigee Message Processors'da String Deduplication'ın nasıl etkinleştirileceği açıklanmaktadır:

  1. /opt/apigee/customer/application/message-processor.properties dosyasını Mesaj İşleyici makinesinde bir düzenleyicide açın. Dosya mevcut değilse oluşturun. Örneğin: 
    vi /opt/apigee/customer/application/message-processor.properties
  2. Bu dosyaya aşağıdaki satırı ekleyin: 
    conf_system_useStringDeduplication=true
  3. Değişikliklerinizi kaydedin.
  4. Bu özellikler dosyasının apigee kullanıcısına ait olduğundan emin olun. Örneğin: 
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  5. Aşağıdaki komutu kullanarak Mesaj İşleyici'yi yeniden başlatın: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  6. Birden fazla Mesaj İşleyiciniz varsa bu adımları tüm Mesaj İşleyicilerde tekrarlayın.

İleti İşleyicilerde Dize Tekrarını Kaldırma İşlemini Doğrulama

Bu bölümde, ileti işlemcilerinde dize tekilleştirmenin başarıyla etkinleştirildiğini nasıl doğrulayacağınız açıklanmaktadır.

İleti işlemcisinde String Deduplication'ı etkinleştirmek için conf_system_useStringDeduplication jetonunu kullansanız da gerçek özelliğin useStringDeduplication aşağıdaki gibi yeni değerle ayarlandığını doğrulamanız gerekir:

  1. useStringDeduplication dizininde /opt/apigee/edge-message-processor/conf özelliğini arayın ve yeni değerin ayarlanıp ayarlanmadığını kontrol edin. Örneğin: 
    grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/conf
  2. Dize Tekilleştirme, Mesaj İşleyici'de başarıyla etkinleştirildiyse önceki komut, system.properties dosyasındaki yeni değeri gösterir.

    Mesaj İşleyici'de Dize Tekilleştirmeyi etkinleştirdikten sonra önceki komuttan alınan örnek sonuç aşağıdaki gibidir: 

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

    Örnek çıktıda, useStringDeduplication özelliğinin system.properties içinde yeni değer true ile ayarlandığını unutmayın. Bu, Dize Tekrarını Kaldırma'nın Mesaj İşleyici'de başarıyla etkinleştirildiğini gösterir.

  3. Mülk için hâlâ eski değeri useStringDeduplication görüyorsanız İleti İşlemcilerde Dize Tekrarını Kaldırma İşlemini Etkinleştirme bölümünde belirtilen tüm adımları doğru şekilde uyguladığınızdan emin olun. Herhangi bir adımı atladıysanız tüm adımları tekrar doğru şekilde uygulayın.
  4. Dize tekilleştirme özelliğini hâlâ etkinleştiremiyorsanız Apigee Destek Ekibi ile iletişime geçin.

Sırada ne var?

Message Processors'da G1GC'yi etkinleştirme