Environment support bundles
Environment support bundles capture logs, conversation data, and VM diagnostics from a specific environment. The contents vary depending on whether the environment is running or stopped.How to download
Download an environment support bundle from any of these locations:- Sidebar: Click the
...on the environment and select Download support bundle. - Conversation header: Click the
...menu on the conversation and select Download support bundle. - Chat command: Type
/support-bundlein the chat input. - Command palette: Search for Download support bundle.
What’s included
When the environment is running, the bundle contains:Metrics are only included when the environment is running. If the environment is stopped, the bundle does not contain resource usage data.
When the environment is stopped, the bundle contains persisted environment logs retrieved from cloud storage. These logs cover the environment’s most recent sessions.
On AWS runners, persisted-log retrieval is limited to 100 S3 listing pages (up to 100,000 objects scanned), 20,000 retained log objects, 256 MiB of stored data, 512 MiB after decompression, and two minutes per request. These limits also apply to persisted environment and snapshot logs and VM statistics. Each runner or runner-manager process accepts up to eight concurrent requests, with at most two per authenticated user or service account across the runners it serves.
Requests that exceed listing or known size limits are rejected. If a streaming download exceeds a limit, it fails instead of returning a completed partial archive.
Retry later when requests are rate-limited. For logs exceeding the retrieval limits on self-hosted AWS runners, ask your AWS administrator to retrieve the relevant objects directly from the runner’s log bucket. For Ona-managed compute, contact support.
Runner support bundles
Runner support bundles capture logs, metrics, profiling data, and network diagnostics from a self-hosted runner.Not available for Ona Cloud runners.
How to download
- Go to Settings → Runners.
- Locate your runner.
- Click the
...menu and select Download support bundle.
What’s included
Automation execution support bundles
Support bundles are also available for individual automation execution actions. These combine environment and conversation data with action metadata.How to download
Click the... menu on an automation execution action and select Download support bundle.
Requesting support
To start a support case, open Support from the organization menu in the dashboard. When reporting an issue, attach the relevant support bundles:- Environment issues: Provide both the environment support bundle and the runner support bundle.
- Runner issues: The runner support bundle alone is sufficient.
- IDE issues: See the troubleshooting section for your editor or IDE for how to export logs.
Review bundle contents before sharing outside your organization.