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.

4.2 KB
Raw Blame
import { useValues } from 'kea'

import { dayjs } from 'lib/dayjs'
import { Tooltip } from 'lib/lemon-ui/Tooltip'
import { cn } from 'lib/utils/css-classes'
import { capitalizeFirstLetter } from 'lib/utils/strings'
import { availableOnboardingProducts, toSentenceCase } from 'scenes/onboarding/shared/utils'

import type { OnboardingProduct } from '~/types'

import type { DataFreshnessSourceApi } from 'products/platform_features/frontend/generated/api.schemas'

import { projectDataFreshnessLogic } from './projectDataFreshnessLogic'

/**
 * `data_source` is a `ProductKey`, so onboarding's product catalog is the maintained name for
 * it and a rename lands here for free. It's Title Case there, hence `toSentenceCase`, which
 * also keeps short acronyms intact ("AI observability", not "Ai observability").
 *
 * Products the catalog doesn't list fall back to humanizing the key, which is right for the
 * ones whose name is just the key ("Tracing").
 */
function dataSourceLabel(source: string): string {
    const catalogued = (availableOnboardingProducts as Partial<Record<string, OnboardingProduct>>)[source]
    return catalogued ? toSentenceCase(catalogued.name) : capitalizeFirstLetter(source.replace(/_/g, ' '))
}

function SourceBreakdown({
    sources,
    quietAfterDays,
}: {
    sources: DataFreshnessSourceApi[]
    quietAfterDays: number
}): JSX.Element | null {
    if (!sources.length) {
        return null
    }
    return (
        <div className="flex flex-col gap-0.5 mt-1">
            {sources.map((source) => {
                const isStale = dayjs().diff(dayjs(source.last_data_at), 'day') >= quietAfterDays
                return (
                    <div key={source.data_source} className="flex items-center justify-between gap-4">
                        <span>{dataSourceLabel(source.data_source)}</span>
                        <span className={cn('shrink-0', isStale && 'text-tertiary')}>
                            {dayjs(source.last_data_at).fromNow()}
                        </span>
                    </div>
                )
            })}
        </div>
    )
}

/**
 * A warning on projects that have stopped receiving data, and nothing at all on the ones that
 * haven't. The label says what the duration measures rather than leaving a bare `12d` for the
 * reader to interpret, because there is no column header in a menu to explain it.
 *
 * A project that has never received anything is stated plainly rather than warned about: a
 * project created a minute ago legitimately has no data, and amber on it would be wrong.
 */
export function ProjectFreshnessIndicator({
    teamId,
    className,
}: {
    teamId: number
    className?: string
}): JSX.Element | null {
    const { dataFreshness, freshnessByTeamId } = useValues(projectDataFreshnessLogic)

    const freshness = freshnessByTeamId[teamId]
    if (!dataFreshness || !freshness || freshness.freshness === 'live') {
        return null
    }

    let label: string
    let headline: string

    if (freshness.freshness === 'never') {
        label = 'No data yet'
        headline = 'This project has never received any data.'
    } else if (!freshness.last_data_at) {
        // Every probe is bounded to the lookback window, so this is as far back as we can see.
        label = `No data for ${dataFreshness.lookback_days}d+`
        headline = `No data of any kind has reached this project in over ${dataFreshness.lookback_days} days.`
    } else {
        label = `No data for ${dayjs().diff(dayjs(freshness.last_data_at), 'day')}d`
        headline = `No data of any kind has reached this project since ${dayjs(freshness.last_data_at).fromNow()}.`
    }

    return (
        <Tooltip
            placement="right"
            title={
                <div className="max-w-xs">
                    <span>{headline}</span>
                    <SourceBreakdown sources={freshness.sources} quietAfterDays={dataFreshness.quiet_after_days} />
                </div>
            }
        >
            <span
                className={cn(
                    'text-xxs shrink-0 ml-1 whitespace-nowrap',
                    freshness.freshness === 'never' ? 'text-tertiary' : 'text-warning',
                    className
                )}
            >
                {label}
            </span>
        </Tooltip>
    )
}