GKE su Bare Metal nettest
identifica i problemi di connettività negli oggetti Kubernetes nei tuoi cluster, come pod, nodi, servizi e alcuni target esterni. nettest
non controlla le connessioni da destinazioni esterne a pod, nodi o servizi. Questo documento descrive come eseguire il deployment di nettest
ed eseguirlo con uno dei manifest, nettest.yaml
o nettest_rhel.yaml
, nel repository anthos-samples
GitHub. Utilizza nettest_rhel.yaml
se esegui GKE su Bare Metal su
Red HatEnterprise Linux (RHEL) o CentOS. Utilizza nettest.yaml
se esegui GKE su Bare Metal su Ubuntu.
Questo documento descrive anche come interpretare i log generati da nettest
per identificare i problemi di connettività con i cluster.
Informazioni su nettest
Lo strumento di diagnostica nettest
è costituito dai seguenti oggetti Kubernetes. Ogni oggetto viene specificato nei nettest
file manifest YAML.
cloudprober
: un DaemonSet e un Service responsabili della raccolta dello stato della connessione di rete, come la percentuale di errore e la latenza.echoserver
: un DaemonSet e un Servizio responsabile di rispondere acloudprober
, fornendogli le metriche per la connettività di rete.nettest
: un pod contenente i containerprometheus
enettest
.prometheus
raccoglie metriche dacloudprober
.nettest
esegue una query suprometheus
e mostra i risultati del test di rete nel log.
nettest-engine
: un ConfigMap per configurare il containernettest
nel podnettest
.
Il manifest specifica anche lo spazio dei nomi nettest
e un ServiceAccount dedicato (insieme a ClusterRole e ClusterRoleBinding) per isolare nettest
dalle altre risorse del cluster.
Esegui nettest
Esegui il deployment di nettest
eseguendo questo comando per il tuo sistema operativo.
Il test viene eseguito automaticamente all'avvio del pod nettest
. Il test richiede circa cinque minuti.
Per il sistema operativo Ubuntu:
kubectl apply -f https://raw.githubusercontent.com/GoogleCloudPlatform/anthos-samples/main/anthos-bm-utils/abm-nettest/nettest.yaml
Per RHEL o CentOS OS:
kubectl apply -f https://raw.githubusercontent.com/GoogleCloudPlatform/anthos-samples/main/anthos-bm-utils/abm-nettest/nettest_rhel.yaml
Ottieni i risultati del test
Al termine del test, che dovrebbe richiedere circa cinque minuti dopo il deployment del manifest nettest
, esegui questo comando per vedere i risultati di nettest
:
kubectl -n nettest logs nettest -c nettest
Mentre nettest
è in esecuzione, invia messaggi come il seguente a stdout
:
I0413 03:33:04.879141 1 collectorui.go:130] Listening on ":8999"
I0413 03:33:04.879258 1 prometheus.go:172] Running prometheus controller
E0413 03:33:04.879628 1 prometheus.go:178] Prometheus controller: failed to
retries probers: Get "http://127.0.0.1:9090/api/v1/targets": dial tcp 127.0.0.1:9090:
connect: connection refused
Se nettest
viene eseguito correttamente senza identificare eventuali errori di connettività, verrà visualizzata la seguente voce di log:
I0211 21:58:34.689290 1 validate_metrics.go:78] Metric validation passed!
Se nettest
ha rilevato problemi di connessione, scrive le voci di log come le seguenti:
E0211 06:40:11.948634 1 collector.go:65] Engine error: step validateMetrics failed:
"Error rate in percentage": probe from "10.200.0.3" to "172.26.115.210:80" has value 100.000000,
threshold is 1.000000
"Error rate in percentage": probe from "10.200.0.3" to "172.26.27.229:80" has value 100.000000,
threshold is 1.000000
"Error rate in percentage": probe from "192.168.3.248" to "echoserver-hostnetwork_10.200.0.2_8080"
has value 2.007046, threshold is 1.000000
Anche se la soglia predefinita è dell'1% (1.000000
), le frequenze di errori fino al 5% possono essere ignorate in sicurezza. Ad esempio, la percentuale di errori per la connettività
dall'indirizzo IP 192.168.3.248
a echoserver-hostnetwork_10.200.0.2_8080
nell'esempio precedente è di circa il due percento (2.007046
). Questo è un
esempio di un problema di connettività segnalato che puoi ignorare.
Interpretare i risultati del test
Quando nettest
termina e rileva un problema di connettività, viene visualizzata la seguente voce nei log del pod nettest
:
"Error rate in percentage": probe from {src} to {dst} has value 100.000000, threshold is 1.000000
In questo caso, {src}
e {dst}
possono essere:
echoserver
IP pod: la connessione da/verso un pod sul nodo.- IP nodo: la connessione da/verso il nodo.
- IP di servizio (vedi il testo seguente per maggiori dettagli)
Inoltre, {dst}
può anche essere:
google.com
: una connessione esterna.dns
: la connessione a un servizio nonhostNetwork
tramite DNS, ovveroechoserver-non-hostnetwork.nettest.svc.cluster.local
.I dettagli per l'IP di servizio sono riportati nelle voci del probe in formato JSON nel log, come nell'esempio seguente. Il probe di esempio seguente mostra che
172.26.27.229:80
è l'indirizzo diservice-clusterip
. Esistono due probe con questo valoretargets
, uno per il pod (pod-service-clusterip
) e uno per il Nodo (node-service-clusterip
).probe { name: "node-service-clusterip" … targets { host_names: "172.26.27.229:80" }
Convalidare le correzioni
Una volta risolti tutti i problemi di connettività segnalati, rimuovi il pod nettest
e applica nuovamente il manifest nettest
per eseguire nuovamente i test di connettività.
Ad esempio, per eseguire nuovamente nettest
per Ubuntu, esegui questi comandi:
kubectl -n nettest delete pod nettest
kubectl apply -f https://raw.githubusercontent.com/GoogleCloudPlatform/anthos-samples/main/anthos-bm-utils/abm-nettest/nettest.yaml
Libera nettest
Al termine del test, esegui questi comandi per rimuovere tutte le risorse nettest
:
kubectl delete namespace nettest
kubectl delete clusterroles nettest:nettest
kubectl delete clusterrolebindings nettest:nettest