Troubleshoot cloud tasks
Cloud tasks run in remote cloud environments, so you can't inspect a local process when something goes wrong. This topic explains how to check what happened, what you can fix yourself, and what to collect before you contact support.
Check the task status and error
Start with the status. A failed task is marked Problem in the task list, and the task page shows the error at the top. The message often names the cause – for example, a missing AI license.
For the cloud task workflow, see Run tasks in cloud.
The result isn't what you expected
If a task finishes but the outcome doesn't match what you wanted, the issue is usually in how the agent approached the task, not in the platform. Open the task and review the agent conversation and the changed files to see what the agent did.
From there, keep iterating in the same task: add more context, leave comments in the code, or refine your prompt, and run it again. Learn how to add context in Task context and how to review a result in Run tasks in cloud.
The environment is missing dependencies or secrets
A cloud environment doesn't inherit your local setup. If a task fails because a dependency, environment variable, or secret is missing, update the environment configuration for the repository and run the task again.
Learn how to configure environments.
The task didn't start or ended with an error
Read the error at the top of the task page first. If it names a cause you can act on, fix that and run the task again. Some failures are transient, such as a temporary problem while the environment starts, so a retry often succeeds.
If the task keeps failing and the error doesn't point to anything you can fix, this is usually an infrastructure issue on the JetBrains side. Collect the information below and contact support.
Collect information for support
Support uses the task ID to find your task, and the collected logs to trace the failure. You can get both from the task's options menu.
Copy the task ID
Open the task's options menu and select Copy ID. Paste it into your support request when asked.
Collect the task logs
If the task's cloud environment has started, you can collect its logs. Open the task's options menu and select Collect Logs. JetBrains Air saves a ZIP archive that contains the cloud-side logs for the run.
Attach this archive to your support request. If the environment never started, there are no logs to collect – share the task ID and the error message instead.
Contact support
To reach support, open the user menu and select Contact Support.
To help support investigate, include:
the task ID (see Copy the task ID) and the collected logs archive, if available
the error message shown on the task page
what you expected to happen and what happened instead, with the steps to reproduce it