Workflow Logs — Trace and Troubleshoot Workflow Event Processing

The Workflow Logs provide a comprehensive overview of events configured within workflows, including the source data and their associated processing paths. This dashboard allows you to efficiently track workflows and their transformed events using various filters, enabling informed decision-making and effective troubleshooting.

Accessing Logs

To access the workflow logs, navigate to the following path in the CustomerLabs dashboard: Monitoring → Logs → Workflow

The dashboard will display the log filtering interface. Ensure that you have configured at least one workflow source to begin viewing data.

Verifying if events are pushed into the datalayer

Workflow logs are generated for workflows configured across each source. Each log entry represents a transformed event that has been processed from the incoming source data.

1. Source Filter: In the Source dropdown, all connected sources will be listed. Select the specific source for which the workflow has been configured.

2. Workflow Filter: In the Workflow dropdown, workflows configured for the selected source will be displayed. Choose the workflow for which you want to view logs.

Verification of Google Tag Manager Installation on your website

To view logs for a specific time period, use the Time Range Filter. This is critical for verifying real-time events sent via Google Tag Manager or other integrations.

• You can select predefined relative timeframes (e.g., last 5 minutes, last 4 hours, last 1 day).

• You can also choose a custom date and time range for precise troubleshooting.

Note

Both relative and custom ranges are applied based on the Processed At timestamp. Logs are available only for the last 28 days, and filtering is limited to a maximum of 3 consecutive days at a time.

Setting up of CustomerLabs Events in GTM

Use the advanced filtering options to locate specific event signatures and payloads.

1. Event Name Filter: The Event Name field allows you to filter logs based on transformed events. Select the required event name from the dropdown.

2. Search By Filter: The Search By field enables you to filter logs using specific data values. Enter the required text in the Search Logs field.

Caution

The Search By filter is case-sensitive. Ensure the text entered matches the expected payload data exactly.

Testing and Validation

After selecting the required filters, click the Apply Filter button to view the logs. Ensure that all mandatory fields (Source, Workflow, and Time Range) are selected to enable the button.

Log Details and Inspection

To view detailed information for a specific log, click the View Details hyperlink. This opens a side panel displaying the JSON payload.

The side panel contains three tabs for deep inspection:

Workflow Input

Displays the source data as it was received from the selected source (incoming raw data).

Event Data

Shows the configured event data, including mapped user identifiers, event properties, and product details.

Destinations

Provides the message ID to access the corresponding logs in the destination dashboard.

Maintenance Tools

• Clear Filters: Restore all filters to their default state by clicking the Clear Filters icon.

• Refresh Logs: Load the most recent data based on your current filter settings by clicking the Refresh button.

Download

Maintaining logs is essential for robust event tracking. Follow this example to validate specific event data.

Quick Example: Verifying “cl_purchase” payment method

Use this workflow to check for events where purchases were made using UPI in the last 3 days.

1. Select the source from the Sources dropdown.

2. Select the workflow from the Workflows dropdown.

3. Select the time range as Last 3 days.

4. Select cl_purchase from the Event Name dropdown.

5. In the Search By field, enter UPI and click Apply Filter.

6. Click on the View details hyperlink and verify the tags in the Workflow Input tab.

Note

For further assistance, contact our support team at [email protected]