- 3 minutes to read

ContextPropertiesFilters - System Parameter

This feature helps you comply with information security standards, so you can run more securely and efficiently 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 overall performance as less data is stored in the system.
✅ As a result, your database backups also become smaller.

The System Parameter ContextPropertiesFilters allows the Logging Service to remove sensitive and unnecessary context properties that would otherwise waste disk space in the Log Databases. The Nodinite Log API can also filter entries on the fly, ensuring unwanted data never even enters the Log Databases.

If there's a match on the name of the context property, it will be removed during processing, including re-index operations.

If the value is null, or the global 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 in 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 or false

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

Administration