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, 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.

Findings & Scoring

Domain scores seem lower than expected

Scores are 100 minus weighted penalties for open findings. Newly connected environments often start lower until findings are resolved, suppressed or rescanned.

A resolved finding still shows as open

After fixing the cloud resource, run a fresh scan. The rule evaluator closes the finding when the underlying condition no longer exists.

A finding is intentional for this environment

Suppress the finding with a reason. Suppressed findings do not count against domain scores and remain traceable for audit review.

Actions & Approvals

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 dashboards or features

Check the user role in Settings > Users. Some features are also 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 or scan job IDs you can share. For security issues, use security@turbofinops.com.

TurboFinOps

Start with one cloud scope. Prove savings fast.

Connect AWS, Azure, or GCP and get actionable findings, score trends, and auditable remediation paths in minutes.

Built for FinOps, governance and audit workflows