datadog-frontend-toolkit 1.0.11 → 1.0.12
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 +37 -12
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -315,14 +315,17 @@ init({
|
|
|
315
315
|
|
|
316
316
|
## CLI — Resource Provisioning
|
|
317
317
|
|
|
318
|
-
The CLI provisions Datadog resources (dashboards, monitors, SLOs) for your service automatically
|
|
318
|
+
The CLI provisions Datadog resources (dashboards, monitors, SLOs) for your service automatically with an **interactive wizard**.
|
|
319
319
|
|
|
320
320
|
> **Note:** This uses Datadog API/App keys and runs server-side only. Never expose these keys in the browser.
|
|
321
321
|
|
|
322
322
|
### Setup Resources
|
|
323
323
|
|
|
324
324
|
```bash
|
|
325
|
-
#
|
|
325
|
+
# Interactive mode — prompts for everything
|
|
326
|
+
npx datadog-frontend-toolkit setup
|
|
327
|
+
|
|
328
|
+
# With CLI arguments
|
|
326
329
|
npx datadog-frontend-toolkit setup \
|
|
327
330
|
--service my-app \
|
|
328
331
|
--env production \
|
|
@@ -330,7 +333,7 @@ npx datadog-frontend-toolkit setup \
|
|
|
330
333
|
--app-key $DD_APP_KEY \
|
|
331
334
|
--team frontend
|
|
332
335
|
|
|
333
|
-
# Using environment variables
|
|
336
|
+
# Using environment variables (prompted for the rest)
|
|
334
337
|
export DD_API_KEY=your-api-key
|
|
335
338
|
export DD_APP_KEY=your-app-key
|
|
336
339
|
npx datadog-frontend-toolkit setup -s my-app -e production
|
|
@@ -355,17 +358,39 @@ npx datadog-frontend-toolkit status -s my-app -e production
|
|
|
355
358
|
|
|
356
359
|
**Monitors (6):**
|
|
357
360
|
- High Frontend Error Rate (>50 errors/5min)
|
|
358
|
-
- Poor LCP Performance (
|
|
359
|
-
- High CLS Score (
|
|
360
|
-
- JS Error Spike (>100 errors/5min)
|
|
361
|
+
- Poor LCP Performance (avg LCP > 3s)
|
|
362
|
+
- High CLS Score (avg CLS > 0.2)
|
|
363
|
+
- JS Error Spike (>100 JS errors/5min)
|
|
361
364
|
- Error Log Anomaly (>200 error logs/15min)
|
|
362
|
-
- Poor INP Performance (
|
|
365
|
+
- Poor INP Performance (avg INP > 400ms)
|
|
366
|
+
|
|
367
|
+
**SLOs (1):**
|
|
368
|
+
- Frontend Availability (99.5% target, monitor-based)
|
|
369
|
+
|
|
370
|
+
### Direct Access Links
|
|
371
|
+
|
|
372
|
+
After provisioning, the CLI outputs **clickable direct links** to every resource in Datadog:
|
|
373
|
+
|
|
374
|
+
```
|
|
375
|
+
✅ Dashboards:
|
|
376
|
+
[Auto] my-app - Frontend Observability
|
|
377
|
+
https://app.datadoghq.com/dashboard/abc-def-ghi/...
|
|
378
|
+
✅ Monitors:
|
|
379
|
+
[Auto] my-app (production) - High Frontend Error Rate
|
|
380
|
+
https://app.datadoghq.com/monitors/123456789
|
|
381
|
+
...
|
|
382
|
+
✅ SLOs:
|
|
383
|
+
[Auto] my-app (production) - Frontend Availability
|
|
384
|
+
https://app.datadoghq.com/slo?slo_id=abcdef123456
|
|
385
|
+
```
|
|
386
|
+
|
|
387
|
+
### Markdown Summary
|
|
388
|
+
|
|
389
|
+
A `datadog-observability-{service}.md` file is generated in the current directory with a full summary of all provisioned resources and their direct links. You can commit this to your repo or share it with your team.
|
|
390
|
+
|
|
391
|
+
### Idempotent Execution
|
|
363
392
|
|
|
364
|
-
|
|
365
|
-
- Frontend Availability (99.5% target)
|
|
366
|
-
- LCP Performance (75% good threshold)
|
|
367
|
-
- INP Performance (75% good threshold)
|
|
368
|
-
- CLS Performance (75% good threshold)
|
|
393
|
+
The CLI is safe to run multiple times. If a resource already exists (matched by name), it will be reused instead of duplicated. Individual resource failures are handled gracefully — one failing resource won't block the rest.
|
|
369
394
|
|
|
370
395
|
---
|
|
371
396
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "datadog-frontend-toolkit",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.12",
|
|
4
4
|
"description": "Enterprise-grade, framework-agnostic frontend observability toolkit for Datadog. Auto-instruments RUM, Logs, Error Tracking, Performance Monitoring, and provisions Dashboards, Monitors & SLOs.",
|
|
5
5
|
"main": "dist/cjs/index.js",
|
|
6
6
|
"module": "dist/esm/index.js",
|