
- Did my integration run successfully?
- If something went wrong β which step failed and why?
- Can I replay a run without waiting for the next trigger?
Reading the Runs List
Each row in the table represents a single workflow execution.| Column | What It Shows |
|---|---|
| Reference | The source record that triggered the run β e.g. HubSpot Deal ID: 49649660024 |
| ID | The unique numeric identifier for this run β e.g. 33222. Always include this in support requests |
| Workflow | The integration that executed β e.g. HubSpot β Xero Invoice |
| Status | The run outcome: Finished, Failed, Running, or Pending |
| Started | The date and time the run began executing |
Run Status Reference
| Status | Meaning | What To Do |
|---|---|---|
| Finished | All steps completed successfully | No action needed. Review details if you want to verify outputs |
| Failed | One or more steps encountered an error and the run could not complete | Click Explain for a summary. Click View to inspect the failed step. Retrigger after fixing the root cause |
| Running | The workflow is currently in progress | Wait for it to complete. Refresh the page to see the updated status |
| Pending | The run is queued and waiting to start | No action needed β it will start automatically |
| Skipped | The run was intentionally skipped based on your workflow logic | No action needed. Skipped runs are expected β the workflow evaluated the event and determined no action was required |
Row Controls
Every row has three interactive controls on the right-hand side. Together they give you full visibility and recovery capability without leaving the page.
π¬ Explain
Click the speech-bubble iconGenerates a plain-English AI summary of the run β what happened, which step failed, and likely cause. Use this first before reading technical logs.
π View
Click the eye iconOpens the full Workflow Run detail page β event payload, step-by-step execution log, duration, and the Re-run button.
β― Actions
Click the three-dot menuDropdown with two options: Retrigger (replay the run) and View (same as the eye icon).
π¬ The Explain Button
Clicking the speech-bubble icon on any row generates an AI-powered plain-English explanation of that run β no JSON reading required. The explanation typically covers:- Which step succeeded or failed
- The specific reason for the failure (e.g. a missing required field, an API authentication error, or a duplicate record check)
- Whether the failure is likely to resolve on retrigger or requires a data fix first
π The Run Detail Page
Clicking the eye icon β or selecting View from the Actions menu β opens the full detail view for that run.
Run Metadata Header
The top section shows everything you need to know about the run at a glance.| Field | What It Tells You |
|---|---|
| ID | The unique run identifier. Include this in any support request |
| Workflow | The name of the integration that was executed |
| Status | Final run state: finished, failed, running, or pending |
| HubSpot Deal ID | The source record that triggered this run |
| Mode | Live (production data) or Test (sandbox). Shown as a green or grey badge |
| Duration | Total time taken to complete all steps |
| Created | When the run record was first created in Lighthouse |
| Started | When Lighthouse began executing the workflow steps |
| Finished | When the final step completed (or failed) |
| Attempts | How many times Lighthouse attempted this run β useful for identifying retry loops |
The Re-run Button
The blue Re-run button in the top-right replays the run using the original stored event payload.The Event Block
The Event block identifies what triggered this run:- Event ID β the internal ID of the incoming event that caused the workflow to start
- Type β the event category (e.g.
other,contact.created,deal.propertyChange) - Click to view details β expands the raw event payload panel on the right, showing the full JSON data Lighthouse received from the source app
Steps β The Execution Log
The Steps section shows each action inside your workflow in sequence.| Element | What It Shows |
|---|---|
| Step number | Steps run in order from top to bottom β Step 1, Step 2, Step 3β¦ |
| Key | The internal name of the step β e.g. fetch-deal-details, find-or-create-xero-contact |
| Status | Whether this individual step finished, failed, or is still running |
| Finished | The exact time this step completed |
| Click to view details | Expands inline to show the stepβs input data, output data, and any error message |
Event Details Panel
The right-hand panel shows the raw JSON payload of the selected event or step β the exact data Lighthouse received from or sent to the connected system. Use this panel to:- Verify that the correct HubSpot deal properties were captured
- Check that field values match what your destination app (e.g. Xero) requires
- Copy the payload to share with the Cloudify support team
β― The Actions Menu
Click the three-dot menu on any row to access two actions: Retrigger and View.
Retrigger vs Re-run β Which to Use
| Use Retrigger when⦠| Use Re-run when⦠|
|---|---|
| The source record in HubSpot has been updated since the original run | You want to replay the exact data that was captured at the time of the original run |
| You fixed a data issue and want the workflow to pick up the corrected values | The failure was a transient error (e.g. a timeout) with no data changes needed |
| You want to test whether a configuration change resolves the issue with current data | You want to confirm the original payload now processes correctly after a Cloudify fix |
Customising the Table View
Click View in the top-right corner of the Workflow Runs list to open the Toggle columns panel. Use it to show or hide columns based on what you need.
| Column | What It Shows | When to Enable It |
|---|---|---|
| Id | The unique run ID | Always β useful for referencing runs in support |
| WorkflowName | The name of the integration | Always β essential when running multiple workflows |
| WorkflowId | The internal workflow definition ID | Only when debugging with Cloudify support |
| Status | The run outcome | Always β core to daily monitoring |
| StartedAt | When the run began | Always β sort by this to see the most recent runs first |
| CreatedAt | When the run record was created in Lighthouse | Optional β differs from StartedAt only for queued runs |
| Mode | Live or Test execution context | Enable when running tests alongside live workflows |
Filtering Runs
Use the filter bar at the top of the list to narrow down what you see.| Filter | Use It To |
|---|---|
| Search box | Search by reference (e.g. a HubSpot Deal ID) or by run ID β useful when a client reports an issue with a specific record |
| Pick a date | Filter by a specific date or date range β use this to investigate incidents from a particular day |
| Status | Show only runs with a specific status β Pending, Running, Finished, Failed, or Skipped. Set to Failed to surface all current issues at once |
| Workflow | Filter by integration name β useful when multiple workflows are active and you want to isolate one |
| Mode | Filter by Live or Test β separates production runs from sandbox runs during setup and testing |
Quick Reference β Common Scenarios
A run shows Failed and I don't know why
A run shows Failed and I don't know why
- Click π¬ Explain (speech-bubble icon) on the row for a plain-English summary.
- Click π View (eye icon) to open the detail page.
- In the Steps section, find the first step with a red status.
- Expand it using Click to view details to read the error message.
- Fix the root cause in the source system (e.g. HubSpot), then use β― β Retrigger.
I fixed the data in HubSpot and want to retry the run
I fixed the data in HubSpot and want to retry the run
Use β― β Retrigger from the Actions menu. This re-fetches the latest record from HubSpot and runs the workflow from scratch using the updated data. Do not use Re-run β it replays the original (now outdated) payload.
A run failed due to a temporary error (timeout or API rate limit)
A run failed due to a temporary error (timeout or API rate limit)
Open the detail page using π View and click the blue Re-run button. This replays the original event payload without re-fetching from HubSpot β correct when the data was fine but the execution failed transiently.
I need to find all failed runs from a specific date
I need to find all failed runs from a specific date
In the filter bar, set Status to
Failed and click Pick a date to select the relevant date. The list will show only failed runs from that day.I want to verify exactly what data was sent to Xero
I want to verify exactly what data was sent to Xero
Open the detail page using π View. In the Steps section, find the step that writes to Xero (e.g.
create-xero-invoice). Expand it using Click to view details. The right-hand Event Details panel shows the exact output data that was sent.I need to share run information with Cloudify support
I need to share run information with Cloudify support
I see a run in Pending status β is something wrong?
I see a run in Pending status β is something wrong?
Pending means the run is queued and waiting for Lighthouse to start processing it. This is typically temporary β refresh the page after a few moments. If a run stays Pending for an extended period, raise a support ticket.
Next Steps
Support
Raise a ticket with Cloudify if a failed run cannot be resolved by Retrigger or Re-run.
Connections
Check connection status if you suspect an authentication issue is causing persistent failures.