Running and Viewing Synthetic Tests
This section describes the running and viewing of synthetic tests which are first created and then installed. For more information on creating and installing synthetic tests, see
Configuring Synthetic Test Profiles and
Installing Synthetic Test Engines.This section includes the following topics:
Working with tests on the Synthetic Tests tab
It is important to note the interaction between the Synthetic Testing page profiles (Configure > All Settings > Administer > Synthetic Test Sources) and tests that exist on the Synthetic Tests screen (More > Synthetic Tests). Specifically:
• Each row on the Synthetic Tests page represents one test. A “test” is the unique combination of one type, one test source (test engine), and one test target. Initially, tests are generated by profiles in the wizard.
• Using the action menu to toggle the Active state of an individual test affects only that test. Toggling the Active check box in the original profile affects all individual tests that were generated by that profile.
• Using the action menu to Move or Copy selected tests to another source automatically modifies the Test Sources settings in the profile that generated the test(s). Modifying the Test Sources list in a profile is equivalent to moving or copying individual tests on the Synthetic Tests page.
• Using the action menu to modify the Target URI of an individual test automatically modifies the Test Targets list in profile that generated that test. Modifying the Test Targets list in a profile affects all individual tests generated by that profile.
• Using the action menu to modify the Name of an individual test has no effect on the profile that generated that test. Modifying certain parameters in a profile affects the Name of all individual tests generated by that profile.
List of tests on the Synthetic Tests page
The controls and indicators on the Synthetic Tests page are:
• Select check box—Click the check box in the Name column to select a test of interest. All selected tests are subject to modification in the action menu.
• Action menu—From this menu you can do the following:
– Quick View—Shows the results of the last test.
– Edit—Allows you to modify the test name and the test URI.
– Run Now—Runs the selected test
– Activate—Enables the test to run at the frequency that is set in the test profile.
– Deactivate—Disables the test from running.
– Delete—Deletes the test.
– Copy to Test Source—Copies the test to the Synthetic Test Sources page.
– Move to Test Source—Moves the test to the Synthetic Test Sources page.
Filtering the set of tests that appear on the Synthetic Tests screen
To limit the set of tests that appear in the list, use the Test filter tool in the left-side panel. Each category corresponds to a property that can be associated with an individual test, as shown in the following screen.
Synthetic Tests filter tool
Working with test engines on the Synthetic Test Sources tab
The Test Sources page presents a list of the test engines associated with this instance of NetIM, as shown in the following screen.
Test engines
The controls and indicators on the Synthetic Test Sources page are:
• Select check box—Select the check box in the Name Column to select a test of interest. All selected tests are subject to modification in the action menu.
• Action menu—From this menu you can do the following:
– Edit Name—Modifies the display name(s) of test sources in all profiles and in all tests. Display names are initially derived from hostnames, but this command does not modify hostnames.
– Set location—Assigns a country and region, and city of this test source.
– Unset Location—Deletes location information.
– Delete—Removes the selected test source from the Synthetic Test Sources list and all associated tests from the Synthetic Tests list.
Filtering the set of test sources that appear on the Test Sources tab
To limit the set of tests sources that appear in the list, click Up or Down. Click All to show all test sources.
Test Sources filter
About deprecated and incompatible test engines and tests
The following conditions occur if you upgrade to NetIM without upgrading test engine software. See
Installing Synthetic Test Engines. After you upgrade test engine software, NetIM automatically redeploys tests to the sources, and these conditions will not occur.
• A deprecated test source
(
) is a test engine that is outdated but which continues to operate in a limited way. Tests on a deprecated engine continue to run, and their statuses continue to be gathered, but no details appear on the Sample Details tab. No test on a deprecated source can be edited, and no test can be copied or moved to that source. In addition, no test on a deprecated source can be Run Now because that action includes a redeployment.
• A deprecated test (
) is a test deployed on a deprecated test source. It continues to run, and its results continue to be gathered, but it cannot be edited, copied, or moved among test sources. It cannot be Run Now.
• An incompatible test source
(
) is a test engine that is outdated and non-functional. Tests on an incompatible engine can be removed, but not edited, copied, or moved.
• An incompatible test (
) is a test deployed on an incompatible test source. It does not function. It can be removed from its source, but not edited, copied, or moved.
Viewing test results on the Test Details tab(s)
To view test results, select a test, and then select Quick View in the action menu.
A pop-up window appears with the test results, as shown in the following screen.
Viewing the Synthetic Test details
Drilling down
When you click a node on the results graph (as in
Figure: Viewing the Synthetic Test details), the next panel depends on the currently selected time range:
• If the selected time range is Last Hour, Last 6 Hours, Last 12 Hours, or a Custom range that covers less than a day, the Sample Details page appears (as in
Figure: Viewing the Synthetic Test details) with the logged output of a single sample.
Sample Details page when Time Range >=1 Day (for an ‘HTTP Test’)
Viewing synthetic test sources
In 2.4.0, NetIM introduced support for a landing page for each synthetic test. To access the landing pages, follow these steps:
1. Log in to the NetIM UI as admin.
2. Choose More > Synthetic Tests. The Synthetic Tests page displays.
3. To view a synthetic test source page, click a synthetic test of interest under the Name column, and the source page displays.
The Synthetic Test source page displays the At a Glance tab by default, and supports a Browse tab for associated test configuration, and Metrics and Alerts tabs to allow you to view the associated metrics and alerts for the synthetic test.
The following screen shows the synthetic test attributes displayed on the Browse tab.
Synthetic tests attributes
Alerting the network operator to synthetic test results
The
Configuring an alert can alert the network operator to the positive or negative results of a synthetic test. See
Configuring an alert in the
Configuring Metric Alerts chapter.