@fougere/observability 0.4.0-alpha.0 → 0.5.0-alpha.1
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 +29 -0
- package/package.json +6 -6
package/README.md
ADDED
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# @fougere/observability
|
|
2
|
+
> One span per operation, and the four signals derived from it
|
|
3
|
+
Optional in the strong sense: core holds no tracing code at all, only a `trace` field on
|
|
4
|
+
the invocation that it carries and never reads. An app that does not install this pays
|
|
5
|
+
nothing.
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
extensions: [observability({ service: 'blog', otlp: 'http://localhost:4318' })],
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
The parent rides the **invocation**, not a header — so the trace crosses whatever the
|
|
12
|
+
topology became, and the difference between the two spans of a split call is what the wire
|
|
13
|
+
cost. Rate, errors and duration are one metric (a histogram of durations, dimensioned by
|
|
14
|
+
the op and by its verdict); saturation is counted by the middleware. OTLP over HTTP in the
|
|
15
|
+
JSON encoding — no protobuf, no dependency.
|
|
16
|
+
|
|
17
|
+
`rpc.topology` is declared here, not by core: an app that never installed this refuses the
|
|
18
|
+
op by name, which is the whole degradation a reader needs.
|
|
19
|
+
|
|
20
|
+
## Installation
|
|
21
|
+
```bash
|
|
22
|
+
pnpm add @fougere/observability
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
Part of [Fougere](https://github.com/chok/fougere) — one schema, a gradient from
|
|
28
|
+
monolith to distributed, the same user code.
|
|
29
|
+
Reference documentation: [the site](https://fougere.dev/) (en/fr).
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fougere/observability",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.5.0-alpha.1",
|
|
4
4
|
"description": "Optional observability for Fougere: one span per operation, W3C Trace Context across any transport.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"fougere",
|
|
@@ -31,14 +31,14 @@
|
|
|
31
31
|
"src"
|
|
32
32
|
],
|
|
33
33
|
"peerDependencies": {
|
|
34
|
-
"@fougere/core": "^0.
|
|
34
|
+
"@fougere/core": "^0.5.0-alpha.1"
|
|
35
35
|
},
|
|
36
36
|
"devDependencies": {
|
|
37
37
|
"vitest": "^4.1.0",
|
|
38
|
-
"@fougere/container": "0.
|
|
39
|
-
"@fougere/schema": "0.
|
|
40
|
-
"@fougere/
|
|
41
|
-
"@fougere/
|
|
38
|
+
"@fougere/container": "0.5.0-alpha.1",
|
|
39
|
+
"@fougere/schema": "0.5.0-alpha.1",
|
|
40
|
+
"@fougere/transport-http": "0.5.0-alpha.1",
|
|
41
|
+
"@fougere/core": "0.5.0-alpha.1"
|
|
42
42
|
},
|
|
43
43
|
"publishConfig": {
|
|
44
44
|
"access": "public"
|