Articles in this section

Debug flow steps

For any flow step in Flow Builder, you can turn on debugging to capture the requests and responses passing between integrator.io and that step's application. Reviewing these logs helps you see exactly what caused a record to fail, or spot what you'd need to change to avoid errors or improve performance. This article covers starting, reviewing, filtering, and deleting flow step debug logs. For connection-level debugging instead of a single step, see Debug a connection.

Flow step debug logs are available for HTTP connectors, including REST connectors, and for all flow step types (this was previously limited to webhook listener steps).

Start debugging a flow step

  1. Open the flow step you want to debug.
  2. Select View debug logs in the upper-right corner of the flow step.
  3. Select Start debug, then choose how long to collect logs: Next 15 minutes, Next 30 minutes, Next 45 minutes, or Next 60 minutes.
  4. Select Apply.
  5. Run the flow — or, if you're debugging a webhook listener, perform the action that triggers the webhook. Debug logs are captured for the duration you chose.

Review debug logs

  1. Confirm you've started the debugger for the flow step, as described above.
  2. Run the flow (or trigger the webhook) so there's traffic to capture.
  3. Open the flow step and select View debug logs.
  4. Select Refresh logs periodically to pull in the most recently collected entries.
  5. Select the timestamp of an entry to see everything sent to and received from the application for that call.

Review the request

Select HTTP request to see:

  • Body — The request body.
  • Headers — The request headers.
  • Other — The request URL and method.

Review the response

Select HTTP response to see:

  • Body — The response body.
  • Headers — The response headers.
  • Other — The response URL and the timestamp the response was sent.

Filter debug logs

The log list shows every call made to and from the flow step during the debug window. Filter it by time, method, or response code.

Filter by time

  1. Select the funnel icon in the Time column.
  2. Choose a timespan: Last 15 minutes, Last 30 minutes, Last hour, Last 4 hours, Last 24 hours, Today, Yesterday, or Custom.
  3. Select Apply, or select Clear to remove the filter.

Filter by method

  1. Select the funnel icon in the Method column.
  2. Select one or more methods: GET, PUT, POST, PATCH, or DELETE.
  3. Select Apply, or select Clear to remove the filter. Select Cancel to close without saving.

Filter by response code

  1. Select the funnel icon in the Response code column.
  2. Select one or more status codes — All codes (default), or specific codes such as 200 OK, 201 Created, 204 No Content, 304 Not Modified, 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 409 Conflict, or 500 Internal Server Error — or a range shorthand such as 2xx or 4xx.
  3. Select Apply, or select Clear to remove the filter. Select Cancel to close without saving.

For a full list of standard HTTP response codes, see the W3.org reference.

Delete a debug log

Select the trash icon in the Actions column next to a log entry, then confirm when prompted.