- 5 minutes to read

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.
Search 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.
Search Event Directions
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

graph LR subgraph "Source" roA[Send file] end subgraph "EAI solution" roA --> |EventDirection: 17
EndPointDirection: 0| ro1{Process} end subgraph "Destination" ro1 --> |EventDirection: 18
EndPointDirection: 1| roB[Receive file] end

Illustration of Event Directions in a file transfer scenario.

API example

graph RL subgraph "Source" roA[API Consumer] end subgraph "EAI solution" roA --> |Request
EventDirection: 21
EndPointDirection: 10| ro1{Process} ro1 --> |Response
EventDirection: 25
EndPointDirection: 10| roA end subgraph "Destination" ro1 --> |Request
EventDirection: 22
EndPointDirection: 11| roB[Receive file] roB --> |Response
EventDirection: 26
EndPointDirection: 11| ro1 end

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:
Search Event Direction Combos
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:
Try it out
To get the list of Event Directions, press the Try it out button.

Then, press the Execute button:
Execute
Execute the request to retrieve Event Directions from the API.

Event Direction from Swagger
Here's an example of EventDirections from the Swagger definition.


Next Step

Log Agents