There are several kinds of log on PrivateServer and each one is suitable to monitor a different aspect of the service.
- static logs
- Auditing
- Web Sessions
- Call Detail Record
- Sip Sessions
- App log configuration
- Install messages
- Provisioning messages
- live logs
- Registered Accounts
- Sip Trunk status
- log's retention
- Data Retention
- Archived Data
4.0.1 Static logs
asfasfafs
4.0.1 SIP Sessions logs
The SIP Sessions page show the activities each Account did with the server. The "Real-Time Management" section includes the actual representation for the status of portion of the service. What it shows is related to the connections which are active when we read it. What is shown here is just the present status, thus it would not stand, it would not leave logs and it would not have an history page to be consulted. The status can be useful to check what's going on right on the time the check itself is happening.
Subtitle |
---|
Prefix | figure |
---|
SubtitleText | List of SIP Session Activitieslive logs |
---|
AnchorName | sip live_logs |
---|
|
Image Removed |
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 Image Added |
There are two logs in the Real-Time Management:
- Registered Accounts
- SIP Trunk status
As you can check in
...
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.
...
they are both listed under the REAL-TIME MANAGEMENT section of the main menu.4.0.2.1 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 |
---|
Prefix | figure |
---|
SubtitleText | Registered Account Accounts list |
---|
AnchorName | registered account list_accounts |
---|
|
Image Removed Image Added |
The The list shows all the user actually who results on line and as you check them. All of them is 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.
Image Removed
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 |
---|
|
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 |
---|
Prefix | Figure |
---|
SubtitleText | Call Detailed Record List |
---|
AnchorName | cdr list |
---|
|
Image Removed |
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:
- Call Date: when the call has been placed
- Caller Number: The virtual phone number used to place the call
- Caller: The caller description, if any
- Caller Group: The caller's group description, if any
- Callee Number: The virtual phone number called
- Callee: The callee description, if any
- Callee Group: The callee's group description, if any
- Total Duration: how long the call lasted. Time elapsed from the moment the "Call Button" is pressed on the caller's client to the one in which the communication is closed at all
- Call Duration: how long the call lasted, just the voice
- Disposition: which result the call had
- Hangup Cause: how long the call lasted
- Call id: a unique number that identifies the call
- Call type: nature of the call performed
Relevant fields in CDR
The Disposition is very important because it tells you the exit code of each call. Possible codes are:
- ANSWERED: the call was taken by the callee
- NO_ANSWER: nobody picked up the phone to answer (mostly this is a time out code)
- BUSY: the callee refused the call
- FAILED: for some reason the call was not able to be placed
The Hangup Cause describes in details what caused the hangup. Possible causes are:
- NO_ROUTE_DESTINATION: The callee is not reachable because of network issues.
- NORMAL_CLEARING: Call closed normally.
- USER_BUSY: The user is busy.
- NO_ANSWER: The callee didn't answer and the call was closed for timeout reason.
- CALL_REJECTED: The callee rejected the call, as by pressing the "hold" button.
- BEARERCAPABILITY_NOTAVAIL: The caller and the callee were using different security models that are not compatible.
- NO_USER_RESPONSE: The same as in "NO_ANSWER", but this happens when the call goes out by Trunk.
The Call Type identifies the nature of the call. Used with the Call id fields this value is useful to trace down complex calls like three-way calls, conferences or transferred calls. Possible values are:
- CALL: Usual call between two persons
- 3-WAY: Usual call (as above) with an added person during the call
- CONFERENCE: Conference call
- TRANSFER: Usual call that is transferred to a third person
The Call id is a number that identifies uniquely the call. It can be used to trace a call if it changes its nature (ie becoming a three-way call) or to group all the participants (ie in a conference room).
4.0.5 Data Retention
Info |
---|
|
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 purposesIn the list you can read the most valuable information about each account:
- Username
- Owner
- Caller Id (This is the primary virtual phone number)
- Caller Id 2 (This is the alternate virtual phone number)
- IP Address: The IP from which the account results connecting
- Registration Expires: how long before a new REGISTER is expected from the client
- User Agent: a string containing summarised informations about platform, version number and edition of the PrivateGSM client used by the Account.
Detailed information about the configuration of each account can be reached by clicking on its Username: you would be redirected on the account's details.
4.0.2.2 SIP Trunk status
Another Real-time commodity is the chance to check your SIP Trunk status. Unlike the SIP Trunk list in shown in the SIP Trunk configuration, here you can't perform any test action.
Subtitle |
---|
Prefix | figure |
---|
SubtitleText | Menu access to the Data RetentionSIP Trunk status |
---|
AnchorName | datasip_retentiontrunk_menusstatus |
---|
|
Image RemovedImage Added |
You can access the functions of "Data Retention" using the menu entries shown in
Xref |
---|
AnchorName | data_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 |
---|
Prefix | figure |
---|
SubtitleText | Data Retention Policy list |
---|
AnchorName | data_retention_policy_list |
---|
|
Image Removed |
In Xref |
---|
AnchorName | data_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 |
---|
Prefix | figure |
---|
SubtitleText | Data Retention Policy editor |
---|
AnchorName | data_retention_policy_editor |
---|
|
Image Removed |
Each log entry listed in
Xref |
---|
AnchorName | data_retention_policy_list |
---|
|
has an editor form as the one shown in Xref |
---|
AnchorName | data_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 |
---|
|
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 |
---|
AnchorName | data_retention_menus |
---|
|
). If you want to access to the stored archives just press the "Archived Data" link.
Subtitle |
---|
Prefix | figure |
---|
SubtitleText | Data Archive List |
---|
AnchorName | data_archive_list |
---|
|
Image Removed |
The "Data Archive List" is shown in the page body (see
Xref |
---|
AnchorName | data_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 |
---|
Prefix | figure |
---|
SubtitleText | The confirmation pop-up window |
---|
AnchorName | popup_are_you_sure |
---|
|
Image Removed |
A confirmation is requested (see
Xref |
---|
AnchorName | popup_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 |
---|
title | Point of no return action! |
---|
|
Please be aware that this action is not undoable! Once confirmed the deletion, the archive is lost forever! |
Still you can verify the Status, along with all the relevant information about the Trunk:
- Host Name
- Trunk Name
- Optional Virtual Phone Number
- Username used to register (if it's a registered Trunk)
- Transport type
- Encryption (if any)
Info |
---|
Please note that there's no direct connection between the present list and the one in the Trunk Configuration page. |