@rsdk/cli.cmd.start 5.11.5-next.0 → 5.11.6-next.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.
- package/CHANGELOG.md +4 -0
- package/dist/opentelemetry/exporter.d.ts +8 -0
- package/dist/opentelemetry/exporter.js +69 -0
- package/dist/opentelemetry/exporter.js.map +1 -0
- package/dist/opentelemetry/opentelemetry.init.js +49 -26
- package/dist/opentelemetry/opentelemetry.init.js.map +1 -1
- package/dist/opentelemetry/otlp-exporter.d.ts +6 -0
- package/dist/opentelemetry/otlp-exporter.js +21 -0
- package/dist/opentelemetry/otlp-exporter.js.map +1 -0
- package/dist/opentelemetry/profiling.context-manager.d.ts +6 -0
- package/dist/opentelemetry/profiling.context-manager.js +87 -0
- package/dist/opentelemetry/profiling.context-manager.js.map +1 -0
- package/dist/opentelemetry/prom-metrics.type.d.ts +2 -0
- package/dist/opentelemetry/prom-metrics.type.js +3 -0
- package/dist/opentelemetry/prom-metrics.type.js.map +1 -0
- package/dist/opentelemetry/propagators.d.ts +5 -0
- package/dist/opentelemetry/propagators.js +34 -0
- package/dist/opentelemetry/propagators.js.map +1 -0
- package/dist/otel-convertors/counter.convertor.d.ts +6 -0
- package/dist/otel-convertors/counter.convertor.js +25 -0
- package/dist/otel-convertors/counter.convertor.js.map +1 -0
- package/dist/otel-convertors/data-points.d.ts +4 -0
- package/dist/otel-convertors/data-points.js +15 -0
- package/dist/otel-convertors/data-points.js.map +1 -0
- package/dist/otel-convertors/gauge.convertor.d.ts +6 -0
- package/dist/otel-convertors/gauge.convertor.js +24 -0
- package/dist/otel-convertors/gauge.convertor.js.map +1 -0
- package/dist/otel-convertors/histogram.convertor.d.ts +6 -0
- package/dist/otel-convertors/histogram.convertor.js +81 -0
- package/dist/otel-convertors/histogram.convertor.js.map +1 -0
- package/dist/otel-convertors/index.d.ts +4 -0
- package/dist/otel-convertors/index.js +21 -0
- package/dist/otel-convertors/index.js.map +1 -0
- package/dist/otel-convertors/summary.convertor.d.ts +6 -0
- package/dist/otel-convertors/summary.convertor.js +69 -0
- package/dist/otel-convertors/summary.convertor.js.map +1 -0
- package/dist/profiling/profiling.d.ts +10 -0
- package/dist/profiling/profiling.js +34 -0
- package/dist/profiling/profiling.js.map +1 -0
- package/dist/start-dev.cmd.d.ts +1 -1
- package/dist/start-dev.cmd.js +17 -3
- package/dist/start-dev.cmd.js.map +1 -1
- package/dist/start.cmd.d.ts +1 -1
- package/dist/start.cmd.js +12 -2
- package/dist/start.cmd.js.map +1 -1
- package/jest.config.js +1 -0
- package/package.json +21 -4
- package/src/opentelemetry/exporter.spec.ts +220 -0
- package/src/opentelemetry/exporter.ts +88 -0
- package/src/opentelemetry/opentelemetry.init.ts +60 -29
- package/src/opentelemetry/otlp-exporter.spec.ts +66 -0
- package/src/opentelemetry/otlp-exporter.ts +28 -0
- package/src/opentelemetry/profiling.context-manager.spec.ts +93 -0
- package/src/opentelemetry/profiling.context-manager.ts +118 -0
- package/src/opentelemetry/prom-metrics.type.ts +9 -0
- package/src/opentelemetry/propagators.spec.ts +67 -0
- package/src/opentelemetry/propagators.ts +35 -0
- package/src/otel-convertors/counter.convertor.ts +34 -0
- package/src/otel-convertors/data-points.ts +19 -0
- package/src/otel-convertors/gauge.convertor.ts +33 -0
- package/src/otel-convertors/histogram.convertor.ts +121 -0
- package/src/otel-convertors/index.ts +4 -0
- package/src/otel-convertors/summary.convertor.ts +86 -0
- package/src/profiling/profiling.ts +37 -0
- package/src/start-dev.cmd.ts +24 -2
- package/src/start.cmd.ts +21 -1
|
@@ -0,0 +1,220 @@
|
|
|
1
|
+
import type {
|
|
2
|
+
GaugeMetricData,
|
|
3
|
+
Histogram as OtelHistogram,
|
|
4
|
+
HistogramMetricData,
|
|
5
|
+
MetricData,
|
|
6
|
+
SumMetricData,
|
|
7
|
+
} from '@opentelemetry/sdk-metrics';
|
|
8
|
+
import {
|
|
9
|
+
AggregationTemporality,
|
|
10
|
+
DataPointType,
|
|
11
|
+
InstrumentType,
|
|
12
|
+
} from '@opentelemetry/sdk-metrics';
|
|
13
|
+
import { Counter, Gauge, Histogram, Registry, Summary } from 'prom-client';
|
|
14
|
+
|
|
15
|
+
import { PromClientMetricProducer } from './exporter';
|
|
16
|
+
|
|
17
|
+
async function collect(
|
|
18
|
+
registry: Registry,
|
|
19
|
+
): Promise<{ metrics: MetricData[]; errors: unknown[] }> {
|
|
20
|
+
const { resourceMetrics, errors } = await new PromClientMetricProducer(
|
|
21
|
+
() => registry,
|
|
22
|
+
).collect();
|
|
23
|
+
|
|
24
|
+
return { metrics: resourceMetrics.scopeMetrics[0]?.metrics ?? [], errors };
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
function byName<T extends MetricData>(metrics: MetricData[], name: string): T {
|
|
28
|
+
const metric = metrics.find((m) => m.descriptor.name === name);
|
|
29
|
+
|
|
30
|
+
if (!metric) throw new Error(`metric ${name} not found`);
|
|
31
|
+
|
|
32
|
+
return metric as T;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
describe('PromClientMetricProducer', () => {
|
|
36
|
+
let registry: Registry;
|
|
37
|
+
|
|
38
|
+
beforeEach(() => {
|
|
39
|
+
registry = new Registry();
|
|
40
|
+
});
|
|
41
|
+
|
|
42
|
+
it('конвертирует counter в монотонный кумулятивный sum', async () => {
|
|
43
|
+
const counter = new Counter({
|
|
44
|
+
name: 'calls_total',
|
|
45
|
+
help: 'calls',
|
|
46
|
+
labelNames: ['route'],
|
|
47
|
+
registers: [registry],
|
|
48
|
+
});
|
|
49
|
+
|
|
50
|
+
counter.inc({ route: '/a' }, 2);
|
|
51
|
+
counter.inc({ route: '/b' });
|
|
52
|
+
|
|
53
|
+
const { metrics, errors } = await collect(registry);
|
|
54
|
+
const sum = byName<SumMetricData>(metrics, 'calls_total');
|
|
55
|
+
|
|
56
|
+
expect(errors).toEqual([]);
|
|
57
|
+
expect(sum.descriptor).toMatchObject({
|
|
58
|
+
description: 'calls',
|
|
59
|
+
type: InstrumentType.COUNTER,
|
|
60
|
+
});
|
|
61
|
+
expect(sum.dataPointType).toBe(DataPointType.SUM);
|
|
62
|
+
expect(sum.isMonotonic).toBe(true);
|
|
63
|
+
expect(sum.aggregationTemporality).toBe(AggregationTemporality.CUMULATIVE);
|
|
64
|
+
expect(sum.dataPoints.map((p) => [p.attributes, p.value])).toEqual([
|
|
65
|
+
[{ route: '/a' }, 2],
|
|
66
|
+
[{ route: '/b' }, 1],
|
|
67
|
+
]);
|
|
68
|
+
});
|
|
69
|
+
|
|
70
|
+
it('отбрасывает точки gauge с NaN и Infinity', async () => {
|
|
71
|
+
const gauge = new Gauge({
|
|
72
|
+
name: 'latency',
|
|
73
|
+
help: 'latency',
|
|
74
|
+
labelNames: ['kind'],
|
|
75
|
+
registers: [registry],
|
|
76
|
+
});
|
|
77
|
+
|
|
78
|
+
gauge.set({ kind: 'ok' }, 5);
|
|
79
|
+
gauge.set({ kind: 'nan' }, Number.NaN);
|
|
80
|
+
gauge.set({ kind: 'inf' }, Number.POSITIVE_INFINITY);
|
|
81
|
+
|
|
82
|
+
const { metrics } = await collect(registry);
|
|
83
|
+
const otel = byName<GaugeMetricData>(metrics, 'latency');
|
|
84
|
+
|
|
85
|
+
expect(otel.dataPointType).toBe(DataPointType.GAUGE);
|
|
86
|
+
expect(otel.dataPoints.map((p) => [p.attributes, p.value])).toEqual([
|
|
87
|
+
[{ kind: 'ok' }, 5],
|
|
88
|
+
]);
|
|
89
|
+
});
|
|
90
|
+
|
|
91
|
+
it('не экспортирует метрику, у которой не осталось точек', async () => {
|
|
92
|
+
new Gauge({ name: 'empty', help: 'empty', registers: [registry] }).set(
|
|
93
|
+
Number.NaN,
|
|
94
|
+
);
|
|
95
|
+
|
|
96
|
+
const { metrics } = await collect(registry);
|
|
97
|
+
|
|
98
|
+
expect(metrics).toEqual([]);
|
|
99
|
+
});
|
|
100
|
+
|
|
101
|
+
it('переводит кумулятивные бакеты histogram в счетчики бакетов', async () => {
|
|
102
|
+
const histogram = new Histogram({
|
|
103
|
+
name: 'duration',
|
|
104
|
+
help: 'duration',
|
|
105
|
+
labelNames: ['route'],
|
|
106
|
+
buckets: [1, 5, 10],
|
|
107
|
+
registers: [registry],
|
|
108
|
+
});
|
|
109
|
+
|
|
110
|
+
for (const v of [0.5, 3, 4, 7, 20]) histogram.observe({ route: '/a' }, v);
|
|
111
|
+
histogram.observe({ route: '/b' }, 2);
|
|
112
|
+
|
|
113
|
+
const { metrics } = await collect(registry);
|
|
114
|
+
const otel = byName<HistogramMetricData>(metrics, 'duration');
|
|
115
|
+
const [a, b] = otel.dataPoints;
|
|
116
|
+
|
|
117
|
+
expect(metrics.map((m) => m.descriptor.name)).toEqual(['duration']);
|
|
118
|
+
expect(otel.dataPointType).toBe(DataPointType.HISTOGRAM);
|
|
119
|
+
expect(otel.dataPoints).toHaveLength(2);
|
|
120
|
+
expect(a.attributes).toEqual({ route: '/a' });
|
|
121
|
+
expect(a.value).toEqual<OtelHistogram>({
|
|
122
|
+
count: 5,
|
|
123
|
+
sum: 34.5,
|
|
124
|
+
buckets: { boundaries: [1, 5, 10], counts: [1, 2, 1, 1] },
|
|
125
|
+
});
|
|
126
|
+
expect(b.attributes).toEqual({ route: '/b' });
|
|
127
|
+
expect(b.value.buckets.counts).toEqual([0, 1, 0, 0]);
|
|
128
|
+
});
|
|
129
|
+
|
|
130
|
+
it('раскладывает summary на квантили, _sum и _count', async () => {
|
|
131
|
+
const summary = new Summary({
|
|
132
|
+
name: 'request',
|
|
133
|
+
help: 'request',
|
|
134
|
+
labelNames: ['route'],
|
|
135
|
+
percentiles: [0.5, 0.9],
|
|
136
|
+
registers: [registry],
|
|
137
|
+
});
|
|
138
|
+
|
|
139
|
+
for (const v of [1, 2, 3]) summary.observe({ route: '/a' }, v);
|
|
140
|
+
|
|
141
|
+
const { metrics } = await collect(registry);
|
|
142
|
+
const quantiles = byName<GaugeMetricData>(metrics, 'request');
|
|
143
|
+
const sum = byName<SumMetricData>(metrics, 'request_sum');
|
|
144
|
+
const count = byName<SumMetricData>(metrics, 'request_count');
|
|
145
|
+
|
|
146
|
+
expect(quantiles.dataPointType).toBe(DataPointType.GAUGE);
|
|
147
|
+
expect(quantiles.dataPoints.map((p) => p.attributes)).toEqual([
|
|
148
|
+
{ quantile: 0.5, route: '/a' },
|
|
149
|
+
{ quantile: 0.9, route: '/a' },
|
|
150
|
+
]);
|
|
151
|
+
|
|
152
|
+
expect(sum.isMonotonic).toBe(false);
|
|
153
|
+
expect(sum.dataPoints.map((p) => [p.attributes, p.value])).toEqual([
|
|
154
|
+
[{ route: '/a' }, 6],
|
|
155
|
+
]);
|
|
156
|
+
|
|
157
|
+
expect(count.isMonotonic).toBe(true);
|
|
158
|
+
expect(count.dataPoints.map((p) => [p.attributes, p.value])).toEqual([
|
|
159
|
+
[{ route: '/a' }, 3],
|
|
160
|
+
]);
|
|
161
|
+
});
|
|
162
|
+
|
|
163
|
+
it('добавляет default labels registry', async () => {
|
|
164
|
+
registry.setDefaultLabels({ app: 'example' });
|
|
165
|
+
new Counter({ name: 'c_total', help: 'c', registers: [registry] }).inc();
|
|
166
|
+
|
|
167
|
+
const { metrics } = await collect(registry);
|
|
168
|
+
|
|
169
|
+
expect(metrics[0].dataPoints[0].attributes).toEqual({ app: 'example' });
|
|
170
|
+
});
|
|
171
|
+
|
|
172
|
+
it('ставит всем точкам одно время сбора', async () => {
|
|
173
|
+
new Counter({ name: 'a_total', help: 'a', registers: [registry] }).inc();
|
|
174
|
+
new Gauge({ name: 'b', help: 'b', registers: [registry] }).set(1);
|
|
175
|
+
|
|
176
|
+
const { metrics } = await collect(registry);
|
|
177
|
+
const [first, second] = metrics.map((m) => m.dataPoints[0]);
|
|
178
|
+
|
|
179
|
+
expect(first.endTime).toEqual(second.endTime);
|
|
180
|
+
expect(first.startTime).toEqual(second.startTime);
|
|
181
|
+
expect(first.startTime[0]).toBeLessThanOrEqual(first.endTime[0]);
|
|
182
|
+
});
|
|
183
|
+
|
|
184
|
+
it('не бросает, если сбор метрик в registry упал', async () => {
|
|
185
|
+
new Gauge({
|
|
186
|
+
name: 'broken',
|
|
187
|
+
help: 'broken',
|
|
188
|
+
registers: [registry],
|
|
189
|
+
collect(): void {
|
|
190
|
+
throw new Error('collect failed');
|
|
191
|
+
},
|
|
192
|
+
});
|
|
193
|
+
|
|
194
|
+
const { metrics, errors } = await collect(registry);
|
|
195
|
+
|
|
196
|
+
expect(metrics).toEqual([]);
|
|
197
|
+
expect(errors).toEqual([new Error('collect failed')]);
|
|
198
|
+
});
|
|
199
|
+
|
|
200
|
+
it('экспортирует остальные метрики, если одна не сконвертировалась', async () => {
|
|
201
|
+
const counter = new Counter({
|
|
202
|
+
name: 'ok_total',
|
|
203
|
+
help: 'ok',
|
|
204
|
+
registers: [],
|
|
205
|
+
});
|
|
206
|
+
|
|
207
|
+
counter.inc();
|
|
208
|
+
const fakeRegistry = {
|
|
209
|
+
getMetricsAsJSON: async () => [
|
|
210
|
+
{ name: 'broken', help: 'broken', type: 'histogram', values: null },
|
|
211
|
+
await counter.get(),
|
|
212
|
+
],
|
|
213
|
+
} as unknown as Registry;
|
|
214
|
+
|
|
215
|
+
const { metrics, errors } = await collect(fakeRegistry);
|
|
216
|
+
|
|
217
|
+
expect(metrics.map((m) => m.descriptor.name)).toEqual(['ok_total']);
|
|
218
|
+
expect(errors).toHaveLength(1);
|
|
219
|
+
});
|
|
220
|
+
});
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
import type { HrTime } from '@opentelemetry/api';
|
|
2
|
+
import { millisToHrTime } from '@opentelemetry/core';
|
|
3
|
+
import { Resource } from '@opentelemetry/resources';
|
|
4
|
+
import type {
|
|
5
|
+
CollectionResult,
|
|
6
|
+
MetricData,
|
|
7
|
+
MetricProducer,
|
|
8
|
+
} from '@opentelemetry/sdk-metrics';
|
|
9
|
+
import { type Registry } from 'prom-client';
|
|
10
|
+
|
|
11
|
+
import {
|
|
12
|
+
CounterConvertor,
|
|
13
|
+
GaugeConvertor,
|
|
14
|
+
HistogramConvertor,
|
|
15
|
+
SummaryConvertor,
|
|
16
|
+
} from '../otel-convertors';
|
|
17
|
+
|
|
18
|
+
import type { PromMetricWithValues } from './prom-metrics.type';
|
|
19
|
+
|
|
20
|
+
// prom-client не хранит время старта серий, все они считаются со старта процесса
|
|
21
|
+
const PROCESS_START_TIME = millisToHrTime(Date.now() - process.uptime() * 1000);
|
|
22
|
+
|
|
23
|
+
export class PromClientMetricProducer implements MetricProducer {
|
|
24
|
+
constructor(private readonly registry: () => Registry) {}
|
|
25
|
+
|
|
26
|
+
async collect(): Promise<CollectionResult> {
|
|
27
|
+
const metrics: MetricData[] = [];
|
|
28
|
+
const errors: unknown[] = [];
|
|
29
|
+
|
|
30
|
+
try {
|
|
31
|
+
const promMetrics = await this.registry().getMetricsAsJSON();
|
|
32
|
+
const endTime = millisToHrTime(Date.now());
|
|
33
|
+
|
|
34
|
+
for (const pm of promMetrics) {
|
|
35
|
+
try {
|
|
36
|
+
metrics.push(...this.convertPromMetricsToOtel(pm, endTime));
|
|
37
|
+
} catch (error) {
|
|
38
|
+
errors.push(error);
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
} catch (error) {
|
|
42
|
+
// если бросить, reader не отправит и метрики SDK: он собирает их в одном Promise.all
|
|
43
|
+
errors.push(error);
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
return {
|
|
47
|
+
resourceMetrics: {
|
|
48
|
+
// SDK игнорирует ресурс producer и подставляет свой
|
|
49
|
+
resource: Resource.empty(),
|
|
50
|
+
scopeMetrics: [
|
|
51
|
+
{
|
|
52
|
+
scope: { name: 'prom-client' },
|
|
53
|
+
metrics: metrics.filter((m) => m.dataPoints.length > 0),
|
|
54
|
+
},
|
|
55
|
+
],
|
|
56
|
+
},
|
|
57
|
+
errors,
|
|
58
|
+
};
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
private convertPromMetricsToOtel(
|
|
62
|
+
promMetrics: PromMetricWithValues,
|
|
63
|
+
endTime: HrTime,
|
|
64
|
+
): MetricData[] {
|
|
65
|
+
switch (promMetrics.type as unknown as string) {
|
|
66
|
+
case 'counter':
|
|
67
|
+
return [
|
|
68
|
+
CounterConvertor.toOtel(promMetrics, PROCESS_START_TIME, endTime),
|
|
69
|
+
];
|
|
70
|
+
case 'gauge':
|
|
71
|
+
return [
|
|
72
|
+
GaugeConvertor.toOtel(promMetrics, PROCESS_START_TIME, endTime),
|
|
73
|
+
];
|
|
74
|
+
case 'histogram':
|
|
75
|
+
return [
|
|
76
|
+
HistogramConvertor.toOtel(promMetrics, PROCESS_START_TIME, endTime),
|
|
77
|
+
];
|
|
78
|
+
case 'summary':
|
|
79
|
+
return SummaryConvertor.toOtel(
|
|
80
|
+
promMetrics,
|
|
81
|
+
PROCESS_START_TIME,
|
|
82
|
+
endTime,
|
|
83
|
+
);
|
|
84
|
+
default:
|
|
85
|
+
return [];
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
}
|
|
@@ -2,10 +2,12 @@
|
|
|
2
2
|
import type { Span } from '@opentelemetry/api';
|
|
3
3
|
import { diag, DiagConsoleLogger, DiagLogLevel } from '@opentelemetry/api';
|
|
4
4
|
import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';
|
|
5
|
-
import {
|
|
6
|
-
import { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-http';
|
|
7
|
-
import {
|
|
8
|
-
import {
|
|
5
|
+
import { OTLPMetricExporter as GrpcMetricExporter } from '@opentelemetry/exporter-metrics-otlp-grpc';
|
|
6
|
+
import { OTLPMetricExporter as JsonMetricExporter } from '@opentelemetry/exporter-metrics-otlp-http';
|
|
7
|
+
import { OTLPMetricExporter as ProtobufMetricExporter } from '@opentelemetry/exporter-metrics-otlp-proto';
|
|
8
|
+
import { OTLPTraceExporter as GrpcTraceExporter } from '@opentelemetry/exporter-trace-otlp-grpc';
|
|
9
|
+
import { OTLPTraceExporter as JsonTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
|
|
10
|
+
import { OTLPTraceExporter as ProtobufTraceExporter } from '@opentelemetry/exporter-trace-otlp-proto';
|
|
9
11
|
import { containerDetector } from '@opentelemetry/resource-detector-container';
|
|
10
12
|
import {
|
|
11
13
|
envDetector,
|
|
@@ -20,9 +22,16 @@ import {
|
|
|
20
22
|
ATTR_SERVICE_NAME,
|
|
21
23
|
ATTR_SERVICE_VERSION,
|
|
22
24
|
} from '@opentelemetry/semantic-conventions';
|
|
25
|
+
import { onProcessShutdown } from '@rsdk/common.node';
|
|
23
26
|
import { ClientRequest, IncomingMessage } from 'node:http';
|
|
24
27
|
import path from 'node:path';
|
|
25
28
|
import { cwd } from 'node:process';
|
|
29
|
+
import type { Registry } from 'prom-client';
|
|
30
|
+
|
|
31
|
+
import { PromClientMetricProducer } from './exporter';
|
|
32
|
+
import { otlpExporter } from './otlp-exporter';
|
|
33
|
+
import { createProfilingContextManager } from './profiling.context-manager';
|
|
34
|
+
import { normalizePropagatorsEnv } from './propagators';
|
|
26
35
|
|
|
27
36
|
const otelDiagLogLevel = process.env.OTEL_DIAG_LOG_LEVEL;
|
|
28
37
|
if (otelDiagLogLevel) {
|
|
@@ -85,6 +94,9 @@ const autoInstumentationOptions: any[] = getNodeAutoInstrumentations({
|
|
|
85
94
|
},
|
|
86
95
|
'@opentelemetry/instrumentation-pino': {
|
|
87
96
|
enabled: true,
|
|
97
|
+
|
|
98
|
+
// логи отправляет transport (LOG_OTEL_ENABLED), иначе они дублируются
|
|
99
|
+
disableLogSending: true,
|
|
88
100
|
logHook(_span: Span, record: Record<string, any>) {
|
|
89
101
|
record['resource.service.name'] = otelServiceName;
|
|
90
102
|
},
|
|
@@ -99,33 +111,63 @@ const autoInstumentationOptions: any[] = getNodeAutoInstrumentations({
|
|
|
99
111
|
|
|
100
112
|
const otelServiceName = process.env.OTEL_SERVICE_NAME ?? manifestData.name;
|
|
101
113
|
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
injectEncoding: B3InjectEncoding.MULTI_HEADER,
|
|
107
|
-
}),
|
|
108
|
-
],
|
|
109
|
-
});
|
|
114
|
+
// без него transport отправляет логи с service.name=unknown_service
|
|
115
|
+
process.env.LOG_OTEL_SERVICE_NAME ??= otelServiceName;
|
|
116
|
+
|
|
117
|
+
normalizePropagatorsEnv(process.env);
|
|
110
118
|
|
|
111
119
|
const resource = new Resource({
|
|
112
120
|
[ATTR_SERVICE_NAME]: otelServiceName,
|
|
113
121
|
[ATTR_SERVICE_VERSION]: manifestData.version,
|
|
114
122
|
});
|
|
115
123
|
|
|
116
|
-
|
|
117
|
-
const
|
|
124
|
+
// registry берем у prom-client из @rsdk/core приложения: у копии из CLI он свой
|
|
125
|
+
const appMetricsRegistry = (): Registry => {
|
|
126
|
+
const corePath = require.resolve('@rsdk/core', { paths: [cwd()] });
|
|
127
|
+
const promClientPath = require.resolve('prom-client', {
|
|
128
|
+
paths: [path.dirname(corePath)],
|
|
129
|
+
});
|
|
130
|
+
|
|
131
|
+
// eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
|
|
132
|
+
return require(promClientPath).register;
|
|
133
|
+
};
|
|
134
|
+
|
|
135
|
+
// NodeSDK читает OTEL_METRIC_EXPORT_* только для своего reader'а, а этот создан вручную
|
|
136
|
+
const envMillis = (name: string): number | undefined =>
|
|
137
|
+
Number.parseInt(process.env[name] ?? '') || undefined;
|
|
138
|
+
const exportIntervalMillis = envMillis('OTEL_METRIC_EXPORT_INTERVAL');
|
|
139
|
+
const exportTimeoutMillis = envMillis('OTEL_METRIC_EXPORT_TIMEOUT');
|
|
140
|
+
|
|
141
|
+
// exporter метрик NodeSDK выбирает по протоколу только для своего reader'а, а наш
|
|
142
|
+
// создан вручную. Exporter трейсов выбирается тем же кодом
|
|
143
|
+
const traceExporter = otlpExporter('TRACES', {
|
|
144
|
+
grpc: GrpcTraceExporter,
|
|
145
|
+
'http/json': JsonTraceExporter,
|
|
146
|
+
'http/protobuf': ProtobufTraceExporter,
|
|
147
|
+
});
|
|
148
|
+
const metricExporter = otlpExporter('METRICS', {
|
|
149
|
+
grpc: GrpcMetricExporter,
|
|
150
|
+
'http/json': JsonMetricExporter,
|
|
151
|
+
'http/protobuf': ProtobufMetricExporter,
|
|
152
|
+
});
|
|
118
153
|
const metricReader = new PeriodicExportingMetricReader({
|
|
119
154
|
exporter: metricExporter,
|
|
155
|
+
...(exportIntervalMillis === undefined ? {} : { exportIntervalMillis }),
|
|
156
|
+
...(exportTimeoutMillis === undefined ? {} : { exportTimeoutMillis }),
|
|
157
|
+
metricProducers: [new PromClientMetricProducer(appMetricsRegistry)],
|
|
120
158
|
});
|
|
121
159
|
|
|
160
|
+
// прелоад профилирования подключается раньше и уже зарегистрировал связь
|
|
161
|
+
// профилей со спанами
|
|
162
|
+
const contextManager = createProfilingContextManager();
|
|
163
|
+
|
|
122
164
|
const sdk = new NodeSDK({
|
|
123
165
|
serviceName: otelServiceName,
|
|
124
166
|
instrumentations: [autoInstumentationOptions],
|
|
125
167
|
resource,
|
|
126
168
|
traceExporter,
|
|
127
169
|
metricReader,
|
|
128
|
-
|
|
170
|
+
...(contextManager && { contextManager }),
|
|
129
171
|
resourceDetectors: [
|
|
130
172
|
containerDetector,
|
|
131
173
|
envDetector,
|
|
@@ -138,23 +180,12 @@ const sdk = new NodeSDK({
|
|
|
138
180
|
sdk.start();
|
|
139
181
|
console.log('Tracing sdk started');
|
|
140
182
|
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
const listener: any = async () => {
|
|
183
|
+
onProcessShutdown(async (signal) => {
|
|
144
184
|
try {
|
|
145
|
-
console.log(
|
|
185
|
+
console.log(`[${signal}] Tracing terminating...`);
|
|
146
186
|
await sdk.shutdown();
|
|
147
187
|
console.log('Tracing terminated');
|
|
148
188
|
} catch (error) {
|
|
149
189
|
console.log('Error terminating tracing', error);
|
|
150
|
-
// eslint-disable-next-line unicorn/no-process-exit
|
|
151
|
-
process.exit(1);
|
|
152
|
-
} finally {
|
|
153
|
-
// eslint-disable-next-line unicorn/no-process-exit
|
|
154
|
-
process.exit(0);
|
|
155
190
|
}
|
|
156
|
-
};
|
|
157
|
-
|
|
158
|
-
for (const signal of signals) {
|
|
159
|
-
process.on(signal, listener);
|
|
160
|
-
}
|
|
191
|
+
});
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import { otlpExporter } from './otlp-exporter';
|
|
2
|
+
|
|
3
|
+
class GrpcExporter {}
|
|
4
|
+
class JsonExporter {}
|
|
5
|
+
class ProtobufExporter {}
|
|
6
|
+
|
|
7
|
+
const exporters = {
|
|
8
|
+
grpc: GrpcExporter,
|
|
9
|
+
'http/json': JsonExporter,
|
|
10
|
+
'http/protobuf': ProtobufExporter,
|
|
11
|
+
};
|
|
12
|
+
|
|
13
|
+
describe('otlpExporter', () => {
|
|
14
|
+
const env = { ...process.env };
|
|
15
|
+
|
|
16
|
+
afterEach(() => {
|
|
17
|
+
process.env = { ...env };
|
|
18
|
+
jest.restoreAllMocks();
|
|
19
|
+
});
|
|
20
|
+
|
|
21
|
+
it('uses http/protobuf by default', () => {
|
|
22
|
+
delete process.env.OTEL_EXPORTER_OTLP_PROTOCOL;
|
|
23
|
+
delete process.env.OTEL_EXPORTER_OTLP_TRACES_PROTOCOL;
|
|
24
|
+
|
|
25
|
+
expect(otlpExporter('TRACES', exporters)).toBeInstanceOf(ProtobufExporter);
|
|
26
|
+
});
|
|
27
|
+
|
|
28
|
+
it('takes protocol from OTEL_EXPORTER_OTLP_PROTOCOL', () => {
|
|
29
|
+
process.env.OTEL_EXPORTER_OTLP_PROTOCOL = 'grpc';
|
|
30
|
+
|
|
31
|
+
expect(otlpExporter('TRACES', exporters)).toBeInstanceOf(GrpcExporter);
|
|
32
|
+
expect(otlpExporter('METRICS', exporters)).toBeInstanceOf(GrpcExporter);
|
|
33
|
+
});
|
|
34
|
+
|
|
35
|
+
it('prefers the signal variable over the common one', () => {
|
|
36
|
+
process.env.OTEL_EXPORTER_OTLP_PROTOCOL = 'grpc';
|
|
37
|
+
process.env.OTEL_EXPORTER_OTLP_METRICS_PROTOCOL = 'http/json';
|
|
38
|
+
|
|
39
|
+
expect(otlpExporter('METRICS', exporters)).toBeInstanceOf(JsonExporter);
|
|
40
|
+
expect(otlpExporter('TRACES', exporters)).toBeInstanceOf(GrpcExporter);
|
|
41
|
+
});
|
|
42
|
+
|
|
43
|
+
it('treats blank values as unset', () => {
|
|
44
|
+
process.env.OTEL_EXPORTER_OTLP_PROTOCOL = 'http/json';
|
|
45
|
+
process.env.OTEL_EXPORTER_OTLP_TRACES_PROTOCOL = ' ';
|
|
46
|
+
|
|
47
|
+
expect(otlpExporter('TRACES', exporters)).toBeInstanceOf(JsonExporter);
|
|
48
|
+
});
|
|
49
|
+
|
|
50
|
+
it('falls back to http/protobuf with a warning on unknown protocol', () => {
|
|
51
|
+
const warn = jest.spyOn(console, 'warn').mockImplementation(() => {});
|
|
52
|
+
process.env.OTEL_EXPORTER_OTLP_TRACES_PROTOCOL = 'http';
|
|
53
|
+
|
|
54
|
+
expect(otlpExporter('TRACES', exporters)).toBeInstanceOf(ProtobufExporter);
|
|
55
|
+
expect(warn).toHaveBeenCalledWith(
|
|
56
|
+
'Unsupported OTLP protocol for traces: http. Using http/protobuf',
|
|
57
|
+
);
|
|
58
|
+
});
|
|
59
|
+
|
|
60
|
+
it('does not take protocol from inherited object keys', () => {
|
|
61
|
+
jest.spyOn(console, 'warn').mockImplementation(() => {});
|
|
62
|
+
process.env.OTEL_EXPORTER_OTLP_PROTOCOL = 'constructor';
|
|
63
|
+
|
|
64
|
+
expect(otlpExporter('TRACES', exporters)).toBeInstanceOf(ProtobufExporter);
|
|
65
|
+
});
|
|
66
|
+
});
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
export type OtlpProtocol = 'grpc' | 'http/json' | 'http/protobuf';
|
|
2
|
+
|
|
3
|
+
const DEFAULT_PROTOCOL: OtlpProtocol = 'http/protobuf';
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* Exporter сигнала по OTEL_EXPORTER_OTLP_<SIGNAL>_PROTOCOL или
|
|
7
|
+
* OTEL_EXPORTER_OTLP_PROTOCOL, как в спецификации OpenTelemetry
|
|
8
|
+
*/
|
|
9
|
+
export const otlpExporter = <T>(
|
|
10
|
+
signal: 'TRACES' | 'METRICS',
|
|
11
|
+
exporters: Record<OtlpProtocol, new () => T>,
|
|
12
|
+
): T => {
|
|
13
|
+
const protocol =
|
|
14
|
+
process.env[`OTEL_EXPORTER_OTLP_${signal}_PROTOCOL`]?.trim() ||
|
|
15
|
+
process.env.OTEL_EXPORTER_OTLP_PROTOCOL?.trim() ||
|
|
16
|
+
DEFAULT_PROTOCOL;
|
|
17
|
+
|
|
18
|
+
if (!Object.hasOwn(exporters, protocol)) {
|
|
19
|
+
// diag без OTEL_DIAG_LOG_LEVEL молчит, а опечатку в протоколе надо увидеть
|
|
20
|
+
console.warn(
|
|
21
|
+
`Unsupported OTLP protocol for ${signal.toLowerCase()}: ${protocol}. Using ${DEFAULT_PROTOCOL}`,
|
|
22
|
+
);
|
|
23
|
+
|
|
24
|
+
return new exporters[DEFAULT_PROTOCOL]();
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
return new exporters[protocol as OtlpProtocol]();
|
|
28
|
+
};
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
import type { Context, ContextManager, Span } from '@opentelemetry/api';
|
|
2
|
+
import { ROOT_CONTEXT, trace, TraceFlags } from '@opentelemetry/api';
|
|
3
|
+
import type { ReadableSpan } from '@opentelemetry/sdk-trace-node';
|
|
4
|
+
import { BasicTracerProvider } from '@opentelemetry/sdk-trace-node';
|
|
5
|
+
import { registerSpanProfiling } from '@rsdk/profiling.common';
|
|
6
|
+
|
|
7
|
+
import { createProfilingContextManager } from './profiling.context-manager';
|
|
8
|
+
|
|
9
|
+
const PROFILE_ID_ATTRIBUTE = 'profile.id';
|
|
10
|
+
|
|
11
|
+
const tracer = new BasicTracerProvider().getTracer('test');
|
|
12
|
+
|
|
13
|
+
const attributes = (span: Span): ReadableSpan['attributes'] =>
|
|
14
|
+
(span as unknown as ReadableSpan).attributes;
|
|
15
|
+
|
|
16
|
+
describe('createProfilingContextManager', () => {
|
|
17
|
+
afterEach(() => {
|
|
18
|
+
registerSpanProfiling();
|
|
19
|
+
});
|
|
20
|
+
|
|
21
|
+
it('без профилирования не подменяет context manager', () => {
|
|
22
|
+
expect(createProfilingContextManager()).toBeUndefined();
|
|
23
|
+
});
|
|
24
|
+
|
|
25
|
+
describe('с профилированием', () => {
|
|
26
|
+
let manager: ContextManager;
|
|
27
|
+
let linked: string[];
|
|
28
|
+
let profiling: boolean;
|
|
29
|
+
|
|
30
|
+
// запускает спан в контексте родителя и активирует его, как инструментации
|
|
31
|
+
const activate = <T>(
|
|
32
|
+
name: string,
|
|
33
|
+
parent: Context,
|
|
34
|
+
fn: (span: Span) => T,
|
|
35
|
+
): T => {
|
|
36
|
+
const span = tracer.startSpan(name, undefined, parent);
|
|
37
|
+
|
|
38
|
+
return manager.with(trace.setSpan(parent, span), () => fn(span));
|
|
39
|
+
};
|
|
40
|
+
|
|
41
|
+
beforeEach(() => {
|
|
42
|
+
linked = [];
|
|
43
|
+
profiling = true;
|
|
44
|
+
registerSpanProfiling((spanId, fn) => {
|
|
45
|
+
linked.push(spanId);
|
|
46
|
+
return fn(profiling ? { [PROFILE_ID_ATTRIBUTE]: spanId } : undefined);
|
|
47
|
+
});
|
|
48
|
+
manager = createProfilingContextManager()!.enable();
|
|
49
|
+
});
|
|
50
|
+
|
|
51
|
+
afterEach(() => {
|
|
52
|
+
manager.disable();
|
|
53
|
+
});
|
|
54
|
+
|
|
55
|
+
it('помечает только корневой спан, работа дочерних идет в его профиль', () => {
|
|
56
|
+
const [root, child] = activate('root', ROOT_CONTEXT, (rootSpan) => [
|
|
57
|
+
rootSpan,
|
|
58
|
+
activate('child', manager.active(), (childSpan) => childSpan),
|
|
59
|
+
]);
|
|
60
|
+
const rootId = root!.spanContext().spanId;
|
|
61
|
+
|
|
62
|
+
expect(linked).toEqual([rootId]);
|
|
63
|
+
expect(attributes(root!)[PROFILE_ID_ATTRIBUTE]).toBe(rootId);
|
|
64
|
+
expect(attributes(child!)[PROFILE_ID_ATTRIBUTE]).toBeUndefined();
|
|
65
|
+
});
|
|
66
|
+
|
|
67
|
+
it('считает корневым спан с родителем из другого сервиса', () => {
|
|
68
|
+
const remote = trace.setSpanContext(ROOT_CONTEXT, {
|
|
69
|
+
traceId: '0af7651916cd43dd8448eb211c80319c',
|
|
70
|
+
spanId: 'b7ad6b7169203331',
|
|
71
|
+
traceFlags: TraceFlags.SAMPLED,
|
|
72
|
+
isRemote: true,
|
|
73
|
+
});
|
|
74
|
+
const server = manager.with(remote, () =>
|
|
75
|
+
activate('server', manager.active(), (span) => span),
|
|
76
|
+
);
|
|
77
|
+
|
|
78
|
+
expect(linked).toEqual([server.spanContext().spanId]);
|
|
79
|
+
});
|
|
80
|
+
|
|
81
|
+
it('не ставит атрибут, когда профилировщик не пишет сэмплы', () => {
|
|
82
|
+
profiling = false;
|
|
83
|
+
|
|
84
|
+
const root = activate('root', ROOT_CONTEXT, (span) => span);
|
|
85
|
+
|
|
86
|
+
expect(attributes(root)[PROFILE_ID_ATTRIBUTE]).toBeUndefined();
|
|
87
|
+
});
|
|
88
|
+
|
|
89
|
+
it('возвращает результат функции', () => {
|
|
90
|
+
expect(activate('root', ROOT_CONTEXT, () => 42)).toBe(42);
|
|
91
|
+
});
|
|
92
|
+
});
|
|
93
|
+
});
|