Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The information contained in each of these modules is mostly self-explanatory.

Asterisk Info Module

The Asterisk Info Module gives you detailed information that can be obtained directly from Asterisk.  Without this Module, you could obtain the same information from the Asterisk Command Line Interface ("CLI").

When you first enter the Module, you'll be at the Summary page.  

There are a number of different reports that can be accessed by clicking on the right-hand side of the screen.  

The "Full Report" option gives you a single screen showing every report available.  

These reports are often useful when troubleshooting issues with Trunks and Extensions.

Asterisk Logfiles

The Asterisk Logfiles Module is an easy way to view portions of the Asterisk Log.  However, this Module is only useful when you want to view a very recent event in the Asterisk Log.  

For a more detailed view of your Asterisk Logfiles, access the command prompt of the machine that you installed Asterisk on.  You can do so by physically accessing the machine, or by using an SSH client to access the command prompt from another machine.  If you are using a Windows machine, you can use a free program called Putty to access the command prompt.  You can download Putty here.

After you log-in, you can access the logfiles by typing:

cd /var/log/asterisk

at the command prompt.

To see a list of the logfiles, type:

ls

at the command prompt.

Typically, today's logfile is called "full" and logfiles from prior days are named "full.xxx" or full-xxx", where xxx is a number of some kind.

If you want to view and search today's logfiles in a text editor, type:

nano full

at the command prompt.  This will open up the logfile in a text editor called "nano."  You can then page up or down, and use CTRL-W to search the Logfile.  When you're done, hit CTRL-X to exit.

Note:  If you inadvertently save the Logfile, Asterisk may stop logging for the day.  If you do so, you can reset Asterisk and FreePBX by typing:

amportal restart

Note:  This command will wait up to 120 seconds for all calls to end.  If the calls have not ended within 120 seconds, they will be terminated.  You can change the amount of time that the system will wait before terminating the calls in the Advanced Settings Module.

If you want to open a prior day's logfiles, replace the word "full" in the example above with the name of the file.  

Another way to easily view logfile information is to use the Linux grep command.  For example, to view a list of all the entries in today's logfile indicating that Trunk is lagged, you could type:

grep "Lagged" full

at the command prompt.  

Note:  the grep command is case sensitive.  So, "Lagged" will not pull up entries that say "lagged" or "LAGGED".  Also, as above, if you want to view prior day's logfiles, replace full with the name of the logfile.

If the results are too long, you can use grep to put the "Lagged" entries in a new file that you can then view in nano.  For example, to move all entries in today's logfile that contain "Lagged" into a file called tempfile, type:

grep "Lagged" full > tempfile

at the command prompt.  Then type:

nano tempfile

to view them in nano, type:

nano tempfile

When you're done in nano, you can delete the tempfile by typing:

rm tempfile

CDR Reports ("Call Detail Reports")

The CDR Reports Module allows you to view a report showing the telephone calls made from and received to your system.  You can choose to view a complete history or calls, or to search by date, date range, number called, caller ID, etc.  The CDR Reports Module includes tooltips that help to explain what the options means.

FreePBX Administration

The FreePBX Administration Module shows a variety of statistical information about your system, such as

  • How many calls are active 
  • How many trunks are active
  • The CPU/Memory/Disk/Network usage
  • The status of your Asterisk/Apache (web)/MySQL (database)/SSH servers
  • System uptime

Most of the information on this report is self-explanatory.  

Note, however, that network usages is reported in KiloBYTES, and not Kilobits.  1 KiloBYTE is equal to 8 Kilobits.  So, if you see that your system is receiving 25 KB/s, that is the same is 200 Kb/s.

PHP Info

This Module will give you details about PHP.

Print Extensions

The Print Extensions Module is a useful tool that allows you to print a list of all numbers that can be dialed from or to your system, and where callers who dial them will end up.

The Module begins by showing you the Inbound Routes, which are numbers that outside callers (any caller coming into a trunk that uses context=from-trunk) can dial, and where those calls will be routed.

The remaining information listed are phone numbers that can be dialed by internal callers (any caller that uses a context=from-internal, including your Extensions).

Weak Password Detection

This module will alert you if anyone is using a weak password.

more information on a particular Reports Module, select the Module from the list to the left.