Chatta subito con l'assistenza
Chat con il supporto

Foglight for Java EE Technologies 5.9.13 - Application Servers User Guide

Monitoring Application Servers Monitoring Systems Monitoring Servers Monitoring Deployed Applications Monitoring Requests Managing Traces Using Object Tracking to Locate Memory Leaks Monitoring Methods Application Servers Monitor Views
JVM view Method Groups view Request Types view Entity EJBs view Message Driven EJBs view Stateful Session EJBs view Stateless Session EJBs view Deployed Applications view JSPs/Servlets components view Resource Adapters components view Web Applications components view Web Services components view .NET views JBoss Services views Oracle Services views Tomcat Services views WebLogic Services views WebSphere Services views JMX Administration dashboard JMX Explorer dashboard
Appendix: Regular Expressions

Using a rule action to collect single traces

As an alternative to manually collecting single traces using the interface, you can add a RequestTracesAction to any rule to collect single traces to assist during issue diagnostics.

For example, a request type is experiencing high response times and you have a rule that sends alarms when it reaches the threshold. You can specify the RequestTracesAction to collect single traces on a specific request type to monitor the issue.

1
On the navigation panel, under Dashboards, click Administration > Rules & Notifications > Rule Management.
5
Click the Conditions, Alarms & Actions tab.
7
From the Action menu, select RequestTracesAction.
8
Click Add to add the RequestTracesAction.
Request Type — Use this action parameter to specify unique request types.
Collect Parameters — Use this action parameter to collect all parameters.
Collect in full detail — Use this action parameter to indicate whether you want to collect methods in full detail or component detail (the default).
Count — Use this action parameter to specify the number of traces being collected.
Criteria — Use this action parameter to specify one or more criteria.
Duration — Use this action parameter to indicate the time period to collect the number of traces.
Is Regular Expression — Use this action parameter if you want to specify the Request Type using regular expressions to match the request type for a single trace collection.
Match All criteria — Use this action parameter to limit the trace collection to all or any of the following criteria:
The agent name IDs — Use this action parameter to specify the agentNameIDs property of the agent that you want to collect traces on.
Track SQL Parameters — Use this action parameter to track SQL bind variable values. The default value is set to Off.
9
In the Value column for Request Type, click Default and specify the value.
Click Change to update the action parameter.

For more information about rules, see Getting started: view and edit rule definitions in the Foglight Administration and Configuration Help.

Related topics:

Using Groovy to collect single traces

You can also use a Groovy script to collect single traces. In Groovy, request types are specified by a regular expression, so the same set of single trace criteria can be used for a group of request types.

When you have a group of request types for which you want to collect single traces using the same criteria, set the criteria using a Groovy script called from the command line (for example, using fglcmd). The collected single traces are stored on the Foglight Management Server, and displayed in the Application Servers Monitor > Requests view for users to review. Use the following function to trigger the collection of requested traces.

This function is used to collect traces in Groovy. Set all the following arguments:

requestType: String

Request type to collect trace.

isRegEx: Boolean

Request type for which to collect a trace defined as regular expression (true/false).

tracePeriod: Long

Duration (in seconds) of the request to trace.

count:Integer

The number of traces to collect.

CollectInFullDetail:Boolean

Collect in Full Detail (true/false).

For details about instrumentation levels, see Appendix: Application Methods in the Foglight for Java EE Technologies Installation Guide.

trackSQLParams:Boolean

Track SQL Parameters (true/false).

matchALL:Boolean

Match all the criteria (true/false).

criteria:List

A list of criteria. See the next table for details.

CollectParameters:Boolean

Collect all trace parameters (true/false).

agents:List

List of agents to collect traces on. If the list is empty or null, then traces are collected on all agents.

Criteria are specified as a list of one or more strings.

all

all

none

none

responseTimeOver:t

ReponseTimeOver:600001

responseTimeUnder:t

ResponseTimeUnder:10001

exceptional

exceptional

incomplete

incomplete

traceParameterContains:k:v

traceParameterContains:name:Bob

traceParameterDoesNotContain:k:v

traceParameterDoesNotContain:name:Tom

traceParameterIs:k:v

traceParameterIs:user:Bob

traceParameterIsNot:k:v

traceParameterIsNot:user:Tom

traceParameterStartsWith:k:v

traceParameterStartsWith:accountnumber:0

traceParameterEndsWith:k:v

traceParameterEndsWith:accountnumber:9

1 Criteria are in milliseconds.

For example:

Related topics:

Viewing traces

After you have configured trace collection, you can review the trace details through the Traces view.

1
3
In the Traces column of the Request Types table, click the number of traces for the request.
The Traces view opens, displaying both Aggregated Traces and Single Traces.
4
Optional — To view aggregated trace details, click a server name in the Aggregated Traces table, or to view single trace details, click a server name in the Single Traces table. The Trace Diagnosis view opens.

Traces view

Use the Traces view to review individual traces of a selected request. This view is divided into four sections: Aggregated Traces table, Single Traces table, Component Technology Breakdown, and Performance charts.

From the Traces view, you can set a breakdown of execution time by selecting Tiers and Component Technologies. By setting any of these options, a selected single trace or an aggregate trace can be used as a comparison benchmark for all the traced metrics. Once specified, both the list view and the tree view display the comparison in the Average Execution Time and Average Exclusive Time columns, and the rest of the metrics comparisons are shown at the bottom of the page, in the method details area.

To learn more about how to set a breakdown, see Viewing breakdowns .

Related Documents

The document was helpful.

Seleziona valutazione

I easily found the information I needed.

Seleziona valutazione