Configura Cloud Monitoring con un agente autonomo

Cloud Monitoring ti aiuta a ottenere visibilità su prestazioni, disponibilità e integrità delle tue applicazioni e della tua infrastruttura. Puoi utilizzare Cloud Monitoring e altre parti dell'osservabilità di Google Cloud per monitorare, risolvere i problemi e gestire i servizi VMware Engine su larga scala.

La configurazione dell'inoltro delle metriche viene definita separatamente per ogni cloud privato utilizzando un agente autonomo. Ogni cloud privato richiede un agente separato, ospitato in una VM Compute Engine o in una VM VMware.

Dopo aver attivato correttamente l'inoltro delle metriche, puoi visualizzarle in Metrics Explorer di Cloud Monitoring. I tipi di risorse e le metriche di VMware Engine iniziano con external.googleapis.com/vmware/vcenter e il FQDN di vCenter è contrassegnato come parte dello spazio dei nomi.

Nota: l'utilizzo dell'agente autonomo non comporta costi aggiuntivi per i clienti di VMware Engine, ma le metriche raccolte tramite l'agente vengono addebitate alle tariffe standard delle metriche personalizzate. Queste tariffe includono allocazioni per l'utilizzo gratuito dei dati per iniziare senza costi anticipati e senza impegni.

Prima di iniziare

I passaggi descritti in questo documento presuppongono che tu abbia prima eseguito quanto segue:

1. Abilita l'API Cloud Monitoring
2. Identifica un account utente della soluzione da utilizzare con l'agente autonomo e imposta una password efficace per l'account utente della soluzione.

3. Crea una VM Compute Engine o una VM VMware da utilizzare come host per l'agente autonomo. Le VM Compute Engine devono trovarsi in una rete VPC (Virtual Private Cloud) con peering con la rete VPC del cloud privato contenente le risorse da monitorare.

   Per un esempio di creazione di una VM Compute Engine, consulta la Guida rapida all'utilizzo di una VM Linux di Compute Engine. Per un esempio di creazione di una VM VMware, consulta Creare una VM VMware.

Se utilizzi una VM Compute Engine per ospitare l'agente autonomo, Google gestisce la rotazione della chiave per l'account di servizio a cui ti connetti. Tuttavia, può essere conveniente creare una VM VMware se disponi di capacità inutilizzata nel tuo cloud privato e non ti dispiace gestire la rotazione della chiave autonomamente.

Indipendentemente da dove crei la VM host dell'agente, deve soddisfare i seguenti requisiti:

Requisiti

La VM host dell'agente deve soddisfare i seguenti requisiti di sistema:

• Sistemi operativi Linux supportati:
• CentOS 6, 7 o 8
• Red Hat Enterprise Linux 6, 7 o 8
• SLES 12 o 15
• Ubuntu 14, 16, 18 o 19
• Almeno 4 GB di RAM
• Spazio di installazione di 300 MB disponibile
• Directory di installazione impostata su /opt/bpagent
• Utilità CLI curl installata

La VM host dell'agente deve inoltre avere accesso ai seguenti indirizzi per raccogliere e inviare metriche e log:

• Porta 443 (TCP) per la connessione HTTPS al server vCenter (valore predefinito)
• monitoring.googleapis.com:443 (external access)
• logging.googleapis.com:443 (external access)

Attivazione del forwarding delle metriche

La procedura per configurare la VM host dell'agente e attivare l'inoltro delle metriche consiste nei seguenti passaggi:

1. Installa l'agente sulla VM
2. Specifica un account di servizio
3. Configurare l'agente in modo che acceda al tuo cloud privato per le metriche
4. Configurare l'agente in modo che acceda all'account di servizio per i report
5. Raccogliere metriche e log
6. Configurare un cloud privato per l'inoltro syslog

Installazione dell'agente autonomo

Per installare l'agente sulla VM host:

1. Connettiti alla VM host dell'agente.

2. Esegui lo script di installazione da remoto:

   sudo sh -c "$(curl -S https://storage.googleapis.com/gcve-observability-agent/latest/vmware-linux-amd64/installer/install.sh)"
   

Per i sistemi in cui la VM host dell'agente potrebbe non avere accesso alla rete esterna, puoi scaricare l'agente e lo script di installazione utilizzando i seguenti comandi:

• Per ottenere l'agente autonomo, esegui quanto segue:

  curl -S https://storage.googleapis.com/gcve-observability-agent/latest/vmware-linux-amd64/artifacts/bpagent-headless-vmware.tar.gz > agent.tar.gz
  

• Per ottenere lo script di installazione, esegui quanto segue:

  curl -S https://storage.googleapis.com/gcve-observability-agent/latest/vmware-linux-amd64/installer/install.sh > install.sh
  

• Per installare l'agente, esegui quanto segue sulla VM host dell'agente:

  sudo sh install.sh agent.tar.gz
  

Specifica un account di servizio personalizzato

Per inoltrare i dati dall'agente a Cloud Monitoring è necessario un account di servizio del tuo progetto Google Cloud. Questo account di servizio deve avere il ruolo Amministratore monitoraggio per le metriche e il ruolo Scrittore log per i log.

Se non hai un account di servizio per il monitoraggio e la registrazione delle applicazioni, creane uno:

1. Nella console Google Cloud, vai a IAM e amministrazione > Account di servizio.

   Vai a Service account

2. Fai clic su Crea account di servizio.

3. Inserisci un nome, un ID e una descrizione per l'account di servizio. Ti consigliamo di ricordare che l'account viene utilizzato per l'integrazione dell'agente.

4. Fai clic su Crea e continua.

5. In Ruolo, seleziona Monitoring Admin.

6. In Ruolo, seleziona Logs Writer.

7. Fai clic su Continua.

8. Fai clic su Fine.

Se hai creato una VM VMware come VM host dell'agente, recupera la chiave privata dell'account di servizio per poterla utilizzare per configurare l'agente:

1. Nella console Google Cloud, vai a IAM e amministrazione > Account di servizio.

   Vai a Service account

2. Trova il tuo account di servizio nell'elenco degli account di servizio.

3. Nella colonna Azioni, fai clic sul menu delle azioni dell'account di servizio e seleziona Gestisci chiavi.

4. Fai clic su Aggiungi chiave e seleziona Crea nuova chiave.

5. Seleziona il tipo di chiave JSON e fai clic su Crea.

6. Apri il file JSON generato e copia l'intero contenuto del file. La raccolta delle metriche e la raccolta dei log utilizzano entrambi lo stesso file della chiave JSON.

7. Nella VM host dell'agente, copia il file della chiave JSON nella directory/opt/bpagent/config/destinations/google_cloud.

Configura l'agente in modo che acceda al tuo cloud privato per le metriche

L'agente autonomo deve accedere al tuo cloud privato per raccogliere le metriche. Nella VM host dell'agente, configura l'accesso copiando e configurando il file vmware_vcenter.yaml:

1. Copia vmware_vcenter.yaml nella directory config/metrics/sources:

   cp /opt/bpagent/config/metrics/examples/vmware_vcenter.yaml /opt/bpagent/config/metrics/sources
   

2. Modifica vmware_vcenter.yaml in modo che corrisponda alle informazioni nell'ambiente VMware Engine:

   collection_interval: 1m0s
   connection_info:
   connection_timeout: "30"
   enable_performance_counters: "true"
   host: VCSA_FQDN
   password: SOLUTION_USER_PASSWORD
   performance_counter_end_time: ""
   performance_counter_query_timeout: "15"
   performance_counter_start_time: ""
   port: "443"
   sdk_path: ""
   ssl_config: "No Verify"
   username: SOLUTION_USER_ACCOUNT

   Sostituisci quanto segue:

   • VCSA_FQDN: il nome di dominio completo (FQDN) dell'appliance vCenter Server nel tuo cloud privato
   • SOLUTION_USER_PASSWORD: la password corrispondente all'account utente della soluzione in uso
   • SOLUTION_USER_ACCOUNT: l'account utente della soluzione utilizzato dall'agente per segnalare le informazioni

Configura l'agente in modo che acceda all'account di servizio per i report

L'agente autonomo deve avere accesso a Google Cloud Observability per inviare metriche e log. Configura l'agente in modo che acceda al progetto utilizzato per i report tramite l'account di servizio con autorizzazioni di monitoraggio e logging.

Nella VM host dell'agente, copia e configura il file log_agent.yaml:

1. Copia log_agent.example.yaml in log_agent.yaml prima della modifica:

   cp /opt/bpagent/config/log_agent.example.yaml /opt/bpagent/config/log_agent.yaml
   

2. Nella parte inferiore di log_agent.yaml, inserisci il nome del progetto e il percorso completo al file della chiave JSON. Per le VM host dell'agente create in Compute Engine, rimuovi o commenta la riga credentials_file.

   ...
   - id: my_project_destination
     project_id: PROJECT_ID
     type: google_cloud_output
     credentials_file: /opt/bpagent/config/destinations/google_cloud/JSON_KEY_FILE

   Sostituisci quanto segue:

   • PROJECT_ID: ID del progetto in cui vuoi generare i log
   • JSON_KEY_FILE: il nome del file della chiave privata dell'account di servizio. Rimuovi o inserisci un commento in questa riga per le VM host dell'agente create in Compute Engine.

   Se devi inoltrare il syslog da ESXi, nell'agente di log autonomo, segui la procedura riportata di seguito per modificare la porta predefinita da 5142 a 514:

   1. Vai a /opt/bpagent/config.
   2. Aggiorna il numero di porta su 514 come segue:

   - id: vmware-vcenter-logs
       # A syslog address of the form `:`
       listen_address: 0.0.0.0:514
       # Enable TLS for the TCP listener
       enable_tls: false
   

Attenzione: tieni presente gli intervalli di aggiornamento delle chiavi dell'account di servizio. Se la chiave privata scade, devi generare una nuova chiave privata e aggiornare log_agent.yaml con eventuali modifiche al nome file.

Raccogliere metriche e log

Per raccogliere metriche o log, l'agente autonomo deve essere in esecuzione sulla VM agente ospitante. Connettiti alla VM host dell'agente e utilizza i seguenti comandi per avviare o interrompere l'agente:

• Per avviare l'agente sulla VM host, esegui quanto segue:

  systemctl start bpagent
  

• Per interrompere l'agente sulla VM host, esegui quanto segue:

  systemctl stop bpagent
  

Configurare un cloud privato per l'inoltro syslog

VMware Engine si integra con Cloud Logging inoltrando i messaggi syslog da vCenter e NSX-T all'agente autonomo. L'agente autonomo è configurato per analizzare i log di vCenter e NSX-T in modo che Cloud Logging possa leggerli.

Per inoltrare i messaggi syslog da VMware Engine, segui questi passaggi:

• Per il forwarding di syslog di vCenter, segui i passaggi descritti in Inoltrare i messaggi syslog di vCenter. Nel campo Server, inserisci l'indirizzo IP o il nome host della VM dell'host agente. L'agente autonomo utilizza il protocollo di comunicazione TCP e ascolta sulla porta 5142. L'agente autonomo deve essere in esecuzione affinché la configurazione di syslog possa essere collegata correttamente.
• Per l'inoltro dei messaggi syslog di NSX-T, segui la procedura descritta in Inoltra i messaggi syslog di NSX-T. Nel campo FQDN o indirizzo IP, inserisci l'indirizzo IP o il nome host della VM host dell'agente. L'agente autonomo utilizza il protocollo di comunicazione TCP e rimane in ascolto sulla porta 5142.

Se prevedi di inoltrare syslog dagli host ESXi, modifica la porta predefinita su cui l'agente di log è in ascolto da 5142 a 514. In questo caso, utilizza la stessa porta (514) per inoltrare syslog da vCenter e NSX-T.

Disinstallazione dell'agente

Per rimuovere l'agente da una VM, connettiti alla VM dell'agente ed esegui i seguenti comandi nella riga di comando:

1. Interrompi e disattiva l'agente autonomo:

   systemctl stop bpagent
   

   systemctl disable bpagent
   

2. Esegui i seguenti comandi per rimuovere il servizio dell'agente autonomo:

   rm /etc/systemd/system/bpagent.service
   

   rm -rf /opt/bpagent
   

3. Aggiorna la configurazione di sistema in base alle modifiche del servizio ed elimina eventuali unità non riuscite:

   systemctl daemon-reload
   

   systemctl reset-failed
   

Dashboard di Cloud Monitoring

Dopo aver attivato l'inoltro delle metriche, puoi installare dashboard predefinite per VMware Engine. Le seguenti dashboard forniscono informazioni aggregate su tutte le origini specificate:

• Dashboard Panoramica:visualizzazione di alto livello che elenca le risorse chiave come data center, cluster e VM.
• Dashboard Concorrenza:utilizzo delle risorse per archiviazione, CPU, memoria e rete per aiutarti a individuare le VM e gli host principali in base alla domanda di risorse.
• Dashboard sul rendimento delle macchine virtuali: indicatori sul rendimento delle istanze di macchine virtuali (VM) che possono essere filtrati in base al nome dell'istanza e utilizzati per confrontare il rendimento di più VM tra loro.

Per accedere a una dashboard di VMware Engine:

1. Nella console Google Cloud, vai a Monitoraggio > Dashboard.

   Accedi a Dashboard

2. Nella scheda Sample Library (Raccolta di esempi), seleziona la categoria VMware.

3. Seleziona la dashboard di tuo interesse e fai clic su Importa.

Le definizioni di queste dashboard sono archiviate anche su GitHub. Per la procedura di installazione o visualizzazione delle definizioni come dashboard personalizzate, consulta Installare dashboard di esempio.

Avvisi di Cloud Monitoring

Puoi utilizzare le metriche dell'integrazione per attivare avvisi e notifiche basati su soglie e incidenti personalizzati. Ad esempio, puoi chiedere a Cloud Monitoring di inviarti una notifica via SMS quando qualcuno crea una nuova VM nel tuo cloud privato.

Per maggiori dettagli, consulta la pagina Introduzione agli avvisi.

Elenco delle metriche raccolte

Dopo aver attivato correttamente l'inoltro delle metriche, puoi visualizzarle in Metrics Explorer di Cloud Monitoring. I tipi di risorse e le metriche di VMware Engine iniziano con il prefisso external.googleapis.com/vmware/vcenter. in Metrics Explorer.

Ecco l'elenco completo delle metriche raccolte per VMware Engine, con il prefisso omesso:

Tipo di risorsa e metrica	Descrizione
cluster.cpu.available	CPU disponibile in un cluster, in megahertz
cluster.memory.available	Memoria disponibile in un cluster, in byte
cluster.cpu.threads	Numero di thread CPU in un cluster
cluster.cpu.effective	CPU effettiva in un cluster di tutti gli host in esecuzione. Gli host non rispondenti o in modalità di manutenzione non vengono conteggiati.
cluster.effective_hosts	Numero di host effettivi in un cluster. Gli host non rispondenti o in modalità di manutenzione non vengono conteggiati.
cluster.memory.effective	Memoria effettiva in un cluster di tutti gli host in esecuzione. Gli host non rispondenti o in modalità di manutenzione non vengono conteggiati.
cluster.hosts	Numero di host in un cluster
cluster.vsan.latency	Latenza vSAN di un cluster, in microsecondi
cluster.vsan.throughput	Velocità effettiva di lettura/scrittura vSAN di un cluster, in byte
cluster.vsan.iops	IOPS vSAN di un cluster
cluster.vsan.congestions	Valore di congestione vSAN di un cluster
cluster.vsan.oio	I/O in attesa (oio) di vSAN in un cluster
datacenter.cpu.average_host_utilization	Utilizzo medio dell'host di un data center, in percentuale
datacenter.clusters	Numero di cluster in un data center
datacenter.datastores	Numero di datastore in un data center
datacenter.hosts	Numero di host in un data center
datacenter.host_systems	Numero di sistemi host in un data center
datacenter.hosts/powered_on	Numero di host accesi in un data center
datacenter.hosts/powered_off	Numero di host spenti in un data center
datacenter.disk/space	Spazio su disco totale in un data center, in terabyte
datastore.capacity_bytes	Capacità di un datastore, in byte
datastore.capacity_utilization	Utilizzo della capacità di un datastore, in percentuale
host_system.network.transmitted_packets	Numero di pacchetti di rete trasmessi dal sistema host
host_system.network.received_packets	Numero di pacchetti di rete ricevuti dal sistema host
host_system.dropped_packets	Numero di pacchetti di rete persi dal sistema host
host_system.network.adapters	Numero di schede di rete del sistema host
host_system.memory.utilization	Utilizzo della memoria del sistema host, in percentuale
host_system.memory.utilization_ratio	Rapporto di utilizzo della memoria del sistema host
host_system.memory.used	Memoria utilizzata dal sistema host, in megabyte
host_system.disk.read	Lettura del disco del sistema host, in kilobyte al secondo
host_system.disk_latency	Latenza del disco del sistema host, in millisecondi
host_system.cpu.usage	Utilizzo della CPU del sistema host, in percentuale
host_system.cpu.utilization_ratio	Rapporto di utilizzo della CPU del sistema host
host_system.cpu.capacity	Capacità della CPU del sistema host, in megahertz
host_system.cpu.reserved_capacity	Capacità CPU riservata del sistema host, in megahertz
host_system.cpu.average_speed	Velocità media della CPU del sistema host, in megahertz
host_system.cpu.used	CPU utilizzata dal sistema host, in megahertz
host_system.vsan.throughput	La velocità in lettura/scrittura vSAN del sistema host, in byte
host_system.vsan.iops	IOPS vSAN del sistema host
host_system.vsan.latency	Latenza vSAN del sistema host, in microsecondi
host_system.vsan.client_cache_hits	Hit della cache client vSAN del sistema host
host_system.vsan.client_cache_hit_rate	Percentuale di successo della cache del client vSAN del sistema host
host_system.vsan.congestions	Valore di congestione vSAN del sistema host
resource_pool.memory.swapped_bytes	Memoria scambiata di vCenter, in megabyte
resource_pool.memory.shared_bytes	Memoria condivisa vCenter, in megabyte
resource_pool.memory.private_bytes	Memoria privata vCenter, in megabyte
resource_pool.memory.shares	Numero di condivisioni della memoria di vCenter
resource_pool.memory.overhead_usage_bytes	Utilizzo dell'overhead della memoria di vCenter, in megabyte
resource_pool.memory.host_usage_bytes	Utilizzo della memoria dell'host vCenter, in megabyte
resource_pool.memory.active_guest_usage_bytes	Utilizzo della memoria vCenter da parte degli ospiti attivi, in megabyte
resource_pool.memory.balloon_size	Dimensioni della memoria del balloon vCenter, in megabyte
resource_pool.cpu.usage	CPU utilizzata da vCenter, in megahertz
resource_pool.cpu.shares	Numero di quote CPU nel pool di risorse, in megabyte
vm.memory.ballooned	Dimensioni della memoria balloon della VM, in megabyte
vm.network.throughput_bytes	Velocità effettiva di rete della VM, in kilobyte al secondo
vm.memory.used_percent	Memoria utilizzata dalla VM, in percentuale della memoria disponibile
vm.memory.usage_bytes	Memoria utilizzata dalla VM, in megabyte
vm.disk.throughput_bytes	Velocità effettiva di lettura/scrittura del disco della VM, in kilobyte al secondo
vm.disk.used_percent	Utilizzo del disco della VM, in percentuale dello spazio di archiviazione disponibile
vm.disk.usage_bytes	Utilizzo del disco della VM, in byte
vm.disk.free_bytes	Spazio su disco disponibile della VM, in byte
vm.cpu.used_percent	Utilizzo della CPU della VM, in percentuale della CPU disponibile
vm.cpu.usage	Utilizzo della CPU della VM, in megahertz
vm.cpu.ready_percent	CPU della VM pronta, ma non in grado di funzionare, in percentuale
vm.vsan.throughput	Velocità effettiva di lettura e scrittura vSAN della VM, in byte
vm.vsan.iops	IOPS vSAN della VM
vm.vsan.latency	Latenza vSAN della VM, in microsecondi
vm.vsan.readCount	Conteggio delle letture vSAN della VM
vm.vsan.writeCount	Conteggio delle scritture vSAN della VM
vsphere.cpu.available	CPU disponibili nei cluster gestiti da vSphere, in gigahertz
vsphere.memory.available	Memoria disponibile nei cluster gestiti da vSphere, in gigabyte
vsphere.clusters.total	Numero di cluster gestiti da vSphere
vsphere.clusters	Conteggio dei cluster gestiti da vSphere con il codice colore dello stato del cluster (ad es. verde, grigio, rosso o giallo)
vsphere.cpu.cpus	Numero totale di core della CPU del sistema host gestiti da vSphere
vsphere.datacenters	Numero di data center gestiti da vSphere
vsphere.datastores.total	Numero di datastore in vSphere
vsphere.datastores	Numero di datastore gestiti da vSphere con il codice colore dello stato del datastore (ad es. verde, grigio, rosso o giallo)
vsphere.disk.space	Spazio su disco totale collegato in vSphere, in terabyte
vsphere.host_systems	Numero di sistemi host in vSphere
vsphere.hosts	Conteggio dei sistemi host gestiti da vSphere con il codice colore dello stato del sistema host (ad es. verde, grigio, rosso o giallo)
vsphere.network.adapters	Numero di adattatori di rete in vSphere
vsphere.hosts.powered_off	Numero di host spenti in vSphere
vsphere.hosts.powered_on	Numero di host accesi in vSphere
vsphere.virtual_machines.total	Numero di VM in tutti i cluster vSphere
vsphere.virtual_machines	Numero di VM gestite da vSphere con il codice colore dello stato della VM (ad es. verde, grigio, rosso o giallo)