Workflow Issues

Troubleshooting guide for workflow-related issues in Solo.

Workflows Not Running

Symptoms

  • Workflows not executing
  • Workflows not triggering
  • Workflow execution errors
  • Workflows inactive

Solutions

  1. Check Workflow Status

    • Go to Settings → Workflow
    • Verify workflows are enabled
    • Check workflow status indicator
    • Reactivate if needed

  2. Review Workflow Configuration

    • Check workflow settings
    • Verify workflow configuration
    • Review workflow permissions
    • Check for missing settings

  3. Check Workflow Logs

    • View workflow activity logs
    • Look for error messages
    • Review recent executions
    • Check for warnings

  4. Verify Workflow Dependencies

    • Check workflow has required resources
    • Verify integrations are working
    • Review workflow connections
    • Test workflow dependencies

Usage Not Tracking

Symptoms

  • Token usage not tracked
  • Agent executions not tracked
  • Usage statistics not updating
  • Usage data missing

Solutions

  1. Check Workflow Status

    • Verify you're using default workflows
    • Check workflow status
    • Review workflow configuration
    • Verify workflows are active

  2. Verify Identity Status

    • Check identity is activated
    • Verify identity settings
    • Review identity configuration
    • Check identity status

  3. Check Settings

    • Go to Settings → Workflow
    • Verify usage tracking is enabled
    • Check usage statistics
    • Review usage settings

  4. Review API Configuration

    • Check API key configuration
    • Verify API key is valid
    • Review API key permissions
    • Check API key usage

Custom Workflow Tool Not Working

Symptoms

  • Custom workflow tool workflows failing
  • Workflow tool webhooks not working
  • Workflow tool integration errors
  • Workflow tool connection issues

Solutions

  1. Check Webhook URL

    • Verify webhook URL is correct
    • Check webhook URL format
    • Test webhook endpoint
    • Verify webhook is accessible

  2. Verify API Key

    • Check API key is valid
    • Verify API key permissions
    • Review API key configuration
    • Test API key

  3. Check Your Workflow Tool Instance

    • Verify your workflow tool instance is running
    • Check your workflow tool instance status
    • Review your workflow tool instance logs
    • Test your workflow tool instance connection

  4. Review Your Workflow

    • Check your workflow configuration
    • Verify workflow is active
    • Review workflow logs
    • Test workflow execution

Workflow Performance Issues

Symptoms

  • Workflows running slowly
  • Workflow timeout errors
  • Workflow performance degradation
  • Workflow execution delays

Solutions

  1. Check Workflow Configuration

    • Review workflow settings
    • Optimize workflow configuration
    • Check for inefficient settings
    • Review workflow limits

  2. Review Workflow Usage

    • Check workflow usage statistics
    • Look for usage patterns
    • Review workflow activity
    • Optimize workflow usage

  3. Check System Resources

    • Verify system resources available
    • Check for resource constraints
    • Review system performance
    • Optimize resource usage

  4. Review Workflow Dependencies

    • Check external service performance
    • Verify integrations are fast
    • Review workflow connections
    • Optimize dependencies

Workflow Errors

Symptoms

  • Workflow showing error messages
  • Workflow failing to execute
  • Workflow returning errors
  • Workflow crashes

Solutions

  1. Review Error Messages

    • Read error messages carefully
    • Note error codes
    • Check error context
    • Document errors

  2. Check Workflow Configuration

    • Verify configuration is valid
    • Check for missing settings
    • Review workflow permissions
    • Validate workflow settings

  3. Review Workflow Logs

    • Check workflow activity logs
    • Look for error patterns
    • Review recent errors
    • Check for warnings

  4. Verify Workflow Dependencies

    • Check workflow has required tools
    • Verify integrations are working
    • Review workflow connections
    • Test workflow dependencies

Workflow Not Triggering

Symptoms

  • Workflows not triggering on events
  • Workflow triggers not working
  • Workflow not responding to events
  • Missing workflow triggers

Solutions

  1. Check Trigger Configuration

    • Verify trigger settings
    • Check trigger configuration
    • Review trigger permissions
    • Check trigger status

  2. Review Event Settings

    • Check event settings
    • Verify events are enabled
    • Review event configuration
    • Check event permissions

  3. Check Workflow Logs

    • Review workflow trigger logs
    • Look for trigger errors
    • Check trigger activity
    • Review trigger logs

  4. Verify Event Sources

    • Check event sources are working
    • Verify event delivery
    • Review event configuration
    • Test event sources

Getting Help

Self-Service

  • Check documentation: Review workflow documentation
  • Search docs: Search for your issue
  • Read guides: Follow workflow setup guides

Contact Support

If you can't resolve the issue:

  • Contact support: Reach out to support team
  • Provide details: Include workflow name, error messages, and steps to reproduce
  • Check status: Verify service status
  • Be patient: Support will respond

Next Steps

Version: 1.0
Last Updated: November 2025