Skip to main content

​
Managing Errors

When workflows error unexpectedly, we provide several methods to help you identify what went wrong. You can access workflow logs via the Error Logging API, receive errors in real-time to your API, or stream error logs via our AWS EventBridge integration.

​
Retrieve Logs for a Single Workflow

Use the GET /2024-03/workflow/{workflowId}/logs endpoint to retrieve log data for a given workflow. Each log includes the executionId (which can be used to rerun an execution), the startedAt and stoppedAt date stamps, and the JSON output of the execution. Endpoint 
GET https://embedded.runalloy.com/{VERSION}/workflow/{workflowId}/logs
Sample Request
cURL
curl -X GET 'https://embedded.runalloy.com/2024-03/workflow/{workflowId}/logs' \
  -H 'Accept: application/json' \
  -H 'Authorization: bearer YOUR_API_KEY'
Sample Response
JSON
{
  "data": [
    {
      "executionId": "6daaa0cf1a3daa6c41b5-ef",
      "startedAt": "2022-10-04T01:12:40.406Z",
      "stoppedAt": "2022-10-04T01:12:59.508Z",
      "status": "success",
      "results": [
        {
          "blockId": "f2eb053c-d04a-1a6c-8cd1-dbd6b8d016d0",
          "startedAt": "2022-10-04T01:12:40.406Z",
          "stoppedAt": "2022-10-04T01:12:40.782Z",
          "data": [
            {
              "json": {
                "body": {
                  "brandValue": "Order Placed"
                }
              },
              "meta": {
                "url": "embedded.runalloy.com",
                "x-request-id": "0a2253180d67dd23f96d81f49bac",
                "x-real-ip": "00.118.107.70",
                "x-forwarded-for": "00.118.107.70",
                "x-forwarded-host": "embedded.runalloy.com",
                "x-forwarded-port": "80",
                "x-forwarded-proto": "http",
                "x-forwarded-scheme": "http",
                "x-scheme": "http",
                "content-length": "1809",
                "content-type": "application/x-www-form-urlencoded; charset=utf-8; boundary=1-dsDx0TBzB4bDi3maDvCe",
                "user-agent": "PostmanRuntime/7.28.4",
                "postman-token": "c6c95c92-ebed-4ade-bdcd-b49f97d7a6c5",
                "cache-control": "no-cache",
                "accept-encoding": "gzip, deflate, br"
              }
            }
          ],
          "id": "0ab1892x-d28e-443b-a03b-20efbedc4c5"
        }
      ]
    }
  ]
}

​
AWS EventBridge

The platform also supports direct integration with AWS EventBridge for streaming error logs. To enable this feature:
  1. Navigate to the AWS EventBridge connection in Settings
  2. Enter your AWS keys (securely encrypted)
  3. Enter your Event Bus Name and save
Once enabled, error logs will automatically stream to AWS. You can disable this feature at any time by toggling the EventBridge connector off.
⌘I