Each software service can have a number of specific rules that define what is to be monitored and what additional options are in effect. You can also assign each software service to existing or newly created tiers and applications.
Before You Begin
It is assumed that, for this task, you are already familiar with the concept of software services and that you know how to create and edit software services and how to open the Rules window. For more information, see Configuring User-Defined Software Services in the RUM Console Online Help.
After a user-defined software service is created, create a group of settings that comprise the rules for the software service. It is necessary to specify, at minimum, the IP addresses and port numbers for the software service.
To configure rules for a user-defined software service: 1. Open the Services tab.
2. On the Services tab, select or clear Enabled to activate or de-activate the service definition. 3. In Rule description, type a brief description to identify the rule.
The description you enter is shown in the Rules table, in the column Rule Name. If no text is entered here, the IP address specified later is used as the description for this rule. 4. Right-click in the Services table and select Add or Open from the context menu.
• To quickly navigate to an entry in this table, click in the table and then type some or all of the IP address.
• Click the magnifying glass icon or press [Ctrl+F] to open a search box to limit the table view to only those rows that contain a match (in any column) to the search string. The Service Details window appears when adding or editing the rules.
5. In the Service Details window, in the IP address(es) fields, enter the server IP address, or enter a range of IP addresses to monitor more than one server.
6. In the Port(s) fields, enter the port number of the monitored service.
You can provide a range of port numbers if such a range of ports is used in your environment. Some software services may be active on a number of predefined ports or may change ports dynamically. To allow for this, you can specify a range of ports. However, specifying more than one port for a service prevents the port number from being reported for that service. If you define more than one port for a particular service name and server IP address (by either specifying a range of ports or by creating two or more distinct rules for the same
service name and server IP address but with different port numbers), the AMD reports the port number for this service as 0, causing the port number to be ignored in traffic reports. NOTE
You can define up to 5000 definitions containing a server and a port. Each association of a server and a port counts as a single definition. Specifying a range of ports counts as providing many individual definitions.
On CAS, the number of processed server definitions is limited by the license. For more information, see Per-Measurement Licensing in the Data Center Real User Monitoring Administration Guide.
Advanced Configuration
7. Optional: Select Client port(s) for reversed-direction protocols.
This option applies only to protocols such as X-Window whose client-server meanings are reversed. If you are uncertain, leave this option cleared.
8. Optional: Select or enter a Group name
Part of URL auto learning configuration. By default, the URL auto-learning mechanism stores the URLs from all the the servers defined in the software service in one pool. You can create separate pools within a single software service based on a number of servers. This way, you ensure the URLs monitored on a server with a lower traffic do not have to compete with URLs from a much larger server in terms of volume. You achieve this by assigning servers to groups within a single software service which translates to separate pools. To create a seperate pool for a group of server, keep them under a common group name of your choice. For more information, see Details of the URL Auto-Learning Algorithm in the Data Center Real User Monitoring Web Application Monitoring User Guide. NOTE
It is important that grouping within the services definition is consistent. Defining services with that same IP address but different ports and assigning them to different groups results in the generation of redundant and irrelevant data.
9. Optional: Enter the main server IP address.
If the monitored application runs on several servers that are linked together in a farm, you can monitor the farm as one virtual server. Type the IP address that you want to use as your main server IP address.
10. Optional: Enter the IP address of the server masking the addresses of monitored servers. If the servers you intend to monitor reside behind an appliance that masks and replaces the addresses of the target servers, you need to set NLB NAT masking IP address to the IP address of the masking server.
Without doing so, the AMD will see two unidirectional conversations instead of one bi-directional conversation between the servers and appliance:
• The conversation between the client and server is observed and recorded (IP address A talking to IP address B)
• When a response travels to the client, a different session (IP address C talking to IP address A) is recorded due to the server's IP address being replaced by the load balancer's IP address.
Unless you account for this, CAS reports will return ambiguously granulated data. Using the NLB NAT masking IP address option will ensure that the AMD monitors contiguous conversations.
11. Optional: Map client IP to client group name.
The mapping allows you to catalog and report traffic going to the same server IP and port by associating client group names with the originating client IP. On the report, the client group name is be reported as a suffix to the software service name.
For example, a software service named “SQL” configured on a server located at 10.1.1.10 can be configured the following way:
Software Service name suffix Client IP Address
_ATLANTA 10.1.1.1
_BOSTON 10.1.1.2
The system will differentiate the “SQL” software service traffic going to the server based on the client IP definition and report data for software service “SQL_ATLANTA” and “SQL_BOSTON” individually.
The default configuration containing no client IP definitions results in an empty client group name. Similarly, an empty group name is used if a client IP is not included in any of the defined IP ranges. This configuration makes it possible to obtain only the client group name.
The same client group name can be used in many client IP ranges. The configuration of each software service is individual per client group name. No cross-relations or cross-checks are performed between the definitions. It is possible to use a different name for the same client IP in each of the software services.
12. Click OK to confirm your changes and close the Service Details window. 13. Configure the settings on the available tabs.
The number of available configuration options depends on the analyzer. See the analyzer-specific section for more information.
14. Optional: On the Options tab, define analyzer-specific options.
The following list describes all possible options. Depending on the analyzer, some may be unavailable:
Operation load time threshold
An operation that takes more than this many seconds is considered slow. When Inherit from global setting is selected, the global setting is used. The global threshold value depends on the analyzer.
Operation time threshold
An operation that takes more than this many seconds is considered slow. When Inherit from global setting is selected, the global setting is used. To edit the global setting,
open the AMD configuration, select Global ➤ General and set the Operation time threshold.
Server time threshold
Server time threshold relates to the server time portion of an overall operation time. Server times above the threshold limit are considered to be slow due to the poor datacenter performance. When Inherit from global setting is selected, the global setting is used. To edit the global setting, open the AMD configuration, select Global ➤ General and set the Server time threshold.
SQL query time threshold
A database query that takes more than this many seconds is considered slow. When Inherit from global setting is selected, the global setting is used. To edit the global setting, open the AMD configuration, select Global ➤ Database Monitoring ➤
General and set the SQL query time threshold. Enable monitoring of persistent TCP sessions
When this option is selected, the TCP sessions that do not start with SYN packets are monitored. By default, this option is selected.
Persistent TCP sessions are TCP sessions for which the start was not recorded. They are also referred to as non-SYN sessions. These sessions can be included in the TCP statistics, based on the configuration properties you enable in RUM Console. The inclusion of these sessions may render the statistics somewhat inaccurate and must be undertaken with care.
Generate transactions and ADS data
Select this option to provide the report server with, for example, raw HTTP traffic data enabling you to view the full HTTP request-response dialog.
SQL Server uses dynamic ports
This option only applies to the TDS analyzer.
Select this option if the database engine you intend to monitor does not have a static port number assigned (for example, a named instance). In this case SQL Server Browser Service (SSBS) is used to discover the actual port of the service. The AMD uses additional UDP analysis of the SSBS to discover the port number for the service you intend to monitor.
If you select this option make sure that the connection details specified on the Services tab identify the SQL Server Browser Service (use the IP address of the server and the port number of the SSBS).
Do not enable this option if your SQL Server uses static ports. Convert the XML content URL-encoding
This check box defines whether the XML URL-encoding content is enabled. When Inherit from global setting is selected, the global XML setting is used.
URL parameter name that contains URL encoded XML document
Provide the parameter name that contains a URL encoded XML document. If this field is empty, the AMD will not analyze XML documents sent in URL parameters. 15. Configure availability
Select the Availability tab to configure the availability reporting at the software service level, overriding the global settings. The scope of failure reporting depends on an analyzer. For more information, see Configuring Availability in the Data Center Real User Monitoring Administration Guide.
16. Click OK.