Event Directions
Unlock granular, end-to-end message tracking and filtering with Nodinite's Event Directions. This feature empowers both business and technical users to distinguish messages at every stage of integration, providing actionable insights and supporting compliance, troubleshooting, and business process optimization.
✅ Gain full visibility into message flow before and after each process step
✅ Filter and group Log Events by direction for precise business and technical analysis
✅ Empower self-service users with tailored Log Views
✅ Enhance compliance and troubleshooting with detailed event context
Helps you and your business filter Log Events so you can distinguish the same message before and after port/workflow processing
EventDirections is an optional numeric field in Log Events that qualifies the direction of a logged event. Use it to create fine-tuned, self-service Log Views for your business, enabling you to focus on the most relevant data at each integration point.
High-level design and implementation details
In any messaging process, multiple steps occur—some internal, some external. Event Directions let you pinpoint exactly where a message is in the process, such as:
- Message before decryption
- Message after decryption
- Message before encryption
- Message after encryption
- Message batch before a split
- Messages after the split
- Flat file before being translated to XML (e.g., BizTalk, IBM IIB, or other brokers using flat file schemas on a Receive port)
- Flat file after being translated from XML (e.g., BizTalk, IBM IIB, or other brokers using flat file schemas on a Send port)
- Workflow/Orchestration inside a loop generating new messages
There are countless scenarios. The Event Direction property provides the Log Event with location semantics—such as before port, after port, inside workflow, or inside process—enabling true end-to-end logging and analysis.
How do I use Event Directions in a Log View?
From Log Views, you can search and group Log Events by the selected Event Direction.
Event Direction being used from within a Log View.
This feature allows you to hide internal events that may not be relevant to business users, focusing instead on what came in or went out (the net result). Conversely, developers can view every detail of the process.
Filtering Log Events by Event Direction for targeted analysis.
# | Event Direction | Value | Comment |
---|---|---|---|
Default | null | Not set | |
1 | ExternalIncoming | 17 | Incoming message before receive in a One-Way receive Port processing |
2 | ExternalIncomingRequest | 21 | Incoming request message before receive Request-Response Port processing |
3 | ExternalIncomingResponse | 25 | Outgoing response message after receive Request-Response Port processing |
4 | ExternalOutgoing | 18 | Outgoing message after send in a One-Way Port processing |
5 | ExternalOutgoingRequest | 22 | Outgoing request message after send Request-Response Port processing |
6 | ExternalOutgoingResponse | 26 | Incoming response message after send Request-Response Port processing |
7 | InternalIncoming | 33 | Incoming message after receive in a One-Way receive Port processing |
8 | InternalOutgoing | 34 | Outgoing message before send in a One-Way send Port processing |
9 | ProcessIncoming | 65 | Incoming message to a function/workflow/orchestration |
10 | ProcessOutgoing | 66 | Outgoing message to a function/workflow/orchestration |
List of values to set the Event Direction for logged messages.
File transfer example
Illustration of Event Directions in a file transfer scenario.
API example
Illustration of Event Directions in an API integration scenario.
Combined Event Directions
From Log Views, you can search and group Log Events by combinations of Event Directions. This enables you to, for example, only see messages before and after processing for a given workflow (e.g., lines 1 and 5).
Valid combinations include:
Valid combinations of Event Directions available from within Log Views.
# | Event Direction | Description |
---|---|---|
1+2+7+9 | Incoming | Filter on ALL messages with any type of Incoming direction |
4+5+8+10 | Outgoing | Filter on ALL messages with any type of Outgoing direction |
2+5 | Request | Filter on ALL messages with any type of Request direction |
3+6 | Response | Filter on ALL messages with any type of Response direction |
1+2+3+4+5+6 | External | Filter on ALL messages going in from external or going out to external systems. For BizTalk, this means before receive port and after send port |
7+8 | Internal | Filter on ALL internal messages. For BizTalk, this means after receive port and before send port |
9+10 | Process | Filter on ALL messages for a Process direction. For BizTalk, this is all events related to an orchestration |
2+TBD | Incoming Request | For future use |
5+TBD | Outgoing Request | For future use |
3+TBD | Incoming Response | For future use |
6+TBD | Outgoing Response | For future use |
List of helpful values for use in Log Views.
Try it out yourself
To see the full list of values for your version, simply test the Log API.
https://localhost/Nodinite/LogAPI/swagger/ui/index#/LogEvent/LogEvent_EventDirection
Replace
https://localhost/Nodinite
as appropriate for your Environment.
Event Direction collection from the Swagger documentation
Simply press the Try it out button:
To get the list of Event Directions, press the Try it out button.
Then, press the Execute button:
Execute the request to retrieve Event Directions from the API.
Here's an example of EventDirections from the Swagger definition.