- 6 minutes to read

Add or manage Message Type

Message Types are the foundation that enables format-independent search across your integration landscape. This guide shows you how to create, configure, and optimize Message Types to unlock powerful search capabilities.

What you'll achieve:

  • ✅ Create Message Types for XML, JSON, EDI, flat files, and custom formats
  • ✅ Bind Search Field Expressions to extract searchable values from specific formats
  • ✅ Configure retention policies for events, context, and message bodies
  • ✅ Document with custom fields and metadata for governance
  • ✅ Analyze traffic patterns and endpoints for operational insights

New to Message Types? Read What is a Message Type? to understand how they enable cross-format search and correlation.

You can create a new Message Type, edit, or delete an existing one from the Message Types Overview.

A Message Type can have the following relationships:

You will see the Search Field Expressions from user-defined Search Fields in read-only mode.
Manage Message Type
This example shows how to manage the Message Type.

Basic data fields

  • You must provide a unique Name to create the Message Type.
  • Description: Optionally, add a user-friendly description.
  • Web Site: Optionally, provide a quick link for end-users, such as a WIKI or SharePoint site with additional documentation.

Remove old messages based on Message Type (Days to keep)

The Logging Service periodically removes old Events, Context, and Bodies.

  • You define the retention period per Message Type.
  • The system only removes logged events that are in the processed state.

Manage Retention
This example shows how to manage retention for Message Types.

Days to keep Events

Set the number of days to keep events for a given Message Type. If you set the value to zero (0), the system removes events on the next cleanup run.
The 'Never remove Events' option keeps data in Nodinite forever.

When the system removes Log Events, it also deletes comments.

Days to keep Context

Set the number of days to keep context data for Log Events of a given Message Type. If you set the value to zero (0), the system removes context on the next cleanup run.
The 'Never remove Context' option keeps data in Nodinite forever.

This value cannot exceed the 'Days to keep Events'.

Days to keep Bodies

Set the number of days to keep bodies for events of a given Message Type. If you set the value to zero (0), the system removes bodies on the next cleanup run.
The 'Never remove Bodies' option keeps data in Nodinite forever.

This value cannot exceed the 'Days to keep Events'.

Visualization of the days to keep for events:

graph TD subgraph "fal:fa-envelope-open-text Days to keep Events" baseInformation(Information about</br>the Event itself) searchFieldValues(Search Field Values) comments(Comments) subgraph "far:fa-key Days to keep Context" conntextValues(&nbsp &nbsp &nbsp Context &nbsp &nbsp &nbsp) end subgraph "fal:fa-file-code Days to keep Bodies" Bodies(&nbsp &nbsp &nbsp Body &nbsp &nbsp &nbsp) end end

The system bases the default values for a new Message Type on System Parameters from the configuration database:

  • DaysToKeepMessageEventsDefault: Sets the default number of days to keep events. Deleting an event also deletes its data/body message. The system assigns this value to new message types as default. You must restart the Logging Service if you change this value.
  • DaysToKeepMessageContextDefault: New 5.3 Sets the default number of days to keep context for an event. The system assigns this value to new message types as default. You must restart the Logging Service if you change this value.
  • DaysToKeepMessageDataDefault: Sets the default number of days to keep data in an event. The system assigns this value to new message types as default. You must restart the Logging Service if you change this value.

If you log too many Messages or Events, data searches may slow down.

Tip

Adjust these settings to fit your business needs. Only keep the data you need.

Custom Fields

As part of the Repository Model, you can add Custom Field values to provide additional documentation about your Message Type.
Custom Fields
This example shows an assigned value from a Custom Field.

Services

The system lists Services associated with the Message Type. Click the link to go to the associated Service.

This is where the magic happens! Search Field Expressions are bound to Message Types to extract searchable values from your integration messages.

How the binding works:

  1. You create a Search Field (e.g., "Order Number")
  2. You configure Search Field Expressions for that field—one per message format
  3. Each expression is assigned to specific Message Types (e.g., XPath for XML types, RegEx for EDI types)
  4. When messages arrive, the Logging Service evaluates only expressions matching the message's Message Type
  5. Extracted values become searchable in Log Views

Example: A "Customer ID" Search Field might have:

  • An XPath expression → Assigned to urn:schemas:orders:Order#Order (XML)
  • A RegEx expression → Assigned to EDIFACT.ORDERS.D96A (EDI)
  • A JSON Path expression → Assigned to https://api.orders.com/v1#Order (JSON)

All three extract the same business concept, but use format-specific techniques!

Search Field
This section shows all Search Field Expressions bound to this Message Type (read-only view).

To manage Search Field Expressions:

Click the Search Field name to navigate to its configuration, or go to Add or manage Search Field in Log Administration to create new bindings.

Learn more: Search Field Expressions Overview explains all 12 expression plugin types and when to use each.

Custom Metadata

As part of the Repository Model, you can add Custom Metadata to provide well-structured, additional documentation about the Message Type.

Statistics

Use perpetual Statistics to analyze traffic patterns for the selected Message Type. The statistics also show a list of tracked Endpoints on the Message Type.
Message Type Statistics
This example shows the recorded traffic pattern and its known Endpoints on the selected Message Type.

Next Steps

Now that you've configured your Message Type:

  1. Add or manage Search Field – Bind Search Field Expressions to this Message Type
  2. Search Field Expressions Overview – Explore all 12 expression plugins (XPath, RegEx, JSON Path, etc.)
  3. Add or manage Service – Organize Message Types within Services
  4. Log Views – Use this Message Type to filter logs for specific teams

Understanding the Concepts

Message Type Conceptual Overview – Understand how Message Types enable cross-format search
What is a Search Field? – Learn how Search Fields extract business-critical values
Repository Model – See how Message Types fit into the overall architecture

Message Types Overview – Manage all Message Types and perform re-indexing
Services – Group related Message Types together
Systems – Document the systems that produce these messages
Endpoints – View endpoints associated with this Message Type
Logging Service – The engine that processes messages and extracts Search Field values