---
title: Diagnostics
description: Read-only platform diagnostics: db, perf, bottlenecks, traffic.
---

# Diagnostics



{/* AUTO-GENERATED by scripts/generate-cli-reference.mjs from `argusctl introspect --json`.
    Do not edit by hand. Regenerate with: pnpm generate:cli */}

> Generated from argusctl v0.1.0 on 2026-06-09. Run `argusctl introspect --json` for the machine-readable tree.

## `argusctl db`

Live database conditions: connections, size, cache-hit ratio, slow queries (read-only).

```bash
argusctl db [options]
```

| Option            | Description                       |
| ----------------- | --------------------------------- |
| `--api <url>`     | API base URL                      |
| `--token <pat>`   | PAT to use                        |
| `--json`          | JSON output                       |
| `--fields <list>` | comma-separated fields to include |

## `argusctl perf`

API latency p50/p95/p99 + error rate + req/min per route (read-only).

```bash
argusctl perf [options]
```

| Option            | Description                       |
| ----------------- | --------------------------------- |
| `--window <min>`  | window in minutes (1-1440)        |
| `--limit <n>`     | max routes (1-200)                |
| `--api <url>`     | API base URL                      |
| `--token <pat>`   | PAT to use                        |
| `--json`          | JSON output                       |
| `--fields <list>` | comma-separated fields to include |

## `argusctl bottlenecks`

Rank current platform constraints (db/pods/dlq/errors) with recommendations (read-only).

```bash
argusctl bottlenecks [options]
```

| Option              | Description                                              |
| ------------------- | -------------------------------------------------------- |
| `--watch [seconds]` | live refresh every N seconds (default 5); Ctrl+C to stop |
| `--api <url>`       | API base URL                                             |
| `--token <pat>`     | PAT to use                                               |
| `--json`            | JSON output                                              |
| `--fields <list>`   | comma-separated fields to include                        |

## `argusctl traffic`

Detection + incident throughput (per-camera / per-tenant) over a window (read-only).

```bash
argusctl traffic [options]
```

| Option             | Description                       |
| ------------------ | --------------------------------- |
| `--window <hours>` | window in hours (1-720)           |
| `--limit <n>`      | max rows per breakdown (1-100)    |
| `--api <url>`      | API base URL                      |
| `--token <pat>`    | PAT to use                        |
| `--json`           | JSON output                       |
| `--fields <list>`  | comma-separated fields to include |

## Examples

```bash
argusctl db            # live DB conditions: connections, size, cache-hit ratio, slow queries
argusctl perf          # API p50/p95/p99 + error rate + req/min per route
argusctl bottlenecks   # ranked platform constraints + recommendations
argusctl traffic       # detection + incident throughput
```


---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)