mirror of
				https://github.com/asterisk/asterisk.git
				synced 2025-11-03 20:38:59 +00:00 
			
		
		
		
	(closes issue #13211) Reported by: eliel Patches: fixtexerrors.patch uploaded by eliel (license 64) git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@134803 65c4cc65-6c06-0410-ace0-fbb531ad65f3
		
			
				
	
	
		
			119 lines
		
	
	
		
			4.6 KiB
		
	
	
	
		
			TeX
		
	
	
	
	
	
			
		
		
	
	
			119 lines
		
	
	
		
			4.6 KiB
		
	
	
	
		
			TeX
		
	
	
	
	
	
In order to properly manage ACD queues, it is important to be able to
 | 
						|
keep track of details of call setups and teardowns in much greater detail
 | 
						|
than traditional call detail records provide.  In order to support this,
 | 
						|
extensive and detailed tracing of every queued call is stored in the
 | 
						|
queue log, located (by default) in \path{/var/log/asterisk/queue_log}.
 | 
						|
 | 
						|
These are the events (and associated information) in the queue log:
 | 
						|
 | 
						|
\textbf{ABANDON(position$|$origposition$|$waittime)}
 | 
						|
 | 
						|
The caller abandoned their position in the queue.  The position is the
 | 
						|
caller's position in the queue when they hungup, the origposition is
 | 
						|
the original position the caller was when they first entered the
 | 
						|
queue, and the waittime is how long the call had been waiting in the
 | 
						|
queue at the time of disconnect.
 | 
						|
 | 
						|
\textbf{AGENTDUMP}
 | 
						|
 | 
						|
The agent dumped the caller while listening to the queue announcement.
 | 
						|
 | 
						|
\textbf{AGENTLOGIN(channel)}
 | 
						|
 | 
						|
The agent logged in.  The channel is recorded.
 | 
						|
 | 
						|
\textbf{AGENTCALLBACKLOGIN(exten@context)}
 | 
						|
 | 
						|
The callback agent logged in.  The login extension and context is recorded.
 | 
						|
 | 
						|
\textbf{AGENTLOGOFF(channel$|$logintime)}
 | 
						|
 | 
						|
The agent logged off.  The channel is recorded, along with the total time
 | 
						|
the agent was logged in.
 | 
						|
 | 
						|
\textbf{AGENTCALLBACKLOGOFF(exten@context$|$logintime$|$reason)}
 | 
						|
 | 
						|
The callback agent logged off.  The last login extension and context is
 | 
						|
recorded, along with the total time the agent was logged in, and the
 | 
						|
reason for the logoff if it was not a normal logoff
 | 
						|
(e.g., Autologoff, Chanunavail)
 | 
						|
 | 
						|
\textbf{COMPLETEAGENT(holdtime$|$calltime$|$origposition)}
 | 
						|
 | 
						|
The caller was connected to an agent, and the call was terminated normally
 | 
						|
by the *agent*.  The caller's hold time and the length of the call are both
 | 
						|
recorded.  The caller's original position in the queue is recorded in
 | 
						|
origposition.
 | 
						|
 | 
						|
\textbf{COMPLETECALLER(holdtime$|$calltime$|$origposition)}
 | 
						|
 | 
						|
The caller was connected to an agent, and the call was terminated normally
 | 
						|
by the *caller*.  The caller's hold time and the length of the call are both
 | 
						|
recorded.  The caller's original position in the queue is recorded in
 | 
						|
origposition.
 | 
						|
 | 
						|
\textbf{CONFIGRELOAD}
 | 
						|
 | 
						|
The configuration has been reloaded (e.g. with asterisk -rx reload)
 | 
						|
 | 
						|
\textbf{CONNECT(holdtime$|$bridgedchanneluniqueid$|$ringtime)}
 | 
						|
 | 
						|
The caller was connected to an agent.  Hold time represents the amount
 | 
						|
of time the caller was on hold. The bridged channel unique ID contains
 | 
						|
the unique ID of the queue member channel that is taking the call. This
 | 
						|
is useful when trying to link recording filenames to a particular
 | 
						|
call in the queue. Ringtime represents the time the queue members phone
 | 
						|
was ringing prior to being answered.
 | 
						|
 | 
						|
\textbf{ENTERQUEUE(url$|$callerid)}
 | 
						|
 | 
						|
A call has entered the queue.  URL (if specified) and Caller*ID are placed
 | 
						|
in the log.
 | 
						|
 | 
						|
\textbf{EXITEMPTY(position$|$origposition$|$waittime)}
 | 
						|
 | 
						|
The caller was exited from the queue forcefully because the queue had no
 | 
						|
reachable members and it's configured to do that to callers when there
 | 
						|
are no reachable members. The position is the caller's position in the
 | 
						|
queue when they hungup, the origposition is the original position the
 | 
						|
caller was when they first entered the queue, and the waittime is how
 | 
						|
long the call had been waiting in the queue at the time of disconnect.
 | 
						|
 | 
						|
\textbf{EXITWITHKEY(key$|$position$|$origposition$|$waittime)}
 | 
						|
 | 
						|
The caller elected to use a menu key to exit the queue.  The key and
 | 
						|
the caller's position in the queue are recorded.  The caller's entry
 | 
						|
position and amoutn of time waited is also recorded.
 | 
						|
 | 
						|
\textbf{EXITWITHTIMEOUT(position$|$origposition$|$waittime)}
 | 
						|
 | 
						|
The caller was on hold too long and the timeout expired.  The position in the
 | 
						|
queue when the timeout occurred, the entry position, and the amount of time
 | 
						|
waited are logged.
 | 
						|
 | 
						|
\textbf{QUEUESTART}
 | 
						|
 | 
						|
The queueing system has been started for the first time this session.
 | 
						|
 | 
						|
\textbf{RINGNOANSWER(ringtime)}
 | 
						|
 | 
						|
After trying for ringtime ms to connect to the available queue member,
 | 
						|
the attempt ended without the member picking up the call. Bad queue
 | 
						|
member!
 | 
						|
 | 
						|
\textbf{SYSCOMPAT}
 | 
						|
 | 
						|
A call was answered by an agent, but the call was dropped because the
 | 
						|
channels were not compatible.
 | 
						|
 | 
						|
\textbf{TRANSFER(extension$|$context$|$holdtime$|$calltime$|$origposition)}
 | 
						|
 | 
						|
Caller was transferred to a different extension.  Context and extension
 | 
						|
are recorded. The caller's hold time and the length of the call are both
 | 
						|
recorded, as is the caller's entry position at the time of the transfer.
 | 
						|
PLEASE remember that transfers performed by SIP UA's by way of a reinvite
 | 
						|
may not always be caught by Asterisk and trigger off this event. The only
 | 
						|
way to be 100\% sure that you will get this event when a transfer is
 | 
						|
performed by a queue member is to use the built-in transfer functionality
 | 
						|
of Asterisk.
 |