~damg/ubuntu/quantal/asterisk/LP1097687

« back to all changes in this revision

Viewing changes to doc/tex/asterisk/node271.html

  • Committer: Bazaar Package Importer
  • Author(s): Lorenzo De Liso
  • Date: 2010-10-15 22:24:34 UTC
  • mfrom: (1.2.8 upstream) (8.3.8 sid)
  • Revision ID: james.westby@ubuntu.com-20101015222434-iy328q8in3lajzlv
Tags: 1:1.6.2.9-2ubuntu1
* Merge from debian unstable, remaining changes:
  - debian/control:
    + Build-depend on hardening-wrapper
    + Change Maintainer
    + Removed Uploaders field.
    + Removed Debian Vcs-Svn entry and replaced with ubuntu-voip Vcs-Bzr,
      to reflect divergence in packages.
  - debian/rules: Make use of hardening-wrapper
  - debian/asterisk.init: chown /dev/dahdi
  - debian/backports/hardy: add file
  - debian/backports/asterisk.init.hardy: add file
 

Show diffs side-by-side

added added

removed removed

Lines of Context:
7
7
  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
8
8
<HTML>
9
9
<HEAD>
10
 
<TITLE>Phone Provisioning</TITLE>
11
 
<META NAME="description" CONTENT="Phone Provisioning">
 
10
<TITLE>Queue Logs</TITLE>
 
11
<META NAME="description" CONTENT="Queue Logs">
12
12
<META NAME="keywords" CONTENT="asterisk">
13
13
<META NAME="resource-type" CONTENT="document">
14
14
<META NAME="distribution" CONTENT="global">
18
18
 
19
19
<LINK REL="STYLESHEET" HREF="asterisk.css">
20
20
 
21
 
<LINK REL="next" HREF="node281.html">
22
 
<LINK REL="previous" HREF="node258.html">
23
 
<LINK REL="up" HREF="asterisk.html">
 
21
<LINK REL="previous" HREF="node261.html">
 
22
<LINK REL="up" HREF="node259.html">
24
23
<LINK REL="next" HREF="node272.html">
25
24
</HEAD>
26
25
 
27
26
<BODY >
28
27
 
29
28
<DIV CLASS="navigation"><!--Navigation Panel-->
30
 
<A NAME="tex2html4198"
 
29
<A NAME="tex2html4201"
31
30
  HREF="node272.html">
32
31
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
33
32
 SRC="/usr/share/latex2html/icons/next.png"></A> 
34
 
<A NAME="tex2html4194"
35
 
  HREF="asterisk.html">
 
33
<A NAME="tex2html4197"
 
34
  HREF="node259.html">
36
35
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
37
36
 SRC="/usr/share/latex2html/icons/up.png"></A> 
38
 
<A NAME="tex2html4188"
 
37
<A NAME="tex2html4193"
39
38
  HREF="node270.html">
40
39
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
41
40
 SRC="/usr/share/latex2html/icons/prev.png"></A> 
42
 
<A NAME="tex2html4196"
 
41
<A NAME="tex2html4199"
43
42
  HREF="node1.html">
44
43
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents"
45
44
 SRC="/usr/share/latex2html/icons/contents.png"></A>  
46
45
<BR>
47
 
<B> Next:</B> <A NAME="tex2html4199"
48
 
  HREF="node272.html">Introduction</A>
49
 
<B> Up:</B> <A NAME="tex2html4195"
50
 
  HREF="asterisk.html">Asterisk Reference Information Version</A>
51
 
<B> Previous:</B> <A NAME="tex2html4189"
52
 
  HREF="node270.html">Queue Logs</A>
53
 
 &nbsp; <B>  <A NAME="tex2html4197"
 
46
<B> Next:</B> <A NAME="tex2html4202"
 
47
  HREF="node272.html">Phone Provisioning</A>
 
48
<B> Up:</B> <A NAME="tex2html4198"
 
49
  HREF="node259.html">Queues</A>
 
50
<B> Previous:</B> <A NAME="tex2html4194"
 
51
  HREF="node270.html">Caveats</A>
 
52
 &nbsp; <B>  <A NAME="tex2html4200"
54
53
  HREF="node1.html">Contents</A></B> 
55
54
<BR>
56
55
<BR></DIV>
57
56
<!--End of Navigation Panel-->
58
57
 
59
 
<H1><A NAME="SECTION001500000000000000000">
60
 
Phone Provisioning</A>
 
58
<H1><A NAME="SECTION001430000000000000000">
 
59
Queue Logs</A>
61
60
</H1>
62
 
  <BR><HR>
63
 
<!--Table of Child-Links-->
64
 
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
65
 
 
66
 
<UL CLASS="ChildLinks">
67
 
<LI><A NAME="tex2html4200"
68
 
  HREF="node272.html">Introduction</A>
69
 
<LI><A NAME="tex2html4201"
70
 
  HREF="node273.html">Configuration of phoneprov.conf</A>
71
 
<UL>
72
 
<LI><A NAME="tex2html4202"
73
 
  HREF="node274.html">The [general] section</A>
74
 
<LI><A NAME="tex2html4203"
75
 
  HREF="node275.html">Creating phone profiles</A>
76
 
</UL>
77
 
<BR>
78
 
<LI><A NAME="tex2html4204"
79
 
  HREF="node276.html">Configuration of users.conf</A>
80
 
<UL>
81
 
<LI><A NAME="tex2html4205"
82
 
  HREF="node277.html">The [general] section</A>
83
 
<LI><A NAME="tex2html4206"
84
 
  HREF="node278.html">Invdividual Users</A>
85
 
</UL>
86
 
<BR>
87
 
<LI><A NAME="tex2html4207"
88
 
  HREF="node279.html">Templates</A>
89
 
<LI><A NAME="tex2html4208"
90
 
  HREF="node280.html">Putting it all together</A>
91
 
</UL>
92
 
<!--End of Table of Child-Links-->
93
 
<BR><HR>
 
61
  In order to properly manage ACD queues, it is important to be able to
 
62
keep track of details of call setups and teardowns in much greater detail
 
63
than traditional call detail records provide.  In order to support this,
 
64
extensive and detailed tracing of every queued call is stored in the
 
65
queue log, located (by default) in /var/log/asterisk/queue_log.
 
66
 
 
67
<P>
 
68
These are the events (and associated information) in the queue log:
 
69
 
 
70
<P>
 
71
<SPAN  CLASS="textbf">ABANDON(position<SPAN CLASS="MATH"><IMG
 
72
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
73
 SRC="img8.png"
 
74
 ALT="$\vert$"></SPAN>origposition<SPAN CLASS="MATH"><IMG
 
75
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
76
 SRC="img8.png"
 
77
 ALT="$\vert$"></SPAN>waittime)</SPAN>
 
78
 
 
79
<P>
 
80
The caller abandoned their position in the queue.  The position is the
 
81
caller's position in the queue when they hungup, the origposition is
 
82
the original position the caller was when they first entered the
 
83
queue, and the waittime is how long the call had been waiting in the
 
84
queue at the time of disconnect.
 
85
 
 
86
<P>
 
87
<SPAN  CLASS="textbf">AGENTDUMP</SPAN>
 
88
 
 
89
<P>
 
90
The agent dumped the caller while listening to the queue announcement.
 
91
 
 
92
<P>
 
93
<SPAN  CLASS="textbf">AGENTLOGIN(channel)</SPAN>
 
94
 
 
95
<P>
 
96
The agent logged in.  The channel is recorded.
 
97
 
 
98
<P>
 
99
<SPAN  CLASS="textbf">AGENTCALLBACKLOGIN(exten@context)</SPAN>
 
100
 
 
101
<P>
 
102
The callback agent logged in.  The login extension and context is recorded.
 
103
 
 
104
<P>
 
105
<SPAN  CLASS="textbf">AGENTLOGOFF(channel<SPAN CLASS="MATH"><IMG
 
106
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
107
 SRC="img8.png"
 
108
 ALT="$\vert$"></SPAN>logintime)</SPAN>
 
109
 
 
110
<P>
 
111
The agent logged off.  The channel is recorded, along with the total time
 
112
the agent was logged in.
 
113
 
 
114
<P>
 
115
<SPAN  CLASS="textbf">AGENTCALLBACKLOGOFF(exten@context<SPAN CLASS="MATH"><IMG
 
116
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
117
 SRC="img8.png"
 
118
 ALT="$\vert$"></SPAN>logintime<SPAN CLASS="MATH"><IMG
 
119
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
120
 SRC="img8.png"
 
121
 ALT="$\vert$"></SPAN>reason)</SPAN>
 
122
 
 
123
<P>
 
124
The callback agent logged off.  The last login extension and context is
 
125
recorded, along with the total time the agent was logged in, and the
 
126
reason for the logoff if it was not a normal logoff
 
127
(e.g., Autologoff, Chanunavail)
 
128
 
 
129
<P>
 
130
<SPAN  CLASS="textbf">COMPLETEAGENT(holdtime<SPAN CLASS="MATH"><IMG
 
131
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
132
 SRC="img8.png"
 
133
 ALT="$\vert$"></SPAN>calltime<SPAN CLASS="MATH"><IMG
 
134
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
135
 SRC="img8.png"
 
136
 ALT="$\vert$"></SPAN>origposition)</SPAN>
 
137
 
 
138
<P>
 
139
The caller was connected to an agent, and the call was terminated normally
 
140
by the *agent*.  The caller's hold time and the length of the call are both
 
141
recorded.  The caller's original position in the queue is recorded in
 
142
origposition.
 
143
 
 
144
<P>
 
145
<SPAN  CLASS="textbf">COMPLETECALLER(holdtime<SPAN CLASS="MATH"><IMG
 
146
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
147
 SRC="img8.png"
 
148
 ALT="$\vert$"></SPAN>calltime<SPAN CLASS="MATH"><IMG
 
149
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
150
 SRC="img8.png"
 
151
 ALT="$\vert$"></SPAN>origposition)</SPAN>
 
152
 
 
153
<P>
 
154
The caller was connected to an agent, and the call was terminated normally
 
155
by the *caller*.  The caller's hold time and the length of the call are both
 
156
recorded.  The caller's original position in the queue is recorded in
 
157
origposition.
 
158
 
 
159
<P>
 
160
<SPAN  CLASS="textbf">CONFIGRELOAD</SPAN>
 
161
 
 
162
<P>
 
163
The configuration has been reloaded (e.g. with asterisk -rx reload)
 
164
 
 
165
<P>
 
166
<SPAN  CLASS="textbf">CONNECT(holdtime<SPAN CLASS="MATH"><IMG
 
167
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
168
 SRC="img8.png"
 
169
 ALT="$\vert$"></SPAN>bridgedchanneluniqueid<SPAN CLASS="MATH"><IMG
 
170
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
171
 SRC="img8.png"
 
172
 ALT="$\vert$"></SPAN>ringtime)</SPAN>
 
173
 
 
174
<P>
 
175
The caller was connected to an agent.  Hold time represents the amount
 
176
of time the caller was on hold. The bridged channel unique ID contains
 
177
the unique ID of the queue member channel that is taking the call. This
 
178
is useful when trying to link recording filenames to a particular
 
179
call in the queue. Ringtime represents the time the queue members phone
 
180
was ringing prior to being answered.
 
181
 
 
182
<P>
 
183
<SPAN  CLASS="textbf">ENTERQUEUE(url<SPAN CLASS="MATH"><IMG
 
184
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
185
 SRC="img8.png"
 
186
 ALT="$\vert$"></SPAN>callerid)</SPAN>
 
187
 
 
188
<P>
 
189
A call has entered the queue.  URL (if specified) and Caller*ID are placed
 
190
in the log.
 
191
 
 
192
<P>
 
193
<SPAN  CLASS="textbf">EXITEMPTY(position<SPAN CLASS="MATH"><IMG
 
194
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
195
 SRC="img8.png"
 
196
 ALT="$\vert$"></SPAN>origposition<SPAN CLASS="MATH"><IMG
 
197
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
198
 SRC="img8.png"
 
199
 ALT="$\vert$"></SPAN>waittime)</SPAN>
 
200
 
 
201
<P>
 
202
The caller was exited from the queue forcefully because the queue had no
 
203
reachable members and it's configured to do that to callers when there
 
204
are no reachable members. The position is the caller's position in the
 
205
queue when they hungup, the origposition is the original position the
 
206
caller was when they first entered the queue, and the waittime is how
 
207
long the call had been waiting in the queue at the time of disconnect.
 
208
 
 
209
<P>
 
210
<SPAN  CLASS="textbf">EXITWITHKEY(key<SPAN CLASS="MATH"><IMG
 
211
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
212
 SRC="img8.png"
 
213
 ALT="$\vert$"></SPAN>position<SPAN CLASS="MATH"><IMG
 
214
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
215
 SRC="img8.png"
 
216
 ALT="$\vert$"></SPAN>origposition<SPAN CLASS="MATH"><IMG
 
217
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
218
 SRC="img8.png"
 
219
 ALT="$\vert$"></SPAN>waittime)</SPAN>
 
220
 
 
221
<P>
 
222
The caller elected to use a menu key to exit the queue.  The key and
 
223
the caller's position in the queue are recorded.  The caller's entry
 
224
position and amoutn of time waited is also recorded.
 
225
 
 
226
<P>
 
227
<SPAN  CLASS="textbf">EXITWITHTIMEOUT(position<SPAN CLASS="MATH"><IMG
 
228
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
229
 SRC="img8.png"
 
230
 ALT="$\vert$"></SPAN>origposition<SPAN CLASS="MATH"><IMG
 
231
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
232
 SRC="img8.png"
 
233
 ALT="$\vert$"></SPAN>waittime)</SPAN>
 
234
 
 
235
<P>
 
236
The caller was on hold too long and the timeout expired.  The position in the
 
237
queue when the timeout occurred, the entry position, and the amount of time
 
238
waited are logged.
 
239
 
 
240
<P>
 
241
<SPAN  CLASS="textbf">QUEUESTART</SPAN>
 
242
 
 
243
<P>
 
244
The queueing system has been started for the first time this session.
 
245
 
 
246
<P>
 
247
<SPAN  CLASS="textbf">RINGNOANSWER(ringtime)</SPAN>
 
248
 
 
249
<P>
 
250
After trying for ringtime ms to connect to the available queue member,
 
251
the attempt ended without the member picking up the call. Bad queue
 
252
member!
 
253
 
 
254
<P>
 
255
<SPAN  CLASS="textbf">SYSCOMPAT</SPAN>
 
256
 
 
257
<P>
 
258
A call was answered by an agent, but the call was dropped because the
 
259
channels were not compatible.
 
260
 
 
261
<P>
 
262
<SPAN  CLASS="textbf">TRANSFER(extension<SPAN CLASS="MATH"><IMG
 
263
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
264
 SRC="img8.png"
 
265
 ALT="$\vert$"></SPAN>context<SPAN CLASS="MATH"><IMG
 
266
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
267
 SRC="img8.png"
 
268
 ALT="$\vert$"></SPAN>holdtime<SPAN CLASS="MATH"><IMG
 
269
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
270
 SRC="img8.png"
 
271
 ALT="$\vert$"></SPAN>calltime<SPAN CLASS="MATH"><IMG
 
272
 WIDTH="10" HEIGHT="37" ALIGN="MIDDLE" BORDER="0"
 
273
 SRC="img8.png"
 
274
 ALT="$\vert$"></SPAN>origposition)</SPAN>
 
275
 
 
276
<P>
 
277
Caller was transferred to a different extension.  Context and extension
 
278
are recorded. The caller's hold time and the length of the call are both
 
279
recorded, as is the caller's entry position at the time of the transfer.
 
280
PLEASE remember that transfers performed by SIP UA's by way of a reinvite
 
281
may not always be caught by Asterisk and trigger off this event. The only
 
282
way to be 100% sure that you will get this event when a transfer is
 
283
performed by a queue member is to use the built-in transfer functionality
 
284
of Asterisk.
 
285
 
 
286
<P>
 
287
 
 
288
<DIV CLASS="navigation"><HR>
 
289
<!--Navigation Panel-->
 
290
<A NAME="tex2html4201"
 
291
  HREF="node272.html">
 
292
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
 
293
 SRC="/usr/share/latex2html/icons/next.png"></A> 
 
294
<A NAME="tex2html4197"
 
295
  HREF="node259.html">
 
296
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
 
297
 SRC="/usr/share/latex2html/icons/up.png"></A> 
 
298
<A NAME="tex2html4193"
 
299
  HREF="node270.html">
 
300
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
 
301
 SRC="/usr/share/latex2html/icons/prev.png"></A> 
 
302
<A NAME="tex2html4199"
 
303
  HREF="node1.html">
 
304
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents"
 
305
 SRC="/usr/share/latex2html/icons/contents.png"></A>  
 
306
<BR>
 
307
<B> Next:</B> <A NAME="tex2html4202"
 
308
  HREF="node272.html">Phone Provisioning</A>
 
309
<B> Up:</B> <A NAME="tex2html4198"
 
310
  HREF="node259.html">Queues</A>
 
311
<B> Previous:</B> <A NAME="tex2html4194"
 
312
  HREF="node270.html">Caveats</A>
 
313
 &nbsp; <B>  <A NAME="tex2html4200"
 
314
  HREF="node1.html">Contents</A></B> </DIV>
 
315
<!--End of Navigation Panel-->
94
316
<ADDRESS>
95
317
lmadsen
96
 
2010-05-03
 
318
2010-06-17
97
319
</ADDRESS>
98
320
</BODY>
99
321
</HTML>