Viewing Configuration & Journal Data

Download this manual as a PDF file

This section describes how to view data collected by Dynamic Applications that collect configuration and journal data.

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 ().

Viewing Device Configuration Data

On the Configs tab of the Device Investigator, you can view configuration information that has been collected from the device by Dynamic Applications. You can also view a list of all changes that occurred with a Dynamic Application between two specific snapshot reference points.

The pane on the left displays a list of Dynamic Applications associated with the device. To view the configuration data collected by a Dynamic Application, select it from the Dynamic Apps section on the left.

Only those Dynamic Applications that have collected data will appear on the Configs tab.

The data displayed on this tab is read-only.

Viewing Device Snapshot Data

You can view all changes between two specific snapshot reference points of a Dynamic Application on the Configs tab of the Device Investigator page.

To view all changes between two snapshots of a Dynamic Application:

  1. Go to the Devices page.
  2. Locate the device for which you want to compare Dynamic Application snapshot data, and click its name under the Device Name column. The Device Investigator page appears.
  3. Click the Configs tab.
  4. Select a Dynamic Application from the collapsible Dynamic Application Configs pane on the left side of this page.

    5. NOTE: You can click the View <Dynamic Application Name> button to open the Dynamic Application Properties Editor modal for that Dynamic Application.

  5. Select two snapshots to compare in the Snapshot drop-down menu. By default, this page will compare the current system and the last snapshot. All changes are highlighted.
  6. Click the [Show X Changes] button, where the variable "X" is the number of changes between the two snapshots, located in the upper right side of the page. The Host Resource: Configuration modal appears.
  7. In this modal, you can view a more detailed breakdown of how these values changed between the two snapshots.

Generating a Device Configuration Report

On the Device Investigator page, you can generate a detailed report on the configuration data for that device.

To generate a device configuration report:

  1. On the Device Investigator page, click the Report button in the top navigation bar. The Device Report modal appears.
  2. From the Select Type drop-down, select Config.
  3. In the Select Format drop-down, select the format for the report. Options include HTML, PDF, DOC, XLS, or CSV.
  4. Click Create Report to generate the report.

Viewing Device Configuration Data in the Classic SL1 User Interface

The Configuration Report page displays data collected from the device by configuration Dynamic Applications. Usually, configuration data contains static information about hardware and configuration settings, such as serial numbers, version numbers, and hardware status.

NOTE: If you select the Hide Object checkbox for an object in the Collection Objects page (System > Manage > Dynamic Applications > Create/Edit), the object will not be included in the Configuration Report page.

For objects of type "enum," you can mouseover the object and view all the possible values for the object.

NOTE: The Configuration Report page does not display Dynamic Applications that have Cache Results selected in the Caching field in the Dynamic Applications Properties Editor page. Dynamic Applications that cache results are designed to collect data only for other Dynamic Applications and cannot be used to display data.

To view Configuration Dynamic Application information:

  1. Go to the Device Manager page (Devices > Device Manager).
  2. Find the device for which you want to view configuration Dynamic Application data and select its bar graph icon ().
  3. In the Device Administration panel, select the Configs tab. The Device Configuration page appears.

Selecting Device Configuration Data to View in the Classic SL1 User Interface

If one or more Dynamic Applications of type "configuration" are associated with the device, the Configuration Report page will display that list of Dynamic Applications in the left NavBar.

NOTE: The left navigation bar does not display Dynamic Applications that have Cache Results selected in the Caching field in the Dynamic Applications Properties Editor page. Dynamic Applications that cache results are designed to collect data only for other Dynamic Applications and cannot be used to display data.

When you select a Dynamic Application in the left NavBar, the right pane displays data collected from the device by the Dynamic Application.

  • Some objects may appear in a list at the top of the right pane. These are objects that are not grouped into a table. For each of these values, no values were specified in the Group field and the Table Alignment field, in the Collection Objects page. These are usually objects for which there is only one, non-changing value (like model number, for example).
  • Some objects may appear in tables. Tables work best for objects with multiple values, like RAM location. Each row represents one value from each collection object in the group, which all have the same index.
  • Each column heading is the name of an object. Mousing over the column heading displays a description of the object. To edit the description, click on the column heading. The Collection Objects page appears, populated with values from the appropriate object. You can edit the value in the Description field, and that value will appear when you mouseover the column heading in the Configuration Report page.
  • Mousing over a value can display the following:
  • If the object is of type "enum", the mouseover text displays the list of all possible values for the object. For example, "0 unknown, 1 disabled, 2 enabled".
  • If change detection has not been enabled, displays the text "Change detection is disabled. No history available".
  • If change detection has been enabled, displays "Click to view change history". If you click, SL1 displays the Change History modal, where you can view all the values collected from the device for the selected object.

Generating a Device Configuration Report in the Classic SL1 User Interface

You can generate a report about the data in the Configuration Report page. To do so:

  1. In the Configuration Report page, in the Navigation Bar (left pane), select the Dynamic Application you want to generate a report from.
  2. In the Configuration Report page, select the Actions menu. Select Print a Report.
  3. SL1 generates an HTML report that contains all the data from the Configuration Report page. You can view, print, or save the report.

Viewing Historical Device Configuration Data in the Classic SL1 User Interface

By default, the Configuration Report page displays data from the latest polling session. However, you can use the Snap-Shot Selector page to display data from a previous polling session in the Configuration Report page.

The Snap-Shot Selector page displays a list of polling sessions where a change was discovered in the configuration data. If none of the data in a Dynamic Application changes from one polling session to the next, then SL1 does not include an entry in the Snap-Shot Selector page.

To display data from a previous polling session in the Configuration Report page:

  1. In the Configuration Report page, in the Navigation Bar (left pane), select the Dynamic Application for which you want to view historical data.
  2. When the data is displayed in the right pane, select the Snap-Shots button.
  3. The Snap-Shot Selector modal page appears. This page displays a calendar interface, in which you can select a date for which you want to view a list of Snap-Shots.
  4. To select a date for a Snap-Shot, scroll through the calendar until you find the month that you are interested in. Click on the date you are interested in.
  5. The pane to the right will display a list of all available Snap-Shots for the selected date. Each Snap-Shot is labeled with a date and time stamp and specifies how many objects had changed values. To select a Snap-Shot, click on it and select the View Snapshot button.

NOTE: If the pane to the right does not display one or more available Snap-Shots, this means that SL1 did not detect any changes to the objects on the selected date.

  1. The data from the selected Snap-Shot is loaded and displayed in the Configuration Report page.

Editing the Configuration Dynamic Application

From the Configuration Report page, you can edit the properties of a Dynamic Application. When you do so, you change the behavior of the Dynamic Application for all subscriber devices, not just the current device.

To edit a Dynamic Application from the Configuration Report page:

  1. In the Configuration Report page, in the Navigation Bar (left pane), select the Dynamic Application you want to view and edit.
  2. When the data from the Dynamic Application is displayed in the right pane, select the Actions menu and choose Edit This Application.
  3. The Collection Objects page appears. In this page, you can edit how SL1 retrieves values for an object and how those values are displayed in the Configuration Report page. You can also access all the other tabs in the Dynamic Applications panel for the Dynamic Application.

For information about editing Dynamic Applications, see the Dynamic Application Development section.

Viewing Device Journal Data

On the Journals tab of the Device Investigator, you can view journal entry information that has been collected from the device by journal Dynamic Applications.

All information from journal Dynamic Applications is included on the Journals tab.

Journal Dynamic Applications collect and store data in log format. Collected data is stored as a series of journal entries, each entry representing a "log". For example, a journal Dynamic Application might collect telephone call records, where each journal entry represents a single call, or it might collect system access records, where each journal entry represents a user session.

For more information about journal Dynamic Applications, see the Journal Dynamic Applications section.

Viewing Device Journal Data in the Classic SL1 User Interface

The Journal View page displays journal entry information collected from the device by Dynamic Applications. All information from Dynamic Applications of type journal is included in the Journal View page. Journal Dynamic Applications store information in log format; for example, telephone call records or access logs.

To view journal Dynamic Application information:

  1. Go to the Device Manager page (Devices > Device Manager).
  2. Find the device for which you want to view journal Dynamic Application data and select its bar graph icon ().
  3. In the Device Reports panel, select the Journals tab. The Journal View page appears.

Searching & Filtering the List of Data

You can filter the list on the Journal View page by one or more parameters. Only journal entries that meet all the filter criteria will be displayed in the Journal View page.

To filter by parameter, enter text into the desired filter-while-you-type field. The Journal View page searches for journal entries that match the text, including partial matches. By default, the cursor is placed in the left-most filter-while-you-type field. You can use the <Tab> key or your mouse to move your cursor through the fields. The list is dynamically updated as you type. Text matches are not case-sensitive.

You can also use special characters to filter each parameter.

Filter the list by one or more of the following parameters:

  • Presentation Objects. Each presentation object column has a filter. For columns that contain a text string or a numeric value, you can enter text to match, including special characters, and the Journal View page will display only journal entries that have a matching value for that presentation object. For each journal entry, the value that is matched for a presentation object is the value of the first collection object that appears in the presentation object text. For columns that contain a time and date, you can select a time span, and the Journal View page will display only journal entries that have a time and date value within the selected time span. Choices are:
  • All. Display all journal entries that match the other filters. 

  • Last Minute. Display only journal entries that have been created within the last minute.
  • Last Hour. Display only journal entries that have been created within the last hour.
  • Last Day. Display only journal entries that have been created within the last day.
  • Last Week. Display only journal entries that have been created within the last week.
  • Last Month. Display only journal entries that have been created within the last month.
  • Last Year. Display only journal entries that have been created within the last year.
  • State. You can enter text to match, including special characters, and the Journal View page will display only journal entries that have a matching state. Journal entries can have one of the following states:
  • Open
  • Closed
  • Abandoned
  • Error
  • Reopened

  • Collected On. You can select a time span, and the Journal View page will display only journal entries that have been updated within that time period. Choices are:
  • All. Display all journal entries that match the other filters. 
  • Last Minute. Display only journal entries that have been created within the last minute.
  • Last Hour. Display only journal entries that have been created within the last hour.
  • Last Day. Display only journal entries that have been created within the last day.
  • Last Week. Display only journal entries that have been created within the last week.
  • Last Month. Display only journal entries that have been created within the last month.
  • Last Year. Display only journal entries that have been created within the last year.

Special Characters

You can include the following special characters to filter by each column except those that display date and time:

When searching for a string, SL1 will match substrings by default, even if you do not include any special characters. For example, searching for "hel" will match both "hello" and "helicopter". When searching for a numeric value, SL1 will not match a substring unless you use a special character.

String and Numeric

  • , (comma). Specifies an "OR" operation. Works for string and numeric values. For example:

"dell, micro" matches all values that contain the string "dell" OR the string "micro".

  • & (ampersand). Specifies an "AND " operation. Works for string and numeric values. For example:

"dell & micro" matches all values that contain both the string "dell" AND the string "micro", in any order.

  • ! (exclamation point). Specifies a "not" operation. Works for string and numeric values. For example:

NOTE: You can also use the "!" character in combination with the arithmetical special characters (min-max, >, <, >=, <=, =) described below.

  • * (asterisk). Specifies a "match zero or more" operation. Works for string and numeric values. For a string, matches any string that matches the text before and after the asterisk. For a number, matches any number that contains the text. For example:

"hel*er" would match "helpers" and "helicopter" but not "hello".

"325*" would match "325", "32561", and "325000".

"*000" would match "1000", "25000", and "10500000".

  • ? (question mark). Specifies "match any one character". Works for string and numeric values. For example:

"l?ver" would match the strings "oliver", "levers", and "lover", but not "believer".

"135?" would match the numbers "1350", "1354", and "1359", but not "135" or "13502"

String

  • ^ (caret). For strings only. Specifies "match the beginning". Matches any string that begins with the specified string. For example:

"^sci" would match "scientific" and "sciencelogic", but not "conscious".

"^happy$" would match only the string "happy", with no characters before or after.

"!^micro" would match all values that do not start with "micro".

"!^$" would match all values that are not null.

"!^" would match null values.

  • $ (dollar sign). For strings only. Specifies "match the ending". Matches any string that ends with the specified string. For example:

"ter$" would match the string "renter" but not the string "terrific".

"^happy$" would match only the string "happy", with no characters before or after.

"!fer$" would match all values that do not end with "fer".

"!^$" would match all values that are not null.

"!$" would match null values.

NOTE: You can use both ^ and $ if you want to match an entire string and only that string. For example, "^tern$" would match the strings "tern" or "Tern" or "TERN"; it would not match the strings "terne" or "cistern".

Numeric

  • min-max. Matches numeric values only. Specifies any value between the minimum value and the maximum value, including the minimum and the maximum. For example:

"1-5 "would match 1, 2, 3, 4, and 5.

  • - (dash). Matches numeric values only. A "half open" range. Specifies values including the minimum and greater or including the maximum and lesser. For example:

"1-" matches 1 and greater. So would match 1, 2, 6, 345, etc.

"-5" matches 5 and less. So would match 5, 3, 1, 0, etc.

  • > (greater than). Matches numeric values only. Specifies any value "greater than". For example:

">7" would match all values greater than 7.

  • < (less than). Matches numeric values only. Specifies any value "less than". For example:

"<12" would match all values less than 12.

  • >= (greater than or equal to). Matches numeric values only. Specifies any value "greater than or equal to". For example:

"=>7" would match all values 7 and greater.

  • <= (less than or equal to). Matches numeric values only. Specifies any value "less than or equal to". For example:

"=<12" would match all values 12 and less.

  • = (equal). Matches numeric values only. For numeric values, allows you to match a negative value. For example:

"=-5 " would match "-5" instead of being evaluated as the "half open range" as described above.

Examples

  • "!dell" matches all values that do not contain the string "dell".
  • "!^micro" would match all values that do not start with "micro".
  • "!fer$" would match all values that do not end with "fer".
  • "!^$" would match all values that are not null.
  • "!^" would match null values.
  • "!$" would match null values.
  • "!*" would match null values.
  • "happy, !dell" would match values that contain "happy" OR values that do not contain "dell".
  • "aio$". Matches only text that ends with "aio".
  • "^shu". Matches only text that begins with "shu".
  • "^silo$". Matches only the text "silo", with no characters before or after.
  • "!silo". Matches only text that does not contains the characters "silo".
  • "!^silo". Matches only text that does not start with "silo".
  • "!0$". Matches only text that does not end with "0".
  • "!^silo$". Matches only text that is not the exact text "silo", with no characters before or after.
  • "!^". Matches null values, typically represented as "--" in most pages.
  • "!$". Matches null values, typically represented as "--" in most pages.
  • "!^$". Matches all text that is not null.
  • silo, !aggr". Matches text that contains the characters "silo" and also text that does not contain "aggr".
  • "silo, 02, !aggr". Matches text that contains "silo" and also text that contains "02" and also text that does not contain "aggr".
  • "silo, 02, !aggr, !01". Matches text that contains "silo" and also text that contains "02" and also text that does not contain "aggr" and also text that does not contain "01".
  • "^s*i*l*o$". Matches text that contains the letter "s", "i", "l", "o", in that order. Other letters might lie between these letters. For example "sXiXlXo" would match.
  • "!^s*i*l*o$". Matches all text that does not that contains the letter "s", "i", "l", "o", in that order. Other letters might lie between these letters. For example "sXiXlXo" would not match.
  • "!vol&!silo". Matches text that does not contain "vol" AND also does not contain "silo". For example, "volume" would match, because it contains "vol" but not "silo".
  • "!vol&02". Matches text that does not contain "vol" AND also contains "02". For example, "happy02" would match, because it does not contain "vol' and it does contain "02".
  • "aggr,!vol&02". Matches text that contains "aggr" OR text that does not contain "vol" AND also contains "02".
  • "aggr,!vol&!infra". Matches text that contains "aggr" OR text that does not contain "vol" AND does not contain "infra".
  • "*". Matches all text.
  • "!*". Matches null values, typically represented as "--" in most pages.
  • "silo". Matches text that contains "silo".
  • " !silo ". Matches text that does not contain "silo".
  • " !^silo$ ". Matches all text except the text "silo", with no characters before or after.
  • "-3,7-8,11,24,50-". Matches numbers 1, 2, 3, 7, 8, 11, 24, 50, and all numbers greater than 50.
  • "-3,7-8,11,24,50-,a". Matches numbers 1, 2, 3, 7, 8, 11, 24, 50, and all numbers greater than 50, and text that includes "a".
  • "?n". Matches text that contains any single character and the character "n". For example, this string would match "an", "bn", "cn", "1n", and "2n".
  • "n*SAN". Matches text the contains "n", zero or any number of any characters and then "SAN". For example, the string would match "nSAN", and "nhamburgerSAN".
  • "^?n*SAN$”. Matches text that begins with any single character, is following by "n", and then zero or any number of any characters, and ends in "SAN".

Selecting Data to View

If one or more journal Dynamic Applications are associated with the device, the Journals tab of the Device Investigator (or the Journal View page in the classic SL1 user interface) will display that list of Dynamic Applications on the left side of the page.

When you select a Dynamic Application on the left side of the page, the right pane displays data collected from the device by the selected Dynamic Application.

The Journals tab of the Device Investigator (or the Journal View page in the classic SL1 user interface) arranges collected journal entries in tabular format.

  • The table contains a row for each journal entry.
  • The table contains a column for each presentation object, plus the State and Collected On columns. Presentation objects define the text to display in each row in the column, including which collection values will be displayed. Presentation objects are defined in the Presentation Objects page for the Dynamic Application.

The Journals tab of the Device Investigator (or the Journal View page in the classic SL1 user interface) displays the following about each journal entry:

To sort by descending order, click the column heading again. To sort a column that contains presentation objects, sorting must be enabled in the Presentation Objects page (System > Manage > Dynamic Applications > Create/Edit). Date and time column sorts by descending order on the first click; to sort by ascending order, click the column heading again.

  • Presentation Objects. One or more columns in the table of journal entries will be presentation objects defined in the Dynamic Application. The values in this column can be based on one or more collection objects, and can be a text string, a number, or a time and date value.

  • State. Specifies the current state of the journal entry. Journal entries can have one of the following states:
  • Open

  • Closed
  • Abandoned
  • Error
  • Reopened
  • Collected On. Specifies the last time the journal entry was updated.

Generating a Report of the Device Journal Data

You can generate a report about the data in the Journals tab of the Device Investigator (or the Journal View page in the classic SL1 user interface).

To generate a report about the a device's journal data:

  1. Go to the Journals tab of the Device Investigator (or the Journal View page in the classic SL1 user interface).

  1. In the left NavBar, select the Dynamic Application from which you want to generate a report.
  2. You can filter the journal entries to include in the report. Using the search filters at the top of the table of journal entries, filter the list of journal entries so that only the journal entries you want to include on the report are displayed.
  3. Click the Actions button and then select Generate Report.
  4. The Export current view as a report page displays. Select the output format for the report, optionally select if SL1 must force the browser to save the file to disk, and then click Generate.

Editing the Journal Dynamic Application

From the Journals tab of the Device Investigator (or the Journal View page in the classic SL1 user interface), you can edit the properties of a Dynamic Application. When you do so, you change the behavior of the Dynamic Application for all subscriber devices, not just the current device.

To edit a journal Dynamic Application:

  1. Go to the Journals tab of the Device Investigator (or the Journal View page in the classic SL1 user interface).
  2. In the left NavBar, select the Dynamic Application you want to view and edit.
  3. When the data from the Dynamic Application is displayed in the right pane, click the Actions button and then select Edit This Application.
  4. The Collection Objects page appears. In this page, you can edit how SL1 retrieves values for an object. You can also access all the other tabs in the Dynamic Applications panel for the Dynamic Application.

For information about editing Dynamic Applications, see the Dynamic Application Development section.