@toa.io/extensions.telemetry 1.0.0-alpha.240 → 1.0.0-alpha.248
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/grafana.md +50 -0
- package/package.json +3 -3
- package/readme.md +176 -25
- package/source/Ready.ts +6 -1
- package/source/Span.ts +32 -0
- package/source/aspects.ts +5 -0
- package/source/extension.ts +46 -12
- package/transpiled/Ready.js +5 -1
- package/transpiled/Ready.js.map +1 -1
- package/transpiled/Span.d.ts +10 -0
- package/transpiled/Span.js +29 -0
- package/transpiled/Span.js.map +1 -0
- package/transpiled/aspects.d.ts +4 -0
- package/transpiled/extension.d.ts +8 -2
- package/transpiled/extension.js +26 -8
- package/transpiled/extension.js.map +1 -1
- package/transpiled/tsconfig.tsbuildinfo +1 -1
package/transpiled/extension.js
CHANGED
|
@@ -1,40 +1,45 @@
|
|
|
1
1
|
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
2
5
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
6
|
exports.ID = exports.deployment = exports.Factory = void 0;
|
|
7
|
+
const node_assert_1 = __importDefault(require("node:assert"));
|
|
4
8
|
const openspan_1 = require("openspan");
|
|
5
9
|
const generic_1 = require("@toa.io/generic");
|
|
6
10
|
const Logs_1 = require("./Logs");
|
|
11
|
+
const Span_1 = require("./Span");
|
|
7
12
|
const Ready_1 = require("./Ready");
|
|
8
13
|
class Factory {
|
|
9
14
|
logsOptions;
|
|
10
15
|
ready;
|
|
11
16
|
constructor() {
|
|
12
17
|
const globEnv = process.env[LOGS_PREFIX];
|
|
13
|
-
const level = process.env.TOA_DEV === '1' ? '
|
|
18
|
+
const level = process.env.TOA_DEV === '1' ? 'trace' : 'info';
|
|
14
19
|
this.logsOptions = globEnv === undefined ? { level } : (0, generic_1.decode)(globEnv);
|
|
15
20
|
this.logsOptions.level ??= level;
|
|
16
21
|
openspan_1.console.configure({ level: this.logsOptions.level });
|
|
22
|
+
const tracesEnv = process.env[TRACES_ENV];
|
|
23
|
+
(0, openspan_1.traces)(tracesEnv === undefined ? {} : (0, generic_1.decode)(tracesEnv));
|
|
17
24
|
this.ready = Ready_1.Ready.create();
|
|
18
25
|
}
|
|
19
26
|
aspect(locator) {
|
|
20
27
|
const logs = this.createLogs(locator);
|
|
21
|
-
|
|
28
|
+
const span = new Span_1.Span(locator);
|
|
29
|
+
return [logs, span];
|
|
22
30
|
}
|
|
23
31
|
manage(composition) {
|
|
24
32
|
if (this.ready === null)
|
|
25
33
|
return composition;
|
|
26
34
|
const ready = this.ready;
|
|
35
|
+
// the composition manages the probe server lifecycle (listen on connect, close on disconnect)
|
|
36
|
+
composition.depends(ready);
|
|
27
37
|
const connect = composition.connect.bind(composition);
|
|
28
|
-
|
|
38
|
+
// readiness is a post-connect phase, not expressible as a dependency
|
|
29
39
|
composition.connect = async () => {
|
|
30
|
-
await ready.listen();
|
|
31
40
|
await connect();
|
|
32
41
|
await ready.complete();
|
|
33
42
|
};
|
|
34
|
-
composition.disconnect = async (interrupt) => {
|
|
35
|
-
await ready.disconnect(interrupt);
|
|
36
|
-
await disconnect(interrupt);
|
|
37
|
-
};
|
|
38
43
|
return composition;
|
|
39
44
|
}
|
|
40
45
|
createLogs(locator) {
|
|
@@ -49,6 +54,8 @@ function deployment(_, annotation) {
|
|
|
49
54
|
const variables = { global: [] };
|
|
50
55
|
if (annotation?.logs !== undefined)
|
|
51
56
|
addLogsVariables(annotation.logs, variables);
|
|
57
|
+
if (annotation?.traces !== undefined)
|
|
58
|
+
addTracesVariables(annotation.traces, variables);
|
|
52
59
|
const ready = (0, Ready_1.normalizeAnnotation)(annotation?.ready);
|
|
53
60
|
if (ready === false) {
|
|
54
61
|
variables.global.push({ name: Ready_1.READY_ENV, value: (0, generic_1.encode)(false) });
|
|
@@ -77,7 +84,18 @@ function addLogsVariables(annotation, variables) {
|
|
|
77
84
|
});
|
|
78
85
|
}
|
|
79
86
|
}
|
|
87
|
+
function addTracesVariables(annotation, variables) {
|
|
88
|
+
const { sample, rate, exporters } = annotation;
|
|
89
|
+
if (sample !== undefined)
|
|
90
|
+
node_assert_1.default.ok(typeof sample === 'number' && sample >= 0 && sample <= 1, 'telemetry.traces.sample must be a number within [0, 1]');
|
|
91
|
+
if (rate !== undefined)
|
|
92
|
+
node_assert_1.default.ok(typeof rate === 'number' && rate > 0, 'telemetry.traces.rate must be a positive number');
|
|
93
|
+
if (exporters?.otlp !== undefined)
|
|
94
|
+
node_assert_1.default.ok(typeof exporters.otlp.endpoint === 'string', 'telemetry.traces.exporters.otlp.endpoint is required');
|
|
95
|
+
variables.global.push({ name: TRACES_ENV, value: (0, generic_1.encode)({ sample, rate, exporters }) });
|
|
96
|
+
}
|
|
80
97
|
const ENV_PREFIX = 'TOA_TELEMETRY';
|
|
81
98
|
const LOGS_PREFIX = ENV_PREFIX + '_LOGS';
|
|
99
|
+
const TRACES_ENV = ENV_PREFIX + '_TRACES';
|
|
82
100
|
exports.ID = 'telemetry';
|
|
83
101
|
//# sourceMappingURL=extension.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"extension.js","sourceRoot":"","sources":["../source/extension.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"extension.js","sourceRoot":"","sources":["../source/extension.ts"],"names":[],"mappings":"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"}
|