Stai visualizzando la documentazione relativa a Apigee e Apigee ibrido.
Visualizza la documentazione di
Apigee Edge.
Sintomo
Durante la replica dei dati durante un'espansione multiregionale, lo stato CassandraDataReplication
potrebbe mostrare uno stato di errore e la replica dei dati potrebbe non riuscire.
Messaggio di errore
Quando utilizzi
kubectl
per visualizzare lo stato della ricompilazione:
kubectl -n apigee get apigeeds \ -o jsonpath="{.items[].status.cassandraDataReplication}{'\n'}"
Vedrai che uno o più pod Cassandra mostrano uno stato di errore e un messaggio che indica che la ricreazione non è riuscita. Ad esempio:
{ "rebuildDetails": { "apigee-cassandra-default-0": { "message": "failed to rebuild from us-west1: java.lang.IllegalStateException : Unable to find sufficient sources for streaming range (-8567285182390470134,-8567154549835592965] in keyspace system_distributed", "state": "error", "updated": 1641581899 }, … } }
Cause possibili
Causa | Descrizione | Le istruzioni di risoluzione dei problemi applicabili a |
---|---|---|
Regione di origine non corretta | È stato specificato un valore errato per source.region all'interno del file YAML della replica dei dati Cassandra. |
Apigee hybrid |
Problemi di connettività di rete | Potrebbero verificarsi problemi di connettività di rete tra i pod Cassandra in data center diversi. | Apigee hybrid |
Passaggi diagnostici comuni
- Recupera lo stato della replica dei dati:
kubectl -n apigee get apigeeds \
-o jsonpath="{.items[].status.cassandraDataReplication}{'\n'}" - Se visualizzi un messaggio di errore simile a quello specificato in Messaggio di errore, significa che stai riscontrando questo problema.
Causa: regione di origine errata
Se nel file YAML di replica dei dati specifichi una regione di origine (datacenter
) diversa dall'origine effettiva datacenter
, la replica dei dati non riuscirà. Esegui i passaggi descritti nella sezione Diagnostica per analizzare questo scenario ed esegui i passaggi descritti nella sezione Risoluzione per correggerlo.
Diagnosi
- Elenca tutti i pod Cassandra nella regione di origine:
kubectl -n apigee get pods -l app=apigee-cassandra
- Ottieni il valore effettivo di
datacenter
da uno qualsiasi dei pod Cassandra restituiti nel passaggio 1:kubectl -n apigee exec -it apigee-cassandra-default-0 -- \ nodetool -u JMX_user -pw JMX_password status
- Ottieni il valore utilizzato per
source.region
nel file di risorsa personalizzata (YAML) di replica dei dati Cassandra che hai creato in Deployment multiregionale. Se utilizzi il nome file di esempio trovato nella documentazione del deployment per più regioni, il nome del file deve esseredatareplication.yaml
.cat datareplication.yaml
Risultati di esempio:
apiVersion: apigee.cloud.google.com/v1alpha1 kind: CassandraDataReplication metadata: name: region-expansion namespace: apigee spec: organizationRef: apigee-hybrid-example-org force: false source: region: "us-west1"
Controlla il risultato dell'output
nodetool status
e verifica se il valore didatacenter
corrisponde o meno al valoresource.region
:kubectl -n apigee exec -it apigee-cassandra-default-0 -- \ nodetool -u jmxuser -pw iloveapis123 status
Risultati di esempio:
Datacenter: dc-1 ================ Status=Up/Down |/ State=Normal/Leaving/Joining/Moving -- Address Load Tokens Owns (effective) Host ID Rack UN 10.104.13.2 491.84 KiB 256 100.0% 7254711c-fe0a-4b34-b50f-861109f97936 ra-1 UN 10.104.11.3 527.36 KiB 256 100.0% 5ec389f0-fd67-4de6-9f21-172d5899ff78 ra-1 UN 10.104.12.7 838.46 KiB 256 100.0% 7a88be82-1f81-4117-86e3-2cda434c0878 ra-1
- Tieni presente che
source.region
(us-west1
) del filedatareplication.yaml
non corrisponde al valore effettivo didatacenter
(dc-1
) dell'output dello statonodetool
. Segui i passaggi in Risoluzione per correggere la configurazione.
Risoluzione
Per correggere la replica dei dati, devi eliminare il job di replica dei dati e crearlo con il nome datacenter
corretto. Procedi nel seguente modo:
- Elimina l'attuale processo di replica dei dati. Se utilizzi il nome file di esempio trovato nella documentazione sul
deployment in più regioni, il file deve essere denominato
datareplication.yaml
.kubectl delete -f datareplication.yaml
- Aggiorna il nome della regione nel file YAML con il valore
datacenter
corretto, ad esempiodc-1
:apiVersion: apigee.cloud.google.com/v1alpha1 kind: CassandraDataReplication metadata: name: region-expansion namespace: apigee spec: organizationRef: apigee-hybrid-example-org force: false source: region: "dc-1"
- Applica la replica dei dati aggiornata:
kubectl apply -f datareplication.yaml
- Controlla lo stato della ricompilazione utilizzando il comando seguente e verifica che lo stato di errore precedentemente segnalato non sia più visibile:
kubectl -n apigee get apigeeds \ -o jsonpath="{.items[].status.cassandraDataReplication}{'\n'}"
- Se il problema persiste, vai alla sezione Causa: problemi di connettività di rete.
Causa: problemi di connettività di rete
L'errore di replica dei dati può anche essere il risultato di problemi di connettività tra i nodi Cassandra.
Diagnosi
Per analizzare questo scenario, procedi nel seguente modo:
- Elenca tutti i pod Cassandra:
# list cassandra pods kubectl -n=apigee get pods -l app=apigee-cassandra
- Esegui questo comando
curl
e telnet sul primo pod Cassandra nel secondo data center (dc-2
) dal primo pod Cassandra nel primo data center (dc-1
) utilizzando la porta7001
:kubectl -n apigee exec -it apigee-cassandra-default-0 bash -- curl -v telnet://DC_2_APIGEE_CASSANDRA_DEFAULT_0_POD_IP:7001
- Se telnet ha esito positivo, viene visualizzato un output simile al seguente:
* Rebuilt URL to: telnet://10.0.4.10:7001/ * Trying 10.0.4.10... * TCP_NODELAY set * Connected to 10.0.4.10 (10.0.4.10) port 7001 (#0)
- In caso contrario, viene visualizzato un errore simile al seguente:
* Rebuilt URL to: telnet://10.0.4.10:7001/ * Trying 10.0.4.10... * TCP_NODELAY set * connect to 10.0.4.10 port 7001 failed: Connection refused * Failed to connect to 10.0.4.10 port 7001: Connection refused * Closing connection 0 curl: (7) Failed to connect to 10.0.4.10 port 7001: Connection refused
L'errore di connettività dal pod Cassandra in un data center al pod Cassandra in un altro data center indica che deve esistere una limitazione del firewall o un problema di connettività di rete.
Risoluzione
- Se questo deployment ibrido Apigee è eseguito su GKE, verifica se sono impostate regole firewall che bloccano il traffico da un data center all'altro e analizza il problema di connettività di rete facendo riferimento alla panoramica sulle regole firewall VPC.
- Se questo deployment ibrido Apigee viene eseguito su GKE-on-prem, collabora con il team di networking competente e analizza il problema di connettività di rete.
Se il problema persiste, consulta l'articolo È necessario raccogliere i dati diagnostici.
Raccogliere dati diagnostici
Se il problema persiste anche dopo aver seguito le istruzioni riportate sopra, raccogli le seguenti informazioni diagnostiche e contatta l'assistenza clienti Google Cloud:
- L'ID del progetto Google Cloud.
- L'organizzazione Apigee ibrida.
- I file
overrides.yaml
provenienti sia dalle regioni di origine sia da quelle nuove, mascherando eventuali informazioni sensibili. - Il file YAML
CassandraDataReplication
. - Output
nodetool status
di Cassandra:kubectl -n apigee exec -it apigee-cassandra-default-0 -- \ nodetool -u JMX_user -pw JMX_password status
- Output
nodetool describecluster
di Cassandra:kubectl -n apigee exec -it apigee-cassandra-default-0 -- \ nodetool -u JMX_user -pw JMX_password describecluster