Docs/Troubleshooting

Support

Troubleshooting

Common issues and how to resolve them. If your issue is not listed here, contact support@turbofinops.com or check the FAQ.

Fastest support path

Include the affected scope, connection name, action or receipt ID, scan job ID, and exact error message.

Connections & Credentials

Connection fails with invalid credentials immediately after saving

Verify the key values have no leading or trailing whitespace. For AWS, confirm the IAM user has programmatic access. For Azure, ensure the client secret has not expired. For GCP, paste the full JSON key file contents.

Azure connection fails with insufficient privileges

The App Registration must have the Reader role assigned at subscription level, not only resource group level. Azure role assignments can take 2-5 minutes to propagate.

GCP connection saves but scan returns no resources

Confirm the service account has Viewer on the correct project and that required APIs are enabled, including Compute Engine, Cloud Resource Manager and Container APIs.

Scans & Inventory

Scan completes but resource count is zero

Check that at least one scope is active, the external ID is correct, and credentials include the relevant describe/list permissions for the expected resource types.

Scan job is running for more than 10 minutes

This can happen during provider rate limits, transient network errors or large scans. Re-run the scan from Dashboard > Scans. If recurring, send support the scan job ID.

Resources appear but findings are zero

That can be valid if resources pass the enabled rules. Review Resources for inventory data and check domain dashboards for score context.

Savings Actions & Receipts

Today shows no savings actions after a successful scan

Confirm the scanned scope has cost-bearing resources and daily cost ingestion is available. Some clean environments will show a no-waste state instead of forced recommendations.

A receipt is still pending

Receipts verify after the configured 7, 14, and 30 day windows. Check that daily cost rows exist for the resource and that the action baseline was captured before execution.

A receipt is inconclusive or regressed

Review the receipt notes and observed daily cost. Inconclusive means the cost signal was not strong enough; regressed means post-action cost moved the wrong way and should not count as verified savings.

Actions & Approvals

Savings action is stuck in pending approval

Actions in manual approval mode need an Admin or designated approver. Confirm notification settings and approve from Dashboard > Actions.

Action failed with conflict detected

The conflict guard blocked execution because of IaC ownership, freeze windows or policy protection. Review the conflict reason before overriding.

VM scheduling is not starting or stopping VMs

Confirm the policy is active, the timezone is correct, the selected resources are current, and credentials include provider start/stop permissions: AWS EC2 StartInstances/StopInstances, Azure VM start/deallocate, or GCP compute.instances.start/stop. Basic scheduling uses cloud APIs and does not require a TurboFinOps agent on the VM.

Integrations & AI

Jira ticket creation fails

Verify the Jira connection is saved and tested, the project key exists, and the API token has Create Issue permissions.

Slack notifications are not received

Verify the webhook URL in Dashboard > Integrations > Notifications, test the channel, and confirm the webhook was not revoked in Slack.

AI explanations return an error or empty response

BYOAI requires a valid provider key. AI Explain, Plan and Summary are available from Professional; AI usage metering is Enterprise-only.

Billing & Access

Users cannot see certain savings or cost surfaces

Check the user role in Settings > Users. Some receipt exports, automation, AI attribution, and enterprise controls are plan-gated, so compare the plan with Billing and the public pricing page.

An upgraded plan still shows locked features

Log out and back in to refresh session entitlement context. If Billing shows the upgrade but features remain locked, contact support.

Scan limit reached

Scan jobs are plan-gated monthly: Free includes 30 scan jobs, Professional includes 90, and Enterprise is unlimited.

Still need help?

Email support@turbofinops.com with a description of the issue, your plan, the affected scope or connection name, and any error messages, action IDs, receipt IDs or scan job IDs you can share. For security issues, use security@turbofinops.com.

Get started

Find recoverable spend before the next invoice lands.

Connect one AWS, Azure or GCP scope, approve the safest savings actions, and give finance a receipt when the savings verify.

Read-only scan first. Approval gates before remediation.