Skip to content

:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.

2.1 KB
Raw Blame
import { makeSpan } from './__mocks__/span'
import { resolveTraceIdentity, type TraceIdentity } from './traceIdentity'
import type { Span } from './types'

describe('resolveTraceIdentity', () => {
    const cases: {
        name: string
        spans: Span[]
        distinctIdKeys?: string[]
        sessionIdKeys?: string[]
        expected: TraceIdentity
    }[] = [
        {
            name: 'reads an identity carried by a later span, not just the first',
            spans: [makeSpan({}), makeSpan({ attributes: { posthogDistinctId: 'user-1', sessionId: 'session-1' } })],
            expected: { distinctId: 'user-1', sessionId: 'session-1' },
        },
        {
            name: 'drops a value the spans disagree on, and keeps the one they agree on',
            spans: [
                makeSpan({ attributes: { posthogDistinctId: 'user-1', sessionId: 'session-1' } }),
                makeSpan({ attributes: { posthogDistinctId: 'user-2', sessionId: 'session-1' } }),
            ],
            expected: { distinctId: null, sessionId: 'session-1' },
        },
        {
            name: 'resolves nothing from spans that carry no correlation keys',
            spans: [makeSpan({ attributes: { 'http.method': 'GET' }, resource_attributes: { 'k8s.pod.name': 'p' } })],
            expected: { distinctId: null, sessionId: null },
        },
        {
            name: 'prefers a configured key over a convention key on the same span',
            spans: [makeSpan({ attributes: { 'user.id': 'configured-user', posthogDistinctId: 'convention-user' } })],
            distinctIdKeys: ['user.id'],
            expected: { distinctId: 'configured-user', sessionId: null },
        },
        {
            name: 'falls back to resource attributes when the span attributes carry nothing',
            spans: [makeSpan({ resource_attributes: { posthogDistinctId: 'user-1', sessionId: 'session-1' } })],
            expected: { distinctId: 'user-1', sessionId: 'session-1' },
        },
    ]

    test.each(cases)('$name', ({ spans, distinctIdKeys, sessionIdKeys, expected }) => {
        expect(resolveTraceIdentity(spans, distinctIdKeys, sessionIdKeys)).toEqual(expected)
    })
})