...
Definition of the sensor type
Configuration
...
basics
Using the UI configuration interface no configuration is required at all as method sensor types are activated automatically if a profile defines such sensor assignment.
Configuration using configuration file(s)
The method sensor type definition is necessary to specify that a certain sensor is available to inspectIT. Based on this configuration the concrete methods that should be monitored using the invocation sequence tracer can be specified.
...
...
method-sensor-type isequence info.novatec.inspectit.agent.sensor.method.invocationsequence.InvocationSequenceSensor INVOC
| Info |
|---|
Compared to other method sensor types, the INVOC priority is mandatory here and reserved for an invocation sequence sensor. |
Associating a method with an invocation sequence
Configuration
...
basics
Using the UI configuration interface it is not possible to directly use invocation sequence sensor. The method can be marked as the one that starts the invocation with in the Timer Sensor assignment options.
Configuration using configuration file(s)
The association of a method with the invocation sequence sensor can be done like with all other method sensor definitions (see the Agent Configuration for the concrete documentation on the possibilities of setting method sensors).
| Code Block |
|---|
sensor isequence info.novatec.inspectitsamples.calculator.Calculator actionPerformed |
Sensor assignment specific options
The invocation sequence sensor provides the following sensor specific options.
Option | Description | Type | Example | |
|---|---|---|---|---|
minduration | define Minimum duration | Define the minimum time an invocation has to consume in order to be saved and transmitted to the server. This helps in reducing the data load from the Agent to the CMR and is a good filter for not so important invocations. | optional | sensor isequence novatec.SubTest msg(int) [INSPECTIT16:name] minduration=10.0 |
Example
...
Examples
Visit Examples page in order to understand how to activate Start invocation option with the UI based configuration interface
...
| title | Configuration using files |
|---|---|
| collapse | true |
...
.
...
What will inspectIT do with this configuration:
- The actionPerformed method is defined as the starting point of the invocation sequence sensor, thus everytime this method is called, it will record a trace
- The timer sensor type is instrumented in the whole application (this is only due to understand the system better, it is never good to instrument everything!)
- Every time the invocation sensor is started, all timer measurements are stored in this context so that the relation between the measurements and the invocation can be reconstructed in the user interface
String length
from version 1.3
This sensor enables the limitations of the string values collected. The invocation sensor concretely can limit the maximum size of the strings collected as context parameters.
Configuration
...
basics
The string length configuration for all sensors is available in the Environment configuration.
Configuration using configuration file(s)
The following definition will, for example, limit all the strings collected by the sensor to 500 characters:
| Code Block | ||
|---|---|---|
| ||
method-sensor-type isequence info.novatec.inspectit.agent.sensor.method.invocationsequence.InvocationSequenceSensor INVOC stringLength=500
|
You You can read more about string length limitations on Sensor type definition pagelimitations Environment configuration page.