@elasticdash/tracing 0.0.7 → 0.0.8
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/dist/index.cjs +91 -91
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +198 -198
- package/dist/index.d.ts +198 -198
- package/dist/index.mjs +83 -80
- package/dist/index.mjs.map +1 -1
- package/package.json +2 -2
package/dist/index.d.cts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import * as _opentelemetry_api from '@opentelemetry/api';
|
|
2
2
|
import { Span, TimeInput, Attributes, TracerProvider, SpanContext } from '@opentelemetry/api';
|
|
3
3
|
import { OpenAiUsage } from '@elasticdash/core';
|
|
4
|
-
export {
|
|
4
|
+
export { ElasticDashOtelSpanAttributes, PropagateAttributesParams, propagateAttributes } from '@elasticdash/core';
|
|
5
5
|
|
|
6
6
|
/**
|
|
7
7
|
* Types of observations that can be created in ElasticDash.
|
|
@@ -12,7 +12,7 @@ export { LangfuseOtelSpanAttributes, PropagateAttributesParams, propagateAttribu
|
|
|
12
12
|
*
|
|
13
13
|
* @public
|
|
14
14
|
*/
|
|
15
|
-
type
|
|
15
|
+
type ElasticDashObservationType = "span" | "generation" | "event" | "embedding" | "agent" | "tool" | "chain" | "retriever" | "evaluator" | "guardrail";
|
|
16
16
|
/**
|
|
17
17
|
* Severity levels for observations in ElasticDash.
|
|
18
18
|
*
|
|
@@ -33,7 +33,7 @@ type ObservationLevel = "DEBUG" | "DEFAULT" | "WARNING" | "ERROR";
|
|
|
33
33
|
*
|
|
34
34
|
* @public
|
|
35
35
|
*/
|
|
36
|
-
type
|
|
36
|
+
type ElasticDashSpanAttributes = {
|
|
37
37
|
/** Input data for the operation being tracked */
|
|
38
38
|
input?: unknown;
|
|
39
39
|
/** Output data from the operation */
|
|
@@ -57,7 +57,7 @@ type LangfuseSpanAttributes = {
|
|
|
57
57
|
*
|
|
58
58
|
* @public
|
|
59
59
|
*/
|
|
60
|
-
type
|
|
60
|
+
type ElasticDashGenerationAttributes = ElasticDashSpanAttributes & {
|
|
61
61
|
/** Timestamp when the model started generating completion */
|
|
62
62
|
completionStartTime?: Date;
|
|
63
63
|
/** Name of the language model used (e.g., 'gpt-4', 'claude-3') */
|
|
@@ -84,14 +84,14 @@ type LangfuseGenerationAttributes = LangfuseSpanAttributes & {
|
|
|
84
84
|
isFallback: boolean;
|
|
85
85
|
};
|
|
86
86
|
};
|
|
87
|
-
type
|
|
88
|
-
type
|
|
89
|
-
type
|
|
90
|
-
type
|
|
91
|
-
type
|
|
92
|
-
type
|
|
93
|
-
type
|
|
94
|
-
type
|
|
87
|
+
type ElasticDashEventAttributes = ElasticDashSpanAttributes;
|
|
88
|
+
type ElasticDashAgentAttributes = ElasticDashSpanAttributes;
|
|
89
|
+
type ElasticDashToolAttributes = ElasticDashSpanAttributes;
|
|
90
|
+
type ElasticDashChainAttributes = ElasticDashSpanAttributes;
|
|
91
|
+
type ElasticDashRetrieverAttributes = ElasticDashSpanAttributes;
|
|
92
|
+
type ElasticDashEvaluatorAttributes = ElasticDashSpanAttributes;
|
|
93
|
+
type ElasticDashGuardrailAttributes = ElasticDashSpanAttributes;
|
|
94
|
+
type ElasticDashEmbeddingAttributes = ElasticDashGenerationAttributes;
|
|
95
95
|
/**
|
|
96
96
|
* Union type representing any ElasticDash observation attributes.
|
|
97
97
|
*
|
|
@@ -99,7 +99,7 @@ type LangfuseEmbeddingAttributes = LangfuseGenerationAttributes;
|
|
|
99
99
|
*
|
|
100
100
|
* @public
|
|
101
101
|
*/
|
|
102
|
-
type
|
|
102
|
+
type ElasticDashObservationAttributes = ElasticDashSpanAttributes & ElasticDashGenerationAttributes & ElasticDashEventAttributes & ElasticDashAgentAttributes & ElasticDashToolAttributes & ElasticDashChainAttributes & ElasticDashRetrieverAttributes & ElasticDashEvaluatorAttributes & ElasticDashGuardrailAttributes;
|
|
103
103
|
/**
|
|
104
104
|
* Attributes for ElasticDash traces.
|
|
105
105
|
*
|
|
@@ -108,7 +108,7 @@ type LangfuseObservationAttributes = LangfuseSpanAttributes & LangfuseGeneration
|
|
|
108
108
|
*
|
|
109
109
|
* @public
|
|
110
110
|
*/
|
|
111
|
-
type
|
|
111
|
+
type ElasticDashTraceAttributes = {
|
|
112
112
|
/** Human-readable name for the trace */
|
|
113
113
|
name?: string;
|
|
114
114
|
/** Identifier for the user associated with this trace */
|
|
@@ -141,21 +141,21 @@ type LangfuseTraceAttributes = {
|
|
|
141
141
|
* particularly useful for generic functions that work with any observation type.
|
|
142
142
|
*
|
|
143
143
|
* ## Included Types
|
|
144
|
-
* - **
|
|
145
|
-
* - **
|
|
146
|
-
* - **
|
|
147
|
-
* - **
|
|
148
|
-
* - **
|
|
149
|
-
* - **
|
|
150
|
-
* - **
|
|
151
|
-
* - **
|
|
152
|
-
* - **
|
|
153
|
-
* - **
|
|
144
|
+
* - **ElasticDashSpan**: General-purpose operations and workflows
|
|
145
|
+
* - **ElasticDashGeneration**: LLM calls and AI model interactions
|
|
146
|
+
* - **ElasticDashEmbedding**: Text embedding and vector operations
|
|
147
|
+
* - **ElasticDashAgent**: AI agent workflows with tool usage
|
|
148
|
+
* - **ElasticDashTool**: Individual tool calls and API requests
|
|
149
|
+
* - **ElasticDashChain**: Multi-step processes and pipelines
|
|
150
|
+
* - **ElasticDashRetriever**: Document retrieval and search operations
|
|
151
|
+
* - **ElasticDashEvaluator**: Quality assessment and scoring
|
|
152
|
+
* - **ElasticDashGuardrail**: Safety checks and content filtering
|
|
153
|
+
* - **ElasticDashEvent**: Point-in-time occurrences and log entries
|
|
154
154
|
*
|
|
155
155
|
* @example
|
|
156
156
|
* ```typescript
|
|
157
157
|
* // Function accepting any observation type
|
|
158
|
-
* function logObservation(obs:
|
|
158
|
+
* function logObservation(obs: ElasticDashObservation) {
|
|
159
159
|
* console.log(`Observation ${obs.id} in trace ${obs.traceId}`);
|
|
160
160
|
*
|
|
161
161
|
* // All observations have common methods
|
|
@@ -175,16 +175,16 @@ type LangfuseTraceAttributes = {
|
|
|
175
175
|
*
|
|
176
176
|
* @public
|
|
177
177
|
*/
|
|
178
|
-
type
|
|
178
|
+
type ElasticDashObservation = ElasticDashSpan | ElasticDashGeneration | ElasticDashEvent | ElasticDashAgent | ElasticDashTool | ElasticDashChain | ElasticDashRetriever | ElasticDashEvaluator | ElasticDashGuardrail | ElasticDashEmbedding;
|
|
179
179
|
/**
|
|
180
180
|
* Parameters for creating a ElasticDash observation wrapper.
|
|
181
181
|
*
|
|
182
182
|
* @internal
|
|
183
183
|
*/
|
|
184
|
-
type
|
|
184
|
+
type ElasticDashObservationParams = {
|
|
185
185
|
otelSpan: Span;
|
|
186
|
-
type:
|
|
187
|
-
attributes?:
|
|
186
|
+
type: ElasticDashObservationType;
|
|
187
|
+
attributes?: ElasticDashSpanAttributes | ElasticDashGenerationAttributes | ElasticDashEventAttributes;
|
|
188
188
|
};
|
|
189
189
|
/**
|
|
190
190
|
* Base class for all ElasticDash observation wrappers providing unified functionality.
|
|
@@ -215,7 +215,7 @@ type LangfuseObservationParams = {
|
|
|
215
215
|
* @example
|
|
216
216
|
* ```typescript
|
|
217
217
|
* // All observation types share these common capabilities
|
|
218
|
-
* const observation:
|
|
218
|
+
* const observation: ElasticDashObservation = startObservation('my-operation');
|
|
219
219
|
*
|
|
220
220
|
* // Common properties available on all observations
|
|
221
221
|
* console.log(`Observation ID: ${observation.id}`);
|
|
@@ -241,16 +241,16 @@ type LangfuseObservationParams = {
|
|
|
241
241
|
*
|
|
242
242
|
* @internal
|
|
243
243
|
*/
|
|
244
|
-
declare abstract class
|
|
244
|
+
declare abstract class ElasticDashBaseObservation {
|
|
245
245
|
/** The underlying OpenTelemetry span */
|
|
246
246
|
readonly otelSpan: Span;
|
|
247
247
|
/** The underlying OpenTelemetry span */
|
|
248
|
-
readonly type:
|
|
248
|
+
readonly type: ElasticDashObservationType;
|
|
249
249
|
/** The span ID from the OpenTelemetry span context */
|
|
250
250
|
id: string;
|
|
251
251
|
/** The trace ID from the OpenTelemetry span context */
|
|
252
252
|
traceId: string;
|
|
253
|
-
constructor(params:
|
|
253
|
+
constructor(params: ElasticDashObservationParams);
|
|
254
254
|
/** Gets the ElasticDash OpenTelemetry tracer instance */
|
|
255
255
|
protected get tracer(): _opentelemetry_api.Tracer;
|
|
256
256
|
/**
|
|
@@ -259,11 +259,11 @@ declare abstract class LangfuseBaseObservation {
|
|
|
259
259
|
* @param endTime - Optional end time, defaults to current time
|
|
260
260
|
*/
|
|
261
261
|
end(endTime?: TimeInput): void;
|
|
262
|
-
updateOtelSpanAttributes(attributes:
|
|
262
|
+
updateOtelSpanAttributes(attributes: ElasticDashObservationAttributes): void;
|
|
263
263
|
/**
|
|
264
264
|
* Updates the parent trace with new attributes.
|
|
265
265
|
*/
|
|
266
|
-
updateTrace(attributes:
|
|
266
|
+
updateTrace(attributes: ElasticDashTraceAttributes): this;
|
|
267
267
|
/**
|
|
268
268
|
* Creates a new child observation within this observation's context with full type safety.
|
|
269
269
|
*
|
|
@@ -298,7 +298,7 @@ declare abstract class LangfuseBaseObservation {
|
|
|
298
298
|
* const dataProcessing = parentObservation.startObservation('data-processing', {
|
|
299
299
|
* input: { userId: '123', dataSize: 1024 },
|
|
300
300
|
* metadata: { processor: 'fast-lane', version: '2.1' }
|
|
301
|
-
* }); // Returns
|
|
301
|
+
* }); // Returns ElasticDashSpan
|
|
302
302
|
*
|
|
303
303
|
* // Create child generation with full LLM attributes
|
|
304
304
|
* const llmCall = parentObservation.startObservation('openai-gpt-4', {
|
|
@@ -311,7 +311,7 @@ declare abstract class LangfuseBaseObservation {
|
|
|
311
311
|
* topP: 1.0
|
|
312
312
|
* },
|
|
313
313
|
* metadata: { priority: 'high', timeout: 30000 }
|
|
314
|
-
* }, { asType: 'generation' }); // Returns
|
|
314
|
+
* }, { asType: 'generation' }); // Returns ElasticDashGeneration
|
|
315
315
|
*
|
|
316
316
|
* // Create child agent for complex reasoning
|
|
317
317
|
* const reasoningAgent = parentObservation.startObservation('reasoning-agent', {
|
|
@@ -324,7 +324,7 @@ declare abstract class LangfuseBaseObservation {
|
|
|
324
324
|
* tools: ['calculator', 'web-search', 'data-analysis'],
|
|
325
325
|
* maxIterations: 5
|
|
326
326
|
* }
|
|
327
|
-
* }, { asType: 'agent' }); // Returns
|
|
327
|
+
* }, { asType: 'agent' }); // Returns ElasticDashAgent
|
|
328
328
|
*
|
|
329
329
|
* // Create child tool for external API calls
|
|
330
330
|
* const apiCall = reasoningAgent.startObservation('market-data-api', {
|
|
@@ -337,7 +337,7 @@ declare abstract class LangfuseBaseObservation {
|
|
|
337
337
|
* rateLimit: 5,
|
|
338
338
|
* timeout: 10000
|
|
339
339
|
* }
|
|
340
|
-
* }, { asType: 'tool' }); // Returns
|
|
340
|
+
* }, { asType: 'tool' }); // Returns ElasticDashTool
|
|
341
341
|
*
|
|
342
342
|
* // Create child retriever for document search
|
|
343
343
|
* const docSearch = parentObservation.startObservation('document-retrieval', {
|
|
@@ -351,7 +351,7 @@ declare abstract class LangfuseBaseObservation {
|
|
|
351
351
|
* embeddingModel: 'text-embedding-ada-002',
|
|
352
352
|
* similarity: 'cosine'
|
|
353
353
|
* }
|
|
354
|
-
* }, { asType: 'retriever' }); // Returns
|
|
354
|
+
* }, { asType: 'retriever' }); // Returns ElasticDashRetriever
|
|
355
355
|
*
|
|
356
356
|
* // Create child evaluator for quality assessment
|
|
357
357
|
* const qualityCheck = parentObservation.startObservation('response-evaluator', {
|
|
@@ -365,7 +365,7 @@ declare abstract class LangfuseBaseObservation {
|
|
|
365
365
|
* threshold: 0.8,
|
|
366
366
|
* metrics: ['bleu', 'rouge', 'semantic-similarity']
|
|
367
367
|
* }
|
|
368
|
-
* }, { asType: 'evaluator' }); // Returns
|
|
368
|
+
* }, { asType: 'evaluator' }); // Returns ElasticDashEvaluator
|
|
369
369
|
*
|
|
370
370
|
* // Create child guardrail for safety checking
|
|
371
371
|
* const safetyCheck = parentObservation.startObservation('content-guardrail', {
|
|
@@ -378,7 +378,7 @@ declare abstract class LangfuseBaseObservation {
|
|
|
378
378
|
* strictMode: true,
|
|
379
379
|
* confidence: 0.95
|
|
380
380
|
* }
|
|
381
|
-
* }, { asType: 'guardrail' }); // Returns
|
|
381
|
+
* }, { asType: 'guardrail' }); // Returns ElasticDashGuardrail
|
|
382
382
|
*
|
|
383
383
|
* // Create child embedding for vector generation
|
|
384
384
|
* const textEmbedding = parentObservation.startObservation('text-embedder', {
|
|
@@ -392,7 +392,7 @@ declare abstract class LangfuseBaseObservation {
|
|
|
392
392
|
* normalization: 'l2',
|
|
393
393
|
* purpose: 'semantic-search'
|
|
394
394
|
* }
|
|
395
|
-
* }, { asType: 'embedding' }); // Returns
|
|
395
|
+
* }, { asType: 'embedding' }); // Returns ElasticDashEmbedding
|
|
396
396
|
*
|
|
397
397
|
* // Create child event for point-in-time logging
|
|
398
398
|
* const userAction = parentObservation.startObservation('user-interaction', {
|
|
@@ -407,7 +407,7 @@ declare abstract class LangfuseBaseObservation {
|
|
|
407
407
|
* userId: 'user_456',
|
|
408
408
|
* browser: 'Chrome 120.0'
|
|
409
409
|
* }
|
|
410
|
-
* }, { asType: 'event' }); // Returns
|
|
410
|
+
* }, { asType: 'event' }); // Returns ElasticDashEvent (auto-ended)
|
|
411
411
|
*
|
|
412
412
|
* // Chain operations - each child inherits context
|
|
413
413
|
* dataProcessing.update({ output: { processed: true, records: 1000 } });
|
|
@@ -432,45 +432,45 @@ declare abstract class LangfuseBaseObservation {
|
|
|
432
432
|
* @see {@link startObservation} for creating root-level observations
|
|
433
433
|
* @see {@link startActiveObservation} for function-scoped child observations
|
|
434
434
|
*/
|
|
435
|
-
startObservation(name: string, attributes:
|
|
435
|
+
startObservation(name: string, attributes: ElasticDashGenerationAttributes, options: {
|
|
436
436
|
asType: "generation";
|
|
437
|
-
}):
|
|
438
|
-
startObservation(name: string, attributes:
|
|
437
|
+
}): ElasticDashGeneration;
|
|
438
|
+
startObservation(name: string, attributes: ElasticDashEventAttributes, options: {
|
|
439
439
|
asType: "event";
|
|
440
|
-
}):
|
|
441
|
-
startObservation(name: string, attributes:
|
|
440
|
+
}): ElasticDashEvent;
|
|
441
|
+
startObservation(name: string, attributes: ElasticDashAgentAttributes, options: {
|
|
442
442
|
asType: "agent";
|
|
443
|
-
}):
|
|
444
|
-
startObservation(name: string, attributes:
|
|
443
|
+
}): ElasticDashAgent;
|
|
444
|
+
startObservation(name: string, attributes: ElasticDashToolAttributes, options: {
|
|
445
445
|
asType: "tool";
|
|
446
|
-
}):
|
|
447
|
-
startObservation(name: string, attributes:
|
|
446
|
+
}): ElasticDashTool;
|
|
447
|
+
startObservation(name: string, attributes: ElasticDashChainAttributes, options: {
|
|
448
448
|
asType: "chain";
|
|
449
|
-
}):
|
|
450
|
-
startObservation(name: string, attributes:
|
|
449
|
+
}): ElasticDashChain;
|
|
450
|
+
startObservation(name: string, attributes: ElasticDashRetrieverAttributes, options: {
|
|
451
451
|
asType: "retriever";
|
|
452
|
-
}):
|
|
453
|
-
startObservation(name: string, attributes:
|
|
452
|
+
}): ElasticDashRetriever;
|
|
453
|
+
startObservation(name: string, attributes: ElasticDashEvaluatorAttributes, options: {
|
|
454
454
|
asType: "evaluator";
|
|
455
|
-
}):
|
|
456
|
-
startObservation(name: string, attributes:
|
|
455
|
+
}): ElasticDashEvaluator;
|
|
456
|
+
startObservation(name: string, attributes: ElasticDashGuardrailAttributes, options: {
|
|
457
457
|
asType: "guardrail";
|
|
458
|
-
}):
|
|
459
|
-
startObservation(name: string, attributes:
|
|
458
|
+
}): ElasticDashGuardrail;
|
|
459
|
+
startObservation(name: string, attributes: ElasticDashEmbeddingAttributes, options: {
|
|
460
460
|
asType: "embedding";
|
|
461
|
-
}):
|
|
462
|
-
startObservation(name: string, attributes?:
|
|
461
|
+
}): ElasticDashEmbedding;
|
|
462
|
+
startObservation(name: string, attributes?: ElasticDashSpanAttributes, options?: {
|
|
463
463
|
asType?: "span";
|
|
464
|
-
}):
|
|
464
|
+
}): ElasticDashSpan;
|
|
465
465
|
}
|
|
466
|
-
type
|
|
466
|
+
type ElasticDashSpanParams = {
|
|
467
467
|
otelSpan: Span;
|
|
468
|
-
attributes?:
|
|
468
|
+
attributes?: ElasticDashSpanAttributes;
|
|
469
469
|
};
|
|
470
470
|
/**
|
|
471
471
|
* General-purpose observation wrapper for tracking operations, functions, and workflows.
|
|
472
472
|
*
|
|
473
|
-
*
|
|
473
|
+
* ElasticDashSpan is the default and most versatile observation type, designed for tracing
|
|
474
474
|
* any operation that has a defined start and end time. It serves as the foundation for
|
|
475
475
|
* building hierarchical traces and can contain any other observation type as children.
|
|
476
476
|
*
|
|
@@ -541,13 +541,13 @@ type LangfuseSpanParams = {
|
|
|
541
541
|
*
|
|
542
542
|
* @see {@link startObservation} - Factory function for creating spans
|
|
543
543
|
* @see {@link startActiveObservation} - Function-scoped span creation
|
|
544
|
-
* @see {@link
|
|
545
|
-
* @see {@link
|
|
544
|
+
* @see {@link ElasticDashGeneration} - For LLM and AI model interactions
|
|
545
|
+
* @see {@link ElasticDashEvent} - For point-in-time occurrences
|
|
546
546
|
*
|
|
547
547
|
* @public
|
|
548
548
|
*/
|
|
549
|
-
declare class
|
|
550
|
-
constructor(params:
|
|
549
|
+
declare class ElasticDashSpan extends ElasticDashBaseObservation {
|
|
550
|
+
constructor(params: ElasticDashSpanParams);
|
|
551
551
|
/**
|
|
552
552
|
* Updates this span with new attributes.
|
|
553
553
|
*
|
|
@@ -563,16 +563,16 @@ declare class LangfuseSpan extends LangfuseBaseObservation {
|
|
|
563
563
|
* });
|
|
564
564
|
* ```
|
|
565
565
|
*/
|
|
566
|
-
update(attributes:
|
|
566
|
+
update(attributes: ElasticDashSpanAttributes): ElasticDashSpan;
|
|
567
567
|
}
|
|
568
|
-
type
|
|
568
|
+
type ElasticDashAgentParams = {
|
|
569
569
|
otelSpan: Span;
|
|
570
|
-
attributes?:
|
|
570
|
+
attributes?: ElasticDashAgentAttributes;
|
|
571
571
|
};
|
|
572
572
|
/**
|
|
573
573
|
* Specialized observation wrapper for tracking AI agent workflows and autonomous operations.
|
|
574
574
|
*
|
|
575
|
-
*
|
|
575
|
+
* ElasticDashAgent is designed for observing intelligent agent systems that combine reasoning,
|
|
576
576
|
* tool usage, memory management, and decision-making in autonomous workflows. It captures
|
|
577
577
|
* the complex multi-step nature of agent operations, including planning, execution, and
|
|
578
578
|
* self-correction cycles typical in advanced AI agent architectures.
|
|
@@ -643,13 +643,13 @@ type LangfuseAgentParams = {
|
|
|
643
643
|
*
|
|
644
644
|
* @see {@link startObservation} with `{ asType: 'agent' }` - Factory function
|
|
645
645
|
* @see {@link startActiveObservation} with `{ asType: 'agent' }` - Function-scoped agent
|
|
646
|
-
* @see {@link
|
|
647
|
-
* @see {@link
|
|
646
|
+
* @see {@link ElasticDashTool} - For individual tool executions within agents
|
|
647
|
+
* @see {@link ElasticDashChain} - For structured multi-step workflows
|
|
648
648
|
*
|
|
649
649
|
* @public
|
|
650
650
|
*/
|
|
651
|
-
declare class
|
|
652
|
-
constructor(params:
|
|
651
|
+
declare class ElasticDashAgent extends ElasticDashBaseObservation {
|
|
652
|
+
constructor(params: ElasticDashAgentParams);
|
|
653
653
|
/**
|
|
654
654
|
* Updates this agent observation with new attributes.
|
|
655
655
|
*
|
|
@@ -673,16 +673,16 @@ declare class LangfuseAgent extends LangfuseBaseObservation {
|
|
|
673
673
|
* });
|
|
674
674
|
* ```
|
|
675
675
|
*/
|
|
676
|
-
update(attributes:
|
|
676
|
+
update(attributes: ElasticDashAgentAttributes): ElasticDashAgent;
|
|
677
677
|
}
|
|
678
|
-
type
|
|
678
|
+
type ElasticDashToolParams = {
|
|
679
679
|
otelSpan: Span;
|
|
680
|
-
attributes?:
|
|
680
|
+
attributes?: ElasticDashToolAttributes;
|
|
681
681
|
};
|
|
682
682
|
/**
|
|
683
683
|
* Specialized observation wrapper for tracking individual tool calls and external API interactions.
|
|
684
684
|
*
|
|
685
|
-
*
|
|
685
|
+
* ElasticDashTool is designed for observing discrete tool invocations within agent workflows,
|
|
686
686
|
* function calling scenarios, or standalone API integrations. It captures the input parameters,
|
|
687
687
|
* execution results, performance metrics, and error conditions of tool operations, making it
|
|
688
688
|
* essential for debugging tool reliability and optimizing tool selection strategies.
|
|
@@ -763,13 +763,13 @@ type LangfuseToolParams = {
|
|
|
763
763
|
*
|
|
764
764
|
* @see {@link startObservation} with `{ asType: 'tool' }` - Factory function
|
|
765
765
|
* @see {@link startActiveObservation} with `{ asType: 'tool' }` - Function-scoped tool
|
|
766
|
-
* @see {@link
|
|
767
|
-
* @see {@link
|
|
766
|
+
* @see {@link ElasticDashAgent} - For agent workflows that use multiple tools
|
|
767
|
+
* @see {@link ElasticDashChain} - For orchestrated tool sequences
|
|
768
768
|
*
|
|
769
769
|
* @public
|
|
770
770
|
*/
|
|
771
|
-
declare class
|
|
772
|
-
constructor(params:
|
|
771
|
+
declare class ElasticDashTool extends ElasticDashBaseObservation {
|
|
772
|
+
constructor(params: ElasticDashToolParams);
|
|
773
773
|
/**
|
|
774
774
|
* Updates this tool observation with new attributes.
|
|
775
775
|
*
|
|
@@ -793,16 +793,16 @@ declare class LangfuseTool extends LangfuseBaseObservation {
|
|
|
793
793
|
* });
|
|
794
794
|
* ```
|
|
795
795
|
*/
|
|
796
|
-
update(attributes:
|
|
796
|
+
update(attributes: ElasticDashToolAttributes): ElasticDashTool;
|
|
797
797
|
}
|
|
798
|
-
type
|
|
798
|
+
type ElasticDashChainParams = {
|
|
799
799
|
otelSpan: Span;
|
|
800
|
-
attributes?:
|
|
800
|
+
attributes?: ElasticDashChainAttributes;
|
|
801
801
|
};
|
|
802
802
|
/**
|
|
803
803
|
* Specialized observation wrapper for tracking structured multi-step workflows and process chains.
|
|
804
804
|
*
|
|
805
|
-
*
|
|
805
|
+
* ElasticDashChain is designed for observing sequential, parallel, or conditional workflow orchestration
|
|
806
806
|
* where multiple operations are coordinated to achieve a larger goal. It captures the flow of data
|
|
807
807
|
* between steps, manages dependencies, tracks progress through complex pipelines, and provides
|
|
808
808
|
* insights into workflow performance and reliability patterns.
|
|
@@ -878,13 +878,13 @@ type LangfuseChainParams = {
|
|
|
878
878
|
*
|
|
879
879
|
* @see {@link startObservation} with `{ asType: 'chain' }` - Factory function
|
|
880
880
|
* @see {@link startActiveObservation} with `{ asType: 'chain' }` - Function-scoped chain
|
|
881
|
-
* @see {@link
|
|
882
|
-
* @see {@link
|
|
881
|
+
* @see {@link ElasticDashSpan} - For individual workflow steps
|
|
882
|
+
* @see {@link ElasticDashAgent} - For intelligent workflow orchestration
|
|
883
883
|
*
|
|
884
884
|
* @public
|
|
885
885
|
*/
|
|
886
|
-
declare class
|
|
887
|
-
constructor(params:
|
|
886
|
+
declare class ElasticDashChain extends ElasticDashBaseObservation {
|
|
887
|
+
constructor(params: ElasticDashChainParams);
|
|
888
888
|
/**
|
|
889
889
|
* Updates this chain observation with new attributes.
|
|
890
890
|
*
|
|
@@ -908,16 +908,16 @@ declare class LangfuseChain extends LangfuseBaseObservation {
|
|
|
908
908
|
* });
|
|
909
909
|
* ```
|
|
910
910
|
*/
|
|
911
|
-
update(attributes:
|
|
911
|
+
update(attributes: ElasticDashChainAttributes): ElasticDashChain;
|
|
912
912
|
}
|
|
913
|
-
type
|
|
913
|
+
type ElasticDashRetrieverParams = {
|
|
914
914
|
otelSpan: Span;
|
|
915
|
-
attributes?:
|
|
915
|
+
attributes?: ElasticDashRetrieverAttributes;
|
|
916
916
|
};
|
|
917
917
|
/**
|
|
918
918
|
* Specialized observation wrapper for tracking document retrieval and search operations.
|
|
919
919
|
*
|
|
920
|
-
*
|
|
920
|
+
* ElasticDashRetriever is designed for observing information retrieval systems that search,
|
|
921
921
|
* filter, and rank content from various data sources. It captures search queries, retrieval
|
|
922
922
|
* strategies, result quality metrics, and performance characteristics of search operations,
|
|
923
923
|
* making it essential for RAG systems, knowledge bases, and content discovery workflows.
|
|
@@ -974,29 +974,29 @@ type LangfuseRetrieverParams = {
|
|
|
974
974
|
* ```
|
|
975
975
|
*
|
|
976
976
|
* @see {@link startObservation} with `{ asType: 'retriever' }` - Factory function
|
|
977
|
-
* @see {@link
|
|
978
|
-
* @see {@link
|
|
977
|
+
* @see {@link ElasticDashChain} - For multi-step RAG pipelines
|
|
978
|
+
* @see {@link ElasticDashEmbedding} - For embedding generation used in vector search
|
|
979
979
|
*
|
|
980
980
|
* @public
|
|
981
981
|
*/
|
|
982
|
-
declare class
|
|
983
|
-
constructor(params:
|
|
982
|
+
declare class ElasticDashRetriever extends ElasticDashBaseObservation {
|
|
983
|
+
constructor(params: ElasticDashRetrieverParams);
|
|
984
984
|
/**
|
|
985
985
|
* Updates this retriever observation with new attributes.
|
|
986
986
|
*
|
|
987
987
|
* @param attributes - Retriever attributes to set
|
|
988
988
|
* @returns This retriever for method chaining
|
|
989
989
|
*/
|
|
990
|
-
update(attributes:
|
|
990
|
+
update(attributes: ElasticDashRetrieverAttributes): ElasticDashRetriever;
|
|
991
991
|
}
|
|
992
|
-
type
|
|
992
|
+
type ElasticDashEvaluatorParams = {
|
|
993
993
|
otelSpan: Span;
|
|
994
|
-
attributes?:
|
|
994
|
+
attributes?: ElasticDashEvaluatorAttributes;
|
|
995
995
|
};
|
|
996
996
|
/**
|
|
997
997
|
* Specialized observation wrapper for tracking quality assessment and evaluation operations.
|
|
998
998
|
*
|
|
999
|
-
*
|
|
999
|
+
* ElasticDashEvaluator is designed for observing evaluation systems that assess, score, and
|
|
1000
1000
|
* validate the quality of AI outputs, content, or system performance. It captures evaluation
|
|
1001
1001
|
* criteria, scoring methodologies, benchmark comparisons, and quality metrics, making it
|
|
1002
1002
|
* essential for AI system validation, content moderation, and performance monitoring.
|
|
@@ -1047,29 +1047,29 @@ type LangfuseEvaluatorParams = {
|
|
|
1047
1047
|
* ```
|
|
1048
1048
|
*
|
|
1049
1049
|
* @see {@link startObservation} with `{ asType: 'evaluator' }` - Factory function
|
|
1050
|
-
* @see {@link
|
|
1051
|
-
* @see {@link
|
|
1050
|
+
* @see {@link ElasticDashGeneration} - For LLM outputs being evaluated
|
|
1051
|
+
* @see {@link ElasticDashGuardrail} - For safety and compliance enforcement
|
|
1052
1052
|
*
|
|
1053
1053
|
* @public
|
|
1054
1054
|
*/
|
|
1055
|
-
declare class
|
|
1056
|
-
constructor(params:
|
|
1055
|
+
declare class ElasticDashEvaluator extends ElasticDashBaseObservation {
|
|
1056
|
+
constructor(params: ElasticDashEvaluatorParams);
|
|
1057
1057
|
/**
|
|
1058
1058
|
* Updates this evaluator observation with new attributes.
|
|
1059
1059
|
*
|
|
1060
1060
|
* @param attributes - Evaluator attributes to set
|
|
1061
1061
|
* @returns This evaluator for method chaining
|
|
1062
1062
|
*/
|
|
1063
|
-
update(attributes:
|
|
1063
|
+
update(attributes: ElasticDashEvaluatorAttributes): ElasticDashEvaluator;
|
|
1064
1064
|
}
|
|
1065
|
-
type
|
|
1065
|
+
type ElasticDashGuardrailParams = {
|
|
1066
1066
|
otelSpan: Span;
|
|
1067
|
-
attributes?:
|
|
1067
|
+
attributes?: ElasticDashGuardrailAttributes;
|
|
1068
1068
|
};
|
|
1069
1069
|
/**
|
|
1070
1070
|
* Specialized observation wrapper for tracking safety checks and compliance enforcement.
|
|
1071
1071
|
*
|
|
1072
|
-
*
|
|
1072
|
+
* ElasticDashGuardrail is designed for observing safety and compliance systems that prevent,
|
|
1073
1073
|
* detect, and mitigate harmful, inappropriate, or policy-violating content and behaviors
|
|
1074
1074
|
* in AI applications. It captures safety policies, violation detection, risk assessment,
|
|
1075
1075
|
* and mitigation actions, ensuring responsible AI deployment and regulatory compliance.
|
|
@@ -1118,34 +1118,34 @@ type LangfuseGuardrailParams = {
|
|
|
1118
1118
|
* ```
|
|
1119
1119
|
*
|
|
1120
1120
|
* @see {@link startObservation} with `{ asType: 'guardrail' }` - Factory function
|
|
1121
|
-
* @see {@link
|
|
1122
|
-
* @see {@link
|
|
1121
|
+
* @see {@link ElasticDashEvaluator} - For detailed quality and safety assessment
|
|
1122
|
+
* @see {@link ElasticDashGeneration} - For protecting LLM outputs with guardrails
|
|
1123
1123
|
*
|
|
1124
1124
|
* @public
|
|
1125
1125
|
*/
|
|
1126
|
-
declare class
|
|
1127
|
-
constructor(params:
|
|
1126
|
+
declare class ElasticDashGuardrail extends ElasticDashBaseObservation {
|
|
1127
|
+
constructor(params: ElasticDashGuardrailParams);
|
|
1128
1128
|
/**
|
|
1129
1129
|
* Updates this guardrail observation with new attributes.
|
|
1130
1130
|
*
|
|
1131
1131
|
* @param attributes - Guardrail attributes to set
|
|
1132
1132
|
* @returns This guardrail for method chaining
|
|
1133
1133
|
*/
|
|
1134
|
-
update(attributes:
|
|
1134
|
+
update(attributes: ElasticDashGuardrailAttributes): ElasticDashGuardrail;
|
|
1135
1135
|
}
|
|
1136
1136
|
/**
|
|
1137
1137
|
* Parameters for creating a ElasticDash generation.
|
|
1138
1138
|
*
|
|
1139
1139
|
* @internal
|
|
1140
1140
|
*/
|
|
1141
|
-
type
|
|
1141
|
+
type ElasticDashGenerationParams = {
|
|
1142
1142
|
otelSpan: Span;
|
|
1143
|
-
attributes?:
|
|
1143
|
+
attributes?: ElasticDashGenerationAttributes;
|
|
1144
1144
|
};
|
|
1145
1145
|
/**
|
|
1146
1146
|
* Specialized observation wrapper for tracking LLM interactions, AI model calls, and text generation.
|
|
1147
1147
|
*
|
|
1148
|
-
*
|
|
1148
|
+
* ElasticDashGeneration is purpose-built for observing AI model interactions, providing rich
|
|
1149
1149
|
* metadata capture for prompts, completions, model parameters, token usage, and costs.
|
|
1150
1150
|
* It's the go-to observation type for any operation involving language models, chat APIs,
|
|
1151
1151
|
* completion APIs, or other generative AI services.
|
|
@@ -1243,23 +1243,23 @@ type LangfuseGenerationParams = {
|
|
|
1243
1243
|
*
|
|
1244
1244
|
* @see {@link startObservation} with `{ asType: 'generation' }` - Factory function
|
|
1245
1245
|
* @see {@link startActiveObservation} with `{ asType: 'generation' }` - Function-scoped generation
|
|
1246
|
-
* @see {@link
|
|
1247
|
-
* @see {@link
|
|
1246
|
+
* @see {@link ElasticDashSpan} - For general-purpose operations
|
|
1247
|
+
* @see {@link ElasticDashEmbedding} - For text embedding and vector operations
|
|
1248
1248
|
*
|
|
1249
1249
|
* @public
|
|
1250
1250
|
*/
|
|
1251
|
-
declare class
|
|
1252
|
-
constructor(params:
|
|
1253
|
-
update(attributes:
|
|
1251
|
+
declare class ElasticDashGeneration extends ElasticDashBaseObservation {
|
|
1252
|
+
constructor(params: ElasticDashGenerationParams);
|
|
1253
|
+
update(attributes: ElasticDashGenerationAttributes): ElasticDashGeneration;
|
|
1254
1254
|
}
|
|
1255
|
-
type
|
|
1255
|
+
type ElasticDashEmbeddingParams = {
|
|
1256
1256
|
otelSpan: Span;
|
|
1257
|
-
attributes?:
|
|
1257
|
+
attributes?: ElasticDashEmbeddingAttributes;
|
|
1258
1258
|
};
|
|
1259
1259
|
/**
|
|
1260
1260
|
* Specialized observation wrapper for tracking text embedding and vector generation operations.
|
|
1261
1261
|
*
|
|
1262
|
-
*
|
|
1262
|
+
* ElasticDashEmbedding is designed for observing embedding model interactions that convert
|
|
1263
1263
|
* text, images, or other content into high-dimensional vector representations. It captures
|
|
1264
1264
|
* embedding model parameters, input preprocessing, vector characteristics, and performance
|
|
1265
1265
|
* metrics, making it essential for semantic search, RAG systems, and similarity-based applications.
|
|
@@ -1319,29 +1319,29 @@ type LangfuseEmbeddingParams = {
|
|
|
1319
1319
|
* ```
|
|
1320
1320
|
*
|
|
1321
1321
|
* @see {@link startObservation} with `{ asType: 'embedding' }` - Factory function
|
|
1322
|
-
* @see {@link
|
|
1323
|
-
* @see {@link
|
|
1322
|
+
* @see {@link ElasticDashRetriever} - For using embeddings in vector search
|
|
1323
|
+
* @see {@link ElasticDashGeneration} - For LLM operations that may use embeddings
|
|
1324
1324
|
*
|
|
1325
1325
|
* @public
|
|
1326
1326
|
*/
|
|
1327
|
-
declare class
|
|
1328
|
-
constructor(params:
|
|
1327
|
+
declare class ElasticDashEmbedding extends ElasticDashBaseObservation {
|
|
1328
|
+
constructor(params: ElasticDashEmbeddingParams);
|
|
1329
1329
|
/**
|
|
1330
1330
|
* Updates this embedding observation with new attributes.
|
|
1331
1331
|
*
|
|
1332
1332
|
* @param attributes - Embedding attributes to set
|
|
1333
1333
|
* @returns This embedding for method chaining
|
|
1334
1334
|
*/
|
|
1335
|
-
update(attributes:
|
|
1335
|
+
update(attributes: ElasticDashEmbeddingAttributes): ElasticDashEmbedding;
|
|
1336
1336
|
}
|
|
1337
1337
|
/**
|
|
1338
1338
|
* Parameters for creating a ElasticDash event.
|
|
1339
1339
|
*
|
|
1340
1340
|
* @internal
|
|
1341
1341
|
*/
|
|
1342
|
-
type
|
|
1342
|
+
type ElasticDashEventParams = {
|
|
1343
1343
|
otelSpan: Span;
|
|
1344
|
-
attributes?:
|
|
1344
|
+
attributes?: ElasticDashEventAttributes;
|
|
1345
1345
|
timestamp: TimeInput;
|
|
1346
1346
|
};
|
|
1347
1347
|
/**
|
|
@@ -1353,8 +1353,8 @@ type LangfuseEventParams = {
|
|
|
1353
1353
|
*
|
|
1354
1354
|
* @public
|
|
1355
1355
|
*/
|
|
1356
|
-
declare class
|
|
1357
|
-
constructor(params:
|
|
1356
|
+
declare class ElasticDashEvent extends ElasticDashBaseObservation {
|
|
1357
|
+
constructor(params: ElasticDashEventParams);
|
|
1358
1358
|
}
|
|
1359
1359
|
|
|
1360
1360
|
/**
|
|
@@ -1383,8 +1383,8 @@ declare class LangfuseEvent extends LangfuseBaseObservation {
|
|
|
1383
1383
|
*
|
|
1384
1384
|
* @public
|
|
1385
1385
|
*/
|
|
1386
|
-
declare function createTraceAttributes({ name, userId, sessionId, version, release, input, output, metadata, tags, environment, public: isPublic, }?:
|
|
1387
|
-
declare function createObservationAttributes(type:
|
|
1386
|
+
declare function createTraceAttributes({ name, userId, sessionId, version, release, input, output, metadata, tags, environment, public: isPublic, }?: ElasticDashTraceAttributes): Attributes;
|
|
1387
|
+
declare function createObservationAttributes(type: ElasticDashObservationType, attributes: ElasticDashObservationAttributes): Attributes;
|
|
1388
1388
|
|
|
1389
1389
|
/**
|
|
1390
1390
|
* Sets an isolated TracerProvider for ElasticDash tracing operations.
|
|
@@ -1413,42 +1413,42 @@ declare function createObservationAttributes(type: LangfuseObservationType, attr
|
|
|
1413
1413
|
* @example
|
|
1414
1414
|
* ```typescript
|
|
1415
1415
|
* import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
|
|
1416
|
-
* import {
|
|
1417
|
-
* import {
|
|
1416
|
+
* import { ElasticDashSpanProcessor } from '@elasticdash/otel';
|
|
1417
|
+
* import { setElasticDashTracerProvider } from '@elasticdash/tracing';
|
|
1418
1418
|
*
|
|
1419
1419
|
* // Create provider with span processors in constructor
|
|
1420
1420
|
* const provider = new NodeTracerProvider({
|
|
1421
|
-
* spanProcessors: [new
|
|
1421
|
+
* spanProcessors: [new ElasticDashSpanProcessor()]
|
|
1422
1422
|
* });
|
|
1423
1423
|
*
|
|
1424
|
-
*
|
|
1424
|
+
* setElasticDashTracerProvider(provider);
|
|
1425
1425
|
*
|
|
1426
|
-
* // Note: Spans created with
|
|
1426
|
+
* // Note: Spans created with getElasticDashTracer() may still inherit
|
|
1427
1427
|
* // context from spans created with the global tracer
|
|
1428
1428
|
* ```
|
|
1429
1429
|
*
|
|
1430
1430
|
* @param provider - The TracerProvider instance to use, or null to clear the isolated provider
|
|
1431
1431
|
* @public
|
|
1432
1432
|
*/
|
|
1433
|
-
declare function
|
|
1433
|
+
declare function setElasticDashTracerProvider(provider: TracerProvider | null): void;
|
|
1434
1434
|
/**
|
|
1435
1435
|
* Gets the TracerProvider for ElasticDash tracing operations.
|
|
1436
1436
|
*
|
|
1437
|
-
* Returns the isolated TracerProvider if one has been set via
|
|
1437
|
+
* Returns the isolated TracerProvider if one has been set via setElasticDashTracerProvider(),
|
|
1438
1438
|
* otherwise falls back to the global OpenTelemetry TracerProvider.
|
|
1439
1439
|
*
|
|
1440
1440
|
* @example
|
|
1441
1441
|
* ```typescript
|
|
1442
|
-
* import {
|
|
1442
|
+
* import { getElasticDashTracerProvider } from '@elasticdash/tracing';
|
|
1443
1443
|
*
|
|
1444
|
-
* const provider =
|
|
1444
|
+
* const provider = getElasticDashTracerProvider();
|
|
1445
1445
|
* const tracer = provider.getTracer('my-tracer', '1.0.0');
|
|
1446
1446
|
* ```
|
|
1447
1447
|
*
|
|
1448
1448
|
* @returns The TracerProvider instance to use for ElasticDash tracing
|
|
1449
1449
|
* @public
|
|
1450
1450
|
*/
|
|
1451
|
-
declare function
|
|
1451
|
+
declare function getElasticDashTracerProvider(): TracerProvider;
|
|
1452
1452
|
/**
|
|
1453
1453
|
* Gets the OpenTelemetry tracer instance for ElasticDash.
|
|
1454
1454
|
*
|
|
@@ -1460,15 +1460,15 @@ declare function getLangfuseTracerProvider(): TracerProvider;
|
|
|
1460
1460
|
*
|
|
1461
1461
|
* @example
|
|
1462
1462
|
* ```typescript
|
|
1463
|
-
* import {
|
|
1463
|
+
* import { getElasticDashTracer } from '@elasticdash/tracing';
|
|
1464
1464
|
*
|
|
1465
|
-
* const tracer =
|
|
1465
|
+
* const tracer = getElasticDashTracer();
|
|
1466
1466
|
* const span = tracer.startSpan('my-operation');
|
|
1467
1467
|
* ```
|
|
1468
1468
|
*
|
|
1469
1469
|
* @public
|
|
1470
1470
|
*/
|
|
1471
|
-
declare function
|
|
1471
|
+
declare function getElasticDashTracer(): _opentelemetry_api.Tracer;
|
|
1472
1472
|
|
|
1473
1473
|
/**
|
|
1474
1474
|
* Options for starting observations (spans, generations, events).
|
|
@@ -1499,7 +1499,7 @@ type StartActiveObservationContext = StartObservationOptions & {
|
|
|
1499
1499
|
*/
|
|
1500
1500
|
type StartObservationOpts = StartObservationOptions & {
|
|
1501
1501
|
/** Type of observation to create. Defaults to 'span' */
|
|
1502
|
-
asType?:
|
|
1502
|
+
asType?: ElasticDashObservationType;
|
|
1503
1503
|
};
|
|
1504
1504
|
/**
|
|
1505
1505
|
* Options for startActiveObservation function.
|
|
@@ -1508,63 +1508,63 @@ type StartObservationOpts = StartObservationOptions & {
|
|
|
1508
1508
|
*/
|
|
1509
1509
|
type StartActiveObservationOpts = StartActiveObservationContext & {
|
|
1510
1510
|
/** Type of observation to create. Defaults to 'span' */
|
|
1511
|
-
asType?:
|
|
1511
|
+
asType?: ElasticDashObservationType;
|
|
1512
1512
|
};
|
|
1513
|
-
declare function startObservation(name: string, attributes:
|
|
1513
|
+
declare function startObservation(name: string, attributes: ElasticDashGenerationAttributes, options: StartObservationOpts & {
|
|
1514
1514
|
asType: "generation";
|
|
1515
|
-
}):
|
|
1516
|
-
declare function startObservation(name: string, attributes:
|
|
1515
|
+
}): ElasticDashGeneration;
|
|
1516
|
+
declare function startObservation(name: string, attributes: ElasticDashEventAttributes, options: StartObservationOpts & {
|
|
1517
1517
|
asType: "event";
|
|
1518
|
-
}):
|
|
1519
|
-
declare function startObservation(name: string, attributes:
|
|
1518
|
+
}): ElasticDashEvent;
|
|
1519
|
+
declare function startObservation(name: string, attributes: ElasticDashAgentAttributes, options: StartObservationOpts & {
|
|
1520
1520
|
asType: "agent";
|
|
1521
|
-
}):
|
|
1522
|
-
declare function startObservation(name: string, attributes:
|
|
1521
|
+
}): ElasticDashAgent;
|
|
1522
|
+
declare function startObservation(name: string, attributes: ElasticDashToolAttributes, options: StartObservationOpts & {
|
|
1523
1523
|
asType: "tool";
|
|
1524
|
-
}):
|
|
1525
|
-
declare function startObservation(name: string, attributes:
|
|
1524
|
+
}): ElasticDashTool;
|
|
1525
|
+
declare function startObservation(name: string, attributes: ElasticDashChainAttributes, options: StartObservationOpts & {
|
|
1526
1526
|
asType: "chain";
|
|
1527
|
-
}):
|
|
1528
|
-
declare function startObservation(name: string, attributes:
|
|
1527
|
+
}): ElasticDashChain;
|
|
1528
|
+
declare function startObservation(name: string, attributes: ElasticDashRetrieverAttributes, options: StartObservationOpts & {
|
|
1529
1529
|
asType: "retriever";
|
|
1530
|
-
}):
|
|
1531
|
-
declare function startObservation(name: string, attributes:
|
|
1530
|
+
}): ElasticDashRetriever;
|
|
1531
|
+
declare function startObservation(name: string, attributes: ElasticDashEvaluatorAttributes, options: StartObservationOpts & {
|
|
1532
1532
|
asType: "evaluator";
|
|
1533
|
-
}):
|
|
1534
|
-
declare function startObservation(name: string, attributes:
|
|
1533
|
+
}): ElasticDashEvaluator;
|
|
1534
|
+
declare function startObservation(name: string, attributes: ElasticDashGuardrailAttributes, options: StartObservationOpts & {
|
|
1535
1535
|
asType: "guardrail";
|
|
1536
|
-
}):
|
|
1537
|
-
declare function startObservation(name: string, attributes:
|
|
1536
|
+
}): ElasticDashGuardrail;
|
|
1537
|
+
declare function startObservation(name: string, attributes: ElasticDashEmbeddingAttributes, options: StartObservationOpts & {
|
|
1538
1538
|
asType: "embedding";
|
|
1539
|
-
}):
|
|
1540
|
-
declare function startObservation(name: string, attributes?:
|
|
1539
|
+
}): ElasticDashEmbedding;
|
|
1540
|
+
declare function startObservation(name: string, attributes?: ElasticDashSpanAttributes, options?: StartObservationOpts & {
|
|
1541
1541
|
asType?: "span";
|
|
1542
|
-
}):
|
|
1543
|
-
declare function startActiveObservation<F extends (generation:
|
|
1542
|
+
}): ElasticDashSpan;
|
|
1543
|
+
declare function startActiveObservation<F extends (generation: ElasticDashGeneration) => unknown>(name: string, fn: F, options: StartActiveObservationOpts & {
|
|
1544
1544
|
asType: "generation";
|
|
1545
1545
|
}): ReturnType<F>;
|
|
1546
|
-
declare function startActiveObservation<F extends (embedding:
|
|
1546
|
+
declare function startActiveObservation<F extends (embedding: ElasticDashEmbedding) => unknown>(name: string, fn: F, options: StartActiveObservationOpts & {
|
|
1547
1547
|
asType: "embedding";
|
|
1548
1548
|
}): ReturnType<F>;
|
|
1549
|
-
declare function startActiveObservation<F extends (agent:
|
|
1549
|
+
declare function startActiveObservation<F extends (agent: ElasticDashAgent) => unknown>(name: string, fn: F, options: StartActiveObservationOpts & {
|
|
1550
1550
|
asType: "agent";
|
|
1551
1551
|
}): ReturnType<F>;
|
|
1552
|
-
declare function startActiveObservation<F extends (tool:
|
|
1552
|
+
declare function startActiveObservation<F extends (tool: ElasticDashTool) => unknown>(name: string, fn: F, options: StartActiveObservationOpts & {
|
|
1553
1553
|
asType: "tool";
|
|
1554
1554
|
}): ReturnType<F>;
|
|
1555
|
-
declare function startActiveObservation<F extends (chain:
|
|
1555
|
+
declare function startActiveObservation<F extends (chain: ElasticDashChain) => unknown>(name: string, fn: F, options: StartActiveObservationOpts & {
|
|
1556
1556
|
asType: "chain";
|
|
1557
1557
|
}): ReturnType<F>;
|
|
1558
|
-
declare function startActiveObservation<F extends (retriever:
|
|
1558
|
+
declare function startActiveObservation<F extends (retriever: ElasticDashRetriever) => unknown>(name: string, fn: F, options: StartActiveObservationOpts & {
|
|
1559
1559
|
asType: "retriever";
|
|
1560
1560
|
}): ReturnType<F>;
|
|
1561
|
-
declare function startActiveObservation<F extends (evaluator:
|
|
1561
|
+
declare function startActiveObservation<F extends (evaluator: ElasticDashEvaluator) => unknown>(name: string, fn: F, options: StartActiveObservationOpts & {
|
|
1562
1562
|
asType: "evaluator";
|
|
1563
1563
|
}): ReturnType<F>;
|
|
1564
|
-
declare function startActiveObservation<F extends (guardrail:
|
|
1564
|
+
declare function startActiveObservation<F extends (guardrail: ElasticDashGuardrail) => unknown>(name: string, fn: F, options: StartActiveObservationOpts & {
|
|
1565
1565
|
asType: "guardrail";
|
|
1566
1566
|
}): ReturnType<F>;
|
|
1567
|
-
declare function startActiveObservation<F extends (span:
|
|
1567
|
+
declare function startActiveObservation<F extends (span: ElasticDashSpan) => unknown>(name: string, fn: F, options?: StartActiveObservationOpts & {
|
|
1568
1568
|
asType?: "span";
|
|
1569
1569
|
}): ReturnType<F>;
|
|
1570
1570
|
/**
|
|
@@ -1591,7 +1591,7 @@ declare function startActiveObservation<F extends (span: LangfuseSpan) => unknow
|
|
|
1591
1591
|
*
|
|
1592
1592
|
* @public
|
|
1593
1593
|
*/
|
|
1594
|
-
declare function updateActiveTrace(attributes:
|
|
1594
|
+
declare function updateActiveTrace(attributes: ElasticDashTraceAttributes): void;
|
|
1595
1595
|
/**
|
|
1596
1596
|
* Updates the currently active observation with new attributes.
|
|
1597
1597
|
*
|
|
@@ -1723,31 +1723,31 @@ declare function updateActiveTrace(attributes: LangfuseTraceAttributes): void;
|
|
|
1723
1723
|
*
|
|
1724
1724
|
* @public
|
|
1725
1725
|
*/
|
|
1726
|
-
declare function updateActiveObservation(attributes:
|
|
1726
|
+
declare function updateActiveObservation(attributes: ElasticDashSpanAttributes, options?: {
|
|
1727
1727
|
asType: "span";
|
|
1728
1728
|
}): void;
|
|
1729
|
-
declare function updateActiveObservation(attributes:
|
|
1729
|
+
declare function updateActiveObservation(attributes: ElasticDashGenerationAttributes, options: {
|
|
1730
1730
|
asType: "generation";
|
|
1731
1731
|
}): void;
|
|
1732
|
-
declare function updateActiveObservation(attributes:
|
|
1732
|
+
declare function updateActiveObservation(attributes: ElasticDashAgentAttributes, options: {
|
|
1733
1733
|
asType: "agent";
|
|
1734
1734
|
}): void;
|
|
1735
|
-
declare function updateActiveObservation(attributes:
|
|
1735
|
+
declare function updateActiveObservation(attributes: ElasticDashToolAttributes, options: {
|
|
1736
1736
|
asType: "tool";
|
|
1737
1737
|
}): void;
|
|
1738
|
-
declare function updateActiveObservation(attributes:
|
|
1738
|
+
declare function updateActiveObservation(attributes: ElasticDashChainAttributes, options: {
|
|
1739
1739
|
asType: "chain";
|
|
1740
1740
|
}): void;
|
|
1741
|
-
declare function updateActiveObservation(attributes:
|
|
1741
|
+
declare function updateActiveObservation(attributes: ElasticDashEmbeddingAttributes, options: {
|
|
1742
1742
|
asType: "embedding";
|
|
1743
1743
|
}): void;
|
|
1744
|
-
declare function updateActiveObservation(attributes:
|
|
1744
|
+
declare function updateActiveObservation(attributes: ElasticDashEvaluatorAttributes, options: {
|
|
1745
1745
|
asType: "evaluator";
|
|
1746
1746
|
}): void;
|
|
1747
|
-
declare function updateActiveObservation(attributes:
|
|
1747
|
+
declare function updateActiveObservation(attributes: ElasticDashGuardrailAttributes, options: {
|
|
1748
1748
|
asType: "guardrail";
|
|
1749
1749
|
}): void;
|
|
1750
|
-
declare function updateActiveObservation(attributes:
|
|
1750
|
+
declare function updateActiveObservation(attributes: ElasticDashRetrieverAttributes, options: {
|
|
1751
1751
|
asType: "retriever";
|
|
1752
1752
|
}): void;
|
|
1753
1753
|
/**
|
|
@@ -1759,7 +1759,7 @@ interface ObserveOptions {
|
|
|
1759
1759
|
/** Name for the observation (defaults to function name) */
|
|
1760
1760
|
name?: string;
|
|
1761
1761
|
/** Type of observation to create */
|
|
1762
|
-
asType?:
|
|
1762
|
+
asType?: ElasticDashObservationType;
|
|
1763
1763
|
/** Whether to capture function input as observation input */
|
|
1764
1764
|
captureInput?: boolean;
|
|
1765
1765
|
/** Whether to capture function output as observation output */
|
|
@@ -2087,4 +2087,4 @@ declare function getActiveTraceId(): string | undefined;
|
|
|
2087
2087
|
*/
|
|
2088
2088
|
declare function getActiveSpanId(): string | undefined;
|
|
2089
2089
|
|
|
2090
|
-
export {
|
|
2090
|
+
export { ElasticDashAgent, ElasticDashChain, ElasticDashEmbedding, ElasticDashEvaluator, ElasticDashEvent, type ElasticDashEventAttributes, ElasticDashGeneration, type ElasticDashGenerationAttributes, ElasticDashGuardrail, type ElasticDashObservation, type ElasticDashObservationAttributes, type ElasticDashObservationType, ElasticDashRetriever, ElasticDashSpan, type ElasticDashSpanAttributes, ElasticDashTool, type ElasticDashTraceAttributes, type ObservationLevel, type ObserveOptions, type StartActiveObservationContext, type StartActiveObservationOpts, type StartObservationOptions, type StartObservationOpts, createObservationAttributes, createTraceAttributes, createTraceId, getActiveSpanId, getActiveTraceId, getElasticDashTracer, getElasticDashTracerProvider, observe, setElasticDashTracerProvider, startActiveObservation, startObservation, updateActiveObservation, updateActiveTrace };
|