AsterTrace

Introduction

This was intended as an example of use mixing Ding and PAMI. However, it might be useful as a tool to help you monitor/debug your asterisk installation, so I'm making it freely available.

See this article for more information: http://marcelog.github.com/articles/php_asterisk_listener_example_using_pami_and_ding.html

AsterTrace is extendable via "listeners". Currently these listeners exist:

• dial
• event
• dtmf
• varset
• newchannel
• newstate
• newexten

So currently, AsterTrace can monitor:

• All events (event-listener)
• Call activity (CDR like) (dial-listener)
• DTMF's pressed (dtmf-listener)
• VarSet's (varset-listener)
• Newchannel (newchannel-listener)
• Newstate (newstate-listener)
• Newexten (newexten-listener)

Each listener is autosufficient, and get called by the container (Ding) whenever an interesting event occurs. Ding will get called by the pami helper, whenever AMI reports an event. This event will then get dispatched to the listeners by ding.

TCP Server

AsterTrace uses the Ding TCPServerHelper to start a tcp server. This server allows you to connect and issue commands, also you can listen for events. The events and responses to the actions sent are serialized with json :) You can try it via telnet.

REST interface

Also, a rest interface is available, so you can make it publicly available through a webserver. This rest interface will let you get events from ami in a json format. Ideal for COMET/Long polling.

Requirements

• PHP 5.3+
• Ding 0.98+ (http://marcelog.github.com/Ding)
• PAMI 1.27+ (http://marcelog.github.com/PAMI)
• mysql server
• log4php (optional)
• pdo-mysql

Configuration

Assuming you are inside the root directory of the source (thus, having ./conf and ./src)

1.- Copy/Rename the file: conf/log4php.properties.example to log4php.properties. Edit it. 2.- Copy/Rename the file: conf/log4php.properties.example to log4php-rest.properties. Edit it. 3.- Copy/Rename the file: conf/mysql.properties.example to mysql.properties. Edit it. The only thing you need from mysql, is to have the database created (nothing else, no tables, AsterTrace will create them on demand). 4.- Copy/Rename the file: conf/php.properties.example to php.properties. Edit it. You can have your own php settings here. 5.- Copy/Rename the file: conf/astertrace.properties.example to astertrace.properties. Edit it. 6.- Copy/Rename the file: conf/server.properties.example to server.properties. Edit it. 7.- Run astertrace, like "php src/mg/AsterTrace/bin/astertrace.php ./conf"

Thanks to

• Joshua Elson for his help in trying and debugging in loaded asterisk servers.