Reference: Application based properties

The application related configuration of nJAMS Client for Mule4 takes place in a separate nJAMS properties file for each MuleSoft Runtime Engine application instance. Typically the name of the application related nJAMS property file follows this pattern: <name_of_service>_njams4.json. You can edit the properties file according to your needs.

This is the reference of available application related nJAMS Client for Mule4 properties.

Note

Any change in this configuration file requires a re-start of the MuleSoft Runtime Engine application instance.

LogMode

logMode:

Controls operation mode of the nJAMS Client for Mule4:

complete nJAMS Client for Mule4 will monitor flows of MuleSoft Runtime Engine (default).

exclusive nJAMS Client for Mule4 will only monitor flows of MuleSoft Runtime Engine that generate nJAMS event(s) on the execution path. When there is no nJAMS event created on the execution path, nJAMS Client for Mule4 does not send a log message.

none the nJAMS Client for Mule4 functionality is completely disabled.

LogLevel

Loglevel controls the log level of a MuleSoft Runtime Engine application. For example, if logLevel = ERROR, nJAMS Client for Mule4 will only send log events, when an error event is generated during execution.

logLevel:

Valid values for Loglevel can be:

0: Info (default)

1: Success

2: Warning

3: Error

Exclude

This setting allows to exclude executions from being monitored by nJAMS.

exclude:

Turn on/off excluding MuleSoft Runtime Engine flow executions.

true excludes flow.

false do not exclude flow (default).

Activity configuration

Contains Tracing and Extract configuration for activities.

For example:

"activities" : {
"ClassificationByGenre" : {
    "tracepoint" : {
    "starttime" : "2019-11-05T08:00:00.000",
    "endtime" : "2019-11-05T09:00:00.000",
    "iterations" : 0,
    "deeptrace" : false
    }
}

Data Masking

Data Masking allows you to mask particular parts of Trace Data, which should remain confidential. Assume you have Tracing enabled for an activity that processes password information. By default, the nJAMS UI provides Trace Data including the password information in plain text. To prevent password information from being shown in plain text, you can use Data Masking. This setting can be applied to the entire application or to individual processes.

dataMasking:

Enter a regular expression. For example, the following regular expression replaces any information that matches XML tag “Password” in Trace Data with an asterisk character (“*”):

"dataMasking" : [ "<Password>(\\p{Alpha}|/|\\p{Digit})*</Password>" ]

Example

This is an example of an application based nJAMS Client for Mule4 properties file:

{
"logMode" : "COMPLETE",
"processes" : {
    ">SuperHeroService>Demo>SuperHeroService>getRocketsFlow>" : {
    "logLevel" : "INFO",
    "exclude" : false,
    "activities" : {
        "HTTP /rockets" : {
        "extract" : {
            "name" : "ExtractruleType",
            "extractRules" : [ {
            "attribute" : "businessService",
            "attributeType" : "attribute",
            "ruleType": "value",
            "rule": "SuperHeroService",
            "inout" : "out"
            }, {
            "attribute" : "eventType",
            "attributeType" : "event",
            "ruleType" : "value",
            "rule" : "info",
            "inout" : "out"
            } ]
        },
        "tracepoint" : {
            "starttime" : "2019-10-22T14:28:00.054659",
            "endtime" : "2019-10-22T14:43:00.054659",
            "iterations" : 0,
            "deeptrace" : false
        }
        }
    },
    "recording" : true
    }
},
"dataMasking" : [ ],
"recording" : true
}