Add the Ring time in the CONNECT on the queue_log and on the Manager event AgentConnect
[asterisk/asterisk.git] / doc / tex / queuelog.tex
index dd2047a..0777b2b 100644 (file)
@@ -6,59 +6,72 @@ queue log, located (by default) in /var/log/asterisk/queue\_log.
 
 These are the events (and associated information) in the queue log:
 
 
 These are the events (and associated information) in the queue log:
 
-ABANDON(position|origposition|waittime)
+\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.
 
 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.
 
-AGENTDUMP
+\textbf{AGENTDUMP}
+
 The agent dumped the caller while listening to the queue announcement.
 
 The agent dumped the caller while listening to the queue announcement.
 
-AGENTLOGIN(channel)
+\textbf{AGENTLOGIN(channel)}
+
 The agent logged in.  The channel is recorded.
 
 The agent logged in.  The channel is recorded.
 
-AGENTCALLBACKLOGIN(exten@context)
+\textbf{AGENTCALLBACKLOGIN(exten@context)}
+
 The callback agent logged in.  The login extension and context is recorded.
 
 The callback agent logged in.  The login extension and context is recorded.
 
-AGENTLOGOFF(channel|logintime)
+\textbf{AGENTLOGOFF(channel|logintime)}
+
 The agent logged off.  The channel is recorded, along with the total time
 the agent was logged in.
 
 The agent logged off.  The channel is recorded, along with the total time
 the agent was logged in.
 
-AGENTCALLBACKLOGOFF(exten@context|logintime|reason)
+\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)
 
 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)
 
-COMPLETEAGENT(holdtime|calltime|origposition)
+\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.
 
 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.
 
-COMPLETECALLER(holdtime|calltime|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.
 
 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.
 
-CONFIGRELOAD
+\textbf{CONFIGRELOAD}
+
 The configuration has been reloaded (e.g. with asterisk -rx reload)
 
 The configuration has been reloaded (e.g. with asterisk -rx reload)
 
-CONNECT(holdtime|bridgedchanneluniqueid)
+\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
 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.
+call in the queue. Ringtime represents the time the queue members phone
+was ringing prior to being answered.
+
+\textbf{ENTERQUEUE(url|callerid)}
 
 
-ENTERQUEUE(url|callerid)
 A call has entered the queue.  URL (if specified) and Caller*ID are placed
 in the log.
 
 A call has entered the queue.  URL (if specified) and Caller*ID are placed
 in the log.
 
-EXITEMPTY(position|origposition|waittime)
+\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
 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
@@ -66,29 +79,35 @@ 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.
 
 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.
 
-EXITWITHKEY(key|position|origposition|waittime)
+\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.
 
 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.
 
-EXITWITHTIMEOUT(position|origposition|waittime)
+\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.
 
 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.
 
-QUEUESTART
+\textbf{QUEUESTART}
+
 The queueing system has been started for the first time this session.
 
 The queueing system has been started for the first time this session.
 
-RINGNOANSWER(ringtime)
+\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!
 
 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!
 
-SYSCOMPAT
+\textbf{SYSCOMPAT}
+
 A call was answered by an agent, but the call was dropped because the 
 channels were not compatible.
 
 A call was answered by an agent, but the call was dropped because the 
 channels were not compatible.
 
-TRANSFER(extension|context|holdtime|calltime)
+\textbf{TRANSFER(extension|context|holdtime|calltime)}
+
 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. PLEASE remember that transfers performed by SIP UA's by way
 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. PLEASE remember that transfers performed by SIP UA's by way