autotel-devtools 13.1.1 → 15.0.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 (38) hide show
  1. package/README.md +24 -23
  2. package/dist/cli.cjs.map +1 -1
  3. package/dist/cli.d.cts +1 -1
  4. package/dist/cli.d.ts +1 -1
  5. package/dist/cli.js.map +1 -1
  6. package/dist/{error-aggregator-C8X-RQRi.d.ts → error-aggregator-BrgYNNoC.d.ts} +2 -3
  7. package/dist/{error-aggregator-7Q2H7htn.d.cts → error-aggregator-bZ-prq97.d.cts} +2 -3
  8. package/dist/{exporter-yqXiHw1Q.d.ts → exporter-BLqTs00O.d.ts} +1 -2
  9. package/dist/{exporter-kXTGDFoH.d.cts → exporter-BSIS3Qgy.d.cts} +1 -2
  10. package/dist/genai/index.cjs.map +1 -1
  11. package/dist/genai/index.d.cts +0 -1
  12. package/dist/genai/index.d.ts +0 -1
  13. package/dist/genai/index.js.map +1 -1
  14. package/dist/http-BUHnkhrC.cjs.map +1 -1
  15. package/dist/http-yIS667nX.js.map +1 -1
  16. package/dist/index.cjs.map +1 -1
  17. package/dist/index.d.cts +2 -3
  18. package/dist/index.d.ts +2 -3
  19. package/dist/index.js.map +1 -1
  20. package/dist/listen-DGzVi7DE.cjs.map +1 -1
  21. package/dist/listen-NVMbBWHw.js.map +1 -1
  22. package/dist/resource-utils-B4UVvfnH.js.map +1 -1
  23. package/dist/resource-utils-DjHJB6uc.cjs.map +1 -1
  24. package/dist/server/exporter.cjs.map +1 -1
  25. package/dist/server/exporter.d.cts +1 -1
  26. package/dist/server/exporter.d.ts +1 -1
  27. package/dist/server/exporter.js.map +1 -1
  28. package/dist/server/index.d.cts +2 -3
  29. package/dist/server/index.d.ts +2 -3
  30. package/dist/server/log-exporter.cjs.map +1 -1
  31. package/dist/server/log-exporter.d.cts +0 -1
  32. package/dist/server/log-exporter.d.ts +0 -1
  33. package/dist/server/log-exporter.js.map +1 -1
  34. package/dist/server/remote-exporter.d.cts +0 -1
  35. package/dist/server/remote-exporter.d.ts +0 -1
  36. package/dist/widget.global.js +14 -13
  37. package/package.json +28 -29
  38. package/skills/autotel-devtools/SKILL.md +0 -123
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "autotel-devtools",
3
- "version": "13.1.1",
3
+ "version": "15.0.0",
4
4
  "description": "Standalone OTLP receiver with web UI for local development",
5
5
  "type": "module",
6
6
  "sideEffects": false,
@@ -32,8 +32,7 @@
32
32
  "main": "./dist/index.js",
33
33
  "types": "./dist/index.d.ts",
34
34
  "files": [
35
- "dist",
36
- "skills"
35
+ "dist"
37
36
  ],
38
37
  "keywords": [
39
38
  "opentelemetry",
@@ -49,49 +48,49 @@
49
48
  ],
50
49
  "dependencies": {
51
50
  "clsx": "^2.1.1",
52
- "@lucide/svelte": "^1.23.0",
53
- "protobufjs": "^8.7.0",
54
- "svelte": "^5.56.4",
51
+ "@lucide/svelte": "^1.25.0",
52
+ "protobufjs": "^8.7.1",
53
+ "svelte": "^5.56.7",
55
54
  "tailwind-merge": "^3.6.0",
56
- "ws": "^8.21.0",
55
+ "ws": "^8.21.1",
57
56
  "autotel-agents": "0.3.0"
58
57
  },
59
58
  "devDependencies": {
60
59
  "@chromatic-com/storybook": "^5.2.1",
61
60
  "@opentelemetry/api": "^1.9.1",
62
- "@opentelemetry/core": "^2.7.1",
63
- "@opentelemetry/otlp-transformer": "^0.218.0",
64
- "@opentelemetry/sdk-logs": "^0.218.0",
65
- "@opentelemetry/sdk-trace-base": "^2.7.1",
66
- "@storybook/addon-a11y": "^10.4.6",
67
- "@storybook/addon-vitest": "^10.4.6",
68
- "@storybook/svelte-vite": "^10.4.6",
61
+ "@opentelemetry/core": "^2.9.0",
62
+ "@opentelemetry/otlp-transformer": "^0.220.0",
63
+ "@opentelemetry/sdk-logs": "^0.220.0",
64
+ "@opentelemetry/sdk-trace-base": "^2.9.0",
65
+ "@storybook/addon-a11y": "^10.5.3",
66
+ "@storybook/addon-vitest": "^10.5.3",
67
+ "@storybook/svelte-vite": "^10.5.3",
69
68
  "@sveltejs/vite-plugin-svelte": "^7.2.0",
70
- "@tailwindcss/postcss": "^4.3.2",
71
- "@tailwindcss/vite": "^4.3.2",
72
- "@testing-library/jest-dom": "^6.9.1",
69
+ "@tailwindcss/postcss": "^4.3.3",
70
+ "@tailwindcss/vite": "^4.3.3",
71
+ "@testing-library/jest-dom": "^7.0.0",
73
72
  "@testing-library/svelte": "^5.4.2",
74
- "@types/node": "^26.1.0",
73
+ "@types/node": "^26.1.1",
75
74
  "@types/ws": "^8.18.1",
76
75
  "@vitest/browser-playwright": "4.1.10",
77
76
  "@vitest/coverage-v8": "4.1.10",
78
- "eslint-plugin-storybook": "^10.4.6",
79
- "eslint-plugin-svelte": "^3.20.0",
77
+ "eslint-plugin-storybook": "^10.5.3",
78
+ "eslint-plugin-svelte": "^3.22.0",
80
79
  "jsdom": "^29.1.1",
81
80
  "playwright": "^1.61.1",
82
- "postcss": "^8.5.16",
83
- "storybook": "^10.4.6",
84
- "svelte-check": "^4.7.2",
85
- "tailwindcss": "^4.3.2",
86
- "tsdown": "^0.22.3",
81
+ "postcss": "^8.5.21",
82
+ "storybook": "^10.5.3",
83
+ "svelte-check": "^4.7.3",
84
+ "tailwindcss": "^4.3.3",
85
+ "tsdown": "^0.22.12",
87
86
  "typescript": "^6.0.3",
88
- "vite": "^8.1.3",
87
+ "vite": "^8.1.5",
89
88
  "vitest": "^4.1.10",
90
- "vitest-browser-svelte": "^2.2.0",
91
- "vitest-mock-extended": "^4.0.0"
89
+ "vitest-browser-svelte": "^3.0.0",
90
+ "vitest-mock-extended": "^5.1.0"
92
91
  },
93
92
  "peerDependencies": {
94
- "autotel": "4.3.0"
93
+ "autotel": "6.0.0"
95
94
  },
96
95
  "peerDependenciesMeta": {
97
96
  "autotel": {
@@ -1,123 +0,0 @@
1
- ---
2
- name: autotel-devtools
3
- description: >
4
- Standalone OTLP receiver with a Svelte web UI for local-dev observability. Use when a developer wants to see OpenTelemetry traces, logs, metrics, and service maps streaming from a running app without setting up Jaeger/Tempo/Prometheus — either as a CLI dashboard or an embedded `<autotel-devtools>` widget.
5
- ---
6
-
7
- # autotel-devtools
8
-
9
- Local-dev OTLP receiver with a browser UI. Think TanStack Devtools for OpenTelemetry — runs as CLI or embeds as a Shadow-DOM-isolated widget in any web app.
10
-
11
- ## Quick Start — pick an approach
12
-
13
- ### Standalone dashboard
14
-
15
- ```bash
16
- npx autotel-devtools
17
- # → OTLP receiver on :4318, UI at http://localhost:4318
18
- ```
19
-
20
- Point any OTel-instrumented app at it. The endpoints accept **both OTLP/JSON and
21
- OTLP/protobuf**, chosen from the request `Content-Type`, so protobuf-default SDKs
22
- (Python/Java/Go) work with no extra config:
23
-
24
- ```bash
25
- # JS (defaults to JSON, or set http/protobuf — both work)
26
- OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 node app.js
27
-
28
- # Python/Java/Go (default to http/protobuf)
29
- OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 python app.py
30
- ```
31
-
32
- ### Embedded widget
33
-
34
- ```html
35
- <script src="http://localhost:4318/widget.js"></script>
36
- <autotel-devtools></autotel-devtools>
37
- ```
38
-
39
- Shadow-DOM-isolated — never leaks styles into the host page.
40
-
41
- ### Programmatic (Node + autotel)
42
-
43
- ```typescript
44
- import { init, trace } from 'autotel';
45
- import { createDevtools } from 'autotel-devtools';
46
-
47
- const { exporter, close } = createDevtools({ port: 4318, verbose: true });
48
-
49
- init({
50
- service: 'my-app',
51
- endpoint: 'http://localhost:4318',
52
- spanProcessors: [exporter], // stream spans to the devtools UI
53
- });
54
-
55
- export const loadUser = trace(ctx => async (id: string) => {
56
- // ... span shows up live in devtools
57
- });
58
- ```
59
-
60
- ## Package Entry Points
61
-
62
- | Import | What |
63
- | --- | --- |
64
- | `autotel-devtools` | `createDevtools()`, `DevtoolsServer`, exporters, types |
65
- | `autotel-devtools/server` | `DevtoolsServer`, OTLP parsing (`parseOtlpTraces`, `parseOtlpLogs`), HTTP routes (`attachDevtoolsRoutes`, `createDevtoolsHttpServer`), telemetry-limit helpers |
66
- | `autotel-devtools/exporter` | `DevtoolsSpanExporter` (standalone) |
67
-
68
- ## Server Endpoints
69
-
70
- | Route | What |
71
- | --- | --- |
72
- | `POST /v1/traces` · `/v1/logs` · `/v1/metrics` | OTLP receivers — JSON or protobuf (`application/x-protobuf`) |
73
- | `GET /` | Dashboard UI (traces, logs, metrics, errors, resources, service map) |
74
- | `GET /widget.js` | Embeddable widget bundle (IIFE) |
75
- | `GET /healthz` | Health check |
76
- | `WS /ws` | WebSocket stream (history replay on connect) |
77
-
78
- ## Views in the UI
79
-
80
- - **Traces** — waterfall + flame graph, search with 300 ms debounce
81
- - **Logs** — severity/resource filtering
82
- - **Metrics** — per-metric time series
83
- - **Errors** — aggregated and grouped by fingerprint
84
- - **Resources** — derived from ingested telemetry
85
- - **Service map** — visualises call graph
86
-
87
- ## Environment Variables
88
-
89
- | Variable | Default | Purpose |
90
- | --- | --- | --- |
91
- | `AUTOTEL_DEVTOOLS_PORT` | `4318` | Server port |
92
- | `AUTOTEL_DEVTOOLS_HOST` | `127.0.0.1` | Bind host |
93
- | `AUTOTEL_DEVTOOLS_TITLE` | — | Dashboard title |
94
- | `AUTOTEL_MAX_TRACE_COUNT` | `100` | Max traces retained in memory |
95
- | `AUTOTEL_MAX_LOG_COUNT` | `100` | Max logs retained |
96
- | `AUTOTEL_MAX_METRIC_COUNT` | `100` | Max metric points retained |
97
-
98
- ## CLI
99
-
100
- ```bash
101
- npx autotel-devtools 4319 # port as bare positional
102
- npx autotel-devtools --port 4319 --host 0.0.0.0 --title "My App"
103
- ```
104
-
105
- | Arg / Flag | Short | Purpose |
106
- | --- | --- | --- |
107
- | `[port]` | — | Listen port shorthand for `--port` (explicit `--port` wins) |
108
- | `--port` | `-p` | Listen port (default 4318); walks to next free port if taken |
109
- | `--host` | `-H` | Bind host (default 127.0.0.1) |
110
- | `--title` | `-t` | Dashboard title |
111
-
112
- ## Works With
113
-
114
- - **autotel** — pass `exporter` into `spanProcessors` for live streaming
115
- - **Standard OpenTelemetry SDK** — any OTLP exporter targeting `http://localhost:4318` works; autotel is not required
116
- - **Browser apps** — the widget is a custom element with Shadow DOM, so drop it in without CSS conflicts
117
-
118
- ## Common Mistakes
119
-
120
- - Do NOT use the widget in Node — it's a browser-only IIFE bundle. Use `createDevtools()` server-side instead.
121
- - Do NOT set a production OTLP endpoint at `localhost:4318` — devtools is in-memory only (no persistence, caps at 100 items per signal by default). Bump `AUTOTEL_MAX_*_COUNT` for longer local sessions.
122
- - Do NOT embed the widget into pages served via strict CSP without allowing `http://localhost:4318` — the WebSocket connection and script load both need the devtools origin allowed.
123
- - Do NOT confuse the two builds — the **server** uses tsup (Node ESM + CJS), the **widget** uses Vite's IIFE build. Don't import `autotel-devtools/server` into widget code; it pulls in Node APIs.