> ## Documentation Index
> Fetch the complete documentation index at: https://astronomer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# astro env metrics-export list

<Info>
  This command is only available on Astro.
</Info>

List the metrics exports for a scope. At Deployment scope, the list includes metrics exports linked from the Workspace unless you set `--resolve-linked` to `false`.

## Usage

```bash wrap theme={null}
astro env metrics-export list
```

## Options

| Option              | Description                                                                                                                                                                      | Possible Values             |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- |
| `--format`          | The output format. Defaults to `table`.                                                                                                                                          | `table`, `json`, or `yaml`  |
| `--output`          | Write the output to a file. Use `-` for stdout. Defaults to `-`.                                                                                                                 | Any valid file path, or `-` |
| `--include-secrets` | Surface secret values in the output. Requires an Organization policy that allows it.                                                                                             | None                        |
| `--resolve-linked`  | Include objects linked from another scope, such as a Workspace metrics export resolved at Deployment scope. Enabled by default. Set to `false` to return addressable object IDs. | `true` (default), `false`   |
| `--workspace-id`    | Set the Workspace scope. Mutually exclusive with `--deployment-id`. Defaults to your current Workspace from CLI context.                                                         | Any valid Workspace ID      |
| `--deployment-id`   | Set the Deployment scope. Mutually exclusive with `--workspace-id`.                                                                                                              | Any valid Deployment ID     |

## Examples

```bash wrap theme={null}
# List Workspace metrics exports
astro env metrics-export list --workspace-id <workspace-id>
```

## Related commands

* [`astro env metrics-export get`](/docs/cli/v1.43/astro-env-metrics-export-get)
* [`astro env metrics-export create`](/docs/cli/v1.43/astro-env-metrics-export-create)