---
page_title: "ona_runners Data Source - ona"
subcategory: "Runners"
description: |-
  Fetches all Ona runners visible to the configured provider token. This data source does not currently support server-side filters.
---

# ona_runners (Data Source)

Fetches all Ona runners visible to the configured provider token. This data source does not currently support server-side filters.

For product context, see [Runner infrastructure](https://ona.com/docs/ona/runners/overview).

## Example Usage

```terraform
data "ona_runners" "example" {}
```

<!-- schema generated by tfplugindocs -->
## Schema

### Read-Only

- `id` (String) Terraform data source ID. Always `runners`.
- `runners` (Attributes List) Runner records sorted by runner ID for deterministic plans. (see [below for nested schema](#nestedatt--runners))

<a id="nestedatt--runners"></a>
### Nested Schema for `runners`

Read-Only:

- `cloudformation_template_url` (String) CloudFormation template URL for AWS EC2 runner setup. This is populated only for `aws_ec2` runners and is null for GCP runners.
- `configuration` (Attributes) Runner configuration. (see [below for nested schema](#nestedatt--runners--configuration))
- `created_at` (String) Time when the runner was created.
- `creator` (Attributes) Identity that created the runner. (see [below for nested schema](#nestedatt--runners--creator))
- `id` (String) Terraform data source ID. This is the same value as `runner_id`.
- `kind` (String) Runner kind deduced by the API from the provider.
- `name` (String) Runner display name.
- `runner_id` (String) Runner ID.
- `runner_provider` (String) Runner cloud provider, such as `aws_ec2` or `gcp`.
- `terraform_module_url` (String) Terraform module URL for deploying runner infrastructure with native cloud-provider resources. AWS EC2 runners link to the unversioned public AWS module repository because it has no official release; GCP runners link to the latest published module in the Terraform Registry.

<a id="nestedatt--runners--configuration"></a>
### Nested Schema for `runners.configuration`

Read-Only:

- `auto_update` (Boolean) Whether the runner automatically updates itself.
- `devcontainer_image_cache_enabled` (Boolean) Whether the shared devcontainer build cache is enabled for this runner.
- `log_level` (String) Runner log level, such as `debug`, `info`, `warn`, or `error`.
- `metrics` (Attributes) Metrics delivery configuration. Custom pipeline passwords are never exposed by this data source. (see [below for nested schema](#nestedatt--runners--configuration--metrics))
- `region` (String) Cloud region configured for the runner, when the runner provider uses a region.
- `release_channel` (String) Runner release channel, such as `stable` or `latest`.
- `update_window` (Attributes) Daily UTC window during which auto-updates may run. (see [below for nested schema](#nestedatt--runners--configuration--update_window))

<a id="nestedatt--runners--configuration--metrics"></a>
### Nested Schema for `runners.configuration.metrics`

Read-Only:

- `custom` (Attributes) Custom remote-write metrics pipeline configuration. Passwords are never exposed by this data source. (see [below for nested schema](#nestedatt--runners--configuration--metrics--custom))
- `managed` (Attributes) Ona-managed metrics pipeline configuration. (see [below for nested schema](#nestedatt--runners--configuration--metrics--managed))

<a id="nestedatt--runners--configuration--metrics--custom"></a>
### Nested Schema for `runners.configuration.metrics.custom`

Read-Only:

- `enabled` (Boolean) Whether the runner sends metrics to the custom pipeline.
- `url` (String) Remote-write URL for the custom metrics pipeline.
- `username` (String) Username for authenticating to the custom metrics pipeline.


<a id="nestedatt--runners--configuration--metrics--managed"></a>
### Nested Schema for `runners.configuration.metrics.managed`

Read-Only:

- `enabled` (Boolean) Whether the runner sends metrics through Ona's managed metrics pipeline.



<a id="nestedatt--runners--configuration--update_window"></a>
### Nested Schema for `runners.configuration.update_window`

Read-Only:

- `end` (String) End time in `HH:00` UTC format.
- `start` (String) Start time in `HH:00` UTC format.



<a id="nestedatt--runners--creator"></a>
### Nested Schema for `runners.creator`

Read-Only:

- `id` (String) Creator subject ID.
- `principal` (String) Creator principal type.