Configurazione del timeout I/O sui router

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

Questo documento spiega come configurare il timeout I/O sui router di Apigee Edge.

Il timeout I/O sul router rappresenta il tempo durante il quale il router attende di ricevere una risposta dal processore di messaggi, dopo aver stabilito la connessione e inviato la richiesta al processore di messaggi. Il valore predefinito del timeout I/O sul router è di 57 secondi.

Il timeout I/O per i router può essere aumentato o diminuito rispetto al valore predefinito di 57 secondi in base alle tue esigenze. Può essere configurato nei seguenti modi:

• In un host virtuale
• Sul router

Le seguenti proprietà controllano il timeout I/O sui router:

ms: milliseconds
s:  seconds (default)
m:  minutes
h:  hours
d:  days
w:  weeks
M:  months (length of 30 days)
y:  years (length of 365 days)

Prima di iniziare

Prima di seguire i passaggi descritti in questo documento, assicurati di comprendere i seguenti argomenti:

• Se non hai familiarità con le proprietà degli host virtuali, leggi Riferimento alle proprietà degli host virtuali.
• Se non hai familiarità con la configurazione delle proprietà per Edge su Private Cloud, leggi Come configurare Edge.
• Assicurati di seguire le Best practice per la configurazione delle raccomandazioni sul timeout I/O.

Configurare il timeout I/O nell'host virtuale

Questa sezione spiega come configurare il timeout I/O nell'host virtuale associato a un organizzazione e a un ambiente. Il timeout I/O può essere configurato nell'host virtuale tramite la proprietà proxy_read_timeout, che rappresenta il valore del timeout I/O in secondi.

Puoi configurare l'host virtuale utilizzando uno dei seguenti metodi:

• UI Edge
• API Edge

Verificare il timeout I/O sugli host virtuali

Questa sezione spiega come verificare che il timeout I/O sia stato modificato correttamente sull' host virtuale utilizzando l'API Edge.

1. Esegui l' API Get virtual host per ottenere la configurazione virtualhost come mostrato di seguito:

   Utente di Public Cloud

   curl -v -X GET https://api.enterprise.apigee.com/v1/organizations/{organization-name}/environments/{environment-name}/virtualhosts/{virtualhost-name} -u <username>
                 

   Utente di Private Cloud

   curl -v -X GET http://<management server-host>:<port #>/v1/organizations/{organization-name}/environments/{environment-name}/virtualhosts/{virtualhost-name} -u <username>
                 

   Dove:

   {organization-name} è il nome dell'organizzazione

   {environment-name} è il nome dell'ambiente

   {virtualhost-name} è il nome dell'host virtuale

2. Verifica che la proprietà proxy_read_timeout sia stata impostata sul nuovo valore.

   Configurazione dell'host virtuale aggiornata di esempio

   {
     "hostAliases": [
       "api.myCompany,com",
     ],
     "interfaces": [],
     "listenOptions": [],
     "name": "secure",
     "port": "443",
     "retryOptions": [],
     "properties": {
       "property": [
         {
           "name": "proxy_read_timeout",
           "value": "120"
         }
       ]
     },
     "sSLInfo": {
       "ciphers": [],
       "clientAuthEnabled": "false",
       "enabled": "true",
       "ignoreValidationErrors": false,
       "keyAlias": "myCompanyKeyAlias",
       "keyStore": "ref://myCompanyKeystoreref",
       "protocols": []
     },
     "useBuiltInFreeTrialCert": false
   }

   Nell'esempio precedente, tieni presente che proxy_read_timeout è stato impostato con il nuovo valore di 120 secondi.

3. Se continui a visualizzare il vecchio valore per proxy_read_timeout,verifica di aver seguito correttamente tutti i passaggi descritti in Configurare il timeout I/O nell'host virtuale. Se hai saltato un passaggio, ripeti correttamente tutti i passaggi.
4. Se non riesci ancora a modificare il timeout I/O, contatta l'assistenza di Apigee Edge.

Configurare il timeout I/O sui router

Questa sezione spiega come configurare il timeout I/O sui router. Il timeout I/O può essere configurato tramite la proprietà del router conf_load_balancing_load.balancing.driver.proxy.read.timeout, che rappresenta il valore del timeout I/O in secondi.

Per configurare il timeout I/O sui router:

1. Sulla macchina del router, apri il seguente file in un editor. Se non esiste già, crealo.

   /opt/apigee/customer/application/router.properties

   Ad esempio, per aprire il file con vi, inserisci il seguente comando:

   vi /opt/apigee/customer/application/router.properties

2. Aggiungi una riga nel seguente formato al file properties, sostituendo un valore per time_in_seconds:

conf_load_balancing_load.balancing.driver.proxy.read.timeout=time_in_seconds

Ad esempio, per modificare il timeout I/O sul router a 120 secondi, aggiungi la seguente riga:

conf_load_balancing_load.balancing.driver.proxy.read.timeout=120

Puoi anche modificare il timeout I/O in minuti. Ad esempio, per modificare il timeout a due minuti, aggiungi la seguente riga:

conf_load_balancing_load.balancing.driver.proxy.read.timeout=2m

3. Salva le modifiche.
4. Assicurati che questo file di proprietà sia di proprietà dell'utente apigee come mostrato di seguito:

   chown apigee:apigee /opt/apigee/customer/application/router.properties

5. Riavvia il router come mostrato di seguito:

   /opt/apigee/apigee-service/bin/apigee-service edge-router restart

6. Se hai più di un router, ripeti i passaggi precedenti su tutti i router.

Verificare il timeout I/O sui router

Questa sezione spiega come verificare che il timeout I/O sia stato modificato correttamente sui router.

Anche se utilizzi il token conf_load_balancing_load.balancing.driver.proxy.read.timeout per impostare il timeout I/O sul router, devi verificare se la proprietà effettiva proxy_read_timeout è stata impostata con il nuovo valore.

1. Cerca la proprietà proxy_read_timeout nella /opt/nginx/conf.d directory e verifica se è stata impostata con il nuovo valore come segue:

   grep -ri "proxy_read_timeout" /opt/nginx/conf.d

2. Se il nuovo valore di timeout I/O viene impostato correttamente sul router, il comando precedente mostra il nuovo valore in tutti i file di configurazione dell'host virtuale.

   Di seguito è riportato il risultato di esempio del comando grep precedente quando il timeout I/O è di 120 secondi:

   /opt/nginx/conf.d/0-default.conf:proxy_read_timeout 120;
   /opt/nginx/conf.d/0-edge-health.conf:proxy_read_timeout 1s;

   Nell'output di esempio precedente, nota che la proprietà proxy_read_timeout è stata impostata con il nuovo valore 120 in 0-default.conf, che è il file di configurazione dell'host virtuale predefinito. Ciò indica che il timeout I/O è stato configurato correttamente a 120 secondi sul router.

3. Se continui a visualizzare il vecchio valore per la proprietà proxy_read_timeout, verifica di aver seguito correttamente tutti i passaggi descritti in Configurare il timeout I/O sui router. Se hai saltato un passaggio, ripeti correttamente tutti i passaggi.
4. Se non riesci ancora a modificare il timeout I/O, contatta l'assistenza di Apigee Edge.

Passaggi successivi

Scopri di più sulla configurazione del timeout I/O nel processore di messaggi