Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

There are several kind of logs on PrivateServer:

  1. SIP activity logs
  2. Registered Accounts
  3. Web Authorization accesses
  4. Call Detailed Records

Each one is suitable to monitor a different part of the service.

4.0.1 SIP activity logs

The SIP Sessions page show the activities each Account did with the server. 

Subtitle
Prefixfigure
SubtitleTextList of SIP Session Activities
AnchorNamesip logs

To get this list just click on the SIP Sessions entry in the main menu. The activities are listed by date and they give you a detailed overview of the SIP status for each one. These logs are very useful for debugging the networking issues on the client side.

Tip
In 
Xref
AnchorNamesip logs
 you can read that a NETWORK_ERROR has caused the DISCONNECT event for one user.

The Event column lists the SIP events:

  • CONNECT: PrivateGSM client opened a connection to PrivateServer. This usually means the client has been activated
  • REGISTER: The Account has been correctly registered and is now on line
  • UNREGISTER: The Account has been correctly unregistered and is now off line
  • DISCONNECT: PrivateGSM client closed the connection. This usually means the client has been stopped.
Each one has its Details column which explains the exact message provided by the PrivateServer.
CONNECT/DISCONNECT event are bound to a remote address, not directly related to a specific VoIP account. A periodic background task analyses the SIP session logs and, when possible, reconcile them binding these events to a specific account. 
Reconciliation is very useful while debugging SIP session for a specific user: clicking on username field will show a filtered list of SIP session events.

4.0.2 Registered Accounts

If you want a full list of all the Accounts who are on line, then you click on the Registered Accounts entry in the main menu.

Subtitle
Prefixfigure
SubtitleTextRegistered Account list
AnchorNameregistered account list

 The list shows all the user actually on line and thus reachable on your PrivateServer. To read more detail about each user just click on its Id.

4.0.3 Web Authorization accesses

You can have a full view of all the access made to the management console.

Just click on the Web Sessions entry in the main menu and you get a list as in figure above. It shows up the detail about the user (principal), the IP address used to connect, the date of each authentication and the outcome (Event Type).

4.0.4 Call Detailed Records

Info
titleNEW FEATURE

In this version the CDR has been completely rearrange to better show the valuable informations

Despite its name the CDR is a debugging and quality assurance facility. It saves all the calls status, meaning it is very useful to understand is something is going wrong with you Secure Call Service.

To access the CDR you must click on the Call Detailed Record in the main menu. You'll get the "Cdr List" page which includes all the calls recorded. 

Subtitle
PrefixFigure
SubtitleTextCall Detailed Record List
AnchorNamecdr list

If the table is empty, please place a phone call between the two SIp Accounts. Then come back on this page and check that the call has been correctly registered. The shown fields are:

Relevant fields in CDR

The Disposition is very important because it tells you the exit code of each call. Possible codes are:

  1. ANSWERED: the call was taken by the callee
  2. NO_ANSWER: nobody picked up the phone to answer (mostly this is a time out code)
  3. BUSY: the callee refused the call
  4. FAILED: for some reason the call was not able to be placed

4.0.5 Data Retention

Info
titleNEW FEATURE

The "Data Retention" feature has been introduced in the present version.

The "Data Retention" is the new possibility that EVSS gives you to archive and store away some of the older data for consultation purposes. 

Subtitle
Prefixfigure
SubtitleTextMenu access to the Data Retention
AnchorNamedata_retention_menus

You can access the functions of "Data Retention" using the menu entries shown in 

Xref
AnchorNamedata_retention_menus
 under the "SERVER CONFIGURATION" voice.

The first one is used to configure the Retention features, the latter for retrieving the information stored on the hard disk of PrivateServer.

4.0.5.1 Setup of Data Retention

You can create a retention policy for some important logs provided by the appliance.

 

Subtitle
Prefixfigure
SubtitleTextData Retention Policy list
AnchorNamedata_retention_policy_list

 

In 
Xref
AnchorNamedata_retention_policy_list
 is shown the list of the available logs to be stored. What happens when you start the Data Retention on a log is that the system checks all the entries older than the date configured (let's say older than one year from the present day) and move them out the regular logging system to a compressed archive that could be later downloaded.

 

Subtitle
Prefixfigure
SubtitleTextData Retention Policy editor
AnchorNamedata_retention_policy_editor

Each log entry listed in

Xref
AnchorNamedata_retention_policy_list
 has an editor form as the one shown in
Xref
AnchorNamedata_retention_policy_editor
. Using the mentioned form you can:

  • enable the Data Retention(Enabled checkbox)
  • select the period to be kept on-line (Period Duration)
  • choose how many archives you want to keep online (Period/s Online)

 

Note
titleNew Feature!

A new Privacy option is possible from this version on: If you set the CDR Period to '0' (zero) then no more CDR logging will be performed for any DIRECT call (calls between two users). Conferences and 3-way calls will be logged as ever, though.

 

4.0.5.2 Retrieve the Data Archives

As said in the previous paragraph (4.0.5.1), there are two left menu entries to manage the Data Retention feature (see 
Xref
AnchorNamedata_retention_menus
). If you want to access to the stored archives just press the "Archived Data" link.

 

Subtitle
Prefixfigure
SubtitleTextData Archive List
AnchorNamedata_archive_list

The "Data Archive List" is shown in the page body (see 

Xref
AnchorNamedata_archive_list
). Each archive row shows its Name, its Creation Timestamp and its Size (all the columns are pretty self explaining).

The last two columns shows two icons: the first one is for downloading the archive, the second one is for deleting it.

Tip

It's possible to download the archive also by clicking on its name

If you choose to delete the archive, press the last column icon.

Subtitle
Prefixfigure
SubtitleTextThe confirmation pop-up window
AnchorNamepopup_are_you_sure

A confirmation is requested (see 

Xref
AnchorNamepopup_are_you_sure
). If you approve the action then the archive is removed from both the list and the hard disk of the appliance.

Warning
titlePoint of no return action!

Please be aware that this action is not undoable! Once confirmed the deletion, the archive is lost forever!

 

 

Navbar