1# gordon traffic
2
3Inspect Gordon traffic plane status.
4
5## Subcommands
6
7| Command | Description |
8|---------|-------------|
9| `gordon traffic status` | Show traffic entrypoints, counters, and reload status |
10
11## Usage
12
13```bash
14gordon traffic status --remote prod
15gordon traffic status --remote https://gordon.example.com --json
16```
17
18Remote mode queries the running Gordon admin API. Local mode does not synthesize runtime traffic state from a fresh config load; use a configured remote target for authoritative counters and reload status.
19
20## Flags
21
22| Flag | Description |
23|------|-------------|
24| `--json` | Output machine-readable JSON |
25| `--remote`, `-r` | Remote Gordon instance or saved remote name |
26
27## JSON Output
28
29```json
30{
31  "last_reload_status": "ok",
32  "entrypoints": [
33    {
34      "name": "postgres",
35      "address": "0.0.0.0:5432",
36      "protocol": "tcp",
37      "active": true,
38      "active_tcp_connections": 1,
39      "active_udp_sessions": 0,
40      "total_accepted": 12,
41      "total_refused": 0,
42      "total_errors": 0,
43      "bytes_in": 4096,
44      "bytes_out": 8192,
45      "smart_tcp": {
46        "http_accepted": 0,
47        "h2c_accepted": 0,
48        "https_fallback_accepted": 0,
49        "tls_passthrough_accepted": 0,
50        "raw_fallback_accepted": 0,
51        "entrypoint_cidr_refused": 0,
52        "raw_fallback_cidr_refused": 0,
53        "proxy_refused": 0,
54        "unknown_no_fallback_refused": 0,
55        "malformed_rejected": 0,
56        "sniff_timeout": 0,
57        "client_hello_too_large": 0
58      }
59    }
60  ],
61  "routers": [],
62  "services": [],
63  "counters": {
64    "active_tcp_connections": 1,
65    "active_udp_sessions": 0,
66    "total_accepted": 12,
67    "total_refused": 0,
68    "total_errors": 0,
69    "bytes_in": 4096,
70    "bytes_out": 8192,
71    "smart_tcp": {
72      "http_accepted": 0,
73      "h2c_accepted": 0,
74      "https_fallback_accepted": 0,
75      "tls_passthrough_accepted": 0,
76      "raw_fallback_accepted": 0,
77      "entrypoint_cidr_refused": 0,
78      "raw_fallback_cidr_refused": 0,
79      "proxy_refused": 0,
80      "unknown_no_fallback_refused": 0,
81      "malformed_rejected": 0,
82      "sniff_timeout": 0,
83      "client_hello_too_large": 0
84    }
85  }
86}
87```
88
89## Related
90
91- [Traffic configuration](../config/traffic.md)
92- [Standalone services](../config/services.md)
93- [Server status](./status.md)