Inicio / Notas técnicas / Manual de emergencia del túnel VXLAN Up→Down

Túnel VXLAN Up→Down: un manual de respuesta de emergencia

La alarma hwNvo3VxlanTnlDown se dispara, y un túnel que estaba bien hace un minuto ha desaparecido. Este es el orden que lo restablece de forma segura — qué confirmar primero, qué reunir antes de cambiar cualquier cosa, las dos causas raíz que explican la mayoría de estas alarmas, y cómo demostrar que la corrección realmente funcionó antes de cerrar el ticket.

Por Yuwen Zhang (Atlas), fundador de AtlasCommTech — 13 años de despliegues de redes de operadores y empresariales · Actualizado en julio de 2026

Por qué el orden importa más que la velocidad aquí

El instinto cuando se dispara una alarma es corregir lo primero que parece mal. En una alarma de túnel VXLAN, ese instinto causa más interrupciones de las que evita.

hwNvo3VxlanTnlDown significa exactamente una cosa: un túnel VXLAN que estaba up se cayó. No dice por qué, y reaccionar solo al texto de la alarma — reiniciar un proceso, hacer bounce de una interfaz, aplicar un cambio de configuración — es como una alarma de un solo túnel se convierte en una interrupción más amplia. Este manual sigue un orden fijo: confirmar qué pasó realmente y hasta dónde llega, reunir la evidencia que distingue la causa raíz del ruido, trabajar las dos causas que explican la mayoría de estos casos, y verificar que ese túnel específico se recuperó antes de darlo por resuelto.

A continuación, ese orden con los comandos exactos, el comando que con más frecuencia termina el incidente — un shutdown de interfaz específico — y por qué tiene que ser la interfaz correcta, no cualquiera que parezca inestable.

Este manual tiene un único punto de bifurcación

Cuatro pasos, un punto de bifurcación — vale la pena tener este esquema a la vista antes de tocar nada.

El punto de bifurcación es simple: ¿la ruta hacia el VTEP remoto desapareció por completo, o está presente pero inestable? Las dos respuestas llevan a dos correcciones completamente distintas, y aplicar la equivocada desperdicia los minutos que más importan durante una interrupción activa.

Alarm: hwNvo3VxlanTnlDown Stage 1 · confirm + scope impact Stage 2 · gather evidence Stage 3a · route to peer VTEP is gonerouting / EVPN fault — not a shutdown fix Stage 3b · route is flappingshutdown the identified unstable interface Stage 4 · verify this tunnel, specifically

Las etiquetas del diagrama se mantienen en inglés por claridad técnica.

Todo lo que está antes del punto de bifurcación es confirmación y recolección de evidencia, no remediación — resista la tentación de corregir algo hasta saber en qué lado de la bifurcación está.

Siguiendo el manual en orden

Cuatro etapas: confirmar y delimitar el alcance, reunir evidencia, aplicar la corrección correspondiente, verificar el túnel específico — no la red en general.

Etapa 1 — Confirmar la alarma y delimitar el impacto

Antes de tocar cualquier configuración, sepa qué está realmente roto y hasta dónde llega.

  1. Inicie sesión en el dispositivo indicado en la alarma — hwNvo3VxlanTnlDown lleva directamente la IP o el nombre del dispositivo con falla, úselo en lugar de adivinar cuál dispositivo está afectado.
  2. Descarte primero una falla de hardware: verifique una falla de la tarjeta de control principal o de la tarjeta de interfaz en ese dispositivo, y verifique en la plataforma de gestión de red si el dispositivo aparece desconectado o con otras alarmas activas. Una falla a nivel de tarjeta tiene su propia remediación y no es en absoluto un problema de VXLAN.
  3. Confirme que el impacto se limita al tráfico transportado por VXLAN en este túnel — ese es el radio de impacto declarado para esta alarma, a menos que la comprobación de hardware del paso anterior indique lo contrario.
%%01NVO3/4/hwNvo3VxlanTnlDown_active: The VXLAN tunnel changed from Up to Down.
(SourceAddress=4.4.4.100, DestinationAddress=3.3.3.100, TunnelId=4026531844)
// the alarm names the affected device and the tunnel's Source/Destination -> log in to that device, not a neighbor

<HUAWEI> display device
// rule out main control board / interface board faults before assuming this is a routing problem

Etapa 2 — Reunir la evidencia antes de tocar nada

Dos comandos le indican con cuál de las dos causas raíz está lidiando — ejecute ambos antes de decidir una corrección.

  1. Ejecute display ip routing-table hacia la dirección del VTEP remoto en el dispositivo con falla, para verificar si la ruta Underlay hacia el VTEP remoto siquiera existe.
  2. Si la ruta falta por completo, este es un caso de pérdida de ruta — vaya a la etapa 3a.
  3. Si la ruta está presente, ejecute display ospf peer brief (o el equivalente para su IGP) repetidamente, con unos segundos de diferencia, y obsérvelo en varias ejecuciones — un vecino que sigue apareciendo y desapareciendo entre ejecuciones está inestable, y eso es la etapa 3b.
<HUAWEI> display ip routing-table 3.3.3.100
<HUAWEI>
// no route to the peer VTEP -> the underlay route is genuinely gone, go to Stage 3a

<HUAWEI> display ospf peer brief
 Peer Address     Interface           State
 10.0.12.2        GE1/0/1             Full
// run this again a few seconds later, and again --
// a neighbor that comes and goes between runs is flapping, not just slow to reconverge

Etapa 3a — Causa raíz: la ruta hacia el VTEP remoto desapareció

Esta es una pérdida real de ruta hacia el peer, no un síntoma de inestabilidad — trátelo como una falla de enrutamiento/EVPN, no una falla de túnel.

  1. Trabaje directamente el diagnóstico de la ruta Underlay faltante — configuración IGP/BGP y estado del vecino, no la configuración VXLAN/NVE.
  2. Si la ruta se aprendió vía EVPN y luego se retiró en lugar de perderse a nivel Underlay, la sección sobre rutas EVPN faltantes de nuestra nota de resolución de problemas del túnel VXLAN cubre en profundidad exactamente este modo de falla.

Etapa 3b — Causa raíz: una ruta está inestable y derriba el túnel repetidamente

Esta es la corrección que realmente resuelve la mayoría de estas alarmas — un corte pequeño, deliberado y temporal, no un bounce de interfaz al azar.

  1. A partir de las salidas repetidas de display ospf peer brief, identifique exactamente qué vecino o interfaz está inestable — no cualquier interfaz que parezca ocupada.
  2. Haga shutdown de esa interfaz específica para romper la adyacencia inestable y evitar que derribe y reconstruya el túnel repetidamente.
  3. Trate esto como una medida provisional que estabiliza el túnel, no como una corrección de causa raíz — el enlace físico, la óptica o el dispositivo aguas arriba que causa la inestabilidad todavía necesita su propia investigación una vez que el incidente esté estable.
[~HUAWEI] interface 10ge 1/0/1   // example only -- use the interface you identified as flapping
[~HUAWEI-10GE1/0/1] shutdown
[*HUAWEI-10GE1/0/1] commit

Etapa 4 — Verificar el túnel específico, no solo la alcanzabilidad general

Un ping funcional en otra parte del fabric no confirma que este túnel se recuperó — verifique el túnel en sí, por su par Source/Destination.

  1. Ejecute display vxlan tunnel y confirme que el State muestra up para este túnel específico, coincidiendo con el par Source/Destination de la alarma original.
<HUAWEI> display vxlan tunnel
Tunnel ID   Source       Destination   State  Type      Uptime
4026531844  4.4.4.100    3.3.3.100     up     dynamic   00:00:42
// confirm State is up for this exact Source/Destination pair before closing the incident

5 cosas que salen mal incluso siguiendo el manual

Una vez que las cuatro etapas anteriores han indicado dónde está el incidente, estos cinco puntos explican la mayor parte de lo que aún sorprende a la gente.

1. La alarma nombra el síntoma, no la causa — la corrección casi nunca está en el propio túnel

SÍNTOMAhwNvo3VxlanTnlDown parece un problema de VXLAN, así que el instinto es ir primero a revisar la configuración VXLAN o NVE.

CAUSAEl túnel es un pasajero, no la causa — cae porque el Underlay dejó de poder alcanzar el VTEP remoto. Toda corrección real en este manual ocurre en el enrutamiento (una ruta faltante o un vecino inestable), nunca en la propia configuración VXLAN/NVE.

SOLUCIÓNComience la recolección de evidencia por la tabla de enrutamiento, no por la configuración VXLAN — display ip routing-table hacia el VTEP remoto es el primer comando que realmente importa.

2. Hacer shutdown de la interfaz equivocada convierte una interrupción en dos

SÍNTOMAEl túnel vuelve brevemente después de un shutdown de interfaz, y luego el incidente empeora — más tráfico afectado, no menos.

CAUSAEl shutdown de interfaz es una acción dirigida y deliberada contra una adyacencia inestable específica identificada a partir de salidas repetidas de display ospf peer brief — no un movimiento general de “apagar todo lo que parezca inestable”. Hacer shutdown de la interfaz equivocada puede eliminar una ruta que funciona en lugar de la inestable.

SOLUCIÓNConfirme el vecino inestable mediante varias ejecuciones repetidas del comando antes de hacer shutdown de cualquier cosa, y haga shutdown solo de esa interfaz.

3. Una falla de hardware a nivel de tarjeta se persigue como un problema de enrutamiento

SÍNTOMALa ruta hacia el VTEP remoto se ve bien, OSPF no está inestable, y sin embargo el túnel permanece caído o sigue reflapeando.

CAUSAUna tarjeta de control principal o una tarjeta de interfaz con fallas puede producir exactamente esta firma — fallas de reenvío intermitentes que parecen un problema de enrutamiento desde la CLI, cuando la falla real es de hardware. Por eso la etapa 1 verifica el estado de las tarjetas y las alarmas de gestión de red antes incluso de que comience la etapa 2.

SOLUCIÓNSi la evidencia de la etapa 2 no apunta claramente a una ruta faltante o inestable, vuelva atrás y descarte una falla de tarjeta mediante la gestión de red antes de dedicar más tiempo al enrutamiento.

4. “El túnel está up” y “el túnel está arreglado” son afirmaciones distintas

SÍNTOMAdisplay vxlan tunnel muestra State up minutos después de la corrección, y luego el túnel vuelve a caer.

CAUSAUn túnel que recupera State up solo confirma que el síntoma inmediato desapareció — no confirma que el vecino inestable identificado en la etapa 3b fuera realmente el correcto, ni que su causa subyacente (una óptica defectuosa, un enlace con fallas, un dispositivo aguas arriba inestable) se haya resuelto. Un shutdown de interfaz es explícitamente una medida provisional en este manual, no una corrección de cierre.

SOLUCIÓNConsidere la verificación de la etapa 4 como confirmación de que el incidente está estable, no resuelto — programe la investigación de seguimiento sobre por qué esa interfaz estaba inestable antes de cerrar completamente el ticket.

5. No todas las fallas de túnel VXLAN disparan esta alarma

SÍNTOMAUn túnel nunca se estableció en primer lugar — display vxlan tunnel muestra Down desde el inicio, sin transición de Up a Down que alarmar.

CAUSAhwNvo3VxlanTnlDown significa específicamente que un túnel previamente up se cayó — es una respuesta de emergencia para un túnel activo y funcional que se rompió. Un túnel que nunca se estableció en absoluto es un tipo de falla diferente, impulsada por la configuración inicial en lugar de algo que rompe un estado funcional.

SOLUCIÓNPara un túnel que nunca se estableció, use la ruta de establecimiento de túnel de nuestra nota dedicada de resolución de problemas del túnel VXLAN en lugar de este manual de emergencia — las causas y las correcciones son distintas.

Diseños de soluciones relacionadas

Cinco preguntas que surgen constantemente

Sacadas directamente del terreno — las que vale la pena tener una respuesta lista.

¿No es hacer shutdown de una interfaz durante una interrupción exactamente el tipo de cambio que no se debe hacer a ciegas?

Sí — por eso la etapa 3b solo recurre a ello después de que la etapa 2 ya haya confirmado, mediante varias comprobaciones repetidas, exactamente qué vecino está inestable. Es una acción dirigida y basada en evidencia sobre una interfaz identificada, no un paso de resolución de problemas a ciegas, y es explícitamente lo segundo que este manual intenta, no lo primero.

¿Qué pasa si display ip routing-table muestra que la ruta hacia el VTEP remoto está presente, pero el túnel aún no vuelve a levantarse?

La presencia de la ruta confirma que el camino Underlay existe, no que VXLAN en sí esté sano — en ese punto esto deja de ser un incidente de enrutamiento y se convierte en una cuestión de establecimiento VXLAN/EVPN. Nuestra nota de resolución de problemas del túnel VXLAN retoma exactamente desde este punto.

¿Este manual reemplaza el flujo completo de resolución de problemas de VXLAN, o coexiste con él?

Coexiste, para un momento distinto. Este manual es para la emergencia específica de una alarma que se dispara en un túnel que funcionaba hace un momento — triaje rápido, evidencia, una corrección provisional, verificación. La nota completa de resolución de problemas es para el trabajo más profundo de causa raíz — problemas de rutas EVPN, discrepancias de VPN-Target, fallas de establecimiento de túnel — hacia el que apuntan los pasos de recolección de evidencia de este manual.

¿Cómo distingo un vecino inestable de uno que simplemente tarda en reconverger después de un evento real?

Ejecute display ospf peer brief varias veces seguidas, con unos segundos de diferencia. Un vecino que se recupera de un evento real se estabiliza y permanece así; un vecino inestable sigue apareciendo y desapareciendo a lo largo de sus ejecuciones repetidas. Si solo ejecuta el comando una vez, no puede notar la diferencia — por eso exactamente la etapa 2 exige comprobaciones repetidas, no una sola mirada.

El túnel está de vuelta — ¿qué pasa después de cerrar el incidente?

La interfaz que apagó en la etapa 3b sigue caída, y era la que llevaba la condición de inestabilidad real — una óptica defectuosa, un enlace marginal, un vecino aguas arriba inestable. Eso es trabajo de seguimiento, no trabajo de incidente: programe la investigación física/óptica y no vuelva a levantar la interfaz hasta saber por qué estaba inestable en primer lugar.

Límites honestos de esta nota

Límites honestos de esta nota

Este manual se basa en la alarma hwNvo3VxlanTnlDown y en las dos causas raíz — pérdida de ruta e inestabilidad de ruta — que explican la mayoría de estos tickets de emergencia. Asume que el túnel estaba previamente up y estable; un túnel que nunca se estableció en absoluto es una falla distinta, cubierta en nuestra nota de resolución de problemas del túnel VXLAN, no aquí. Tampoco reemplaza una investigación de hardware a nivel de tarjeta, que la etapa 1 le indica descartar primero pero no detalla, y no cubre la recuperación orquestada por controlador en fabrics SDN, donde se aplica la misma lógica Underlay pero los comandos difieren.

¿En medio de una alarma de túnel VXLAN ahora mismo?

Cuéntenos qué muestran display ip routing-table y display ospf peer brief para el túnel afectado, y le ayudaremos a encontrar rápidamente el punto de bifurcación.

WhatsApp con un ingeniero →

Lecturas relacionadas

Solo usamos cookies para analítica anónima — sin publicidad ni rastreo entre sitios.Política de privacidad