Asterisk error reference
One page per failure that actually shows up in an Asterisk full
log: what the line means, the causes worth checking in order, and how to tell them apart from
the log you already have. Nearly all of these are diagnoses pbxray makes automatically.
SIP response codes
What the far end sent back, and what it was telling you.
-
SIP 488
SIP 488 Not Acceptable Here in Asterisk
A 488 means the two sides could not agree on how to carry the media. Nine times out of ten that is a codec mismatch, but SRTP and ...
-
SIP 403
SIP 403 Forbidden in Asterisk
A 403 is a refusal, not a failure. The far end understood exactly what you asked for and decided you were not allowed to ask. That...
-
SIP 401 / 407
SIP 401 and 407 authentication loops in Asterisk
A single 401 or 407 is not an error at all - it is the normal first half of SIP digest authentication. The failure is the loop: RE...
-
SIP 480
SIP 480 Temporarily Unavailable in Asterisk
A 480 says the destination exists but could not be reached right now. It is a statement about availability, not about the number b...
-
SIP 404
SIP 404 Not Found in Asterisk
A 404 is the far end saying it has never heard of the number you dialled. Since you almost certainly dialled a number that exists,...
-
SIP 486
SIP 486 Busy Here in Asterisk
Of all the rejection codes, 486 is the one most likely to mean exactly what it says. The line is in use. That makes the interestin...
-
SIP 500 / 503
SIP 503 Service Unavailable in Asterisk
A 503 means the server that received your request is refusing to handle it right now. It is a statement about the far end's health...
-
SIP 603
SIP 603 Declined in Asterisk
A 603 is a decision. Something looked at this specific call and chose to refuse it, which makes it different in kind from a 486 bu...
-
SIP 483
SIP 483 Too Many Hops in Asterisk
Every SIP request carries a Max-Forwards counter that decrements at each hop. When it reaches zero the request is rejected with a ...
-
pjsip
"No matching endpoint found" in Asterisk
Asterisk received a SIP request and could not match it to any configured endpoint. On a box reachable from the internet, the overw...
Dialplan and channel failures
Asterisk's own log lines, where the call never got as far as a SIP response.
-
CHANUNAVAIL
DIALSTATUS CHANUNAVAIL in Asterisk and FreePBX
CHANUNAVAIL is Asterisk saying it could not even build the channel. No INVITE was sent, no far end was consulted, and no SIP respo...
-
app_dial
"Everyone is busy/congested at this time" in Asterisk
This line is app_dial's verdict when no destination could even ring. The bracketed counts after it are the most useful part and th...
-
app_dial
"No one is available to answer at this time" in Asterisk
This is app_dial summarising a Dial() attempt where nothing worked out. It is a conclusion drawn from several attempts, which mean...
-
Dial()
"No devices or endpoints to dial" in Asterisk
This one has a nasty property: the line that fails is not the line with the bug. Dial() ran with nothing to dial because a variabl...
-
pbx.c
"Cannot find extension" in Asterisk
A jump went somewhere that does not exist. The log names both the extension and the context it looked in, which between them nearl...
-
pjsip
"Rejected because extension not found in context" in Asterisk
An INVITE arrived, Asterisk looked up the dialled number in the context assigned to that endpoint, and found no extension matching...
-
Gosub()
"Gosub attempted to reach non-existent destination" in Asterisk
Gosub failures are more confusing than Goto failures because the Gosub is often one you did not write. Dial() and Queue() call sub...
-
AGI
AGI script returning -1 in Asterisk
When AGI returns -1, the dialplan did its job and the script did not. That is useful, because it means the answer is in the script...
-
Cause 8
Congestion (circuits busy) in Asterisk
Congestion is a capacity statement about your side, not a rejection from the far end. Every channel on the trunk was already in us...
-
DNS
"No such host" in Asterisk
Asterisk could not resolve the hostname it was asked to dial, so no channel was ever created. Before blaming DNS, note that a real...
-
Audio
"Exceptionally long voice queue length" in Asterisk
This warning is about media, not signalling. Frames are arriving faster than they are being written out, and callers hear the resu...
-
RTP
"RTP Read too short" in Asterisk
Asterisk received an RTP packet that was too short to be a valid one and threw it away. The important question is not what one pac...