Subscription Data

Download this manual as a PDF file

If you have a subscription license, you can use the Subscription Usage page (System > Monitor > System Usage > Subscription button) to:

  • View current or historical subscription license usage graphs
  • Download subscription license usage data for manual upload to the ScienceLogic billing server
  • Upload a receipt from the ScienceLogic billing server

If your SL1 system is configured to communicate with the ScienceLogic billing server, usage data will be sent automatically from your SL1 system to the ScienceLogic billing server once a day. After the ScienceLogic billing server receives the usage data, SL1 will automatically mark the license usage file as delivered.

If your SL1 system is not configured to communicate with the ScienceLogic billing server or if the connection to the ScienceLogic billing server fails, you can manually upload usage data to the ScienceLogic billing server.

Use the following menu options to navigate the SL1 user interface:

  • To view a pop-out list of menu options, click the menu icon ().
  • To view a page containing all of the menu options, click the Advanced menu icon ().

Ensuring Accurate Data

If the reports described in this section do not appear to be correct, validate your configuration by opening the Subscription Usage page (System > Monitor > System Usage > Subscription button):

  • For secure/air-gapped systems, the latest "Summary Date" value will be within the last 48 hours
  • For systems that connect to ScienceLogic, the latest "Summary Date" value will be within the last 48 hours, and the "Delivery Status" is "1".

Viewing Subscription Usage

ScienceLogic uses the data collected for each device to assign a license to the device, and you are billed based on the number of device licenses you consume. The rules that govern how licenses are assigned are based on your subscription with ScienceLogic. Certain types of devices do not count against your device license usage in SL1. For more information, see the Non-billable Devices section.

The Subscription Usage page (System > Monitor > System Usage > Subscription button) provides a visual overview of your device license usage, including historical and current information. The information available in each panel of the page is described in this section and is accessible from the drop down menu in the top right of the page.

The Current License Usage drop-down in the Subscription Usage page

Current License Usage Totals

The bar chart in the upper-left corner of the Subscription Usage page shows the current total consumption of device licenses by license type. Each bar represents a license type. You can hover over a bar to see the number of licenses currently being consumed for that type. In the example below, we have four license types. We see that we are currently using 12 Ratio licenses.

The bar chart of the Subscription Usage page

Historical License Usage Totals

The line graph in the upper-right corner of the Subscription Usage page shows subscription license usage over time by license type. You can hover over a data point to see how many licenses of a given type were in use at that point in time.

The line graph of the Subscription Usage page

A Date Range selector lets you narrow your view by using one of the following:

  • All
  • Current Quarter
  • Last Quarter
  • Current & Last Quarter
  • Last Year

Whereas the "Current License Usages Totals" bar chart showed us that the most used license type currently is the Ratio license, the historical graph shows us that the Non-Billable license type is the most used over the given time range.

Current License Totals

The Current License usage table in the lower half of the Subscription Usage page lets you view information about your current subscription license usage in one of two ways:

  • Current License Usage by Device. Choose "Current License Usage" from the drop-down list. Provides a list of all devices and the licenses they are using. You can search the table or filter on Device Name, Class, Organization, Category, or License Type.

    The Current License Usage by Device table

    You can click on a device to open the Device Investigator page for the device. For more information, see Using the Device Investigator.

    If you are looking for a specific device license or licenses, click the gear icon () to the right of the Search field and select Advanced. For more information, see Performing an Advanced Search.

  • Current License Counts by Device Class. Choose "Current License Counts" from the drop-down list. Provides a list of all device classes that are associated with devices in the system, the device category, the total licenses currently consumed by devices of that device class, and a breakdown count for each license type for the device class. You can filter this table by device Class or Category.

The Current License Counts by Device Class table

  • Current License Counts by Device Category. Choose "Current License Category" from the drop-down list. Provides the Total number of licensed categories, their Test status, and number of Tests by Category.

    The Current License Counts by Device Category table

    The "Current License Category" category information also auto-populates and can be displayed in the "Current License Totals" bar chart above.

Viewing Delivery Status

The License Data Delivery Status page displays the status of one or more daily license usage files. To view the License Data Delivery Status page:

  1. Go to the Subscription Usage page (System > Monitor > System Usage > Subscription button).
  2. Click the License Data Delivery Status button.
  3. The License Data Delivery Status modal appears and displays a list of daily license usage files. For each daily license usage file, the License Data Delivery Status page displays the following:
  • Summary Date. Date associated with the daily license-usage file.
  • Delivery Status. Possible values are:
  • "0" (zero). File has not been uploaded to the ScienceLogic billing server.
  • "1" (one). File has been uploaded to the ScienceLogic billing server and may be deleted from the SL1 system by the automated maintenance process.
  • Summary Size. Size of the daily license usage file.

Manually Uploading License Usage to ScienceLogic

If your SL1 system is configured to communicate with ScienceLogic, usage data will automatically be sent to the ScienceLogic billing server once a day. After the ScienceLogic billing server receives the usage data, SL1 will automatically mark the license usage file as delivered.

If your SL1 system is not configured to communicate with ScienceLogic or if the connection to the ScienceLogic billing server fails:

  • You can use the License Data Delivery Status page to manually download the daily license-usage file.
  • You can then log in to the ScienceLogic billing server and manually upload the daily license-usage file.
  • You can then use the License Data Delivery Status page to upload the ScienceLogic "receipt" to your SL1 system, allowing SL1 to mark the license usage file as delivered.
  • License usage files will not be deleted from your system until they are delivered.

Downloading the Daily License Usage File

If your SL1 system is not configured to communicate with ScienceLogic or if the connection to the ScienceLogic billing server fails, you can use the License Data Delivery Status page to manually download the daily license usage file. You can then log in to the ScienceLogic Licensing and Billing server and manually upload the daily license usage file.

To download the daily license-usage file using the License Data Delivery Status page:

  1. Go to the Subscription Usage page (System > Monitor > System Usage > Subscription button).
  2. Click License Data Delivery Status.
  3. Select one or more daily license usage files to download to your local computer, and then click the Download button.

NOTE: If the download size exceeds 50MB, the Download button is disabled.

  1. The daily license usage file is saved to your local computer. The downloaded file is usually named "license_data.json.gz".

Manually Uploading the Daily License Usage File to ScienceLogic

After downloading the daily license usage file to your local computer, you can manually upload the file to the ScienceLogic billing server. To do this:

  1. Log in to the ScienceLogic billing system.
  2. Go to the Subscription Data page (Preferences > Account > Subscription Billing).
  3. In the Subscription Data page, go to the Subscription Data Update pane. Use the Browse button to find the daily license-usage file that you downloaded to your local computer.
  4. Click the Get Update button to upload the daily license-usage file to the ScienceLogic server.

The Get Update button of the Subscription Data page

  1. The ScienceLogic server will provide a "receipt" file for you to download. This file is usually called "status_updated.json.gz". You must upload this receipt to your SL1 system.

Uploading the ScienceLogic Receipt

After uploading the daily license usage file to the ScienceLogic Billing server, the ScienceLogic server will provide a "receipt" file for you to download. This file is usually called "status_updated.json.gz".

You must upload this "receipt" file to your SL1 system to inform your SL1 system that the upload was successful and that the SL1 system may delete the daily license usage file.

To upload the "receipt" file:

  1. Go to the Subscription Usage page (System > Monitor > System Usage > Subscription button).
  2. Click License Data Delivery Status.
  3. In the Status Update File field, click Choose File and browse to locate the "receipt" file.
  4. Click the Upload button to upload the "receipt" file to your SL1 system.

Data Retention Settings for Licensing

The Data Retention Settings page contains settings for subscribers.

To adjust these settings:

  1. Go to the Data Retention Settings page (System > Settings > Data Retention).

  1. The following sliders appear under the Subscription Data Retention heading:
  • Subscriber Device Configuration Data. For users with a subscriber license. Number of months to retain the files and database tables that contain configuration information for a device. Default value is two months.

  • Subscriber Device Usage Data. For users with a subscriber license. Number of months to retain information on total number of events and total number of tickets. Default value is two months.
  • Subscriber System Configuration Data. For users with a subscriber license. Number of months to retain the files and database tables that contain configuration information for the SL1 system. Default value is three months.
  • Subscriber System Usage Data. For users with a subscriber license. Number of months to retain information on total number of events and total number of tickets. Default value is three months.
  • Subscriber Device Type Data. For users with a subscriber license. Number of months to retain the files and database tables that map each device to a device category, as per your subscriber license. Default value is three months.
  • Subscriber Daily Delivery Data. For users with a subscriber license. Number of months to retain the "crunched" license usage data that is calculated each day using the Subscriber Device Configuration Data, Subscriber System Configuration Data, Subscriber System Usage Data, and Subscriber Device Type Data. SL1 will not prune data that has not yet been delivered to the ScienceLogic Licensing and Billing server. Default value is three months.

The Data Retention Settings page contains settings for feature data retention as well. This data is applicable to all systems.

To adjust these settings:

  1. Go to the Data Retention Settings page (System > Settings > Data Retention).

  1. The following sliders appear under the Feature Data Retention heading:
  • Feature Configuration Data. Feature data is information about how SL1 is being used, including configuration data and performance metrics. Number of months to retain raw feature configuration values. Default value is six months.
  • Feature Performance Data. Feature data is information about how SL1 is being used, including configuration data and performance metrics. Number of months to retain raw performance metric values. Default value is six months.
  • Feature Performance Data Aggregation Daily. For users with a subscriber license. Number of months to retain the files and database tables that contain aggregated daily-performance values. Default value is six months.
  • Feature Performance Data Aggregation Hourly. For users with a subscriber license. Number of months to retain the files and database tables that contain hourly-performance values. Default value is six months.

The Feature Data Retention section of the Data Retention Settings page