arvo-core 2.2.0 → 2.2.2
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.
|
@@ -90,16 +90,19 @@ var ArvoOrchestratorEventFactory = /** @class */ (function (_super) {
|
|
|
90
90
|
subject: parentSubject,
|
|
91
91
|
version: _this.contract.version,
|
|
92
92
|
meta: Object.fromEntries(Object.entries({
|
|
93
|
-
redirectto: (_a = event.redirectto) !== null && _a !== void 0 ? _a : ArvoOrchestrationSubject_1.default.parse(parentSubject).execution
|
|
94
|
-
|
|
93
|
+
redirectto: (_a = event.redirectto) !== null && _a !== void 0 ? _a : ArvoOrchestrationSubject_1.default.parse(parentSubject).execution
|
|
94
|
+
.initiator,
|
|
95
|
+
}).filter(function (item) { return Boolean(item[1]); })),
|
|
95
96
|
})
|
|
96
97
|
: ArvoOrchestrationSubject_1.default.new({
|
|
97
98
|
orchestator: _this.contract.accepts.type,
|
|
98
99
|
initiator: event.source,
|
|
99
100
|
version: _this.contract.version,
|
|
100
|
-
meta: event.redirectto
|
|
101
|
-
|
|
102
|
-
|
|
101
|
+
meta: event.redirectto
|
|
102
|
+
? {
|
|
103
|
+
redirectto: event.redirectto,
|
|
104
|
+
}
|
|
105
|
+
: undefined,
|
|
103
106
|
});
|
|
104
107
|
var generatedEvent = (0, helpers_1.createArvoEvent)(__assign(__assign({}, event), { subject: newSubject, traceparent: (_c = (_b = event.traceparent) !== null && _b !== void 0 ? _b : otelHeaders.traceparent) !== null && _c !== void 0 ? _c : undefined, tracestate: (_e = (_d = event.tracestate) !== null && _d !== void 0 ? _d : otelHeaders.tracestate) !== null && _e !== void 0 ? _e : undefined, type: _this.contract.accepts.type, datacontenttype: schema_1.ArvoDataContentType, dataschema: utils_1.EventDataschemaUtil.create(_this.contract), data: validationResult.data }), extensions, { disable: true });
|
|
105
108
|
span.setAttributes(generatedEvent.otelAttributes);
|
|
@@ -5,14 +5,55 @@ import { TelemetryLogLevel, OpenTelemetryHeaders } from './types';
|
|
|
5
5
|
*/
|
|
6
6
|
export declare class ArvoOpenTelemetry {
|
|
7
7
|
/** OpenTelemetry tracer instance for creating spans */
|
|
8
|
-
|
|
8
|
+
tracer: Tracer;
|
|
9
9
|
private static instance;
|
|
10
10
|
private constructor();
|
|
11
11
|
/**
|
|
12
|
-
* Gets the instance of ArvoOpenTelemetry
|
|
13
|
-
*
|
|
12
|
+
* Gets or creates the singleton instance of ArvoOpenTelemetry.
|
|
13
|
+
* This method ensures only one instance of ArvoOpenTelemetry exists throughout the application.
|
|
14
|
+
*
|
|
15
|
+
* @param {Object} [config] - Optional configuration object for initializing the instance
|
|
16
|
+
* @param {Tracer} [config.tracer] - Optional custom OpenTelemetry tracer instance.
|
|
17
|
+
* If not provided, defaults to a tracer with name 'arvo-instrumentation'
|
|
18
|
+
*
|
|
19
|
+
* @returns {ArvoOpenTelemetry} The singleton instance of ArvoOpenTelemetry
|
|
20
|
+
*
|
|
21
|
+
* @example
|
|
22
|
+
* // Get instance with default tracer
|
|
23
|
+
* const telemetry = ArvoOpenTelemetry.getInstance();
|
|
24
|
+
*
|
|
25
|
+
* @example
|
|
26
|
+
* // Get instance with custom tracer
|
|
27
|
+
* const customTracer = trace.getTracer('custom-tracer', '2.0.0');
|
|
28
|
+
* const telemetry = ArvoOpenTelemetry.getInstance({ tracer: customTracer });
|
|
29
|
+
*
|
|
30
|
+
* @remarks
|
|
31
|
+
* The tracer configuration is only applied when creating a new instance.
|
|
32
|
+
* Subsequent calls with different tracer configurations will not modify the existing instance.
|
|
33
|
+
*/
|
|
34
|
+
static getInstance(config?: {
|
|
35
|
+
tracer?: Tracer;
|
|
36
|
+
}): ArvoOpenTelemetry;
|
|
37
|
+
/**
|
|
38
|
+
* Forces a reinitialization of the ArvoOpenTelemetry instance.
|
|
39
|
+
* Use this method with caution as it will affect all existing traces and spans.
|
|
40
|
+
*
|
|
41
|
+
* @param {Object} config - Configuration object for reinitializing the instance
|
|
42
|
+
* @param {Tracer} [config.tracer] - Optional custom OpenTelemetry tracer instance
|
|
43
|
+
* @param {boolean} [config.force=false] - If true, skips active span checks
|
|
44
|
+
*
|
|
45
|
+
* @throws {Error} If there are active spans and force is not set to true
|
|
46
|
+
* @throws {Error} If called before instance initialization
|
|
47
|
+
*
|
|
48
|
+
* @example
|
|
49
|
+
* // Safe reinitialization
|
|
50
|
+
* const customTracer = trace.getTracer('new-tracer', '2.0.0');
|
|
51
|
+
* ArvoOpenTelemetry.reinitialize({ tracer: customTracer });
|
|
14
52
|
*/
|
|
15
|
-
static
|
|
53
|
+
static reinitialize(config: {
|
|
54
|
+
tracer?: Tracer;
|
|
55
|
+
force?: boolean;
|
|
56
|
+
}): void;
|
|
16
57
|
/**
|
|
17
58
|
* Creates and manages an active span for a given operation. This function provides two modes of operation:
|
|
18
59
|
* 1. Automatic span management (default): Handles span lifecycle, status, and error recording
|
|
@@ -35,19 +35,69 @@ var types_1 = require("./ArvoExecution/types");
|
|
|
35
35
|
* Singleton class for managing OpenTelemetry instrumentation across libraries
|
|
36
36
|
*/
|
|
37
37
|
var ArvoOpenTelemetry = /** @class */ (function () {
|
|
38
|
-
function ArvoOpenTelemetry() {
|
|
39
|
-
this.tracer = api_1.trace.getTracer('arvo-instrumentation', '1.0.0');
|
|
38
|
+
function ArvoOpenTelemetry(tracer) {
|
|
39
|
+
this.tracer = tracer !== null && tracer !== void 0 ? tracer : api_1.trace.getTracer('arvo-instrumentation', '1.0.0');
|
|
40
40
|
}
|
|
41
41
|
/**
|
|
42
|
-
* Gets the instance of ArvoOpenTelemetry
|
|
43
|
-
*
|
|
42
|
+
* Gets or creates the singleton instance of ArvoOpenTelemetry.
|
|
43
|
+
* This method ensures only one instance of ArvoOpenTelemetry exists throughout the application.
|
|
44
|
+
*
|
|
45
|
+
* @param {Object} [config] - Optional configuration object for initializing the instance
|
|
46
|
+
* @param {Tracer} [config.tracer] - Optional custom OpenTelemetry tracer instance.
|
|
47
|
+
* If not provided, defaults to a tracer with name 'arvo-instrumentation'
|
|
48
|
+
*
|
|
49
|
+
* @returns {ArvoOpenTelemetry} The singleton instance of ArvoOpenTelemetry
|
|
50
|
+
*
|
|
51
|
+
* @example
|
|
52
|
+
* // Get instance with default tracer
|
|
53
|
+
* const telemetry = ArvoOpenTelemetry.getInstance();
|
|
54
|
+
*
|
|
55
|
+
* @example
|
|
56
|
+
* // Get instance with custom tracer
|
|
57
|
+
* const customTracer = trace.getTracer('custom-tracer', '2.0.0');
|
|
58
|
+
* const telemetry = ArvoOpenTelemetry.getInstance({ tracer: customTracer });
|
|
59
|
+
*
|
|
60
|
+
* @remarks
|
|
61
|
+
* The tracer configuration is only applied when creating a new instance.
|
|
62
|
+
* Subsequent calls with different tracer configurations will not modify the existing instance.
|
|
44
63
|
*/
|
|
45
|
-
ArvoOpenTelemetry.getInstance = function () {
|
|
64
|
+
ArvoOpenTelemetry.getInstance = function (config) {
|
|
46
65
|
if (ArvoOpenTelemetry.instance === null) {
|
|
47
|
-
ArvoOpenTelemetry.instance = new ArvoOpenTelemetry();
|
|
66
|
+
ArvoOpenTelemetry.instance = new ArvoOpenTelemetry(config === null || config === void 0 ? void 0 : config.tracer);
|
|
48
67
|
}
|
|
49
68
|
return ArvoOpenTelemetry.instance;
|
|
50
69
|
};
|
|
70
|
+
/**
|
|
71
|
+
* Forces a reinitialization of the ArvoOpenTelemetry instance.
|
|
72
|
+
* Use this method with caution as it will affect all existing traces and spans.
|
|
73
|
+
*
|
|
74
|
+
* @param {Object} config - Configuration object for reinitializing the instance
|
|
75
|
+
* @param {Tracer} [config.tracer] - Optional custom OpenTelemetry tracer instance
|
|
76
|
+
* @param {boolean} [config.force=false] - If true, skips active span checks
|
|
77
|
+
*
|
|
78
|
+
* @throws {Error} If there are active spans and force is not set to true
|
|
79
|
+
* @throws {Error} If called before instance initialization
|
|
80
|
+
*
|
|
81
|
+
* @example
|
|
82
|
+
* // Safe reinitialization
|
|
83
|
+
* const customTracer = trace.getTracer('new-tracer', '2.0.0');
|
|
84
|
+
* ArvoOpenTelemetry.reinitialize({ tracer: customTracer });
|
|
85
|
+
*/
|
|
86
|
+
ArvoOpenTelemetry.reinitialize = function (config) {
|
|
87
|
+
if (!ArvoOpenTelemetry.instance) {
|
|
88
|
+
throw new Error('Cannot reinitialize before initialization. Call getInstance first.');
|
|
89
|
+
}
|
|
90
|
+
// Check for active spans unless force is true
|
|
91
|
+
if (!config.force) {
|
|
92
|
+
var activeSpan = api_1.trace.getActiveSpan();
|
|
93
|
+
if (activeSpan) {
|
|
94
|
+
throw new Error('Cannot reinitialize while spans are active. ' +
|
|
95
|
+
'Either end all spans or use force: true (not recommended)');
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
// Create new instance
|
|
99
|
+
ArvoOpenTelemetry.instance = new ArvoOpenTelemetry(config.tracer);
|
|
100
|
+
};
|
|
51
101
|
/**
|
|
52
102
|
* Creates and manages an active span for a given operation. This function provides two modes of operation:
|
|
53
103
|
* 1. Automatic span management (default): Handles span lifecycle, status, and error recording
|