<html>
<head>
    <base href="https://wiki.asterisk.org/wiki">
            <link rel="stylesheet" href="/wiki/s/en/2171/18/9/_/styles/combined.css?spaceKey=AST&amp;forWysiwyg=true" type="text/css">
    </head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
    <h2><a href="https://wiki.asterisk.org/wiki/display/AST/CEL+Events+and+Fields">CEL Events and Fields</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://wiki.asterisk.org/wiki/display/~rmudgett">Richard Mudgett</a>
    </h4>
        <div id="versionComment">
        <b>Comment:</b>
        Updated to add missing CEL events.<br />
    </div>
        <br/>
                         <h4>Changes (12)</h4>
                                 
    
<div id="page-diffs">
                    <table class="diff" cellpadding="0" cellspacing="0">
    
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >|CHAN_START|The time a channel was created| <br>|CHAN_END|The time a channel was terminated| <br></td></tr>
            <tr><td class="diff-changed-lines" >|ANSWER|The time a channel was answered (ie, phone taken <span class="diff-changed-words">off-hook<span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">, etc</span>)|</span> <br></td></tr>
            <tr><td class="diff-changed-lines" >|HANGUP|The time at which a hangup <span class="diff-changed-words">occurred<span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">.</span>|</span> <br></td></tr>
            <tr><td class="diff-unchanged" >|CONF_ENTER|The time a channel was connected into a conference room| <br>|CONF_EXIT|The time a channel was removed from a conference room| <br></td></tr>
            <tr><td class="diff-changed-lines" >|CONF_START|The time the first person enters a <span class="diff-changed-words">conference<span class="diff-added-chars"style="background-color: #dfd;"> room</span>|</span> <br></td></tr>
            <tr><td class="diff-changed-lines" >|CONF_END|The time the last person left a <span class="diff-changed-words">conf<span class="diff-added-chars"style="background-color: #dfd;">erence room</span></span> (and turned out the lights?)| <br></td></tr>
            <tr><td class="diff-unchanged" >|APP_START|The time a tracked application was started| <br>|APP_END|the time a tracked application ended| <br>|PARK_START|The time a call was parked| <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-changed-words">|PARK_END|<span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">u</span><span class="diff-added-chars"style="background-color: #dfd;">U</span>npark</span> event| <br></td></tr>
            <tr><td class="diff-unchanged" >|BRIDGE_START|The time a bridge is started| <br>|BRIDGE_END|The time a bridge is ended| <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">|BRIDGE_UPDATE|This is a replacement channel (Masquerade)| <br></td></tr>
            <tr><td class="diff-changed-lines" >|3WAY_START|When a 3-way <span class="diff-changed-words">conf<span class="diff-added-chars"style="background-color: #dfd;">erence</span></span> starts (usually via attended <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">xfer)|</span> <span class="diff-added-words"style="background-color: #dfd;">transfer)|</span> <br></td></tr>
            <tr><td class="diff-changed-lines" >|3WAY_END|When one or all exit a 3-way <span class="diff-changed-words">conf<span class="diff-added-chars"style="background-color: #dfd;">erence</span>|</span> <br></td></tr>
            <tr><td class="diff-unchanged" >|BLINDTRANSFER|When a blind transfer is initiated| <br>|ATTENDEDTRANSFER|When an attended transfer is initiated| <br>|TRANSFER|Generic transfer initiated; not used yet...?| <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">|PICKUP|This channel picked up the peer channel| <br>|FORWARD|This channel is being forwarded somewhere else| <br></td></tr>
            <tr><td class="diff-changed-lines" >|HOOKFLASH|So far, when a hookflash event occurs on a <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">Zap</span> <span class="diff-added-words"style="background-color: #dfd;">DAHDI</span> interface| <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">|USER_DEFINED|these are triggered from the dialplan, and have a name given by the user.| <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">|LINKEDID_END|The last channel with the given linkedid is retired| <br>|USER_DEFINED|Triggered from the dialplan, and has a name given by the user| <br></td></tr>
            <tr><td class="diff-unchanged" > <br>h5. Table of CEL Event Fields <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
    
            </table>
    </div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <p>While CDRs and the Manager are basically both event tracking mechanisms, CEL tries to track only those events that might pertain to billing issues. </p>

<h5><a name="CELEventsandFields-TableofCELEvents"></a>Table of CEL Events</h5>

<div class='table-wrap'>
<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'>Event</th>
<th class='confluenceTh'>Description</th>
</tr>
<tr>
<td class='confluenceTd'>CHAN_START</td>
<td class='confluenceTd'>The time a channel was created</td>
</tr>
<tr>
<td class='confluenceTd'>CHAN_END</td>
<td class='confluenceTd'>The time a channel was terminated</td>
</tr>
<tr>
<td class='confluenceTd'>ANSWER</td>
<td class='confluenceTd'>The time a channel was answered (ie, phone taken off-hook)</td>
</tr>
<tr>
<td class='confluenceTd'>HANGUP</td>
<td class='confluenceTd'>The time at which a hangup occurred</td>
</tr>
<tr>
<td class='confluenceTd'>CONF_ENTER</td>
<td class='confluenceTd'>The time a channel was connected into a conference room</td>
</tr>
<tr>
<td class='confluenceTd'>CONF_EXIT</td>
<td class='confluenceTd'>The time a channel was removed from a conference room</td>
</tr>
<tr>
<td class='confluenceTd'>CONF_START</td>
<td class='confluenceTd'>The time the first person enters a conference room</td>
</tr>
<tr>
<td class='confluenceTd'>CONF_END</td>
<td class='confluenceTd'>The time the last person left a conference room (and turned out the lights?)</td>
</tr>
<tr>
<td class='confluenceTd'>APP_START</td>
<td class='confluenceTd'>The time a tracked application was started</td>
</tr>
<tr>
<td class='confluenceTd'>APP_END</td>
<td class='confluenceTd'>the time a tracked application ended</td>
</tr>
<tr>
<td class='confluenceTd'>PARK_START</td>
<td class='confluenceTd'>The time a call was parked</td>
</tr>
<tr>
<td class='confluenceTd'>PARK_END</td>
<td class='confluenceTd'>Unpark event</td>
</tr>
<tr>
<td class='confluenceTd'>BRIDGE_START</td>
<td class='confluenceTd'>The time a bridge is started</td>
</tr>
<tr>
<td class='confluenceTd'>BRIDGE_END</td>
<td class='confluenceTd'>The time a bridge is ended</td>
</tr>
<tr>
<td class='confluenceTd'>BRIDGE_UPDATE</td>
<td class='confluenceTd'>This is a replacement channel (Masquerade)</td>
</tr>
<tr>
<td class='confluenceTd'>3WAY_START</td>
<td class='confluenceTd'>When a 3-way conference starts (usually via attended transfer)</td>
</tr>
<tr>
<td class='confluenceTd'>3WAY_END</td>
<td class='confluenceTd'>When one or all exit a 3-way conference</td>
</tr>
<tr>
<td class='confluenceTd'>BLINDTRANSFER</td>
<td class='confluenceTd'>When a blind transfer is initiated</td>
</tr>
<tr>
<td class='confluenceTd'>ATTENDEDTRANSFER</td>
<td class='confluenceTd'>When an attended transfer is initiated</td>
</tr>
<tr>
<td class='confluenceTd'>TRANSFER</td>
<td class='confluenceTd'>Generic transfer initiated; not used yet...?</td>
</tr>
<tr>
<td class='confluenceTd'>PICKUP</td>
<td class='confluenceTd'>This channel picked up the peer channel</td>
</tr>
<tr>
<td class='confluenceTd'>FORWARD</td>
<td class='confluenceTd'>This channel is being forwarded somewhere else</td>
</tr>
<tr>
<td class='confluenceTd'>HOOKFLASH</td>
<td class='confluenceTd'>So far, when a hookflash event occurs on a DAHDI interface</td>
</tr>
<tr>
<td class='confluenceTd'>LINKEDID_END</td>
<td class='confluenceTd'>The last channel with the given linkedid is retired</td>
</tr>
<tr>
<td class='confluenceTd'>USER_DEFINED</td>
<td class='confluenceTd'>Triggered from the dialplan, and has a name given by the user</td>
</tr>
</tbody></table>
</div>


<h5><a name="CELEventsandFields-TableofCELEventFields"></a>Table of CEL Event Fields</h5>


<p>Table 11.2: List of CEL Event Fields</p>
<div class='table-wrap'>
<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'>Field</th>
<th class='confluenceTh'>Description</th>
</tr>
<tr>
<td class='confluenceTd'>eventtype</td>
<td class='confluenceTd'>The name of the event; see the above list; each is prefixed with "EV_".</td>
</tr>
<tr>
<td class='confluenceTd'>eventtime</td>
<td class='confluenceTd'>The time the event happened</td>
</tr>
<tr>
<td class='confluenceTd'>cidname</td>
<td class='confluenceTd'>CID name field</td>
</tr>
<tr>
<td class='confluenceTd'>cidnum</td>
<td class='confluenceTd'>CID number field</td>
</tr>
<tr>
<td class='confluenceTd'>cidani</td>
<td class='confluenceTd'>CID ANI field</td>
</tr>
<tr>
<td class='confluenceTd'>cidrdnis</td>
<td class='confluenceTd'>CID RDNIS field</td>
</tr>
<tr>
<td class='confluenceTd'>ciddnid</td>
<td class='confluenceTd'>CID DNID field</td>
</tr>
<tr>
<td class='confluenceTd'>exten</td>
<td class='confluenceTd'>The extension in the dialplan</td>
</tr>
<tr>
<td class='confluenceTd'>context</td>
<td class='confluenceTd'>The context in the dialplan</td>
</tr>
<tr>
<td class='confluenceTd'>channame</td>
<td class='confluenceTd'>The name assigned to the channel in which the event took place</td>
</tr>
<tr>
<td class='confluenceTd'>appname</td>
<td class='confluenceTd'>The name of the current application</td>
</tr>
<tr>
<td class='confluenceTd'>appdata</td>
<td class='confluenceTd'>The arguments that will be handed to that application</td>
</tr>
<tr>
<td class='confluenceTd'>amaflags</td>
<td class='confluenceTd'>The AMA flags associated with the event; user assignable.</td>
</tr>
<tr>
<td class='confluenceTd'>accountcode</td>
<td class='confluenceTd'>A user assigned datum (string)</td>
</tr>
<tr>
<td class='confluenceTd'>uniqueid</td>
<td class='confluenceTd'>Each Channel instance gets a unique ID associated with it.</td>
</tr>
<tr>
<td class='confluenceTd'>userfield</td>
<td class='confluenceTd'>A user assigned datum (string)</td>
</tr>
<tr>
<td class='confluenceTd'>linkedid</td>
<td class='confluenceTd'>the per-call id, spans several events, possibly.</td>
</tr>
<tr>
<td class='confluenceTd'>peer</td>
<td class='confluenceTd'>For bridge or other 2-channel events, this would be the other channel name</td>
</tr>
</tbody></table>
</div>

    </div>
        <div id="commentsSection" class="wiki-content pageSection">
        <div style="float: right;" class="grey">
                        <a href="https://wiki.asterisk.org/wiki/users/removespacenotification.action?spaceKey=AST">Stop watching space</a>
            <span style="padding: 0px 5px;">|</span>
                <a href="https://wiki.asterisk.org/wiki/users/editmyemailsettings.action">Change email notification preferences</a>
</div>
        <a href="https://wiki.asterisk.org/wiki/display/AST/CEL+Events+and+Fields">View Online</a>
        |
        <a href="https://wiki.asterisk.org/wiki/pages/diffpagesbyversion.action?pageId=5242937&revisedVersion=3&originalVersion=2">View Changes</a>
                |
        <a href="https://wiki.asterisk.org/wiki/display/AST/CEL+Events+and+Fields?showComments=true&amp;showCommentArea=true#addcomment">Add Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>