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.

3.8 KB
Raw Blame
import { useMemo } from 'react'

import { LemonTag, Tooltip } from '@posthog/lemon-ui'

import { IconRobot } from 'lib/lemon-ui/icons'
import { CATEGORY_LABELS } from 'lib/utils/botDetection'

import { LiveEvent } from '~/types'

const TOP_BOT_LIMIT = 5

interface BotTotals {
    total: number
    byName: Map<string, { name: string; category: string; count: number }>
}

const aggregateBots = (events: LiveEvent[]): BotTotals => {
    const byName = new Map<string, { name: string; category: string; count: number }>()
    let total = 0

    for (const event of events) {
        if (!event.properties?.$virt_is_bot) {
            continue
        }
        const botName = event.properties.$virt_bot_name as string | undefined
        const botCategory = event.properties.$virt_traffic_category as string | undefined

        if (!botName) {
            continue
        }
        total += 1
        const categoryLabel = (CATEGORY_LABELS as Record<string, string>)[botCategory ?? ''] ?? botCategory ?? ''
        const existing = byName.get(botName)
        if (existing) {
            existing.count += 1
        } else {
            byName.set(botName, {
                name: botName,
                category: categoryLabel,
                count: 1,
            })
        }
    }

    return { total, byName }
}

export interface LiveBotPanelProps {
    events: LiveEvent[]
    className?: string
}

export function LiveBotPanel({ events, className }: LiveBotPanelProps): JSX.Element | null {
    const { total, byName } = useMemo(() => aggregateBots(events), [events])

    if (events.length === 0) {
        return null
    }

    const topBots = [...byName.values()].sort((a, b) => b.count - a.count).slice(0, TOP_BOT_LIMIT)
    const regularCount = events.length - total
    const botShare = events.length > 0 ? (total / events.length) * 100 : 0

    return (
        <div
            className={`flex flex-wrap items-center gap-2 rounded-md border border-border bg-bg-light px-3 py-2 text-xs ${
                className ?? ''
            }`}
        >
            <Tooltip title="Bot detection is based on known user agent patterns for crawlers, AI agents, monitoring tools and automation frameworks.">
                <span className="flex items-center gap-1 font-medium text-default">
                    <IconRobot className="text-sm text-muted" />
                    Bot traffic
                </span>
            </Tooltip>

            <span className="tabular-nums text-muted">
                <span className="font-medium text-default">{total.toLocaleString()}</span> bot events of{' '}
                <span className="tabular-nums">{events.length.toLocaleString()}</span>
                {` · `}
                {botShare.toFixed(botShare < 10 ? 1 : 0)}%
            </span>

            {regularCount > 0 && (
                <span className="text-muted hidden sm:inline">({regularCount.toLocaleString()} regular)</span>
            )}

            {topBots.length > 0 && (
                <>
                    <span className="text-muted">·</span>
                    <div className="flex flex-wrap items-center gap-1">
                        {topBots.map((bot) => (
                            <Tooltip key={bot.name} title={`${bot.count.toLocaleString()} events · ${bot.category}`}>
                                <LemonTag type="muted" size="small" className="text-[11px]">
                                    {bot.name} · {bot.count.toLocaleString()}
                                </LemonTag>
                            </Tooltip>
                        ))}
                        {byName.size > TOP_BOT_LIMIT && (
                            <span className="text-muted">+{byName.size - TOP_BOT_LIMIT} more</span>
                        )}
                    </div>
                </>
            )}
        </div>
    )
}