datadog-frontend-toolkit 1.0.52 → 1.0.53

package/README.md

@@ -19,6 +19,7 @@ One `init()` call to auto-instrument **RUM**, **Logs**, **Error Tracking**, **Pe
 - **Resource provisioning CLI** — auto-creates Dashboards, Monitors, SLOs, and Burn Rate Alerts
 - **Environment-aware SLO targets** — 99.5% for production, 95% for non-production
 - **Google SRE burn rate alerts** — multi-window, multi-burn-rate alerting with auto-clamped thresholds
+- **Traffic-aware thresholds** — `--load-size` calibrates monitor thresholds to your app's traffic volume
 - **Resource teardown** — `--remove` flag deletes all managed resources for a service/environment
 - **Plugin system** — extend with custom integrations
 - **Lifecycle hooks** — `beforeInit`, `afterInit`, `beforeLog`, `beforeError`
@@ -337,7 +338,8 @@ npx datadog-frontend-toolkit setup \
   --env production \
   --api-key $DD_API_KEY \
   --app-key $DD_APP_KEY \
-  --team frontend
+  --team frontend \
+  --load-size medium
 
 # Using environment variables (prompted for the rest)
 export DD_API_KEY=your-api-key
@@ -352,6 +354,9 @@ npx datadog-frontend-toolkit setup -s my-app -e production --force
 
 # Skip specific resources
 npx datadog-frontend-toolkit setup -s my-app -e production --no-slos
+
+# Specify traffic load (skips interactive prompt)
+npx datadog-frontend-toolkit setup -s my-app -e production --load-size high -y
 ```
 
 ### Remove Resources
@@ -379,13 +384,36 @@ npx datadog-frontend-toolkit status -s my-app -e production
 **Dashboard (1):**
 - Frontend Observability overview with RUM metrics, Web Vitals, error tracking, API endpoint errors, and performance panels
 
-**Monitors (6):**
-- High Frontend Error Rate (>50 errors/5min)
+**Monitors (6):** — thresholds adapt to your `--load-size` profile
+- High Frontend Error Rate
 - Poor LCP Performance (avg LCP > 3s)
 - High CLS Score (avg CLS > 0.2)
-- JS Error Spike (>100 JS errors/5min)
-- Error Log Anomaly (>200 error logs/15min)
-- Poor INP Performance (avg INP > 400ms)
+- JS Error Spike
+- Error Log Anomaly
+- Slow Page Load (avg loading time > 5s)
+
+### Traffic Load Profiles (`--load-size`)
+
+Monitor thresholds and evaluation windows are automatically calibrated based on the selected traffic profile:
+
+| Profile | Users/min | Error Rate | JS Spike | Log Anomaly | Web Vitals Window |
+|---------|-----------|------------|----------|-------------|-------------------|
+| `low` | 1–50 | >10 in 15m | >25 in 15m | >50 in 15m | 4h |
+| `medium` | 50–500 | >50 in 10m | >100 in 10m | >200 in 15m | 1h |
+| `high` | 500–5,000 | >200 in 5m | >500 in 5m | >500 in 10m | 30m |
+| `very-high` | 5,000+ | >500 in 5m | >1,000 in 5m | >2,000 in 10m | 15m |
+
+If `--load-size` is not provided via flag, the CLI prompts interactively:
+
+```
+Expected traffic load for this service:
+  › 1) Low  (1–50 users/min)  — internal tools, admin panels, staging envs
+    2) Medium  (50–500 users/min)  — B2B SaaS, department-level apps
+    3) High  (500–5,000 users/min)  — company-wide apps, B2C products
+    4) Very High  (5,000+ users/min)  — high-traffic consumer apps
+```
+
+When using `-y` (skip prompts) without `--load-size`, defaults to `low`.
 
 **SLOs (2) — environment-aware targets:**
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "datadog-frontend-toolkit",
-  "version": "1.0.52",
+  "version": "1.0.53",
   "description": "Enterprise-grade, framework-agnostic frontend observability toolkit for Datadog. Auto-instruments RUM, Logs, Error Tracking, Performance Monitoring, and provisions Dashboards, Monitors & SLOs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",