# Troubleshooting Multistep Checks - Checkly Docs

> Learn how to troubleshoot multistep checks.

Source: https://www.checklyhq.com/docs/detect/synthetic-monitoring/multistep-checks/troubleshooting/

---

- Authentication and Authorization
- Data Flow Problems
- Timing and Performance Issues
- Error Handling and Recovery

# Troubleshooting Multistep Checks

Learn how to troubleshoot multistep checks.

Multistep checks are a powerful tool for monitoring complex API workflows. However, they can sometimes be tricky to troubleshoot. Here are some common issues and solutions:

## ​ Authentication and Authorization

**Issue: Authentication failures or token expiration**
**Solutions**:

- Verify credentials are current and valid

- Implement token refresh logic for long workflows

- Check API permissions for all required endpoints

- Use environment variables for sensitive credentials

## ​ Data Flow Problems

**Issue: Variables not passing correctly between steps**
**Solutions**:

- Verify variable assignment syntax and scope

- Add logging to track variable values

- Check JSON parsing and data extraction logic

- Validate API response formats match expectations

## ​ Timing and Performance Issues

**Issue: Workflows timing out or running slowly**
**Solutions**:

- Optimize API performance and database queries

- Increase timeout values for complex operations

- Implement parallel processing where possible

- Add monitoring for long-running operations

## ​ Error Handling and Recovery

**Issue: Workflows failing without proper cleanup**
**Solutions**:

- Implement try-catch blocks with proper error handling

- Add cleanup logic in finally blocks

- Design idempotent operations for safe retries

- Create rollback procedures for failed transactions

Was this page helpful?

[Suggest edits](https://github.com/checkly/docs/edit/main/detect/synthetic-monitoring/multistep-checks/troubleshooting.mdx)[Raise issue](https://github.com/checkly/docs/issues/new?title=Issue%20on%20docs&body=Path:%20/detect/synthetic-monitoring/multistep-checks/troubleshooting)

[x](https://x.com/checklyhq)[github](https://github.com/checkly)[linkedin](https://linkedin.com/company/checkly)

[Powered by This documentation is built and hosted on Mintlify, a developer documentation platform](https://www.mintlify.com/?utm_campaign=poweredBy&utm_medium=referral&utm_source=checkly-422f444a)