Logs, Results, and Traces

Logs, results, and traces give you visibility into what happens when your flows process data. They are accessed from the same section of the navigation and are linked together by trace GUIDs.

  • Logs record events that occur during processing – informational messages, warnings, and errors.
  • Results store the data payloads produced by each node in a flow.
  • Traces tie logs and results together into a single processing run, visualized as a flow chart.

Logs

Logs capture processing events from nodes and services as your flows run. Each log entry includes a message, a severity level, and links to the flow, node, and trace that produced it.

Log Levels

  • Info – routine processing events (e.g., file fetched, document converted)
  • Warn – non-fatal issues that may need attention
  • Error – failures that prevented a node from completing
  • Debug – detailed diagnostic information

Filtering and Searching

Use the controls at the top of the Logs page to narrow down what you see:

  • Level tabs – filter to a specific severity (All, Info, Warnings, Errors, Debug)
  • Flow – filter to logs from a specific flow
  • Service – filter to logs from a specific node service (e.g., SftpFetchService, EdiToJsonService)
  • Search – find logs by trace GUID or log ID

Active filters appear as badges below the controls. Click the X on a badge to remove that filter.

Log Details

Click a log ID to open its detail panel. The panel shows:

  • The full log message
  • Metadata – log ID, timestamp, trace GUID, service name, flow, and node (with links to each)
  • Details – additional structured data, displayed as JSON when present
  • A link to the associated result, if one exists

Buffered Writes

Logs are written to the database periodically, not instantly. It may take a short time before a new log entry appears.

Results

Results are the data payloads produced by each node as it processes data through a flow. Every time a node runs, it creates a result containing the output data and metadata.

Searching Results

Use the search field to find results by trace GUID or result ID. Results linked to the same trace GUID were produced during the same processing run.

Result Details

Click a result ID to open its detail panel. The panel shows:

  • Metadata – result ID, timestamp, trace GUID, and the node that produced it (with links)
  • Error badge – displayed when the result represents a processing failure
  • Metadata JSON – structured metadata about the result
  • Data – the full data payload, displayed as JSON

Trace Viewer

A trace represents a single processing run through one or more flows, identified by a trace GUID. The trace viewer assembles all logs and results for that trace into a visual flow chart so you can see exactly what happened at each step.

Accessing the Trace Viewer

From the Logs or Results pages, click the magnifying glass icon next to any trace GUID. You can also click View Trace from a log or result detail panel.

Flow Chart

The trace viewer displays the flow’s nodes in a left-to-right diagram. Each node card shows:

  • The node kind (input, transformation, branch, output) and service
  • The number of results produced
  • A green border when all results succeeded
  • A red border when any result contains an error
  • A dashed border when the node produced no results (it was not reached during this run)

Node Details

Click a node in the flow chart to view its details below. The detail panel has three sections:

  1. Input – results from upstream nodes that fed into this node. Entry nodes (with no upstream connection) show “No incoming result.”
  2. Output – results produced by this node. Each result card shows its ID, timestamp, metadata, and data payload. Cards with errors are flagged.
  3. Logs – log entries specific to this node.

Result cards are expanded by default. Click the Data toggle to collapse or expand the payload view.

Diagnosing Errors

When a trace contains errors, a Diagnose Errors button appears in the trace viewer header. This opens an AI diagnostics panel that analyzes the error results and logs across the node graph.

Using Diagnostics

  1. Click Diagnose Errors to open the panel
  2. Optionally type additional context about the errors (e.g., what changed recently, what the expected behavior is)
  3. Click Diagnose to generate an analysis
  4. After the initial diagnosis, use the chat input to ask follow-up questions

You can choose which AI model to use from the dropdown in the panel header. Use Re-diagnose to start a fresh analysis, or Clear History to reset the conversation.

Data Retention

Logs and results are automatically removed after 45 days. Results linked to billing records are kept until those records are also removed. EDI transaction records are hidden after 45 days and permanently removed after 120 days. Retrieve your data via webhooks, the API, or direct downloads before the retention window closes.