Abilitazione di G1GC sui processori di messaggi

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X.
info

Questo documento spiega come abilitare il Garbage Collector Garbage First (G1GC) sui processori di messaggi di Apigee Edge.

Il processore di messaggi di Apigee Edge viene eseguito sulla Java Virtual Machine (JVM) e utilizza il Garbage Collector predefinito, seriale o parallelo, a seconda delle configurazioni hardware e del sistema operativo. In determinate circostanze e in base alle tue esigenze, potresti voler modificare il tipo di Garbage Collector utilizzato sul processore di messaggi.

Il G1GC è il Garbage Collector generazionale in stile server con pause brevi per Java HotSpot VM che migliora il rendimento complessivo del processore di messaggi. In genere, è progettato per applicazioni con set di dati di dimensioni medie o grandi in cui il tempo di risposta è più importante della velocità effettiva complessiva. Ad esempio, puoi prendere in considerazione l'utilizzo di G1GC se la dimensione dell'heap è elevata (maggiore di 3 GB).

In genere, è consigliabile impostare un altro parametro JVM UseStringDeduplication insieme a G1GC. Questo parametro ottimizza la memoria utilizzata dall'heap Java facendo in modo che i valori String duplicati o identici condividano lo stesso array di caratteri.

Prima di iniziare

Abilitare G1GC sui processori di messaggi

Questa sezione spiega come abilitare G1GC sul processore di messaggi Edge. G1GC può essere abilitato tramite la proprietà useG1GC nel componente del processore di messaggi. Per impostazione predefinita, questa proprietà è impostata su false sui processori di messaggi. Per configurare qualsiasi proprietà sul processore di messaggi, utilizza il token in base alla sintassi descritta in Come configurare Edge.

Per abilitare G1GC sui processori di messaggi:

  1. Individua il token per la proprietà useG1GC
  2. Abilita G1GC sul processore di messaggi

Individua il token per la proprietà useG1GC

I seguenti passaggi spiegano come individuare il token per la proprietà useG1GC:

  1. Cerca la proprietà useG1GC nella directory di origine del processore di messaggi /opt/apigee/edge-message-processor/source utilizzando il seguente comando:
    grep -ri "useG1GC" /opt/apigee/edge-message-processor/source
  2. L'output di questo comando mostra il token per la proprietà useG1GC del processore di messaggi come segue:
    /opt/apigee/edge-message-processor/source/conf/system.properties:useG1GC={T}conf_system_useG1GC{/T}

    La stringa tra i tag {T}{/T} è il nome del token che puoi impostare nel file .properties del processore di messaggi. Pertanto, il token per la proprietà useG1GC è il seguente:

    conf_system_useG1GC

Abilita G1GC sui processori di messaggi

I seguenti passaggi spiegano come abilitare G1GC sui processori di messaggi Apigee:

  1. Apri il file /opt/apigee/customer/application/message-processor.properties sulla macchina del processore di messaggi in un editor. Se il file non esiste, allora crealo. Ad esempio:
    vi /opt/apigee/customer/application/message-processor.properties
  2. Aggiungi la seguente riga a questo file:
    conf_system_useG1GC=true
  3. Salva le modifiche.
  4. Assicurati che il file delle proprietà sia di proprietà dell'utente apigee. Ad esempio:
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  5. Riavvia il processore di messaggi utilizzando il seguente comando:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  6. Se hai più di un processore di messaggi, ripeti questi passaggi su tutti i processori di messaggi.

Verificare la configurazione di G1GC sui processori di messaggi

Questa sezione spiega come verificare che la configurazione di G1GC sia stata modificata correttamente sui processori di messaggi.

Anche se utilizzi il token conf_system_useG1GC per abilitare G1GC sul processore di messaggi, devi verificare che la proprietà effettiva useG1GC sia stata impostata con il nuovo valore come segue:

  1. Cerca la proprietà useG1GC nella directory /opt/apigee/edge-message-processor/conf e verifica che sia stata impostata con il nuovo valore. Ad esempio:
    grep -ri "useG1GC" /opt/apigee/edge-message-processor/conf
  2. Se G1GC è stato abilitato correttamente sul processore di messaggi, il comando precedente mostra il nuovo valore nel file system.properties.

    Il risultato di esempio del comando precedente, dopo aver abilitato G1GC sul processore di messaggi, è il seguente:

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

    Nell'output di esempio, tieni presente che la proprietà useG1GC è stata impostata con il nuovo valore true in system.properties. Ciò indica che G1GC è stato abilitato correttamente sul processore di messaggi.

  3. Se continui a visualizzare il vecchio valore per la proprietà useG1GC, verifica di aver seguito correttamente tutti i passaggi descritti in Abilitare G1GC sui processori di messaggi. Se hai saltato un passaggio, ripeti correttamente tutti i passaggi.
  4. Se non riesci ancora ad abilitare G1GC, contatta l'assistenza di Apigee Edge.

Passaggi successivi

Abilitare la deduplicazione delle stringhe sui processori di messaggi