Page tree
Skip to end of metadata
Go to start of metadata

Introduction

In order to be helpful we require data. The data needs to be balanced between useful and concise. Too much useless information can be as bad as no information at all. This guide aims to provide information that will allow users to provide useful  and concise information. Please note your log locations may vary based on your distribution of choice

Where is the information at

Log files

Much of the information we need will be contained within various log files. Note that logs may be rotated out so file names may be followed by a dash(-) or a dot(.) with a number such as the date.

Some of these logs may depend on your version and log configuration

LogDescription
/var/log/asterisk/fullAll log levels dump here. Usually this is the log you will look at for old call traces
/var/log/asterisk/fail2banFail2ban log
/var/log/asterisk/freepbx.logMessages put out by FreePBX modules
/var/log/asterisk/freepbx_security.logFreePBX Security events
/var/log/httpd/access_logApache Access logs.
/var/log/httpd/error_logApache Error logs

/var/log/messages

Linux system log
/var/log/dmesgKernel level messages
/var/log/yum.logPackage activities processed through yum.

Filtering the Data

Some of these log files will have thousands of lines of data.  People are more likely to look at 50 log lines than they are to look at 500. If we can reduce the output we should.

 

NOTE THAT EVERYONE WHO MAY SEE INFORMATION YOU POST PUBLICLY IS NOT YOUR FRIEND. BE SURE TO REMOVE ANY PRIVATE AND IDENTIFIABLE INFORMATION INCLUDING BUT NOT LIMITED TO:

  • Passwords
  • Phone numbers
  • Public IP addresses
  • Extension numbers

It may still be desirable to differentiate the information so you should replace this information with something unique to the item. See the following example

ORIGINALREPLACEMENT
[email protected]$$w0rdPASSWORD
203.0.113.1
AAA.A.AAA.A
203.0.113.12
BBB.B.BBB.BB
2013NNNN
2014OOOO
6025551212

PPPPPPPPPP

9285551212QQQQQQQQQQ

Grep

Typically to filter we use grep. With grep we can search for strings or patterns.

Finding all lines that have 1234 in the full log
grep 1234 /var/log/asterisk/full

 

Overview

The Support page in System Admin helps you prepare for receiving technical support related to your system. You can quickly and easily set up SSH keys that will give Sangoma support staff access to your server, and you can remove those keys when you no longer need them. You can also download system information files (log dumps) that you can give to the support team.

For more information on paid support options, please see these wikis:

 

Logging In

  • On the top menu click Admin
  • In the drop-down menu click System Admin
  • In the menu at the right, click Support

Support Files

This section of the module lets you download a ZIP file containing system information for Sangoma support staff.

  1. Use the Yes/No toggle buttons to select which items to include in your report. Make your selections according to what has been requested by support staff. If no specific selections have been requested, you can leave everything set to default. The defaults are shown above.
    1. FreePBX Versions: A list of all modules installed, and their versions
    2. System Information: Operating system information
    3. Asterisk Logs: The last 24 hours of Asterisk logs
    4. Firewall Settings: Current ip-tables save output
    5. ASTDB Dump: Complete ASTDB dump (not MySQL)
    6. License Information: License information and status of this server
    7. Dialplan: Complete dialplan as generated by FreePBX (including _custom files)
    8. SIP Settings: SIP configuration settings. Will contain secret information.
    9. PJSIP Settings: PJSIP configuration settings. Will contain secret information.
    10. IAX Settings: IAX configuration settings. Will contain secret information. 
  2. After you've made your selections, click the Download button to save the ZIP file to your computer.


 

  • No labels