Adding a software service with the wizard

Monitoring ► Software services, then click Add software service and select With wizard

Use this wizard to define a software service to be monitored using the HTTP or HTTPS analyzer.

Tip

See Software services for beginners for more information on choosing a software service creation method.

Starting the wizard

  1. In the NAM Console, open the main menu

    and select Monitoring ► Software services.

  2. Click the Add software service button.
    The Add software service window is displayed with three options:

    • With wizard
    • Manually
    • Using packaged applications

    Add software service

  3. In the With wizard section, click

    The first screen of the Web configuration wizard is displayed: Software service.

    • Complete the wizard pages in order to define your software service.
    • Use the Previous and Next buttons to navigate.

1 - Software service

Describe the basic information identifying the software service.

  1. Analyzer
    This can be HTTP or HTTPS. If you need a different analyzer, you cannot use the software service wizard.
  2. Software service name
    The name under which to list and sort your software service.
  3. Rule description
    A software service can have more than one rule, so this name is used to distinguish one rule from another within a single software service.
  4. NAM Probes selected for the software service
    A list of monitoring devices for this software service. Clear the machine that do not apply.

2 - Services

Define the services by specifying the IP address or range of addresses and port range.

  1. (Optional) Traffic trace
    You can record a traffic trace now or select a previously recorded trace from the list, then get addresses and ports from the trace. For details, see Recorded traffic.
    If you already know the address and port information, however, you can click Add (over in the List of services) and manually provide the IP address and port information in the pop-up window.
  2. Profiles
    Choose which part of the traffic observed by the NAM Probes is taken into account for configuration. Usually, the traffic is assigned to one profile at a time, but in some cases, you may want to add more profiles. For example, to have SOAP over HTTP traffic monitored with the HTTP analyzer, you need to select the SOAP profile in addition to the default HTTP profile.
  3. Statistics
    In the Statistics section, you can view the detected services together with the parameters of a given type and add the services to the monitoring list. When you see a service that you want to monitor, select the check box to add it to the List of services.
  4. Category
    To change the preview settings, change the parameter type using the Category list. The section contents are updated accordingly. Note that different categories are available depending on the profile selected. For example, HTTP profile will not list an XML tag as a category.

3 - URLs and parameters groups

Define the URL to be monitored.

  1. Click ADD URL to specify the URL to be monitored or excluded from the monitoring by indicating the type of the URL, the actual URL and the URL analysis profile (Web, SOAP/XML or Oracle Forms).
    After the URL is added, you can edit its parameters or design your custom reporting based on the occurrence of particular strings in your traffic.
    For more information on adding a URL to be monitored, see Configuring URL monitoring.
  2. Parameter groups lets you create parameter groups that consist of parameter definitions as to where the parameter occurs (Search scope), the parameter value itself, and whether the value an exact match or is it at the beginning or and end of the parameter (Match Method). Custom RegEx will allow you to use regular expression in the parameter value.
  3. Reported elements lets you design your custom reporting based on the occurrence of particular strings in your traffic. You can:
    • Define grouping attributes by specifying the rules to be applied to the request URL or response body.
    • Extract miscellaneous parameters from the request or response body.
    • Define custom metrics to monitor certain types of measurable data.
    • Analyze and categorize operation attributes (text entities retrieved from requests and responses of a web operation).
    • Extract correlation IDs used to match asynchronous operations.
    • Extract the EBS module name used in Oracle EBS monitoring.
    • Edit the steps for each extraction rule that you have created.
  4. For more information on the search options available to you for each defined step, see Searching within the payload.

4 - User name recognition

On this page, define the user recognition method. You can:

  • Find the user name and define the user name rule if you know which request part contains user login information, filter or search traffic for a specific POST/GET parameter, a cookie name or a whole HTTP header. If you know what a user login is, search for the login sequence in the traffic trace.
  • Refine the user recognition schema with additional session ID rules (some web servers use session ID to keep user sessions). If you define a session ID rule, user recognition may work better and return more precise results. To add a session ID rule, add user name rule first, then select session ID parameter from filter or search. You can define a session ID rule manually.
  • Refine the user recognition schema with additional session Acknowledge URL rules.
  • For more information on the search options available to you for each defined step, see Searching within the payload.

5 - Summary

The summary panel presents your software service definition for review.

At a minimum, verify the following:

  • Analyzer shows the traffic analyzer you need for this software service: HTTP or HTTPS
  • Software service name shows the name under which you want to list and sort your software service
  • Selected services lists the addresses and ports on which this software service is supposed to watch traffic

After you have checked the above:

  • If you are satisfied with your software service definition, click Apply to save the software service definition.
  • If you need to go back and change anything, click Previous to step back through the wizard.