Overview

Settings window is used to configure SAM Reports.

There you can:

Settings Window

There are four main areas:

  • common options
  • project actions and options
  • project list
  • display area


SAM Reports 2 Settings - Main Window

SAM Reports 2 Settings - Main Window


Project Settings

There are five main areas of project settings:


SAM Reports 2 - Settings - Asterisk Project Settings

SAM Reports 2 - Settings - Asterisk Project Settings


On the image above you see the five main parts tabs that appear on the bottom of each project window. Below I will describe each one.

But first, let’s take a look at a video describing adding a new project and processing data:

Asterisk Project Settings

On this page you enter the information related to connecting to your Asterisk server.


SAM Reports 2 - Asterisk Project Settings

SAM Reports 2 - Asterisk Project Settings


Single Log Files Settings

If you use single log files, that are placed in default location, then you don’t need to edit anything on this page. Same goes if your Asterisk installation rotates log files. Then you would go to the “Multiple Log Files” page.


SAM Reports 2 - Settings - Asterisk Single Log Files

SAM Reports 2 - Settings - Asterisk Single Log Files


Multiple Log Files Settings

Multiple Log Files let you define the rules that explain to SAM Reports 2 how  your sliced Asterisk log files get rotated. That is necessary for the Transfer or Import to work properly. This is only needed if you don’t have a single log files configuration on your Asterisk PBX.


SAM Reports 2 - Asterisk Rotated Log Files Settings

SAM Reports 2 - Asterisk Rotated Log Files Settings


Transfer Settings

Here you can define the SFTP connection settings for your project’s Asterisk machine.

SAM Reports 2 Asterisk Transfer Settings
SAM Reports 2 Asterisk Transfer Settings

Manager Settings

Those settings let you define local codes and prefixes. PBX prefix is important so that phone numbers may be identified correctly.


SAM Reports 2 Asterisk Prefix Settings

SAM Reports 2 Asterisk Prefix Settings


Project Rules

Project rules commands let you see the raw log files of the current project (only in Enterprise Edition), also set the rules for processing log files, and view last parsed results.


SAM Reports 2 Asterisk Project Rules

SAM Reports 2 Asterisk Project Rules


Log Files Viewer

Log Files Viewer is an application that comes only in the Enterprise Edition of SAM Reports 2. It let’s you view and inspect your project’s raw log files, as created by the Asterisk PBX.

The purpose of Log Files Viewer is to construct ignore rules and agent rules for your project, which is only possible if you can examine the raw log files.


SAM Reports 2 Log Files Viewer

SAM Reports 2 Log Files Viewer


Agent Rules

If an agent’s extension is contained within it’s name, than you can define the rules explaining how that extension can be recognized and extracted.


SAM Reports 2 Asterisk Agents Parsing Rules

SAM Reports 2 Asterisk Agents Parsing Rules


Ignore Rules

Ignore rules let you ignore some lines from CDR and queue log files. You may have such needs if your CDR log file has many unnecessary log lines, not to crowd your report with redundant data. Or maybe there are some privacy issues involved.


SAM Reports 2 - Ignore Rules for Parsing Asterisk Log Files

SAM Reports 2 - Ignore Rules for Parsing Asterisk Log Files


Last Parse Results

This command shows you a window with animated report displaying the project’s last parsing flow. You can see more information here.

Common Settings

Common settings inform you about SAM Reports2 application installation directory and the data directory.

You can also change the skin with common settings


SAM Reports 2 Settings - Common

SAM Reports 2 Settings - Common


.

Clicky Web Analytics