Skip to main content
Support bundles collect diagnostic data that helps identify and resolve issues. Ona provides support bundles for both environments and runners. For IDE-related issues, see the troubleshooting guide for your editor or IDE.

Environment support bundles

Environment support bundles capture logs and diagnostic data 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 either location:
  • Sidebar: Click the ... on the environment and select Download support bundle.
  • Conversation: Click the picker and select Download support bundle.

What’s included

When the environment is running, the bundle contains:
DataDescription
Environment logsLogs from the environment’s core services
Automation logsLogs from tasks and services running in the environment
MetricsVM resource usage (CPU, memory) over time
Agent memoryConversation and context data from Ona agent sessions
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.

Runner support bundles

Runner support bundles capture logs, metrics, and diagnostic data from a self-hosted runner. They are useful when diagnosing runner issues and environment issues.
They are not available for Ona Cloud runners.

How to download

  1. Go to Settings → Runners.
  2. Locate your runner card.
  3. Click the ... menu and select Download support bundle.

What’s included

DataDescription
LogsRunner logs, gathered from ephemeral storage and cloud logging services
MetricsA snapshot of runner metrics from the last 24 hours
DiagnosticsRuntime profiling data, memory usage, and system information

Requesting support

To start a support case, use the chat bubble in the bottom-right corner of the application home page. When reporting an issue, attach the relevant support bundles / logs:
  • Environment issues: Provide both the environment support bundle and the runner support bundle.
  • Runner issues: The runner support bundle alone is sufficient. Examples include setting up a new runner, investigating a degraded runner, or providing supplemental information for environment issues.
  • IDE issues: See the troubleshooting section for your editor or IDE on how to export logs.
Review contents before sharing outside your organization.