$('a[name]').remove(); $('#ic-homepage__footer').before('

'); $("#tabs").tabs({ selected: 1 }); $("#ic-homepage__ic-tips").append( quickTipHTML() ); unhideOneProductTip(); $("#ic-homepage__product-tips").wrapInner('

'); $("#ic-homepage__feed-tips").wrapInner('

'); });

IBM Tivoli Monitoring > Version 6.3 > User's Guides > Agent Builder User's Guide > Test and debugging your agent IBM Tivoli Monitoring, Version 6.3


Full agent testing

Use full agent testing to test all attribute groups of your agent together. You can also use full agent testing to test data sources that cannot be tested using the attribute group test function.


You can use full agent testing to run the agent in the same way it runs in IBM Tivoli Monitoring without needing an IBM Tivoli Monitoring installation.


Procedure

  1. Open the Agent Test perspective:

    • Click Test the agent in the Test Agent section of the Agent Editor, Agent Information page.

      Figure 1. Test Agent section of the Agent Editor, Agent Information page.

    • Alternatively, from the Agent Builder menu select Window > Open Perspective > Other, select Agent Test and click OK .

    The Agent Test perspective opens (Figure 4). The Agent Test view shows agents that are currently being edited and are eligible to be tested. An Attribute Group Test view is also displayed. The Attribute Group Test view is initially empty. The Attribute Group Test view shows data that is collected from a selected attribute group when the agent is running.

    Tip: If no agents are being edited, the Agent Test perspective is empty. To populate the view, go to the IBM Tivoli Monitoring perspective and open an agent in the Agent Editor. When an agent is opened in the Agent Editor return to the Agent Test perspective to test the agent.

  2. Optional: Configure environment variables and configuration properties before you start the test. You can access the Environment Variables and Runtime Configuration windows in two ways from the Agent Test view:

    • Right-click the agent in the Agent Test view to open a selection menu. You can select Set Environment from the menu to open the Environment Variables window. You can select Configuration from the menu to open the Runtime Configuration window.

      Figure 2. Agent Test menu.

    • Click the view menu icon on the Agent Test view toolbar to access the Set Environment and Configuration menu items as in the previous choice.

    For more information about using the Environment Variables and Runtime Configuration windows, see (Attribute group testing).

    1. The agent is populated automatically with the last set of configuration that relates to each tested attribute group.

    2. Some environment variables can have different default values for attribute group testing and for full agent testing. For more information about environment variables with special values for attribute group testing, see (Test Environment variables).

  3. In the Agent Test view, select the agent that you want to test and click the start agent icon .

    A window indicates that the agent is starting. When the agent starts, its attributes groups are shown as children of the agent in the Agent Test view. The attribute groups are indicated by the attribute group icon .

    The status attribute groups that give information about the agent (Performance Object Status, Thread Pool Status and Take Action Status) are also shown as children of the agent in the Agent Test view. The status attribute groups are indicated by the information icon .

    You can start and run more than one agent at the same time.

    The stop agent icon becomes available when the agent is started.

    If your agent has subnodes or navigator groups, they are shown as nodes in the Agent Test view. Subnode definitions are shown under the agent. A subnode instance node is shown under the subnode definition node. Attribute groups and navigator groups are shown under the subnode instance node. For example:

    Figure 3. Agent Test view with example subnode and navigator group highlighted.

    You can right-click on any of the nodes in the Agent Test view to access menu selections like Edit and Stop Agent. Edit opens the Data Source Definition for the selected node in the Agent Editor.

    Changes that you make with the Agent Editor are not visible in the running agent until you stop and restart the agent.

  4. In the Agent Test view, select the first attribute group that you want to test.

    When you select an attribute group, a data collection begins for the selected attribute group. If the collection takes some time, a window indicates that the data collection is in progress. When the data collection is complete the collected data is displayed in the Attribute Group Test view, for example:

    Figure 4. Agent Test perspective

    If no data is displayed, a message 0 data rows returned is shown in the Attribute Group Test view. There are several reasons why the agent might not return data. These reasons include:

    • There is no data

    • Incorrect definition

    • Incorrect configuration

    You can check the reason why no data is returned by looking at the value of the Error_Code in the Performance Object Status attribute group. For more information about viewing the Performance Object Status attribute group, see step 9

    To collect data for another attribute group in the running agent, select the required attribute group. When you select an attribute group in the Agent Test view, the corresponding attribute group is displayed in the Agent Editor view.

  5. Optional: Run a second data collection, after the initial data collection, for certain attribute group types, to get useful data values. To run a data collection, click the collect data icon in the Attribute Group Test view.

    If the collection takes some time, a window indicates that a data collection is in progress. When the data collection is complete, the newly collected data is displayed in the Attribute Group Test view.

  6. Optional: Click an attribute column heading in the Attribute Group Test view to open the Attribute Information in the Agent Editor Data Source Definition tab. You can also access the same Attribute Information by right-clicking on any data cell in the table and choosing Edit from the menu. You can edit properties of the attribute in the normal way. Changes that you make are not visible in the running agent until you stop and restart the agent.

  7. Optional: Open multiple Attribute Group Test views at the same time. To open an additional Attribute Group Test view, click the view menu icon on the Attribute Group Test view toolbar and then select Open view for attribute group.

    When an additional Attribute Group Test view is opened, it displays the same attribute information as the original Attribute Group Test view. You can then select another attribute group in the Agent Test view to display different attribute group information in the original Attribute Group Test view. The first time another Attribute Group Test view is opened, it opens in the same location as the original view but with its own tab. To see the two views simultaneously, you can drag the tab to another location in the workspace.

  8. Optional: Select the subnode instance information attribute group, if your agent has subnodes, to see how the subnodes are listed in your agent (Figure 3). Selecting the subnode instance information attribute group shows subnode instance information in the Attribute Group Test view (for all online subnodes of the selected type).

  9. Optional: To see more information about the operation of the agent, you can select the Performance Object Status and Thread Pool Status attribute groups in the Agent Test view. These status attribute groups are indicated by the information icon . Select these groups to see status information about earlier data collections for your attribute groups.

    For example:

    Figure 5. The Attribute Group Test view that shows more information (Performance Object Status) about data collections for the Managed_URLs and Managed_Nodes attribute groups

  10. When you are finished testing your agent, click the stop agent icon


Parent topic:

Test and debugging your agent

+

Search Tips   |   Advanced Search