Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The information on this page refers to License Statistics 6.13 16 and newer, which added harvesting agents to the "license limits exceeded" alertimproved 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.1316, see documentation for previous versions.

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

The events you You can subscribe to includereceive notifications for the following:

  • License Statistics events , including expiring license and exceeding the limit on number of users or hosts that may be monitored. (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.(visible for License Statistics Administrator users only)
  • License servers going down.
  • Feature utilization exceeding a specified percentage . For (for example, you can specify that you want to get an email alert if feature F1 utilization is 80% or greater.)
  • Feature expiration . For (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 users accounts to receive email notifications for events.

...

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.

Anchor
licstat_alerts
licstat_alerts
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

Image Added

The License Statistics Events options are detailed below.

Receiving email alerts for the License Statistics license expiring

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

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

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

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 users accounts only. These alert options are not visible for other usersaccounts.

To receive email alerts when the limit for the number of users/hosts/harvesting agents that License Statistics can monitor (based on your License Statistics license) is exceededusage initially increases:

  1. In the License Statistics Events tab of the Email SubscriptionSubscriptions page, select the "License limit exceededThreshold Exceeded" checkbox. (This option is checked by default for users with Administrator privileges.) 
  2. Click Save.

There are three types of alerts you may receive associated with exceeding the user/host/harvesting agent limit:

  • Initial usage increase
  • User/host/harvesting agent limit exceeded
  • User/host/harvesting agent limit exceeded report

These alerts are described below.

Initial usage increase

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

...

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.User

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 exceededThis alert is sent when 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 In such cases, 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 ether 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.

User/host/harvesting agent limit exceeded report

This alert is In addition, a report of occurrences when the Useruser/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 a user 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.

...

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

  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.
      Image Removed
      Image Added

    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.
      Image Removed
      Image Added

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 user account subscribed to receive alerts for the server.

...

  • 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 useraccount.
  • 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 SubscriptionSubscriptions 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%.
    Image Removed
    Image Added
  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 SubscriptionSubscriptions 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.
    Image Removed
    Image Added

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

...

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

...