Skip to content

troubleshooting-help.mdx

Latest commit

 

History

History
223 lines (161 loc) · 6.88 KB

troubleshooting-help.mdx

File metadata and controls

223 lines (161 loc) · 6.88 KB
title Troubleshooting Guide
description Fix common issues and resolve workflow problems with step-by-step solutions

Troubleshooting Guide

Having trouble with your AetherFlow workflows? This comprehensive troubleshooting guide will help you identify and resolve common issues. Follow the step-by-step solutions below to get your automations running smoothly.

Quick Issue Diagnosis

Workflow Not Triggering

Common Causes & Solutions

Workflow Status
Check if your workflow is active or paused.
Solution: Go to your workflow dashboard and ensure the status shows "Active" (green indicator). If paused, click the play button to activate it.

Trigger Conditions
Verify your trigger settings are correct.
Solution: Review trigger conditions (e.g., email sender, keywords, time schedules). Test manually to ensure conditions are met.

Integration Permissions
Ensure AetherFlow has proper access to connected services.
Solution: Re-authorize integrations in Settings → Integrations. Check for expired tokens or revoked permissions.

Service Availability
Verify connected services are operational.
Solution: Check service status pages (e.g., Gmail status, Slack status) and our status page at status.aetherflow.com.

Workflow Execution Failures

Common Failure Scenarios

Integration API Issues
Rate limits, API outages, or authentication problems
Check: API status, rate limits, authentication tokens

Data Format Problems
Unexpected data structure from integrations
Check: Data mapping, field formats, required fields

Permission Changes
Revoked access to connected accounts
Check: Account permissions, OAuth tokens, service access

Rate Limiting
Too many API calls in a short period
Check: API quotas, request frequency, batch operations

Step-by-Step Troubleshooting Process

1. Check Workflow Logs

Go to your workflow in the dashboard Click on the "Logs" or "History" tab Look for recent executions and their status Click on failed executions to see detailed error messages Understand when failures occurred Examine input data and step-by-step execution details **Pro Tip:** Enable detailed logging in workflow settings to get more comprehensive error information.

2. Test Workflow Manually

For Trigger-Based Workflows:

  • Use the "Test" button in workflow settings
  • Provide sample input data that matches your trigger
  • Verify each step executes correctly
  • Check output data and integration responses

For Scheduled Workflows:

  • Temporarily change schedule to run immediately
  • Execute manually using the run button
  • Monitor execution in real-time
  • Restore original schedule after testing

3. Verify Integration Health

Integration Health Checks

Re-authorize Connections
Go to Settings → Integrations and click "Reconnect" for problematic services.

Check API Limits
Review your API usage in integration dashboards and ensure you haven't exceeded limits.

Verify Credentials
Ensure API keys, tokens, and passwords are current and have proper permissions.

Performance Monitoring

Setting Up Performance Alerts

Configure notifications for workflow performance issues:

  • Execution failures: Get alerted when workflows fail repeatedly
  • Slow performance: Notifications when workflows take longer than expected
  • Resource usage: Alerts when approaching plan limits
  • Integration issues: Automatic detection of connection problems

Performance Optimization

Analytics Dashboard
Monitor workflow performance metrics
• Success rates and failure patterns
• Average execution times
• Resource usage and API calls
• Error frequency and types

Optimization Strategies
Improve workflow efficiency
• Batch operations where possible
• Implement caching for repeated data
• Use parallel processing
• Optimize data transformations

Advanced Troubleshooting

Common Error Messages

Error Code Reference

AUTHENTICATION_FAILED
Integration credentials are invalid or expired. Re-authorize the connection.

RATE_LIMIT_EXCEEDED
Too many API calls. Implement delays or upgrade your plan for higher limits.

DATA_FORMAT_ERROR
Input data doesn't match expected format. Check data mapping and field types.

SERVICE_UNAVAILABLE
External service is down. Check service status and retry later.

Debug Mode

Enable advanced debugging for complex issues:

  • Step-by-step execution: See exactly what happens at each workflow step
  • Variable inspection: Check the values of variables throughout execution
  • API request/response logging: View all HTTP requests and responses
  • Conditional breakpoints: Pause execution at specific points for inspection

Getting Additional Help

Self-Service Resources

Documentation
Comprehensive guides and tutorials
Browse docs →

Community Forum
Get help from other users
Join discussion →

Video Tutorials
Step-by-step video guides
Watch videos →

Contact Support

When you need direct assistance:

Include These Details:

  • Workflow ID and name
  • Exact error messages
  • Steps to reproduce the issue
  • Your plan type and usage
  • Browser and OS information

Contact Methods:

Response Times

  • Free Plan: Community forum
  • Pro Plan: 24-hour response
  • Enterprise: Priority support

Prevention Best Practices

Proactive Monitoring

  • Set up alerts for workflow failures and performance issues
  • Regular health checks on all integrations
  • Monitor usage to avoid hitting plan limits
  • Keep integrations updated with latest API versions

Workflow Design

  • Test thoroughly before deploying to production
  • Implement error handling and fallback mechanisms
  • Use descriptive naming for easy troubleshooting
  • Document complex workflows for future maintenance

Regular Maintenance

  • Review logs weekly for potential issues
  • Update integrations when services release new versions
  • Optimize performance based on usage patterns
  • Backup configurations regularly

Need Urgent Help?
For critical workflow issues affecting your business, Enterprise customers can access 24/7 priority support with dedicated technical account managers.