In questo documento viene descritto come verificare, risolvere e risolvere i problemi relativi al protocollo NTP (Network Time Protocol) in un'infrastruttura Cisco ACI. Vengono descritti il modello di policy NTP, la verifica della configurazione, i comandi di verifica operativa, un flusso di lavoro di valutazione per i sintomi NTP comuni e gli scenari dettagliati di risoluzione dei problemi.
Il materiale di questo documento è stato estratto dalla guida alla risoluzione dei problemi di ACI Management and Core Services — Pod Policies, dalla guida alla configurazione di base di Cisco APIC, versione 6.1(x) — Provisioning Core ACI Fabric Services e dalla guida alla progettazione di Cisco ACI.
La sincronizzazione dell'ora è una funzionalità cruciale in un fabric ACI da cui dipendono le attività di monitoraggio, operative e risoluzione dei problemi. La sincronizzazione dell'orologio garantisce la corretta analisi dei flussi di traffico, la correlazione dei timestamp di debug e di errore su più nodi di fabric e l'utilizzo completo della funzionalità del contatore atomico da cui dipendono i punteggi di integrità dell'applicazione. Una configurazione NTP inesistente o non corretta non attiva necessariamente un errore o un livello di integrità basso, pertanto è importante configurare la sincronizzazione dell'ora nelle prime fasi dell'implementazione dell'infrastruttura.
L'NTP in ACI è gestito attraverso una catena di quattro oggetti di policy:
datetimePol): definisce la configurazione NTP, inclusi lo stato amministrativo, lo stato di autenticazione, lo stato del server e la modalità master. Disponibile in Fabric > Fabric Policies > Policies > Pod > Date and Time (Fabric > Criteri fabric > Criteri > Pod > Data e ora).datetimeNtpProv): definisce le singole voci del server NTP (provider) all'interno di una policy di data e ora, inclusi l'IP/FQDN del server, la selezione EPG di gestione (fuori banda o in banda), il flag preferito e gli intervalli di polling.fabricPodPGrp): fa riferimento alla policy su data e ora insieme ad altre policy a livello di pod (BGP RR, SNMP, ecc.). Disponibile in Fabric > Fabric Policies > Pods > Policy Groups (Infrastruttura > Criteri fabric > Bacchetti > Gruppi di criteri).fabricPodP) - associa un Pod Policy Group a un selettore di pod. Disponibile in Fabric > Fabric Policies > Pods > Profiles.Tutti e quattro i collegamenti in questa catena devono essere configurati per NTP da applicare ai nodi fabric. Se un collegamento è interrotto, la configurazione del provider NTP non verrà trasferita sugli switch.
ACI supporta tre schemi di autenticazione NTP: MD5, SHA-1 e AES128-CMAC. AES128-CMAC è stato introdotto nella versione APIC 6.1(1) ed è lo schema consigliato, in quanto MD5 è considerato debole e non sicuro. Quando la modalità FIPS è abilitata, sono supportati solo AES128-CMAC e SHA-1.
Gli switch foglia ACI possono fungere da server NTP per i client downstream (ad esempio, server collegati al fabric). Questa funzionalità è disabilitata per impostazione predefinita e deve essere abilitata in modo esplicito tramite l'opzione Stato server nei criteri di data e ora. Se abilitato, i client possono utilizzare l'indirizzo IP dello switch foglia in banda, fuori banda, SVI di dominio bridge o L3Out come indirizzo del server NTP.
Prima di risolvere i problemi relativi allo stato operativo NTP, verificare che la catena di configurazione sia stata completata. La configurazione errata è la causa principale più comune dei problemi NTP in ACI.
Passare a Tenant > mgmt > Indirizzi di gestione dei nodi (per l'assegnazione statica) o EPG di gestione dei nodi (per i gruppi di connettività).
Confermare che a ogni APIC e nodo dello switch sia assegnato un indirizzo IP di gestione. I nodi senza indirizzi di gestione non possono comunicare con il server NTP.
In alternativa, eseguire una query sull'API:
apic1# moquery -c mgmtRsOoBStNode
Selezionare Fabric > Fabric Policies > Policies > Pod > Date and Time > [Your Policy].

Verificare che sia configurato almeno un provider NTP (server). Se esistono più provider, contrassegnarne almeno uno come Preferito.
Verificare il provider NTP tramite l'API:
apic1# moquery -c datetimeNtpProv # datetimeNtpProv dn : uni/fabric/time-NTP-Policy/ntpprov-10.1.1.100 name : 10.1.1.100 preferred : yes <--- at least one should be "yes" epgDn : uni/tn-mgmt/mgmtp-default/oob-default <--- management EPG minPoll : 4 maxPoll : 6 keyId : 0
Selezionare Fabric > Fabric Policies > Pods > Policy Groups > [Gruppo di criteri del pod].

Verificare che il campo Criterio data/ora faccia riferimento al criterio di data e ora corretto.
apic1# moquery -c fabricPodPGrp -f 'fabricPodPGrp.name=="default"'
Cercare l'attributo datetimePolName o la relazione fabricRsTimePol associata.
Passare a Fabric > Fabric Policies > Pods > Profiles > [Profilo del tuo dispositivo] (Fabric > Fabric Policies > Pods > Profiles > [Profilo del tuo dispositivo].

Verificare che il campo Gruppo di criteri infrastruttura faccia riferimento al gruppo di criteri POD corretto.
Selezionare Sistema > Impostazioni di sistema > Data e ora.

Verificare che il formato di visualizzazione (locale o UTC) e il fuso orario siano impostati come previsto. Questa impostazione è un criterio di formattazione data/ora predefinito distinto che non può essere eliminato o duplicato.
Dopo aver verificato che la catena di configurazione sia corretta, utilizzare i comandi seguenti per verificare il funzionamento di NTP in fase di esecuzione.
Questo comando mostra lo stato di sincronizzazione NTP su tutti gli APIC. Il simbolo * indica che il server è selezionato per la sincronizzazione.
apic1# show ntpq nodeid remote refid st t when poll reach auth delay offset jitter ------ - ------------------------------ ------------------------------ -------- -- -------- -------- -------- ---- -------- -------- -------- 1 * ntp.example.com .GPS. 1 u 20 64 377 none 0.213 +0.102 0.005 2 * ntp.example.com .GPS. 1 u 6 64 377 none 0.196 +0.007 0.004 3 * ntp.example.com .GPS. 1 u 27 64 377 none 0.216 -0.008 0.006
Aspetto positivo:
* (selezionati per la sincronizzazione) accanto al server remoto.reach è 377 (ottale), il che indica che gli ultimi 8 sondaggi hanno avuto successo.st (strato) è compreso tra 1 e 15. Strato 16 indica che il server non è sincronizzato.l'offset è basso (generalmente meno di 100 ms in ambienti sani).Aspetto negativo:
* accanto a qualsiasi server - nessun server è selezionato per la sincronizzazione.reach è 0 — non è stata ricevuta alcuna risposta NTP.st è 16: il server NTP non è sincronizzato con la relativa origine del tempo upstream.offset è estremamente grande (migliaia di millisecondi) — l'orologio viene spostato in modo significativo.apic1# show clock Time : 11:24:18.391 UTC-04:00 Tue Apr 07 2026
Verificare che l'ora sia corretta. Confrontare con il tempo previsto per rilevare la deviazione dell'orologio.
apic1# bash admin@apic1:~> date Tue Apr 7 11:24:45 EDT 2026
Verificare che il provider NTP sia stato inserito nello switch.
leaf1# show ntp peers ----------------------------------------------------------------------------- Peer IP Address Serv/Peer Prefer KeyId Vrf ----------------------------------------------------------------------------- 10.1.1.100 Server yes None management
Aspetto positivo: L'indirizzo IP o il nome host del server NTP viene visualizzato con Serv/Peer = Server e il VRF corretto (in genere gestione per OOB).
Aspetto negativo: Nessun peer elencato oppure l'indirizzo IP del server NTP non corrisponde al provider configurato. In genere indica che i criteri di data e ora non sono stati applicati tramite la catena di profili del gruppo di criteri POD/POD.
Verificare che il server NTP sia selezionato per la sincronizzazione.
leaf1# show ntp peer-status
Total peers : 1
* - selected for sync, + - peer mode(active),
- - peer mode(passive), = - polled in client mode
remote local st poll reach delay vrf
--------------------------------------------------------------------------------
*10.1.1.100 0.0.0.0 1 64 377 0.000 management
Il carattere * è essenziale: conferma che il server NTP è utilizzato per la sincronizzazione.
Aspetto negativo:
* accanto al server — lo switch non è sincronizzato con il server.reach è 0 — non è stata ricevuta alcuna risposta NTP. Ciò indica un problema di raggiungibilità.st è 16: il server NTP non è sincronizzato e non può fornire un'ora valida.Verificare lo scambio di pacchetti NTP per confermare la raggiungibilità. Sostituire l'indirizzo IP con l'indirizzo del provider NTP dello switch interessato.
leaf1# show ntp statistics peer ipaddr 10.1.1.100 ... packets sent: 9256 packets received: 9256 ...
Aspetto positivo: i pacchetti inviati e i pacchetti ricevuti sono all'incirca uguali e in aumento.
Aspetto negativo: i pacchetti inviati aumentano, ma i pacchetti ricevuti sono pari a 0 o aumentano a malapena — le risposte NTP non raggiungono lo switch.
leaf1# show clock 11:24:24.121066 EDT Tue Apr 07 2026
Selezionare Fabric > Fabric Policies > Policies > Pod > Date and Time > [Your Policy] > [Provider NTP].
Nella colonna Stato sincronizzazione dovrebbe essere visualizzato Sincronizzato con il server NTP remoto per tutti i nodi. La convergenza dello stato di sincronizzazione dopo la distribuzione iniziale può richiedere alcuni minuti.
Eseguire una query sulla classe datetimeNtpq per controllare la sincronizzazione NTP tra tutti gli APIC:
apic1# moquery -c datetimeNtpq # datetimeNtpq dn : topology/pod-1/node-1/sys/ntpq-ntp.example.com remote : ntp.example.com tally : * <--- selected for sync stratum : 1 reach : 377 <--- all recent polls successful offset : +0.102 delay : 0.213 jitter : 0.005 refid : .GPS.
Utilizzare questa struttura decisionale quando viene segnalato un problema NTP su un nodo ACI.
Accedere allo switch interessato ed eseguire:
leaf1# show ntp peers
leaf1# show ntp peer-status
* presente → NTP sta sincronizzando. Se l'ora non è corretta, passare allo scenario 5: Offset grande/deriva orologio.* presente → passare al punto 3.Controllare la colonna reach in show ntp peer-status.
reach = 0 → nessuna risposta dal server NTP. Andare allo scenario 2: Server NTP non raggiungibile.reach > 0 ma non * → sono in arrivo risposte ma la sincronizzazione non è stabilita. Controllare lo strato — andare al passo 4.Sintomo: show ntp peers on the switch non restituisce voci.
Controllo configurazione:
Causa principale: Uno dei quattro link nella catena di policy (Date and Time Policy → NTP Provider → Pod Policy Group → Pod Profile) è rotto. La causa più comune è la mancata associazione del gruppo di criteri per i pod al profilo dei pod o la mancata selezione dei criteri di data e ora nel gruppo di criteri per i pod.
Soluzione: Completare il collegamento mancante nella catena di criteri. Verificare che il profilo del pod per il pod interessato faccia riferimento a un gruppo di criteri del pod contenente i criteri di data e ora corretti. Dopo l'applicazione, la configurazione del provider NTP verrà inviata agli switch entro pochi minuti.
Sintomo: show ntp peer-status mostra reach = 0. show ntp statistics peer ipaddr 10.1.1.100 mostra i pacchetti ricevuti = 0.
Controllo configurazione: Verificare che il provider NTP sia associato all'EPG (OOB o in-band) di gestione corretto. Se si utilizza OOB, verificare che i contratti OOB consentano l'uso della porta UDP 123.
Controllo operativo:
leaf1# ping 10.1.1.100 vrf management
leaf1# tcpdump -n -i eth0 dst port 123 tcpdump: verbose output suppressed, use -v or -vv for full protocol decode listening on eth0, link-type EN10MB (Ethernet), capture size 65535 bytes 16:49:01.431624 IP 10.1.20.23.123 > 10.1.1.100.123: NTPv4, Client, length 48 16:49:01.440303 IP 10.1.1.100.123 > 10.1.20.23.123: NTPv4, Server, length 48
Causa principale: In genere, una delle seguenti opzioni:
Soluzione: Risolvere il problema relativo alla raggiungibilità. Assegnare un indirizzo di gestione se mancante, correggere il gateway predefinito, aggiornare le regole del firewall o correggere la selezione EPG di gestione sul provider NTP.
Sintomo: show ntp peer-status mostra lo strato (st) = 16. Lo switch non verrà sincronizzato con un server dello strato 16.
Controllo operativo: Accedere al server NTP o eseguire una query su di esso da un host esterno per verificare che sia sincronizzato con la propria origine temporale upstream.
Causa principale: Il server NTP stesso ha perso la sincronizzazione con il proprio orologio di riferimento upstream. Un server con strato 16 indica che non dispone di un'origine tempo affidabile.
Soluzione: Correggere il server NTP. Si trova all'esterno dell'infrastruttura ACI: controllare la configurazione del server NTP e la relativa origine del tempo upstream. Se il server NTP non può essere corretto immediatamente, configurare un provider NTP alternativo nei criteri di data e ora.
Sintomo: show ntp peer-status mostra reach > 0 e lo strato è valido, ma non * viene visualizzato. Il server NTP risponde, ma lo switch non accetta la risposta.
Controllo configurazione:
Causa principale: La chiave di autenticazione, l'algoritmo o l'ID della chiave non corrisponde tra ACI e il server NTP, pertanto lo switch rifiuta la risposta NTP come non autenticata.
Soluzione: Allineare la configurazione di autenticazione. Verificare che ID chiave, valore chiave e algoritmo siano configurati in modo identico sia su ACI che sul server NTP. AES128-CMAC è consigliato per APIC versione 6.1(1) e successive.
Sintomo: Lo switch sembra essere sincronizzato (* presente, reach = 377), ma il valore di offset in show ntp peer-status o show ntpq è molto grande (centinaia o migliaia di millisecondi), o l'orologio è visibilmente errato.
Controllo operativo:
apic1# show ntpq
Controllare la colonna offset. Un offset integro è in genere inferiore a 100 ms.
Causa principale: L'orologio si è spostato in modo significativo prima che fosse stabilita la sincronizzazione NTP o che l'orologio hardware (RTC) fosse stato reimpostato durante un riavvio (ad esempio, a causa di una batteria CMOS scarica). La tecnologia NTP corregge l'orologio gradualmente tramite il dorso, che può richiedere tempo per grandi offset.
Soluzione: Se l'offset è molto grande e NTP è in fase di sincronizzazione attiva, attendere che l'orologio converga. L'NTP controlla l'orologio gradualmente, mentre per correggere completamente i grandi offset possono essere necessarie ore. Se l'offset non diminuisce, verificare che il server NTP fornisca un'ora precisa. Se il problema si verifica dopo ogni riavvio, verificare l'orologio hardware (batteria RTC/CMOS) sul nodo interessato.
Sintomo: Quando NTP è configurato per la gestione in banda, vengono generati errori su un APIC in standby correlato a NTP o ai criteri di monitoraggio.
Causa principale: Quando si applica una policy NTP per la gestione in banda, l'APIC in standby richiede anche la configurazione in banda. Senza di esso, i difetti vengono sollevati.
Soluzione: Configurare la gestione in banda anche per l'APIC in standby. In questo modo vengono cancellati i difetti.
Sintomo: Un errore IP duplicato viene generato dopo l'aggiunta di provider NTP.
Causa principale: È stato aggiunto un FQDN come provider NTP, quindi l'indirizzo IP risolto di tale FQDN è stato aggiunto come secondo provider NTP. ACI rileva il duplicato.
Soluzione: Eliminare il provider duplicato aggiunto più di recente (la voce dell'indirizzo IP se l'FQDN è stato aggiunto per primo o viceversa). Utilizzare una sola voce per server NTP, ovvero FQDN o indirizzo IP, non entrambi.
Sintomo: Il provider NTP configurato con un nome host non sta eseguendo la risoluzione. show ntp peers non visualizza l'indirizzo IP previsto oppure NTP non è in fase di sincronizzazione.
Controllo configurazione:
Causa principale: Il server DNS non è raggiungibile o non è configurato. La risoluzione dei nomi host per il provider NTP non è riuscita.
Soluzione: Configurare i criteri del servizio DNS, verificare la raggiungibilità del DNS e applicare l'etichetta DNS corretta. In alternativa, utilizzare l'indirizzo IP del server NTP al posto del nome host.
Di seguito sono riportate le condizioni relative all'NTP che possono generare errori in ACI:
Prendere in considerazione l'escalation a Cisco TAC se:
show ntp peer-status mostra un comportamento imprevisto, ad esempio lo strato persistente 16 su un server di cui è stata confermata la sincronizzazione esterna.Quando si applica TAC, fornire i seguenti dati:
show ntpq da tutti gli APIC.show ntp peer, show ntp peer-status, show ntp statistics peer ipaddr <IP> e show clock da tutti gli switch interessati.moquery -c datetimePol, moquery -c datetimeNtpProv e moquery -c datetimeNtpq dall'APIC.| Revisione | Data di pubblicazione | Commenti |
|---|---|---|
1.0 |
07-Apr-2026
|
Versione iniziale |