From 3a6e01c1abd4a68810f1d85c9aa75293af47f579 Mon Sep 17 00:00:00 2001 From: Paul Buetow Date: Sat, 14 Feb 2026 13:54:54 +0200 Subject: docs: restructure documentation and move scripts to scripts/ - Add docs/ hierarchy: guides, backends, operations, reference, design - Slim root README; add documentation index and links to docs/ - Add missing docs: csv-format-flexibility, dns-resolution, dtail-metrics-example, magefile - Document Prometheus/VictoriaMetrics and ClickHouse backends - Move all helper shell scripts to scripts/; update Magefile and doc references - Add ASCII diagrams for watch mode (CSV watcher), auto mode, and ingestion paths - Add .gitignore Co-authored-by: Cursor --- docs/reference/cli.md | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 docs/reference/cli.md (limited to 'docs/reference/cli.md') diff --git a/docs/reference/cli.md b/docs/reference/cli.md new file mode 100644 index 0000000..83d02b0 --- /dev/null +++ b/docs/reference/cli.md @@ -0,0 +1,57 @@ +# CLI Reference + +All flags and defaults. Modes: `realtime`, `historic`, `backfill`, `auto`, `watch`. + +## Global + +| Flag | Default | Description | +|------|---------|-------------| +| `-version` | — | Print version and exit | +| `-mode` | `realtime` | Mode: realtime, historic, backfill, auto, or watch | + +## Realtime + +| Flag | Default | Description | +|------|---------|-------------| +| `-pushgateway` | `http://localhost:9091` | Pushgateway URL | +| `-job` | `example_metrics_pusher` | Job name for metrics | +| `-continuous` | `false` | Push every 15s | + +## Historic + +| Flag | Default | Description | +|------|---------|-------------| +| `-prometheus` | `http://localhost:9090/api/v1/write` | Prometheus Remote Write URL | +| `-hours-ago` | `24` | Hours in the past (single datapoint) | + +## Backfill + +| Flag | Default | Description | +|------|---------|-------------| +| `-prometheus` | `http://localhost:9090/api/v1/write` | Prometheus Remote Write URL | +| `-start-hours` | `48` | Start time in hours ago | +| `-end-hours` | `0` | End time in hours ago (0 = now) | +| `-interval` | `1` | Interval between points in hours | + +## Auto + +| Flag | Default | Description | +|------|---------|-------------| +| `-file` | — | Input file path (required) | +| `-format` | `csv` | Input format: csv or json | +| `-pushgateway` | `http://localhost:9091` | Pushgateway URL | +| `-prometheus` | `http://localhost:9090/api/v1/write` | Prometheus Remote Write URL | + +## Watch + +| Flag | Default | Description | +|------|---------|-------------| +| `-file` | — | CSV file(s) to watch (comma-separated for multiple); required | +| `-metric-name` | — | Base metric name (e.g. myapp, food); required | +| `-prometheus` | `http://localhost:9090/api/v1/write` | Prometheus Remote Write URL (set to empty to disable) | +| `-clickhouse` | — | ClickHouse HTTP URL (e.g. http://localhost:8123) | +| `-clickhouse-table` | `epimetheus_metrics` | ClickHouse table name | +| `-job` | `example_metrics_pusher` | Job name for metrics | +| `-resolve-ip-labels` | (ip only) | Comma-separated additional IP labels to resolve via DNS | + +Watch mode requires at least one of `-prometheus` or `-clickhouse`. Use `-prometheus=` to ingest only to ClickHouse. -- cgit v1.2.3