mirror of
https://github.com/forcedotcom/afv-library.git
synced 2026-07-30 11:43:26 +08:00
56 lines
2.1 KiB
SQL
56 lines
2.1 KiB
SQL
-- Agent Platform Tracing spans — OpenTelemetry span tree per trace.
|
|
-- DMO: ssot__TelemetryTraceSpan__dlm
|
|
--
|
|
-- Placeholders (substituted by scripts/dc.py.load_sql):
|
|
-- WHERE_CLAUSE — the filter expression, no "WHERE" keyword
|
|
-- ORDER_BY — full "ORDER BY <col>" or empty string
|
|
--
|
|
-- Provisioned only when **Agent Platform Tracing** is enabled (Setup →
|
|
-- Einstein Audit, Analytics, and Monitoring Setup). Captures spans from
|
|
-- Apex, Flows, Prompt Builder, Invocable Actions, Planner, AI Gateway,
|
|
-- LLM Gateway, DC Query Federator.
|
|
--
|
|
-- Join to STDM: `ssot__TelemetryTrace__c = Interaction.ssot__TelemetryTraceId__c`.
|
|
-- Parent/child within a trace: `ssot__TelemetryParentSpanId__c = <another span>.ssot__Id__c`.
|
|
|
|
SELECT
|
|
ssot__Id__c,
|
|
ssot__TelemetryTrace__c,
|
|
ssot__TelemetryParentSpanId__c,
|
|
ssot__OperationName__c,
|
|
ssot__ServiceName__c,
|
|
ssot__SpanKind__c,
|
|
ssot__StatusCode__c,
|
|
ssot__StartDateTime__c,
|
|
ssot__EndDateTime__c,
|
|
ssot__DurationNumber__c,
|
|
ssot__TelemetrySpanAttributeText__c,
|
|
ssot__InternalOrganizationId__c
|
|
FROM ssot__TelemetryTraceSpan__dlm
|
|
WHERE {{WHERE_CLAUSE}}
|
|
{{ORDER_BY}};
|
|
|
|
|
|
-- ============================================================================
|
|
-- EXAMPLE WHERE clauses (pass via where_clause=)
|
|
-- ============================================================================
|
|
|
|
-- All spans for one trace (joins to Interaction.ssot__TelemetryTraceId__c)
|
|
-- WHERE → ssot__TelemetryTrace__c = '<trace_id>'
|
|
-- ORDER BY → ORDER BY ssot__StartDateTime__c
|
|
|
|
-- All spans for a set of traces (whole session)
|
|
-- WHERE → ssot__TelemetryTrace__c IN ('<trace_id1>','<trace_id2>',...)
|
|
|
|
-- Only root spans (no parent)
|
|
-- WHERE → ssot__TelemetryTrace__c = '<trace_id>'
|
|
-- AND ssot__TelemetryParentSpanId__c = null
|
|
|
|
-- Only spans from a specific service
|
|
-- WHERE → ssot__TelemetryTrace__c = '<trace_id>'
|
|
-- AND ssot__ServiceName__c = 'Atlas Reasoning Engine'
|
|
|
|
-- Slow spans — duration > 1s (nanoseconds in DurationNumber)
|
|
-- WHERE → ssot__TelemetryTrace__c = '<trace_id>'
|
|
-- AND ssot__DurationNumber__c > 1000000000
|