Monitorings Addon

From Kolmisoft Wiki

Jump to: navigation, search

IMPORTANT - From MOR X4 Monitorings functionality is replaced with Alerts functionality!
Why? Because it allows to discard second server and greatly extends the available functionality!
More information how functionality differs in X4 and X3 can be found here


[edit] What is Monitorings Addon?

Monitorings Addon is an optional MOR feature that:

  • protects you from high money losses.
    • blocks suspicious users on various activity
    • informs administrators about suspicious activity
  • allows admin and resellers to spy their user calls on real-time
  • allows to see leg A and leg B codecs used and post-dial delay in Active calls.

[edit] How Monitorings Addon work?

Monitoring Addon crawls the MOR database and counts user's call price sum over specified period. If user's call price sum over specified period will be higher or lower than the amount specified in monitoring – an action will be taken. Possible actions are:

  • Only notify admin (no action is taken against user)
  • Block user (user is automatically blocked, no notification is sent to admin)
  • Block user and send notification for admin

You can create differently configured monitorings for:

  • All users
  • Postpaid users
  • Prepaid users
  • 1 user (separate monitorings for each user, also called personal monitorings)

Also it is possible to create 2 or more monitorings for each group, for example:

  • First monitoring only reports admin about quickly increasing sum, let's say 50 Euro
  • If an administrator takes no action and someone tries to abuse the system when call sum for that user reaches for example 100 Euro the second monitoring can block that user

System's administrator can turn on monitorings for resellers. If they are off, resellers users are not under any monitorings terms.

[edit] Monitorings for resellers

As it is mentioned above, administrator can turn on monitorings for resellers. If you want to do it choose or create Reseller Permissions group, there you can enable monitorings for resellers.

[edit] Where to find Monitorings?

Remember: you will find Monitorings only if you have purchased Monitorings Addon.

Monitorings can be found in ADDONS section –> Monitorings.


[edit] How to create a Monitoring?

[edit] Global Monitoring

Global Monitoring will be applied to all users which meet the requirements (this will be explained later)

1. Go to ADDONS section –> Monitorings.
2. Select the desired options for new global Monitoring:


  • Period – this option let's you specify how often the monitoring must run and check all users balance.
  • Amount – this option let's you specify the amount of money and whether it is maximum limit or minimum call price limit. When user's balance drops to or reachs the amount you specified an action will be taken against him depending on other parameters.
  • Block user – if this option is set to Block – user will be blocked. He will not be able to make any calls.
  • Send Email to Admin – here you may choose to be informed about the action by email.
  • User type – this options specifies a user group an action must be taken against.
    • All – Monitoring will be applied to All users
    • Postpaid – Monitoring will be applied to Postpaid users
    • Prepaid – Monitoring will be applied to Prepaid users

3. Press the "Create" button to create the Monitoring

[edit] Additional Notes

  • You can create as many Monitorings for any group as you want. For example you can create 2 monitorings for Postpaid users:
    • 1 monitoring could just inform the administrator about the high user's balance (in this case select these options: enter the amount and choose Increases more, choose Do not block, choose Send, choose Postpaid)
    • 2 monitoring could block the user with high balance if the administrator is sleeping and didn't saw the warning email (in this case enter a bigger amount than in the first monitoring and choose Increases more, choose Block, choose Send, choose User type: Postpaid)
    • 3 monitoring could inform the administrator that some users stoped calling for some reason, maybe because of some technical problems, that otherwise would not be noticed so quickly (in this case enter some amount and choose Drops bellow, choose Do not block, choose Send, choose User type: Postpaid)
  • Do not add too much monitorings, because this functionality is database intensive. A separate database server could be dedicated for monitorings.

[edit] Personal Monitorings

[edit] What is a Personal Monitoring?

A Personal Monitoring is applied only to a specific user.

[edit] How to create a Personal Monitoring?

1. Navigate to SETTINGS –> Users


2. Select the marked icon:


3. Select the marked icon:


4. Depending on your scenario enter correct settings for a monitoring. Some information about marked fields:

  • 1. Must never be equal 0
  • 2. or 3. must be set to block or to send. You may select both, but you cannot leave them both "Do not block" and "Do not send"


5. Press the marked button to create the monitoring:


6. You will get a confirmation that monitoring was created:


[edit] Monitoring alerts when usage drops

In MOR it is also possible to monitor if users call price sum is under some certain certain sum. This is useful to detect that something is wrong with user's settings, providers assigned to him, etc.. Go to ADDONS –> Monitorings if you want to make a monitoring for users' group or SETTINGS –> Users if you want to make a monitoring for single users. You will see this window:

File: monitorings_usagedrops.png

Select Drops below, choose other settings and click Create. The text next to the information icon below shows what actions will be taken under what conditions depending on your choices.

[edit] Disable global monitorings for 1 or more users

In some situations you might need to disable global monitorings for some users leaving only personal monitorings. You can do that by navigating to user settings and enabling the marked setting:


[edit] Simultaneous calls

Monitorings Addon is able to spy if there are any simultaneous calls happening to the same destination. To create such a monitoring select Simultaneous calls in Condition section:


[edit] Monitorings Settings

Go to ADDONS –> Monitorings –> Settings


And you will reach Monitorings Settings page


Here you can disable Chanspy functionality. And manage Dynamic Blacklist Functionality settings.

[edit] Recommended hardware

Recommended hardware can be found here.

Minimum requirements:

  • 20GB of free space on HDD
  • 2GB of RAM


  • 50GB or more space on HDD
  • 2GB of RAM

[edit] See Also

Personal tools


Try M2