Включение G1GC в процессорах сообщений

Вы просматриваете документацию Apigee Edge .
Перейдите в документацию Apigee
X.info

В этом документе объясняется, как включить сборщик мусора Garbage First (G1GC) на процессорах сообщений Apigee Edge.

Обработчик сообщений Apigee Edge работает на виртуальной машине Java (JVM) и использует сборщик мусора по умолчанию — последовательный или параллельный, в зависимости от конфигурации оборудования и операционной системы. В определенных обстоятельствах и в зависимости от ваших потребностей может потребоваться изменить тип сборщика мусора, используемого в обработчике сообщений.

G1GC — это низкопаузовый сборщик мусора серверного типа для Java HotSpot VM, который повышает общую производительность обработчика сообщений. Как правило, он предназначен для приложений со средними и большими наборами данных, где время отклика важнее общей пропускной способности. Например: вы можете рассмотреть возможность использования G1GC, если размер кучи большой (более 3 ГБ).

Как правило, рекомендуется устанавливать еще один параметр JVM, UseStringDeduplication наряду с G1GC. Этот параметр оптимизирует использование памяти кучи Java, заставляя повторяющиеся или идентичные строковые значения использовать один и тот же символьный массив.

Прежде чем начать

Включение G1GC в обработчиках сообщений

В этом разделе объясняется, как включить G1GC в обработчике сообщений Edge. G1GC можно включить с помощью свойства useG1GC в компоненте обработчика сообщений. По умолчанию это свойство установлено в false для обработчиков сообщений. Чтобы настроить любое свойство в обработчике сообщений, используйте токен в соответствии с синтаксисом, описанным в разделе «Как настроить Edge» .

Для включения G1GC на обработчиках сообщений выполните следующие действия:

  1. Найдите токен для свойства useG1GC.
  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 была успешно изменена на обработчиках сообщений.

Даже если вы используете токен conf_system_useG1GC для включения G1GC в обработчике сообщений, необходимо убедиться, что фактическое свойство useG1GC установлено с новым значением следующим образом:

  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 в system.properties получило новое значение true . Это указывает на то, что G1GC успешно включен в обработчике сообщений.

  3. Если для свойства useG1GC по-прежнему отображается старое значение, убедитесь, что вы правильно выполнили все шаги, описанные в разделе «Включение G1GC в обработчиках сообщений» . Если вы пропустили какой-либо шаг, повторите все шаги заново.
  4. Если вам по-прежнему не удается включить G1GC, обратитесь в службу поддержки Apigee Edge .

Что дальше?

Включение дедупликации строк в обработчиках сообщений

,

Вы просматриваете документацию Apigee Edge .
Перейдите в документацию Apigee
X.info

В этом документе объясняется, как включить сборщик мусора Garbage First (G1GC) на процессорах сообщений Apigee Edge.

Обработчик сообщений Apigee Edge работает на виртуальной машине Java (JVM) и использует сборщик мусора по умолчанию — последовательный или параллельный, в зависимости от конфигурации оборудования и операционной системы. В определенных обстоятельствах и в зависимости от ваших потребностей может потребоваться изменить тип сборщика мусора, используемого в обработчике сообщений.

G1GC — это низкопаузовый сборщик мусора серверного типа для Java HotSpot VM, который повышает общую производительность обработчика сообщений. Как правило, он предназначен для приложений со средними и большими наборами данных, где время отклика важнее общей пропускной способности. Например: вы можете рассмотреть возможность использования G1GC, если размер кучи большой (более 3 ГБ).

Как правило, рекомендуется устанавливать еще один параметр JVM, UseStringDeduplication наряду с G1GC. Этот параметр оптимизирует использование памяти кучи Java, заставляя повторяющиеся или идентичные строковые значения использовать один и тот же символьный массив.

Прежде чем начать

Включение G1GC в обработчиках сообщений

В этом разделе объясняется, как включить G1GC в обработчике сообщений Edge. G1GC можно включить с помощью свойства useG1GC в компоненте обработчика сообщений. По умолчанию это свойство установлено в false для обработчиков сообщений. Чтобы настроить любое свойство в обработчике сообщений, используйте токен в соответствии с синтаксисом, описанным в разделе «Как настроить Edge» .

Для включения G1GC на обработчиках сообщений выполните следующие действия:

  1. Найдите токен для свойства useG1GC.
  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 была успешно изменена на обработчиках сообщений.

Даже если вы используете токен conf_system_useG1GC для включения G1GC в обработчике сообщений, необходимо убедиться, что фактическое свойство useG1GC установлено с новым значением следующим образом:

  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 в system.properties получило новое значение true . Это указывает на то, что G1GC успешно включен в обработчике сообщений.

  3. Если для свойства useG1GC по-прежнему отображается старое значение, убедитесь, что вы правильно выполнили все шаги, описанные в разделе «Включение G1GC в обработчиках сообщений» . Если вы пропустили какой-либо шаг, повторите все шаги заново.
  4. Если вам по-прежнему не удается включить G1GC, обратитесь в службу поддержки Apigee Edge .

Что дальше?

Включение дедупликации строк в обработчиках сообщений