Diagnósticos de Asterisk por comandos: guía práctica para técnicos e ISP

Son las 9 de la mañana, el teléfono de la recepción no timbra y el cliente ya está llamando al celular para quejarse. Si trabajas con centrales Asterisk, sea en una oficina, en un call center o dentro de un ISP que ofrece telefonía IP, conoces esa escena. La buena noticia es que Asterisk te dice casi todo lo que está pasando; solo hay que saber preguntarle.
En esta guía vas a aprender a diagnosticar las fallas más comunes desde la línea de comandos, organizadas por síntoma. Los comandos son para Asterisk 18 y 20. Cuando un comando depende del canal SIP, te indicamos si es de PJSIP (el recomendado) o de chan_sip, que está obsoleto en Asterisk 18 y 20 y fue eliminado en Asterisk 21.
El orden de trabajo es siempre el mismo:
- Entrar a la CLI.
- Revisar los comandos base.
- Diagnosticar el registro.
- Diagnosticar el audio.
- Diagnosticar las llamadas que se caen.
- Diagnosticar el plan de marcado.
- Revisar los logs.
Paso 1: cómo entrar a la CLI de Asterisk
Desde la terminal del servidor, conéctate a la consola del proceso que ya está corriendo:
sudo asterisk -rvvv
La opción -r se conecta a la instancia activa (no arranca otra) y cada v sube un nivel de detalle (verbose). Para salir sin detener Asterisk, escribe exit o presiona Ctrl+C.
Una aclaración importante para el resto de la guía: los comandos que empiezan con sudo se escriben en la terminal de Linux; los demás se escriben dentro de la CLI de Asterisk, sin sudo.
Paso 2: comandos base
Antes de buscar la falla, confirma con qué estás trabajando:
core show version
core show uptime
module show like pjsip
core show versionte dice la versión exacta. No es lo mismo diagnosticar un Asterisk 18 que un 20.core show uptimemuestra cuánto tiempo lleva corriendo el sistema y cuándo fue la última recarga. Si el uptime es de pocos minutos y nadie reinició, sospecha de un reinicio inesperado.module show like pjsiplista los módulos de PJSIP cargados. Si no aparecen, ningún comandopjsipva a funcionar.
Luego, sube el nivel de detalle de la consola:
core set verbose 5
core set debug 3
El verbose muestra lo que pasa en cada llamada; el debug agrega mensajes internos para desarrolladores y genera mucho texto. Úsalo solo mientras diagnosticas y apágalo al terminar:
core set debug off

Paso 3: la extensión o el troncal no registra
Es la falla más común: el teléfono dice “No registrado” o el troncal del proveedor aparece caído.

Con PJSIP (Asterisk 18 y 20)
pjsip show endpoints
pjsip show endpoint <nombre>
pjsip show registrations
pjsip show contacts
pjsip show endpointslista todas las extensiones y troncales con su estado. Una extensión con estado “Unavailable” no tiene un contacto alcanzable.pjsip show endpoint <nombre>muestra el detalle de una sola: su AOR, su autenticación, su contexto y sus contactos. Cambia<nombre>por el nombre del endpoint, por ejemplo101.pjsip show registrationsmuestra los registros salientes, es decir, los troncales que tu Asterisk registra contra un proveedor. El estado correcto es “Registered”.pjsip show contactsmuestra los equipos que se registraron en tu central, con su IP y su tiempo de respuesta.
Ejemplo simulado:
Contact: 101/sip:101@192.168.10.25:5060 a1b2c3d4e5 Avail 12.345
Si el endpoint no aparece en contactos, activa el registro de mensajes SIP y pide al teléfono que se registre de nuevo:
pjsip set logger on
Vas a ver cada REGISTER y la respuesta de Asterisk. Un 401 Unauthorized repetido suele indicar usuario o contraseña incorrectos; un 403 Forbidden, que el equipo fue rechazado. Si no aparece ningún REGISTER, el paquete no está llegando: revisa la red, el firewall y la IP del servidor configurada en el teléfono. Al terminar:
pjsip set logger off
Con chan_sip (solo sistemas heredados)
Si todavía tienes una central con chan_sip, los equivalentes son:
sip show peers
sip show registry
sip set debug on
Para apagar el debug de chan_sip, usa sip set debug off. Si puedes, planifica la migración a PJSIP: chan_sip ya no existe en Asterisk 21.
Paso 4: no hay audio o el audio va en un solo sentido
La llamada conecta, pero nadie escucha nada, o solo una de las partes escucha. En la gran mayoría de los casos el culpable es el NAT: la señalización SIP pasa, pero el audio (RTP) va a una IP o a un puerto equivocado.
Activa el debug de RTP mientras haces una llamada de prueba:
rtp set debug on
Vas a ver líneas “Sent RTP packet” y “Got RTP packet”. Si solo aparecen paquetes enviados y ningún paquete recibido, el audio del otro lado no está llegando. Fíjate también en las IP: si aparece una IP privada donde debería estar la pública, tienes un problema de NAT. Apágalo enseguida, porque genera muchísimo texto:
rtp set debug off
Revisa la configuración de NAT en PJSIP
Si tu Asterisk está detrás de NAT, el transporte en pjsip.conf debe anunciar la IP pública y conocer tu red local:
[transport-udp]
type=transport
protocol=udp
bind=0.0.0.0
external_media_address=<IP pública>
external_signaling_address=<IP pública>
local_net=192.168.10.0/24
Los cambios de transporte en PJSIP no se aplican con un reload; requieren reiniciar Asterisk (core restart gracefully).
external_media_address: la IP pública que Asterisk pone en el SDP para el audio.external_signaling_address: la IP pública que usa en los encabezados SIP.local_net: tu red interna. A los equipos de esta red no se les aplica la IP externa.
En los endpoints que llegan desde afuera, también ayudan rtp_symmetric=yes, force_rport=yes y rewrite_contact=yes.
Revisa los puertos RTP
El rango de puertos de audio está en rtp.conf. Consúltalo desde la terminal:
sudo grep -E "rtpstart|rtpend" /etc/asterisk/rtp.conf
Ese mismo rango UDP tiene que estar abierto en el firewall del servidor y, si aplica, redirigido en el router. Un rango cerrado es la causa clásica del audio en un solo sentido.

Paso 5: llamadas que se caen
Para ver qué está activo en este momento:
core show channels
core show channels verbose
El primero muestra los canales y llamadas activas. El segundo agrega el contexto, la extensión, la aplicación que se está ejecutando y la duración de cada canal. Si una llamada se cae, mira en qué aplicación estaba justo antes.
Lee el código de colgado
Cada llamada termina con un código de colgado (hangup cause) del estándar Q.850. Los más comunes:
- 16: colgado normal.
- 17: usuario ocupado.
- 19: no contesta.
- 21: llamada rechazada.
- 34: no hay circuito o canal disponible.
Para ver el código en la consola, puedes agregar esta extensión h en el contexto de la llamada, en extensions.conf:
exten => h,1,NoOp(Causa de colgado: ${HANGUPCAUSE})
Con pjsip set logger on también vas a ver el BYE o la respuesta SIP que cerró la llamada, y quién la envió.
Session timers y qualify
Si las llamadas se cortan siempre después del mismo tiempo, revisa estas opciones en pjsip.conf:
- En el endpoint:
timers,timers_sess_expiresyrtp_timeout. Unrtp_timeoutmuy bajo cuelga la llamada cuando no llega audio durante esos segundos. - En el AOR:
qualify_frequency. Asterisk envía OPTIONS a ese intervalo; si el equipo deja de responder, su contacto pasa a no disponible.
Si la llamada se cae unos 30 segundos después de contestar, una causa común es que el ACK no llega, casi siempre por NAT. Vuelve al paso 4.
Paso 6: errores del plan de marcado
Marcas un número y escuchas “el número marcado no existe”, o la llamada no hace nada. Revisa el contexto:
dialplan show <contexto>
Cambia <contexto> por el nombre real, por ejemplo interno. Verás todas las extensiones y patrones de ese contexto. Confirma que el endpoint (el que revisaste con pjsip show endpoint <nombre>) apunte al contexto correcto y que el patrón cubra el número marcado.
Después de editar extensions.conf, recarga el plan de marcado:
dialplan reload
Luego, con core set verbose 5 activo, marca de nuevo y sigue cada línea “Executing”. Si aparece un aviso de que la extensión no se encontró en el contexto, ya sabes dónde está el error: el número no coincide con ningún patrón.

Paso 7: revisión de logs
La consola muestra lo que pasa ahora; los logs guardan lo que ya pasó. Para seguir el log completo en tiempo real:
sudo tail -f /var/log/asterisk/full
Ojo: el archivo full solo existe si está habilitado en /etc/asterisk/logger.conf, con una línea como esta:
full => notice,warning,error,verbose
Después de habilitarlo, recarga el logger:
sudo asterisk -rx "logger reload"
Para buscar algo puntual, usa grep:
sudo grep -i "No matching endpoint" /var/log/asterisk/full
sudo grep -i "unreachable" /var/log/asterisk/full
sudo grep "C-00000012" /var/log/asterisk/full
El primero encuentra intentos de registro o llamadas que no coinciden con ningún endpoint (útil también para detectar escaneos). El segundo, equipos que dejaron de responder al qualify. El tercero sigue una llamada completa por su identificador; cámbialo por el que veas entre corchetes en tu log.

Tabla resumen: síntoma → comando

| Síntoma | Comando para empezar | Qué buscar |
|---|---|---|
| La extensión no registra (PJSIP) | pjsip show contacts |
El contacto de la extensión, con estado “Avail” |
| El troncal del proveedor no registra (PJSIP) | pjsip show registrations |
El troncal, con estado “Registered” |
| La extensión o el troncal no registra (chan_sip, heredado) | sip show peers |
El peer, con estado “OK” |
| No hay audio o va en un solo sentido | rtp set debug on |
Paquetes recibidos y la IP correcta |
| Las llamadas se caen | core show channels verbose |
La aplicación activa antes del corte |
| El número no existe o la llamada no avanza | dialplan show <contexto> |
Un patrón que cubra el número marcado |
| Falla que ya pasó | sudo tail -f /var/log/asterisk/full |
Los avisos y errores de la hora de la falla |
Preguntas frecuentes
¿Por dónde empiezo si no sé qué está fallando?
Sigue el mismo orden de esta guía: entra a la CLI, revisa los comandos base, el registro, el audio, las llamadas que se caen, el plan de marcado y, al final, los logs.
¿Uso los comandos pjsip o los comandos sip?
Depende del módulo. En Asterisk 18 y 20, lo recomendado es PJSIP; chan_sip está obsoleto y fue eliminado en Asterisk 21. Con module show like pjsip confirmas qué tienes cargado, y con module show like chan_sip compruebas si queda algo heredado cargado.
¿Dejo activados el debug de RTP y el logger de PJSIP?
No. Generan mucho texto y pueden llenar el disco. Actívalos solo durante la prueba y apágalos con rtp set debug off y pjsip set logger off.
¿Por qué no encuentro el archivo /var/log/asterisk/full?
Porque no está habilitado en logger.conf. Agrega la línea full => notice,warning,error,verbose, recarga el logger y vuelve a intentarlo.
Conclusión
Diagnosticar una central Asterisk no es adivinar: es seguir un orden. Entra a la CLI, revisa los comandos base, verifica el registro, revisa el audio, investiga las llamadas que se caen, corrige el plan de marcado y, al final, apóyate en los logs. Con estos comandos vas a resolver la mayoría de los tickets de telefonía antes de que el cliente vuelva a llamar.

Y como casi todas estas fallas terminan siendo de red (NAT, firewall, puertos), vale la pena tener la base de redes bien firme. Practica con las herramientas gratuitas de Canó Academy para practicar redes.