@tsuga/cli 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +35 -2
  2. package/dist/cli.js +144 -58
  3. package/package.json +3 -3
package/README.md CHANGED
@@ -22,6 +22,30 @@ tsuga self-update
22
22
 
23
23
  This runs `npm install -g @tsuga/cli@latest`. The CLI also checks for new versions once a day and prints a notice when one is available.
24
24
 
25
+ ## Shell completion
26
+
27
+ Tab-complete commands and flags in `bash`, `zsh`, or `fish`.
28
+
29
+ For `bash` and `zsh`, add the matching line to your shell startup file:
30
+
31
+ ```bash
32
+ # ~/.bashrc
33
+ eval "$(tsuga completion bash)"
34
+
35
+ # ~/.zshrc
36
+ eval "$(tsuga completion zsh)"
37
+ ```
38
+
39
+ Then open a new shell (or `source` the file).
40
+
41
+ For `fish`, write the script to your completions directory:
42
+
43
+ ```fish
44
+ tsuga completion fish > ~/.config/fish/completions/tsuga.fish
45
+ ```
46
+
47
+ Fish loads it automatically in new shells.
48
+
25
49
  ## Authentication
26
50
 
27
51
  All authentication lives under `tsuga auth`.
@@ -31,7 +55,7 @@ All authentication lives under `tsuga auth`.
31
55
  For interactive use, log in as a user with a browser authorization flow:
32
56
 
33
57
  ```bash
34
- # Prints an authorization URL. On macOS, also opens it in your browser.
58
+ # Opens your browser to an authorization URL, or prints the URL if it can't be opened.
35
59
  tsuga auth login
36
60
 
37
61
  # Print the saved user access token
@@ -169,7 +193,7 @@ tsuga logs patterns --rationale "exploring telemetry to investigate prod outage"
169
193
 
170
194
  ### Available resources
171
195
 
172
- `cloud-resources`, `dashboards`, `ingestion-api-keys`, `investigations`, `monitors`, `notification-rules`, `notification-silences`, `quality-reports`, `retention-policies`, `routes`, `services`, `tag-policies`, `teams`
196
+ `cloud-resources`, `dashboards`, `ingestion-api-keys`, `investigations`, `monitors`, `notification-rules`, `notification-silences`, `quality-reports`, `retention-policies`, `routes`, `services`, `slos`, `tag-policies`, `teams`
173
197
 
174
198
  > Notes:
175
199
  >
@@ -283,6 +307,15 @@ tsuga logs error-pattern-increases --from -24h --team my-team --env prod
283
307
  tsuga traces search --from -30m --query 'span_name:GET'
284
308
  ```
285
309
 
310
+ ### Summarize a trace
311
+
312
+ Aggregates groups of similar spans into synthetic summary spans (marked with
313
+ `spanAttributes.aggregation.is_summary`) for a compact view of large traces:
314
+
315
+ ```bash
316
+ tsuga traces summarize --trace-id 78c99c5bb1e4a30297fa134b9dbec64f --from -30m
317
+ ```
318
+
286
319
  ### Metrics
287
320
 
288
321
  ```bash