Overview of Insight Inspector

Insight Inspector is a web application that helps you review and analyze solutions. You select a solution to record during a test run and then review and inspect the events and entities that are associated with each solution agent.

Insight Inspector presents a list of solution recordings identified by solution name. Click a solution name to display entities, agents, and event timelines that are organized into groups according to the entity type. The application displays useful data about the events, entities, and errors that are processed when you create and run a test from a test client project.

The following diagram and table provide an overview of the steps that you perform to prepare a solution for testing, to record a solution test run, and to review the recording by using Insight Inspector.

Restriction: Insight Inspector is not intended for use with production servers.
How to review a solution by using the Insight Inspector
Table 1. Steps to inspect a solution
Step Description and where to learn more
Install and configure a development server. Insight Inspector records solution tests that run on a development server.

See Creating a development server.

Deploy the solution that you want to test to the development server. You can deploy a solution by running the solutionManager script, or by using JMX MBeans.

See Deploying solution and agent archives.

Record a test. Add the startRecording method to the test driver in a test client project class. Use the startRecording method in the TestDriver API to create a recording during solution processing. You can also use RESTful commands to start and stop a recording.

See Starting and stopping a test recording by using test driver.

Run the test client project that includes the test driver to create entities and emit events. Run the test client project with a test driver instance to capture the behavior of the solution.

See Loading entities and submitting events by using TestDriver.

Stop the recording. Add the stopRecording method in the test client project class. See Starting and stopping a test recording by using test driver.
Open Insight Inspector and review the solution recording to examine events in detail. Enter the solution recording URL in your browser to open the Insight Inspector window. You must have the tester or administrator user role, or an equivalent level of access, to run Insight Inspector.

See Opening Insight Inspector.

Select a recording. Review the list of agents that are grouped by entity type, and examine the processed and emitted events that are associated with the agents. Select an event to see detailed information about the event and the entity associated with the event.

See Inspecting a solution timeline.