Monitoraggio delle statistiche dei nodi di trasporto host NSX tramite API

Con le API di NSX è possibile monitorare sia i valori temporizzati sia i valori in tempo reale delle statistiche del nodo di trasporto host.

Il sistema utilizza esx-obsrv-stats-monitor per monitorare l'integrità dei nodi di trasporto host ESXi.

Le statistiche vengono raccolte per nodo di trasporto host. I valori delle statistiche non vengono aggregati a livello di ciascun cluster host.

I valori temporizzati delle statistiche del nodo di trasporto host vengono raccolti periodicamente da ciascun nodo di trasporto host (l'impostazione predefinita è ogni 300 secondi) e memorizzati nella cache dal sistema. Gli ultimi valori memorizzati nella cache aggiornati vengono recuperati dall'host e restituiti dall'API.

A scopo di debug, gli utenti di NSX possono monitorare i valori in tempo reale delle statistiche del nodo di trasporto host. Il sistema recupera le statistiche in tempo reale dai moduli del kernel del percorso dati in esecuzione nei nodi di trasporto host.

Con le API di NSX, è possibile visualizzare i seguenti tipi di statistiche per i nodi di trasporto host:

Statistiche dei pacchetti (packet_stats)
Statistiche di sistema del percorso rapido (fast_path_sys_stats)
Statistiche dei pacchetti della piattaforma (platform_packet_stats)
Statistiche sull'utilizzo della CPU della piattaforma (platform_cpu_usage_stats)
Statistiche sull'utilizzo di lcore del percorso rapido (fast_path_lcore_usage_stats)

Nella risposta dell'API, le statistiche sono organizzate in base ai moduli del percorso dati che raccolgono le statistiche dai nodi di trasporto dell'host. Per una descrizione delle statistiche, vedere Statistiche del nodo di trasporto host NSX.

La procedura descritta in questa documentazione illustra il flusso di lavoro dell'API per il monitoraggio dei valori temporizzati e dei valori in tempo reale delle statistiche del nodo di trasporto host. I passaggi della procedura menzionano solo gli URI dell'API. Per informazioni dettagliate sullo schema dell'API, sui parametri e sul payload della risposta o della richiesta dell'API di esempio, fare riferimento alla Guida di NSX API.

Per ulteriori informazioni sull'utilizzo della CLI centrale NSX o della CLI ESXi host per la visualizzazione delle statistiche del nodo di trasporto, fare riferimento alla Informazioni di riferimento sull'interfaccia della riga di comando NSX.

Procedura

Eseguire l'API seguente per visualizzare le descrizioni di tutte le statistiche nel esx-obsrv-stats-monitor:
```
GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-stats-monitor
```
Eseguire l'API seguente per recuperare l'elenco dei profili del esx-obsrv-stats-monitor:
```
GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-stats-monitor/profiles
```
La risposta dell'API visualizza il profilo predefinito e un profilo definito dall'utente (se creato) per questo monitoraggio. Il profilo predefinito viene creato dal sistema e applicato al gruppo predefinito creato dal sistema. Il gruppo predefinito contiene tutti i nodi di trasporto host ESXi nel sistema. Il profilo predefinito è attivato per impostazione predefinita in tutti i nodi di trasporto host.

Per visualizzare la configurazione del profilo predefinito, eseguire l'API seguente:
```
GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-stats-monitor/profiles/default-profile
```
(Facoltativo) Eseguire l'API seguente per modificare la configurazione del profilo predefinito:
```
PATCH https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-stats-monitor/profiles/default-profile
```
Copiare la risposta dell'API GET del profilo predefinito e incollarlo in un editor di testo. Modificare i valori di configurazione del profilo. Infine, inviare la configurazione modificata nel corpo della richiesta di questa API PATCH.
Scenario di esempio:
Si supponga di voler applicare un profilo definito dall'utente a un set specifico di host (ad esempio A e B), ma applicare il profilo predefinito a tutti gli host rimanenti nel sistema. In questo caso, è necessario creare un gruppo personalizzato che contenga i due nodi di trasporto host (A e B). I gruppi contenenti solo membri del nodo di trasporto host possono essere creati utilizzando l'API di NSX. L'interfaccia utente non supporta questa funzionalità. Dopo aver creato il gruppo desiderato, utilizzare questo gruppo nella proprietà applied_to_group_paths del profilo definito dall'utente.

Utilizzare la stessa API PATCH, descritta in precedenza, per creare il profilo definito dall'utente.

Ad esempio, la seguente API crea un profilo definito dall'utente con ID "profile-1":
```
PATCH https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-stats-monitor/profiles/profile-1
```
Quando l'API viene eseguita correttamente, il profilo definito dall'utente (profile-1) sostituisce il profilo predefinito nei nodi di trasporto A e B dell'host. Per tutti i nodi di trasporto host rimanenti nel sistema, viene applicato il profilo predefinito.

(Facoltativo) Eseguire l'API seguente per leggere lo stato del monitoraggio in un nodo di trasporto host specifico:

GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-stats-monitor/status?transport_node_id=<node-id>

Per ottenere il node_id dei nodi di trasporto host, eseguire l'API seguente:

GET https://<nsx-mgr>/policy/api/v1/infra/sites/default/enforcement-points/default/host-transport-nodes

Eseguire l'API seguente per visualizzare i valori temporizzati delle statistiche del nodo di trasporto host per un nodo specifico:
```
GET https://<nsx-mgr>/policy/api/v1/infra/sites/default/enforcement-points/default/host-transport-nodes/<host-tn-id>/statistics/monitor
```
Per ottenere il node_id del nodo di trasporto host, utilizzare la stessa API, come indicato nel passaggio precedente.

Questa API restituisce gli ultimi valori memorizzati nella cache delle statistiche di monitoraggio dell'integrità per il nodo di trasporto host specificato. Per impostazione predefinita, vengono restituite solo le statistiche dei pacchetti per il nodo di trasporto host.
Come accennato in precedenza in questa sezione, l'API può restituire i seguenti tipi di statistiche di monitoraggio dell'integrità per un nodo di trasporto host:
- Statistiche dei pacchetti (packet_stats). Questo tipo è quello predefinito.
- Statistiche di sistema del percorso rapido (fast_path_sys_stats)
- Statistiche dei pacchetti della piattaforma (platform_packet_stats)
- Statistiche sull'utilizzo della CPU della piattaforma (platform_cpu_usage_stats)
- Statistiche sull'utilizzo di lcore del percorso rapido (fast_path_lcore_usage_stats)
Quando il parametro della query type viene omesso nell'URI dell'API, per impostazione predefinita l'API restituisce solo le statistiche dei pacchetti.

Per visualizzare le statistiche per uno o più tipi specifici insieme, utilizzare il parametro query type nell'URI dell'API.
Esempio 1: l'API seguente restituisce i valori temporizzati delle statistiche del nodo di trasporto host per un singolo tipo:
```
GET https://<nsx-mgr>/policy/api/v1/infra/sites/default/enforcement-points/default/host-transport-nodes/<host-tn-id>/statistics/monitor?type=platform_cpu_usage_stats
```
Esempio 2: l'API seguente restituisce i valori temporizzati delle statistiche del nodo di trasporto host per più tipi insieme:
```
GET https://<nsx-mgr>/policy/api/v1/infra/sites/default/enforcement-points/default/host-transport-nodes/<host-tn-id>/statistics/monitor?type=platform_cpu_usage_stats,fast_path_sys_stats,platform_packet_stats
```
Assicurarsi che i tipi siano specificati in un elenco separato da virgole e senza spazi prima e dopo le virgole.
Eseguire l'API seguente per visualizzare i valori in tempo reale delle statistiche di integrità del nodo di trasporto per un nodo specifico:
```
GET https://<nsx-mgr>/policy/api/v1/infra/sites/default/enforcement-points/default/host-transport-nodes/<host-tn-id>/statistics/debug
```
Come accennato in precedenza nel passaggio 5, quando il parametro query type viene omesso nell'URI dell'API, per impostazione predefinita l'API restituisce solo le statistiche dei pacchetti.

Per visualizzare le statistiche per uno o più tipi specifici insieme, utilizzare il parametro query type nell'URI dell'API.
Esempio 1: l'API seguente restituisce i valori in tempo reale delle statistiche del nodo di trasporto host per un singolo tipo:
```
GET https://<nsx-mgr>/policy/api/v1/infra/sites/default/enforcement-points/default/host-transport-nodes/<host-tn-id>/statistics/debug?type=platform_cpu_usage_stats
```
Esempio 2: l'API seguente restituisce i valori in tempo reale delle statistiche del nodo di trasporto host per più tipi insieme:
```
GET https://<nsx-mgr>/policy/api/v1/infra/sites/default/enforcement-points/default/host-transport-nodes/<host-tn-id>/statistics/debug?type=platform_cpu_usage_stats,fast_path_sys_stats,platform_packet_stats
```