85da484c3ff04ac10226a828ece1510ddf6af5a7
[asterisk/asterisk.git] / doc / queuelog.txt
1 Queue Log Information
2 =====================
3
4 In order to properly manage ACD queues, it is important to be able to
5 keep track of details of call setups and teardowns in much greater detail
6 than traditional call detail records provide.  In order to support this,
7 extensive and detailed tracing of every queued call is stored in the
8 queue log, located (by default) in /var/log/asterisk/queue_log.
9
10 These are the events (and associated information) in the queue log:
11
12 ABANDON(position|origposition|waittime)
13 The caller abandoned their position in the queue.  The position is the
14 caller's position in the queue when they hungup, the origposition is
15 the original position the caller was when they first entered the
16 queue, and the waittime is how long the call had been waiting in the 
17 queue at the time of disconnect.
18
19 AGENTDUMP
20 The agent dumped the caller while listening to the queue announcement.
21
22 AGENTLOGIN(channel)
23 The agent logged in.  The channel is recorded.
24
25 AGENTLOGOFF(channel|logintime)
26 The agent logged off.  The channel is recorded, along with the total time
27 the agent was logged in.
28
29 COMPLETEAGENT(holdtime|calltime|origposition)
30 The caller was connected to an agent, and the call was terminated normally
31 by the *agent*.  The caller's hold time and the length of the call are both
32 recorded.  The caller's original position in the queue is recorded in
33 origposition.
34
35 COMPLETECALLER(holdtime|calltime|origposition)
36 The caller was connected to an agent, and the call was terminated normally
37 by the *caller*.  The caller's hold time and the length of the call are both
38 recorded.  The caller's original position in the queue is recorded in
39 origposition.
40
41 CONFIGRELOAD
42 The configuration has been reloaded (e.g. with asterisk -rx reload)
43
44 CONNECT(holdtime)
45 The caller was connected to an agent.  Hold time represents the amount
46 of time the caller was on hold.
47
48 ENTERQUEUE(url|callerid)
49 A call has entered the queue.  URL (if specified) and Caller*ID are placed
50 in the log.
51
52 EXITWITHKEY(key|position)
53 The caller elected to use a menu key to exit the queue.  The key and
54 the caller's position in the queue are recorded.
55
56 EXITWITHTIMEOUT(position)
57 The caller was on hold too long and the timeout expired.
58
59 QUEUESTART
60 The queueing system has been started for the first time this session.
61
62 SYSCOMPAT
63 A call was answered by an agent, but the call was dropped because the 
64 channels were not compatible.
65
66 TRANSFER(extension,context)
67 Caller was transferred to a different extension.  Context and extension
68 are recorded.
69