Troubleshooting

Overview

Operational troubleshooting for common Console workflows. Include run IDs, project IDs, and timestamps when contacting support.

Authentication and access

Login issues

Verify email, retry OAuth, check organization SSO configuration. Contact admin if OTP not delivered.

Account invitation not received

Verify email address and spam filters. Admin can resend invitation from Directory → Users.

Organization access issues

Confirm team membership and correct tenant. Admin adds user to team if missing.

Permission denied (403)

Check role assignment. Demo lockdown modes may restrict write access.

Organization not found

Verify hostname mapping and session tenant context with administrator.

Requirements and generation

File upload fails

Check file size (typically 10MB max) and MIME type. Retry on stable network.

Requirements parsing fails

Confirm document attached to correct project or specification; retry generation.

Requirements not reflected in generation

Confirm document linked to project and test types selected before generation.

Test generation stalls or empty

Verify test types and requirements present. Improve PRD detail and retry.

Generated tests incomplete

Add acceptance criteria to requirements; regenerate or edit cases manually.

Invalid JSON in generated output

Edit cases manually in test library; report persistent parser issues to support.

Execution

Test execution fails immediately

Verify application URL accessibility and agent online status in Agent Console.

Application cannot be reached

Check firewall rules, VPN, and authentication for target environment.

Playwright or browser execution fails

Verify execution path, desktop and restricted networks typically require endpoint agents.

Agent offline

Restart agent process; verify registration and network policy in Agent Console telemetry.

Endpoint not connected

Check endpoint heartbeat and credentials in Agent Console.

No matching agent found

Adjust labels, capabilities, or policy to match available agents.

Project not found (404)

Confirm project ID and organization scope in API or Console URL.

Results and reports

Results not showing

Clear filters; verify correct tenant; check Demo Mode settings.

Artifacts missing

Verify run completed; check artifacts tab and permissions.

Screenshot missing

Verify execution environment supports capture; check agent type and artifact collectors.

Report not loading

Retry; verify report permissions with administrator.

Slow Console performance

Use filters and pagination; contact support for large tenant optimization.

Share link expired

Generate a new time-limited share link from run detail if policy allows.

Integrations and billing

Integration connection failed

OAuth may require re-authorization. Verify provider status and scopes.

Billing or credits issue

Review billing settings and subscription status with billing admin.

Demo Mode data not showing

Enable Demo Mode in Settings for internal demo accounts.

Generation and review

Scenarios duplicate requirements

Edit scenario titles during review; merge overlapping scenarios before case generation.

Case steps malformed

Fix step JSON in case editor, save, and rerun smoke validation.

Review queue backlog

Assign reviewers by team; prioritize release-critical projects using Coverage gaps.

Regeneration overwrites edits

Duplicate approved cases before regenerating scoped sections only.