Troubleshooting

Common Issues

Authentication & Access

I can't sign in or keep getting logged out

• Verify your credentials and tenant name.
• Check if your account is active (contact your admin).
• Clear browser cache/cookies and try again.
• Ensure your session hasn't expired (default timeout applies).

I can't see a project, schema, or dataset I expect

• Confirm you're signed into the correct tenant.
• Verify you're a member of that project (ask a project admin).

I can't create or edit projects/constraints

• Your role might be view-only for that project.
• Request edit or admin permissions from a project admin.

Data Generation

Dataset generation is stuck or failed

• Open Dataset View and check the status and error details.
• Review constraints for circular dependencies or invalid logic.
• Verify schema fields are properly configured.
• Share the dataset ID with support if the issue persists.

Generated data doesn't match my constraints

• Confirm constraints are used during generation.
• Review constraint logic for conflicts or overlaps.
• Test with a smaller dataset to isolate the issue.

Integrations

Integration connection failed

• Verify credentials and endpoint URLs are correct.
• Check if the service is up and available.
• Test credentials independently (e.g., AWS CLI for S3).

Data export to integration fails

• Confirm the target destination exists and is writable.
• Check if the integration has sufficient permissions.

Performance

Pages load slowly or time out

• Check your internet connection stability.
• Clear browser cache and disable unnecessary extensions.
• Contact support if slow performance affects multiple users.

Dataset generation takes too long

• Consider reducing dataset size or complexity.
• Break large datasets into smaller batches.
• Simplify or reduce the number of active constraints.
• Check if background tasks are queued (see Analytics).

Getting Help

Still experiencing issues? Follow these steps:

1. Check recent changes: Review Release Notes for known issues.
2. Search FAQ: See if your question is answered in the FAQ.
3. Review documentation: Consult the relevant guide in Guides.
4. Contact support: Provide ID(s) and error details for faster resolution.

Information to Include

When reporting issues, include:

• Tenant name and user role
• Project and dataset IDs (if applicable)
• Timestamp when the issue occurred
• Error messages or status codes
• Steps to reproduce the issue
• Browser and version (for UI issues)

See Common Workflows for best practices that prevent common issues.