Search

NAM Server ► Search

All searches start from the search box at the top of the NAM Server screen:

NAM Server search icon

This help topic describes how NAM Search works out of the box. To learn how to customize queries, see Customizing query definitions.

Changes in NAM 2019 Service Pack 2

  • Press the Ctrl-Alt-Shift-Space key combination to open a magnified search entry box for easier query entry. (Press Esc to close it.)
  • New full-sentence query options are available. See New query options in NAM 2019 Service Pack 2 for examples.

You can use NAM Server Search to quickly find all entities from various dimensions (such as applications, transactions, software services, sites, user names, alerts, and many more) containing your search string.

Click in the search box, type your search string, and press Enter.

The Search results page is a tabbed report, where tabs are data categories. If there is a non-zero number of matches for a category, the number of matches is displayed in parentheses following the tab name. Click that tab to see the results.

On each tab, you can:

  • Use the Find box in any category for a more granular search within that category.
  • Click a drilldown button to open a relevant report with your search string applied as a filter.
Example search
  1. Click the search icon.
  2. Type citrix and press Enter.
    The Search results page lists the number of matches for citrix across all categories.
  3. Open the Technical tab to see a breakdown of matches categorized by software services, analyzers, analyzer groups, and so on. From here, you can:
    • Type an additional search string in the Find box for any category (for example, software services) and click Find to show only the results that match the original search (in this example, citrix) and the additional string you just searched for.
    • Click a drilldown button. For example, click Operation explorer in the Software services section of your results to open Operation explorer filtered for your search string (in this example, citrix). To see a menu of additional drilldowns available here, select the ... button next to the Operation explorer button.

Search results tabs include:

  • Overview
    Shows a breakdown of all search results. Click in any category to switch to that tab on the Search results page.
  • Business
    Lists business categories (such as applications, transactions, and tiers) matching your search.
  • Technical
    Lists technical categories (such as software services, analyzers, analyzer groups, server names, operations, tasks, modules, and sites) matching your search.
  • Users
    Lists user names matching your search. Click a user name to see details on that user or to drill down to relevant reports filtered for the selected user.
  • RUM
    Lists real user monitoring results.
  • Synthetic
    Lists Enterprise Synthetic applications and transactions matching your search.
  • Network
    Lists network-related results.
  • Alerts
    Lists alerts matching your search.
    • Click a time open Alerts explorer filtered for the search string and the selected time.
    • Click a message to drill down to display related search results with additional drilldown options from there.
  • Reports
    Lists reports matching your search.
    • Dashboard reports can be opened directly.
    • Other reports are not made to be opened directly (they are designed to be part of the workflow and may require filters).

Finding reports

  1. In the NAM Server search box, enter a search string (for example, operation reports) and press Enter.
    The Search result details page shows the results of searching your deployment for matches to operation reports.
  2. If you are looking for a report containing operation, select the Reports tab to see reports such as Operation explorer.

Searches apply to

  • Report name, title, or dashboard section name
  • Additional metadata: last modification date, creation date, usage (number of hits)

Displayed search results are split into two sections:

  • Dashboard reports, which are designed to be opened directly.
  • Other reports, which are designed to be part of the workflow and may require filters to be applied through drilldown links to run properly.

You can use the open command in the search box to open a report directly, without having to locate and select a menu option for the report. For example, if you know you are looking for a report called Operation explorer:

  • Enter open operation explorer to open the Operation explorer with no parameters.
  • Enter open operation explorer for last 2 hours to open the Operation explorer with the report time range set to Last 2 hours.

If a report with the name you provide can’t be found, the system instead runs a search as if you had issued your command without open.

Use tags if you want to skip the overview page of the search results and speed up the search process by searching through only one dimension or a group of dimension values. Add any of the search tags listed here to your query to narrow your search to the specified category of results or dimension.

Syntax: your query search_tag

Full-sentence query examples

Starting with NAM 2017, it is also possible to do queries by asking full sentence questions.

This table shows examples of the sort of questions you can ask the NAM Server in NAM 2018. You can also write your own question templates (and not only in English). See Customizing full-sentence query pattern definitions for customization details.

Example query Results
how are things? Opens Health dashboard.
what's going on? Opens Health dashboard.
how were my citrix apps doing over the last two hours? Opens Health dashboard filtered for Application = *citrix* and time set to Last 2 hours.
could patient access server 172. today? Opens User explorer filtered by Server name = *172.*, User name = *patient*, and time set to Today.
who was using citrix over the last 3 hours? Opens User explorer filtered for Application = citrix and time set to Last 3 hours.
what does application citrix do? Opens Operation explorer filtered by Application = citrix.
what does ctxuser do? Opens User explorer filtered by User name = *ctxuser*.
why was my citrix slow in the last hour? Opens Operation explorer to the Slow operation cause breakdown tab filtered by Application = *citrix* and time set to Last hour.
what alerts were sent recently? Opens Alerts explorer with time set to Last 5 minutes.
what alerts were sent for application citrix today? Opens Alerts explorer with time set to Today and Application set to Citrix.
how many users were affected by availability over the last 2 hours Opens User explorer with time set to Last 2 hours.
how many users were affected by performance over the last 2 hours Opens User explorer with time set to Last 2 hours and the perspective set to per application performance affected users and Application performance <100.
how is network for fastweb location? Opens Network overview filtered for Client site = *fastweb* and time set to Today.
what network performance did users from fastweb experience? Opens Network explorer, Overview, filtered for Client site = *fastweb* and time set to Today.
what is network rtt for fastweb location? Opens Network explorer, RTT, filtered for Client site = *fastweb*, and time set to Today.
which sites were queried in the last hour? Opens DNS explorer, Overview, with time set to Last one hour.
what software services are active on VLAN 0? Opens Network explorer, Overview, filtered for VLAN = 0.
what is the most active area now? Opens Network locations overview, Areas, with time set to Last 5 minutes.
which services were used by ctxuser? Opens Operation explorer, Overview, filtered by User name = *ctxuser*.
what is performance of server 172. for patient? Opens Operation explorer, Overview, filtered by User name = *patient* and Server name = *172.*.

New query options in NAM 2019 Service Pack 2

Applies to NAM 2019 SP2

The following are additional query options available starting with NAM 2019 Service Pack 2.

Query or query category Details
comparison queries Use compare to issue commands such as:
  • compare health between Gdansk and Linz - opens Operation explorer, Overview, filtered by Client site = *Linz* | *Gdansk* and Traffic type = Real
  • compare network between Gdansk and Linz - opens Network explorer, Overview, filtered by Client site = *Linz* | *Gdansk*
  • compare availability between Gdansk and Linz - opens Error explorer, Overview, filtered by Client site = *Linz* | *Gdansk*
report analysis queries Use commands like these to open the Report explorer for analyzing report usage.
  • Analyze Operation explorer usage - opens Report explorer to analyze the Operation explorer report from a usage perspective.
  • analyze Operation explorer modifications - opens Report explorer to analyze the Operation explorer report from a modifications perspective.
  • Who has Operation explorer as home page - opens Report explorer to display users who have set the Operation explorer report as their homepage.
  • Who has favorited Operation explorer - opens Report explorer to display users who have set the Operation explorer report as a favorite.
  • who liked Operation explorer - opens Report explorer to display users who liked the Operation explorer report.
opening and running commands
  • execute print java info - runs the PRINT JAVA INFO command.
  • execute DMI DATAVIEW COLUMN STATISTICS CVENT.TfcOnLink - runs the DMI DATAVIEW COLUMN STATISTICS command for CVENT.TfcOnLink.
  • command asdf - (where asdf is an unknown command) opens the command list with a search box.
  • command HTML LIST ICONS - runs the HTML LIST ICONS command.
  • command log profile add with DMI 'Test me' 5 1000 0 OFF opens the DMI DATAVIEW COLUMN STATISTICS command with the specified optional parameters populated.
    • Module = DMI
    • Class mask = Test me
    • Level = 5
    • Period = 1000 (minutes)
    • Delay = 1000 (minutes)
user profile queries
  • To display User profile for user chris, these alternatives are equivalent:
    • chris profile
    • show chris profile
    • profile of chris
  • To display User profile for yourself (the user currently logged in), these alternatives are equivalent:
    • my profile
    • my user profile
    • show my user profile
  • To display the Users list, these alternatives are equivalent:
    • user profiles
    • show user profiles
  • To display the Users list filtered for *admin*, these alternatives are equivalent:
    • admin profiles
    • show user profiles for admin
importing reports To open Export/Import Reports for importing a DMI report, these alternatives are equivalent:
  • import report
  • import reports
reviewing log files To open the server logs browsing tool, these alternatives are equivalent:
  • logs
  • show logs
  • browse logs
configuring properties
  • Advanced properties examples:
    • configure rtm properties - opens Advanced properties for configuring rtm properties.
    • configure advanced properties for admin - opens Advanced properties.
  • System properties (server-specific properties) examples:
    • configure user properties
    • show global properties
    • configure user properties for adminuser - opens System properties for user adminuser.
  • User properties (user-specific properties) examples:
    • configure general properties for me
    • configure my system properties
applying patches
  • apply patch or apply patches - opens Patch assistant for uploading and installing patches.

Setting the time range

Each question in a full-sentence query, or in an action to open a report by name, can be finished with an in or over followed by one of the time range phrases in the following table. A report using a time phrase in the left column will be opened in the time range indicated in the right column.

Supported time range phrases Displays report for this time range
  • now, recently
last monitoring interval
  • last 1 hour, the last 1 hour, last 1h, the last 1h, last one hour, the last one hour, last hour, the last hour
  • last 2 hour, the last 2 hour, last 2 hours, the last 2 hours, last 2h, the last 2h, last 2hrs, the last 2hrs, last two hour, the last two hour, last two hours, the last two hours
[etc.]
Last N hours
  • today, this day
Today
  • yesterday, 1 day ago, one day ago, the previous day, previous day
Yesterday
  • 2 days ago, two days ago
  • 10 days ago, ten days ago
[etc.]
N days ago
  • last 7 days, last 7 day, last seven days, the last 7 days, the last 7 day, the last seven days
Last 7 days
  • last 30 days, last 30 day, last thirty days, the last 30 days, the last 30 day, the last thirty days
Last 30 days
  • week to date, this week
Week to date
  • full week, last full week, previous week, the full week, the last full week, the previous week
Full week
  • month to date, this month
Month to date
  • full month, last full month, previous month
Full month
  • last 3 months, last three months, the last 3 months, the last three months
Last 3 months
  • last 12 months, last twelve months, the last 12 months, the last twelve months
Last 12 months
  • quarter to day, this quarter
Quarter to day
  • year to day, this year
Year to day