Questa documentazione illustra i concetti di base di un monitoraggio SHA, ovvero di un componente introdotto nel framework SHA (System Health Agent) di NSX 4.2.

SHA è l'Agente stato del sistema distribuito in NSX. Questo framework monitora le statistiche (metriche) di vari componenti NSX, ad esempio host ESXi, server bare-metal, edge NSX, appliance NSX Manager e così via. SHA monitora le statistiche del componente, le analizza, rileva l'anomalia e attiva le azioni di correzione quando vengono soddisfatte condizioni specifiche.

Prima di NSX 4.2, per controllare la raccolta delle statistiche dei componenti (metriche), gli utenti NSX dovevano eseguire un processo in due passaggi. In primo luogo, dovevano determinare la mappatura tra le statistiche e i plug-in SHA. In altre parole, dovevano determinare quale plug-in SHA controlla quali statistiche e quindi utilizzare i profili del plug-in SHA per controllare la raccolta delle statistiche. I profili del plug-in SHA sono principalmente destinati agli sviluppatori che hanno accesso al codice e possono determinare quale profilo del plug-in SHA deve essere modificato per quali statistiche.

Con l'introduzione del componente di monitoraggio nel framework SHA, il processo è ora semplificato.

Monitora

Un monitoraggio è un componente del framework SHA che monitora varie statistiche (metriche) sullo stato del sistema ed esegue l'azione corrispondente. Ad esempio, esporta le statistiche in una destinazione per consentire agli utenti di visualizzare lo stato del sistema, attiva allarmi per informare gli utenti ed esegue il dump delle statistiche in un file per l'analisi offline. Un monitoraggio sostituisce i plug-in SHA, introdotti in una versione precedente di NSX. Un monitoraggio fornisce descrizioni dettagliate delle statistiche in modo che gli utenti conoscano lo scopo di ogni statistica e sappiano come controllare il monitoraggio quando necessario.

Ad esempio, esx-obsrv-stats-monitor contiene le descrizioni di tutte le statistiche di osservabilità raccolte da un nodo di trasporto host ESXi.

Attualmente, un monitoraggio supporta l'esportazione di statistiche in una singola destinazione, che è NSX Manager.

Profilo di monitoraggio

Un profilo monitoraggio consente di controllare il monitoraggio configurando una serie di proprietà.

Ad esempio, alcune proprietà di configurazione nel profilo di monitoraggio sono:

  • enable
  • check_interval
  • applied_to_group_paths

Qui sono elencate solo alcune delle proprietà di configurazione. Per ulteriori informazioni su tutte le proprietà di configurazione in un profilo di monitoraggio, vedere lo schema del profilo di monitoraggio SHA nella Guida di NSX API all'indirizzo:

GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/<monitor-id>/profiles/<profile-id>

È possibile accedere ai profili di monitoraggio e al monitoraggio stesso solo con API di NSX. Attualmente, questi componenti non sono esposti nell'interfaccia utente di NSX Manager.

Per ottenere l'elenco di tutti gli ID di monitoraggio, utilizzare la seguente API:

GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors

Per ottenere l'elenco di tutti i profili per un monitoraggio specifico, utilizzare la seguente API:

GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/<monitor-id>/profiles
Nota: In una distribuzione di NSX multi-tenant, gli utenti dei progetti e dei VPC NSX non possono utilizzare le API del profilo di monitoraggio e il monitoraggio stesso. Queste API sono attualmente disponibili per l'utilizzo solo da parte degli utenti nello spazio predefinito.

Ogni monitoraggio ha un profilo predefinito creato dal sistema. Ad esempio, il profilo predefinito di esx-obsrv-stats-monitor viene applicato a tutti i nodi di trasporto host nel sistema in cui viene eseguito questo monitoraggio. Quando si aggiorna la configurazione del profilo predefinito, la modifica influisce su tutti i nodi. Non è possibile eliminare il profilo predefinito.

È possibile creare un profilo definito dall'utente (personalizzato) per sostituire il profilo predefinito per un gruppo specifico di nodi di trasporto host. Se al monitoraggio vengono applicati più profili in un nodo di trasporto host, l'ultimo profilo applicato sostituirà gli altri profili. Il profilo predefinito ha la priorità più bassa.

Indipendentemente dal fatto che si stia configurando il profilo predefinito o un profilo personalizzato del monitoraggio, alcune proprietà del profilo non possono essere modificate.

Ad esempio:
  • Il profilo predefinito di esx-obsrv-stats-monitor viene applicato al gruppo predefinito creato dal sistema, che contiene tutti i nodi di trasporto host nel sistema. Non è possibile modificare la proprietà applied_to_group_paths del profilo predefinito.
  • Non è possibile disattivare esx-obsrv-alarms-monitor impostando la proprietà enable nel profilo su false. Questo monitoraggio segnala gli allarmi nel sistema ed è sempre attivato.

Tipi di monitoraggio

Il framework SHA contiene due tipi principali di monitoraggio.

Monitoraggi di esportazione delle metriche

Questi monitoraggi vengono utilizzati per esportare le metriche (statistiche) in una destinazione, ad esempio NSX Manager. Ad esempio, esx-obsrv-stats-monitor.

Per un monitoraggio di esportazione delle metriche, il sistema supporta un solo profilo definito dall'utente (personalizzato).

Monitoraggi standard

Questi monitoraggi vengono utilizzati per eseguire altre attività, esclusa l'esportazione di metriche, ad esempio la segnalazione di allarmi a NSX Manager, il dump delle statistiche in un file e così via. Ad esempio, esx-obsrv-alarms-monitor, esx-obsrv-segment-stats-file-dump-monitor.

Per un monitor standard, non vi è alcuna limitazione sul numero di profili definiti dall'utente (personalizzati) che è possibile creare.

Un monitoraggio definisce una categoria di statistiche (metriche) di alto livello che controlla. Le statistiche in un monitoraggio sono organizzate in più categorie secondarie. Un monitoraggio secondario viene definito per controllare singole categorie secondarie. Per impostazione predefinita, la configurazione definita per il monitoraggio principale viene applicata a tutti i monitoraggi secondari nel monitoraggio principale. Se necessario, è possibile modificare la configurazione dei monitoraggi secondari.

Ad esempio:

esx-obsrv-stats-monitor è un tipo di monitoraggio di esportazione delle metriche. Contiene due monitoraggi secondari di tipo esportazione delle metriche, denominati esx-obsrv-datapath-traffic-stats-monitor e esx-obsrv-datapath-infra-stats-monitor.

Il vantaggio di categorizzare le statistiche in un monitoraggio con più monitoraggi secondari è che è possibile controllare tutti i monitoraggi secondari insieme al monitoraggio principale. Non è necessario eseguire chiamate API separate per consentire ai singoli monitoraggi secondari di configurare le loro proprietà.