ContextPropertiesFilters - System Parameter
Unlock advanced control over your log data with the ContextPropertiesFilters system parameter. This powerful feature automatically filters and removes sensitive or unnecessary context properties from Log Events, helping you meet security standards, optimize performance, and reduce storage costs—all while ensuring compliance with information security requirements.
✅ Reduce disk space in the Log Databases by eliminating unnecessary data
✅ Remove sensitive information automatically to protect confidential data
✅ Boost performance as less data is processed and stored
✅ Shrink database backups for faster, more efficient storage management
✅ Automate compliance with advanced filtering and real-time data control
The System Parameter ContextPropertiesFilters empowers the Logging Service to automatically remove sensitive and unnecessary context properties, preventing unwanted data from consuming disk space in the Log Databases. The Nodinite Log API can also filter entries in real time, ensuring only relevant data is stored and unwanted information never enters the system.
When a context property name matches a filter, it is removed during processing—including re-index operations. If the value is null
or the global Enabled flag is false
, context properties remain untouched.
System Parameter Name | Data Type | Values/Example | Comment |
---|---|---|---|
ContextPropertiesFilters | json | JSON object as exemplified later on this page | Default = null |
This feature was introduced in version 6.0.0.11.
JSON Structure and Examples
This is an advanced feature. By default, it is set to null
(DBNULL), meaning filtering is not active until configured.
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 maximum processing time for each entry is 25 milliseconds. Avoid overly complex expressions for best performance.
- Description – An optional field describing the intent
- Enabled – Individual entries may be enabled or disabled. You do not have to remove an expression if you are experimenting 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 used by the Nodinite Logging Service to process BizTalk Log Events and set the correct Event Direction.
Tip
Leverage the power of RegEx—fewer entries perform better. Internal loops handle the filtering for maximum efficiency.
Important
This feature permanently removes data. Make sure you understand the impact before enabling!
Frequently Asked Questions
Find more solutions and answers in the Nodinite System Parameters FAQ and 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 Topics
- ProtectedContextValues – Hide the values for Context properties.
- Install and Update Tool