---
title: "ezgh obs services list"
description: "List the project's services."
---

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

# ezgh obs services list

{/* Generated by ezgh-cli's internal/tools/clidocs from the ezgh command tree. Don't edit: change the command's help in ezgh-cli and regenerate. */}

```sh
ezgh obs services list [--query q] [--environment e] [--application a] [--active true|false|all] [--stats [--from t] [--to t]] [flags]
```

List the project's services, by key, with the applications, environments and signals each was seen on and when it was last seen. Only active services (seen in the last 7 days) are listed unless `--active` is false (only inactive ones) or all. `--query` keeps the services whose key or name contains it (ignoring case); `--key` keeps the one with that exact key.

`--stats` adds each service's requests per second, error rate and p95 latency over `--from` (default 1h ago) to `--to` (default now), from span metrics: requests are server and consumer spans, and with `--environment` only that environment's count. Stats are PromQL reads, which need obs.metrics.query; without it the services are listed without stats.

Part of [`ezgh obs services`](/cli/reference/obs-services).

## Examples

```sh
ezgh obs services list
ezgh obs services list --environment production --stats --from 6h
ezgh obs services list --application shop --active all
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--active` | string | `true` | true: seen in the last 7 days; false: not; all |
| `--all` | boolean |  | follow nextCursor through every page |
| `--application` | string |  | only services seen with this application (ezgh.metadata.application) |
| `--cursor` | string |  | start from this page (a previous page's nextCursor) |
| `--environment` | string |  | only services seen in this environment (and, with `--stats`, its stats) |
| `--from` | string |  | start of `--stats`' window (default 1h ago) |
| `--key` | string |  | only the service with this exact key |
| `--limit` | int | `20` | items per page, 1 to 100 |
| `-q`, `--query` | string |  | only services whose key or name contains this (ignoring case) |
| `--stats` | boolean |  | add requests per second, error rate and p95 latency from span metrics |
| `--to` | string |  | end of `--stats`' window (default now) |

This command also takes the [global flags](/cli/reference#global-flags).

Source: https://docs.ezghcloud.com/cli/reference/obs-services-list/index.mdx