@dx-do/cli 6.0.4 → 6.1.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.
package/README.md CHANGED
@@ -47,7 +47,7 @@ bunx @dx-do/cli@<version> <--config=<config-file>> command-group command <parame
47
47
  #### Output
48
48
 
49
49
  ```
50
- ℹ info dx-do v6.0.4 on node v24.16.0 on linux-x64 via node (ssl: 3.5.6)
50
+ ℹ info dx-do v6.1.0 on node v24.16.0 on linux-x64 via node (ssl: 3.5.6)
51
51
  ⚠ warning Not loading configuration
52
52
  ✖ error Usage: dx-do --option[=value]... <command-group> <command> <command-param>=<value>...
53
53
  ℹ info Available command-groups: acc, agent, agentic, alarm, alert, apm-universe, asm, attribute, audit, auth, axa, blob, channel, config, dashboard, diagnose, event, experience, graph, help, inventory, jsextension, log, managementmodule, metrex, metric, metricgrouping, nass, o2-alert, o2-managementmodule, o2-metricgrouping, o2-universe, perspective, service, situation, sql, tas, topographer, trace, ui, vertex
@@ -213,9 +213,9 @@ bunx @dx-do/cli@<version> <--config=<config-file>> command-group command <parame
213
213
  ```
214
214
  #### nass
215
215
  ```nass
216
- ⤜ update-metadata-attribute.........................: updates a metric's metadata attribute
217
- ⤜ report-metric-value...............................: reports a single metric value to a metric
218
- ⤜ register-metric...................................: registers a metric
216
+ ⤜ update-metadata-attribute.........................: update a single metadata attribute on a metric
217
+ ⤜ report-metric-value...............................: register a metric and store a single value for it at the current time
218
+ ⤜ register-metric...................................: register a metric in the NASS metadata store
219
219
  ⤜ query-metric-data.................................: executes a nass metric data query
220
220
  ⤜ query-metadata....................................: executes a nass metadata query
221
221
  ⤜ query-metadata-by-ids.............................: executes a nass metadata query
@@ -267,6 +267,7 @@ bunx @dx-do/cli@<version> <--config=<config-file>> command-group command <parame
267
267
  ```help
268
268
  ⤜ ui................................................: Explains `dx-do ui start` — the browser-based visual query builder for TAS / NASSQL / Metrics-Metadata queries.
269
269
  ⤜ time-formats......................................: explains time formats for 'metric data' and 'agent get-trace-sumaries'.
270
+ ⤜ metric-types......................................: explains numericMetricType and enumMetricType for 'nass register-metric' and 'nass report-metric-value'.
270
271
  ⤜ bulk-patch........................................: explains vertex bulk-patch
271
272
  ⤜ dashboard.........................................: explains dashboard command setup.
272
273
  ⤜ configuration.....................................: explains configuration
@@ -276,6 +277,8 @@ bunx @dx-do/cli@<version> <--config=<config-file>> command-group command <parame
276
277
  ```
277
278
  #### trace
278
279
  ```trace
280
+ ⤜ inject-simple.....................................: inject a synthetic APM transaction trace into the tracestore using CLI arguments
281
+ ⤜ inject............................................: inject APM transaction trace(s) from a JSON file into the tracestore
279
282
  ⤜ trace-details.....................................: get trace details for traceId
280
283
  ⤜ query-threaddumps.................................: find threaddumps for an agent
281
284
  ⤜ get-threaddump....................................: retrieve a previously collected threaddump
@@ -330,7 +333,7 @@ bunx @dx-do/cli@<version> <--config=<config-file>> command-group command <parame
330
333
  ```
331
334
  #### tas
332
335
  ```tas
333
- ⤜ store-graph.......................................: stores vertexes and edges
336
+ ⤜ store-graph.......................................: store vertices and edges in the TAS topology store from a JSON file
334
337
  ⤜ query-json........................................: executes a query defined in a json file
335
338
  ⤜ query-all.........................................: finds everything
336
339
  ⤜ query-agents......................................: finds everything
@@ -434,6 +437,7 @@ bunx @dx-do/cli@<version> <--config=<config-file>> command-group command <parame
434
437
  #### log
435
438
  ```log
436
439
  ⤜ query.............................................: queries DXO2 Log analytics
440
+ ⤜ ingest............................................: ingest one or more log entries directly into the DXO2 log analytics gateway
437
441
  ```
438
442
  #### blob
439
443
  ```blob
@@ -509,11 +513,12 @@ npx @dx-do/cli alert list
509
513
 
510
514
  ```
511
515
  {
512
- "configurationVersion": "3"
513
- "cohortId": "<cohortUD from Settings -> Connector Parameters>",
514
- "userToken": <DX User Token from Settings -> Manage Tokens -> New Token -> User>,
516
+ "configurationVersion": "4",
517
+ "cohortId": "<cohortId from Settings -> Connector Parameters>",
518
+ "userToken": "<DX User Token from Settings -> Manage Tokens -> New Token -> User>",
515
519
  "dxGatewayHost": "https://apmgw.dxi-na1.saas.broadcom.com/",
516
- "dxASMToken": <optional token for ASM API usage>
520
+ "dxASMToken": "<optional: token for ASM API usage>",
521
+ "dxLogIngestionURL": "<optional: log gateway base URL for 'log ingest' (e.g. https://logs-gateway.dxi-na1.saas.broadcom.com)>"
517
522
  }
518
523
  ```
519
524
 
@@ -75,10 +75,12 @@ When an MCP client (Claude Code, Cursor, mcp-inspector) spawns `dx-do` as a subp
75
75
 
76
76
  ```
77
77
  {
78
- "configurationVersion": "3"
79
- "cohortId": "<cohortUD from Settings -> Connector Parameters>",
80
- "userToken": <DX User Token from Settings -> Manage Tokens -> New Token -> User>,
78
+ "configurationVersion": "4",
79
+ "cohortId": "<cohortId from Settings -> Connector Parameters>",
80
+ "userToken": "<DX User Token from Settings -> Manage Tokens -> New Token -> User>",
81
81
  "dxGatewayHost": "https://apmgw.dxi-na1.saas.broadcom.com/",
82
+ "dxASMToken": "<optional: token for ASM API usage>",
83
+ "dxLogIngestionURL": "<optional: log gateway base URL for 'log ingest' (e.g. https://logs-gateway.dxi-na1.saas.broadcom.com)>"
82
84
  }
83
85
  ```
84
86