Astsee
A [fun] pbx usage auditing tool
Screenshots (click for bigger)
version 0.1 |
version 0.4 |
Overview
Astsee is a fun, graphical way to see what's going on in your asterisk server. Upon first startup the layout is
empty, but it connects to your asterisk server's manager interface to receive notifications of new channels and links.
As channels are detected, they are added to the layout. As links are made and broken, animated lightning graphically
shows the bridge between the pertinent channels.
This is pre-release software. Proceed at your own risk. Don't hurt your goldfish. If you do, I'm not replacing it.
What works:
- SIP, Zap, and IAX[2] channels are added to the layout when asterisk mentions them
- Bridges between channels are drawn graphically
- Nodes are arranged prettily in a circle (But press 'R' to randomize their positions)
- The CallerID info is available by hovering the mouse over the nodes
- Transferring a call seems to mostly work, including parking a call and retrieving it from the same or any other location.
What doesn't work but I would like to implement eventually:
- You can't delete nodes from the layout
- You can't specify a filter of techs/channels to ignore
- Meetme rooms aren't handled, but create superfluous node "Zap/pseudo"
- Echo chamber results in a superfluous node with tech "SIP" and channel "SIP"
- You can't destroy bridges (drop the call)
- You can't drag and drop the terminii of the bridges to transfer a call
- You can't disable animations for slower computers
- Various media players and resource-intensive virtual guests cause Astsee to behave at a snail's pace
- You can't configure the colors or graphics (you can replace the 64x64 node_gfx.tga with your own if you want)
- If you mis-specify the manager username/secret, Astsee will simply crash :(
- Nodes exist in perpetuity once detected. I would like to option for them to time out after a set time, or at least fade away a bit
- The mouse leaves droppings
- This one is my favorite. I'll surprise you later. I'm really excited about it. Traces of this hint can be found in version 0.5!
Again, ALPHA software. It runs in windowed mode, 800x600, 16bpp. It requires socat. 'apt-get install socat' for that,
if on ubuntu or debian. If not on ubuntu, or these instructions don't work for your debianish distribution, you can try
socat. I linked in static versions of allegro into my binaries
so you wouldn't have to have allegro even installed.
Download
• Linux i386 ELF binary version 0.5 - NEW! The not-afraid-to-show-your-dad version! But can you find the secret? astsee-0.5.tgz
• Linux i386 ELF binary version 0.4 - Things kinda work! astsee-0.4.tgz
• Linux i386 ELF binary version 0.2 - Shoddy mouse support! astsee-0.2.tgz
• Linux i386 ELF binary version 0.1 - astsee-0.1.tgz
• Source now available. Innovate! Source code packages
If it doesn't run on your machine, tell me what it DOES do and I'll see if I can make it work for you.
• Sorry, a Windows version is not possible right now because I can't find socat available for Windows.
Usage
$ ./astsee host/ip port username secret
Example:
$ ./astsee 10.0.0.252 5038 mojo *****
Of course, this is the manager username/secret configured in asterisk's manager.conf.