Merged revisions 378374,378377,378384 via svnmerge from
[asterisk/asterisk.git] / configs / cel.conf.sample
1 ;
2 ; Asterisk Channel Event Logging (CEL)
3 ;
4
5 ; Channel Event Logging is a mechanism to provide fine-grained event information
6 ; that can be used to generate billing information. Such event information can
7 ; be recorded to various backend modules.
8 ;
9
10 [general]
11
12 ; CEL Activation
13 ;
14 ; Use the 'enable' keyword to turn CEL on or off.
15 ;
16 ; Accepted values: yes and no
17 ; Default value:   no
18
19 ;enable=yes
20
21 ; Application Tracking
22 ;
23 ; Use the 'apps' keyword to specify the list of applications for which you want
24 ; to receive CEL events.  This is a comma separated list of Asterisk dialplan
25 ; applications, such as Dial, Queue, and Park.
26 ;
27 ; Accepted values: A comma separated list of Asterisk dialplan applications
28 ; Default value:   none
29 ;
30 ; Note: You may also use 'all' which will result in CEL events being reported
31 ;       for all Asterisk applications.  This may affect Asterisk's performance
32 ;       significantly.
33
34 apps=dial,park
35
36 ; Event Tracking
37 ;
38 ; Use the 'events' keyword to specify the list of events which you want to be
39 ; raised when they occur.  This is a comma separated list of the values in the
40 ; table below.
41 ;
42 ; Accepted values: A comma separated list of one or more of the following:
43 ;  ALL              -- Generate entries on all events
44 ;  CHAN_START       -- The time a channel was created
45 ;  CHAN_END         -- The time a channel was terminated
46 ;  ANSWER           -- The time a channel was answered (ie, phone taken off-hook)
47 ;  HANGUP           -- The time at which a hangup occurred
48 ;  CONF_ENTER       -- The time a channel was connected into a conference room
49 ;  CONF_EXIT        -- The time a channel was removed from a conference room
50 ;  CONF_START       -- The time the first person enters a conference room
51 ;  CONF_END         -- The time the last person left a conference room (and
52 ;                      turned out the lights?)
53 ;  APP_START        -- The time a tracked application was started
54 ;  APP_END          -- the time a tracked application ended
55 ;  PARK_START       -- The time a call was parked
56 ;  PARK_END         -- Unpark event
57 ;  BRIDGE_START     -- The time a bridge is started
58 ;  BRIDGE_END       -- The time a bridge is ended
59 ;  BRIDGE_UPDATE    -- This is a replacement channel (Masquerade)
60 ;  3WAY_START       -- When a 3-way conference starts (usually via attended transfer)
61 ;  3WAY_END         -- When one or all exit a 3-way conference
62 ;  BLINDTRANSFER    -- When a blind transfer is initiated
63 ;  ATTENDEDTRANSFER -- When an attended transfer is initiated
64 ;  TRANSFER         -- Generic transfer initiated; not used yet...?
65 ;  PICKUP           -- This channel picked up the peer channel
66 ;  FORWARD          -- This channel is being forwarded somewhere else
67 ;  HOOKFLASH        -- So far, when a hookflash event occurs on a DAHDI
68 ;                      interface
69 ;  LINKEDID_END     -- The last channel with the given linkedid is retired
70 ;  USER_DEFINED     -- Triggered from the dialplan, and has a name given by the
71 ;                      user
72 ;
73 ; Default value: none
74 ;                (Track no events)
75
76 events=APP_START,CHAN_START,CHAN_END,ANSWER,HANGUP,BRIDGE_START,BRIDGE_END
77
78 ; Date Format
79 ;
80 ; Use the 'dateformat' keyword to specify the date format used when CEL events
81 ; are raised.
82 ;
83 ; Accepted values: A strftime format string (see man strftime)
84 ;
85 ; Example: "%F %T"
86 ;  -> This gives the date and time in the format "2009-06-23 17:02:35"
87 ;
88 ; If this option is not specified, the default format is "<seconds>.<microseconds>"
89 ; since epoch.  The microseconds field will always be 6 digits in length, meaning it
90 ; may have leading zeros.
91 ;
92 ;dateformat = %F %T
93
94 ;
95 ; Asterisk Manager Interface (AMI) CEL Backend
96 ;
97 [manager]
98
99 ; AMI Backend Activation
100 ;
101 ; Use the 'enable' keyword to turn CEL logging to the Asterisk Manager Interface
102 ; on or off.
103 ;
104 ; Accepted values: yes and no
105 ; Default value:   no
106 ;enabled=yes
107
108 ; Use 'show_user_defined' to put "USER_DEFINED" in the EventName header,
109 ; instead of (by default) just putting the user defined event name there.
110 ; When enabled the UserDefType header is added for user defined events to
111 ; provide the user defined event name.
112 ;
113 ;show_user_defined=yes
114
115 ;
116 ; RADIUS CEL Backend 
117 ;
118 [radius]
119 ;
120 ; Log date/time in GMT
121 ;usegmtime=yes
122 ;
123 ; Set this to the location of the radiusclient-ng configuration file
124 ; The default is /etc/radiusclient-ng/radiusclient.conf
125 ;radiuscfg => /usr/local/etc/radiusclient-ng/radiusclient.conf
126 ;