ContextPropertiesFilters - System Parameter
This feature aids in complying with information security, hence; you run more securely and faster than ever before
Reduce disk space in the Log Databases.
Remove potentially sensitive data that you do not want Nodinite to store over time.
Increase the overall performance as less data is in the system.
As a result, your database backups also get smaller.
You cannot use Search Fields on data that does not exist (!).
The System parameter ContextPropertiesFilters allows the Logging Service to remove sensitive and unnecessary context properties that just waste disk space in the Log Databases. The Nodinite Log API also rids entries on the fly; e.g. the unwanted data does not even enter the Log Databases.
If there's a match on the name of the context property, then it will be removed during processing, which includes re-index operations.
If the value is null
, or the "global" flag Enabled flag is false
, context properties are not removed from the system.
System Parameter Name | Data Type | Values/Example | Comment |
---|---|---|---|
ContextPropertiesFilters | json | json object as exemplified later on this page | Default = null |
This feature was introduced with version 6.0.0.11
JSON Structure and Examples
This is an advanced feature; The default is null
(DBNULL) meaning the feature is not in use.
Global settings
- Enabled - Global flag,
true
orfalse
Filters array
The Filters array holds the entries to use in the match.
- RegExFilter - The regular expression, a RegEx (case insensitive). The max time for the processing of each entry is set to 25 milliseconds. Make sure to not use too complex expressions.
- Description - A handy optional field describing the intent
- Enabled - Individual entries may be enabled/disabled. You do not have to remove an expression if you are toying with this feature.
{
"Enabled": true,
"Filters": [
{
"RegExFilter": "pAssWOrd",
"Description": "This filter removes all context properties with password in the name (case insensitive)",
"Enabled": true
},
{
"RegExFilter": "http://schemas.microsoft.com/BizTalk/2003/file-properties#SecretKey",
"Description": "Remove the secret key in use on dynamic send ports",
"Enabled": true
}]
}
Important
Do NOT remove the
http://schemas.microsoft.com/BizTalk/2003/system-properties#MessageExchangePattern
as this is in use by the Nodinite Logging Service to process BizTalk Log Events to set a proper Event Direction
Tip
Do make use of the power that comes with RegEx, less entries perform better. This is because internal loops perform the filtering.
Important
This feature removes data permanentely. Make sure to know what you are doing!
Frequently asked questions
Additional solutions to common problems and the Nodinite System Parameters FAQ exist in the Troubleshooting user guide.
How do I change the value?
Changing a value for the pre-defined System Parameters is described in the generic 'How do I change the System Parameters' article.
Next Step
Related
- ProtectedContextValues - Hide the values for Context properties.
- Install and Update Tool