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.

feat(replay): explain an empty backend logs session in the inspector (#121237)

Jon McCallum5c6e51fc7d8a
diff --git a/frontend/snapshots.yml b/frontend/snapshots.yml
index 98fbd14a4476..074563cb568d 100644
--- a/frontend/snapshots.yml
+++ b/frontend/snapshots.yml
@@ -2248,6 +2248,10 @@ snapshots:
hash: v1.k794b7964.a3e65d5201b873423bb6d077e88fcad12715ee293bdedcf5a2dc78efbc2d0cda.VSPF0yHLd7eCx-17S2ASvg21MoomuY6VOjuxq3oPQmI
components-playerinspector-itemsessionchange--session-previous--light:
hash: v1.k794b7964.33ce327f146d06d1412d431080ac84ae39558411b2073fe18a2ed98d834a2681.FDbDlC4-qfrH2RR1F_KpijnZNM9Ss_4s-p19Ee8fGtY
+ components-playerinspector-sessionlogsunavailablenotice--default--dark:
+ hash: v1.k794b7964.b6b8ea64af0cc80b7837a554c409ef83db23b59b62e1f5902299c81200f9bc08.pI2W9R5niCsyBy9b5gz7KCCuhXyUrbjLeSn94JOGfqQ
+ components-playerinspector-sessionlogsunavailablenotice--default--light:
+ hash: v1.k794b7964.def1a94101924d9ba1ed9839e75996bf4e441ab7a8a87c9d40c562aa3fcf8e52.Ki2JETBTO6hceqCmhd1tECfaeBKraUttdpRd-OjGkFo
components-playground-variables-panel--filled-and-unfilled-variables--dark:
hash: v1.k794b7964.d28a4b122342606c71fde8cfe726699c638c612006427700a69f4583ac90c0f7.vg3kJyg8C3Yq4hkjUqsB1V7Yzn8CH_HJQKRN-uZU3w0
components-playground-variables-panel--filled-and-unfilled-variables--light:
diff --git a/frontend/src/scenes/session-recordings/player/inspector/PlayerInspectorControls.tsx b/frontend/src/scenes/session-recordings/player/inspector/PlayerInspectorControls.tsx
index a8580b9a8bbc..05acef28c734 100644
--- a/frontend/src/scenes/session-recordings/player/inspector/PlayerInspectorControls.tsx
+++ b/frontend/src/scenes/session-recordings/player/inspector/PlayerInspectorControls.tsx
@@ -15,7 +15,7 @@ import {
IconStethoscope,
IconTerminal,
} from '@posthog/icons'
-import { LemonButton, LemonInput, SideAction, Tooltip } from '@posthog/lemon-ui'
+import { LemonButton, LemonDropdown, LemonInput, SideAction, Tooltip } from '@posthog/lemon-ui'
import { SettingsBar, SettingsButton, SettingsToggle } from 'lib/components/PanelSettings/PanelSettings'
import { FEATURE_FLAGS } from 'lib/constants'
@@ -33,6 +33,7 @@ import { urls } from 'scenes/urls'
import { SessionRecordingPlayerMode, sessionRecordingPlayerLogic } from '../sessionRecordingPlayerLogic'
import { InspectorSearchInfo } from './components/InspectorSearchInfo'
+import { SessionLogsUnavailableNotice } from './components/SessionLogsUnavailableNotice'
function sideActionForType({
type,
@@ -281,16 +282,46 @@ function CommentsFilterSettingsButton(): JSX.Element {
function LogsFilterSettingsButton(): JSX.Element {
const { logicProps } = useValues(sessionRecordingPlayerLogic)
- const { allItemsByItemType, logsLoading, logsLoadError } = useValues(playerInspectorLogic(logicProps))
+ const { allItemsByItemType, logsLoading, logsLoadError, logsInitialLoadRequested } = useValues(
+ playerInspectorLogic(logicProps)
+ )
const hasLogItems = allItemsByItemType['logs']?.length > 0
+ const showLogsUpsell = logsInitialLoadRequested && !logsLoading && !logsLoadError && !hasLogItems
+
+ useEffect(() => {
+ if (showLogsUpsell) {
+ posthog.capture('recording inspector upsell shown', { type: 'logs' })
+ }
+ }, [showLogsUpsell])
+
+ if (showLogsUpsell) {
+ return (
+ <div className="SettingsBar--button--square">
+ <LemonDropdown
+ overlay={<SessionLogsUnavailableNotice sessionId={logicProps.sessionRecordingId} />}
+ closeOnClickInside={false}
+ placement="bottom-end"
+ >
+ <LemonButton
+ className="rounded-[0px]"
+ size="xsmall"
+ icon={<IconLive />}
+ data-attr="player-inspector-logs-unavailable"
+ >
+ Logs
+ </LemonButton>
+ </LemonDropdown>
+ </div>
+ )
+ }
const disabledReason = logsLoading
? 'Loading logs...'
- : logsLoadError
- ? 'Failed to load logs for this session'
- : !hasLogItems
- ? 'No logs found for this session'
+ : !logsInitialLoadRequested
+ ? "Logs load after the recording's events load"
+ : logsLoadError
+ ? 'Failed to load logs for this session'
: undefined
return (
diff --git a/frontend/src/scenes/session-recordings/player/inspector/components/SessionLogsUnavailableNotice.stories.tsx b/frontend/src/scenes/session-recordings/player/inspector/components/SessionLogsUnavailableNotice.stories.tsx
new file mode 100644
index 000000000000..4ffd39bce5bb
--- /dev/null
+++ b/frontend/src/scenes/session-recordings/player/inspector/components/SessionLogsUnavailableNotice.stories.tsx
@@ -0,0 +1,19 @@
+import type { Meta, StoryObj } from '@storybook/react'
+
+import { SessionLogsUnavailableNotice } from 'scenes/session-recordings/player/inspector/components/SessionLogsUnavailableNotice'
+
+type Story = StoryObj<typeof SessionLogsUnavailableNotice>
+const meta: Meta<typeof SessionLogsUnavailableNotice> = {
+ title: 'Components/PlayerInspector/SessionLogsUnavailableNotice',
+ component: SessionLogsUnavailableNotice,
+ render: (props) => (
+ <div className="w-100 border rounded bg-surface-primary">
+ <SessionLogsUnavailableNotice {...props} />
+ </div>
+ ),
+}
+export default meta
+
+export const Default: Story = {
+ args: { sessionId: '01900000-0000-0000-0000-000000000001' },
+}
diff --git a/frontend/src/scenes/session-recordings/player/inspector/components/SessionLogsUnavailableNotice.tsx b/frontend/src/scenes/session-recordings/player/inspector/components/SessionLogsUnavailableNotice.tsx
new file mode 100644
index 000000000000..9be4f87fa4e0
--- /dev/null
+++ b/frontend/src/scenes/session-recordings/player/inspector/components/SessionLogsUnavailableNotice.tsx
@@ -0,0 +1,43 @@
+import { Link } from '@posthog/lemon-ui'
+
+import { CopyToClipboardInline } from 'lib/components/CopyToClipboard'
+import { urls } from 'scenes/urls'
+
+export function SessionLogsUnavailableNotice({ sessionId }: { sessionId: string }): JSX.Element {
+ return (
+ <div className="flex flex-col gap-1.5 p-2 max-w-100" data-attr="player-inspector-logs-unavailable-notice">
+ <span className="font-semibold">No logs in this session</span>
+ <p className="m-0">
+ PostHog has no logs linked to this session. Your backend may not send logs to PostHog, or its logs may
+ not include the session ID. New logs can take a few minutes to appear.
+ </p>
+ <div className="flex items-center gap-x-3 gap-y-1 flex-wrap text-xs text-muted">
+ <span>
+ Session ID:{' '}
+ <CopyToClipboardInline
+ explicitValue={sessionId}
+ description="session ID"
+ iconSize="xsmall"
+ iconPosition="end"
+ className="font-mono"
+ >
+ {sessionId}
+ </CopyToClipboardInline>
+ </span>
+ <Link
+ to="https://posthog.com/docs/logs/link-session-replay"
+ target="_blank"
+ data-attr="player-inspector-logs-unavailable-docs"
+ >
+ Link logs to sessions
+ </Link>
+ <Link
+ to={urls.settings('environment-logs', 'logs-session-id-attribute-keys')}
+ data-attr="player-inspector-logs-unavailable-settings"
+ >
+ Session ID settings
+ </Link>
+ </div>
+ </div>
+ )
+}