The information on this page refers to License Statistics 6.16 and newer, which improved License Statistics event alerts to include two options for exceeding license threshold and exceeding user/host/harvesting agent limits. If you are using a version previous to v6.16, see documentation for previous versions.

License Statistics accounts can subscribe to receive email alerts about events that occur for servers and features being monitored by going to Email Subscriptions under your logged-in username, shown in the upper right corner of the application window.

You can subscribe to receive notifications for the following:

  • License Statistics events (visible for License Statistics Administrator users only)
  • License servers going down
  • Feature utilization exceeding a specified percentage (for example, you can specify that you want to get an email alert if feature F1 utilization is 80% or greater)
  • Feature expiration (for example, you can specify that you want to get an email alert 60 days before the license for feature F1 expires)

Note that a License Statistics administrator must first enable email notifications as described in Configuring email in order for accounts to receive email notifications for events.

Setting the email address for receiving alerts

You must set an email address in order to receive email alerts. To set or change the email address at which to receive email alerts, use the Account Settings tab, also located under your logged-in username.

Receiving email alerts for License Statistics events

License Statistics alerts are available for administrative accounts only. These alert options are not visible for other accounts.

License Statistics event alerts include:

  • Expiring license
  • Exceeding the license threshold (initial usage increase)
  • Exceeding the user/host/harvesting agent limit 
  • Attempts by an unsupported Agent version to connect to License Statistics

To subscribe to alerts for License Statistics events, toggle on the desired options in the License Statistics Events tab of the Email Subscriptions page. 

The License Statistics Events options are detailed below.

Receiving email alerts for the License Statistics license expiring

This alert is available for administrative accounts only. This alert option is not visible for other accounts.

To receive email alerts when the License Statistics license is nearing expiration:

  1. In the License Statistics Events tab of the Email Subscriptions page, select the "License expire" checkbox. (This option is checked by default for accounts with Administrator privileges.)
  2. Click Save.

With this alert toggled on, you will receive an email alert once per the following intervals:

  • 30-15 days before the license expiration date
  • 14-8 days before the license expiration date
  • 7-0 days before the license expiration date

If the alert cannot be sent on the first day of the interval (due to problems communicating with the mail server or the mail server being down), additional alerts will be attempted during that interval until the alert is successful and/or the interval has passed. After an alert is sent successfully, another alert will not be sent until the next interval is reached. If an entire interval passes without an alert being sent successfully, no further alerts for that interval will be attempted.     

Receiving email alerts for exceeding the license threshold

These alerts are available for administrative accounts only. These alert options are not visible for other accounts.

To receive email alerts when usage initially increases:

  1. In the License Statistics Events tab of the Email Subscriptions page, select the "License Threshold Exceeded" checkbox. 
  2. Click Save.

With this alert toggled on, you will receive an email alert when usage initially increases:

  • From 79% or lower to 80% - 90%
  • From 90% or lower to 91% - 95%
  • From 95% or lower to 96% or higher

When usage remains within one of these ranges, an additional alert will be sent only once per month. For example, if your usage increases from 75% to 82% on October 10, a notification is sent on that day. Then, if on October 20 the usage increases to 91%, another alert will be sent on that day. If the usage stays between 91% and 95%, another notification will not be sent until November 10 (one month after the initial notification) and once a month thereafter until the next threshold of 96% is reached. As soon as the usage increases to 96% or higher, an alert will be sent out on that day.

Receiving email alerts for exceeding the user/host/harvesting agent limit

This alert is available for administrative accounts only. This alert option is not visible for other accounts.

High Performance Computing (HPC) licenses do not have a limit on number of hosts that can be monitored; otherwise, the host limit is 125% of the user limit.

To receive email alerts when the user/host/harvesting agent limit is exceeded:

  1. In the License Statistics Events tab of the Email Subscriptions page, select the "License Limit Exceeded" checkbox. 
  2. Click Save.

With this alert toggled on, you will receive an email alert when the limit for the number of users/hosts that License Statistics can monitor (based on your License Statistics license) is exceeded. 

When the limit for the number of users/hosts that License Statistics can monitor is exceeded, the data collection is skipped to avoid license over-usage and is permanently lost. This notification is sent only the first time it occurs in the day, even if the overage occurs subsequently in that day.

You can either disable some license servers to lower the amount of monitored users/hosts or, if the User/host/harvesting agent limit is frequently exceeded, consider upgrading the license to allow for a greater number of users/hosts to be monitored.

In addition, a report of occurrences when the user/host/harvesting agent limit was exceeded one or more times will be sent. This report is sent only once for the previous day's occurrences. The report contains:

  • A list of all affected license servers for which data was lost due to the limit having been exceeded.
  • Number of failed queries per server for the entire previous day.
  • Date of first occurrence.

Further details on the occurrences (such as dates for each occurrence) can be found in the Event Log.

Receiving email alerts for unsupported Agent versions

This alert is available for administrative accounts only. This alert option is not visible for other accounts.

To receive email alerts when an unsupported Agent version attempts a connection to License Statistics:

  1. In the License Statistics Events tab of the Email Subscriptions page, select the "Unsupported Agent Version" checkbox. 
  2. Click Save.

With this alert toggled on, you will receive an email alert:
1. On the first occurrence per user (newly subscribed user or new License Statistics installation)
2. After midnight each day, if there are any outdated agents
3. After a License Statistics update, if there are any outdated agents

Receiving email alerts for license servers that are unable to gather proper usage data

The license server status that appears as "Down", "Unknown" or "Internal Error" indicates that the monitored license server is unable to gather proper usage data.

A continuous, uninterrupted license server connection is essential to successfully monitor your licenses and it is important to know when License Statistics is unable to gather usage data for a given license server. An administrator or an account responsible for a given license server can subscribe to receive such email alerts to gain insight into the status of monitored license servers. Each such notification indicates a potential data loss event and informs that actions should be taken to maintain license server connectivity.

Note: You can subscribe to receive email alerts only for visible license servers with remote monitoring configured.

To receive email alerts when a license server is unable to deliver proper usage data:

  1. Go to the License Server Events tab of the Email Subscriptions page. This page contains a list of Unsubscribed License Servers and a list of Subscribed License Servers.



  2. To subscribe to license server notifications, use one of the following methods.
    1. To subscribe to all license servers, click the checkbox next to "Subscribe to all license servers" at the top of the License Server Events page. (The grids that let you select individual license servers no longer display after you select this option.)
      or
    2. To subscribe to one or more individual license servers, click the checkbox next to the license server(s) in the Unsubscribed License Servers grid, and then either click the Add button or drag and drop the items into the Subscribed License Servers grid. You can select all license servers at once by clicking the checkbox next to License Server at the top of the Unsubscribed License Servers grid. You may want to do this if, for example, you want to subscribe to all license servers except one or two in a list of several servers.
  3. Select how often to receive the notifications:
    1. If subscribing to all license servers (option "a" above), select the time interval from the "Send email notification" drop-down.



    2. If subscribing to individual license servers (option "b" above), a Subscription Options dialog will pop up for you to select the frequency. After selecting the frequency, the selected license servers will appear in the Subscribed License Servers list.



Note:

  • If you want to set different notification frequencies for individual license servers, add the license servers individually instead of subscribing to all license servers.
  • If you use the "Subscribe to all license servers" option, you will also receive notifications for all newly added license servers. If you add license servers individually, you will not receive notifications for newly added license servers.
  • After new license servers are added, they will appear on the Unsubscribed License Servers grid, so you can subscribe to them individually as needed (or switch to subscribing to all license servers).

After subscribing to license server events, you will receive an email alert when any subscribed and monitored license server cannot gather data. An electronic mail notification system periodically scans for a license server with "Down," "Unknown," or "Internal Error" status, and when it detects such a server, it sends an email notification for every License Statistics account subscribed to receive alerts for the server.

Each notification is sent only once, unless the license server status changes. A notification will be resent under the following circumstances:

  • When the status of the license server is floating between an "Up" status and one of the following statuses: "Down," "Unknown" or "Internal Error." (See License Servers for more information.)
  • When the status of the license server is changing between one status and another that indicates the license server is unable to deliver usage data (e.g., from "Down" to "Unknown," from "Internal Error" to "Down," etc.).
  • When a license server that has a "Down," "Unknown" or "Internal Error" status becomes visible to the account.
  • When the "Repeat every" option was selected and the same license servers have the same status ("Down," "Unknown," or "Internal Error") after the entire interval has passed.

When a license server remains unable to gather proper usage data for a longer time, the notification will not be resent.

Receiving email alerts for feature utilization

To receive email alerts for features that exceed a specified utilization percentage:

  1. In the Feature Utilization Events tab of the Email Subscriptions page:
    1. Select a license server to receive utilization alerts for,
      or
    2. Select the plus sign next to a license server to select individual features to receive utilization alerts for.
  2. Use the slider under the "Utilization" column to set the percentage of utilization that the feature must reach in order for an email alert to be sent. For example, if you set the percentage to "75," you will get an email alert whenever utilization rises to 75% or above. The default is 90%.


  3. Repeat the above steps for all features you want to receive utilization alerts for.

Note: Notification is send every time the utilization increases from below the threshold to the value above it.

Receiving email alerts for feature expiration

To receive email alerts when a feature is nearing its expiration date:

  1. In the Feature Expiration Events area of the Email Subscriptions page, add license servers and/or individual features as described above for feature utilization alerts.
  2. Use the slider under the "Days to expiration" column to set the number of days prior to expiration you want to receive an alert. You can set the slider value from 1 to 99 days.



  3. Repeat the above steps for all features you want to receive expiration alerts for.

Note: You cannot add multiple subscriptions for the same feature. You need to remove the existing subscription before adding a new one. 

Unavailable grids and panels

Grids and panels in the Email Subscriptions page may be disabled because:

  • No license servers have been added for monitoring
  • Default installation data is missing

To enable grids and panels, add at least one license server for which you want to receive notifications.