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.8 KB
Raw Blame
/**
 * How many projects a breakdown by project shows individually before the rest are folded
 * into one "all other projects" series. Shared by the usage and spend dashboards so the two
 * behave the same way.
 *
 * The billing service applies no cap a caller did not ask for, so this is the only default: a
 * chart-friendly number of series, with the rest folded into one so the totals still reconcile.
 */
export const DEFAULT_TOP_PROJECTS = 20

export const TOP_PROJECTS_OPTIONS = [10, 20, 50, 100]

/**
 * Rows per page in the usage and spend breakdown tables.
 *
 * Every row carries a checkbox, a colour swatch and one cell per day in the range, so the table
 * is wide as well as long. Rendering every row at once is unusable for an organization with
 * thousands of projects. The pagination control hides itself when everything fits on one page,
 * so smaller organizations see no change.
 */
export const BILLING_TABLE_PAGE_SIZE = 100

/**
 * Most series the usage and spend charts will draw.
 *
 * A table paginates; a line chart cannot. Past a few dozen lines the chart stops being readable
 * and starts being slow, and breaking usage down by project on a large organization produces
 * thousands of series. Above this the chart draws the largest and says how many it left out.
 *
 * Fifty because breaking down by usage type alone tops out at thirty series, so that view is
 * never truncated. The cap only bites once projects are in the breakdown.
 */
export const MAX_CHARTED_BILLING_SERIES = 50

// Labels mirror ee/billing/billing_types.py::USAGE_TYPE_OPTIONS.
// Values are sent to the `billing` repo as `usage_types`; keep in sync with `billing/billing/types/usage.py::SupportedUsageType`.
export const SPEND_TYPES = [
    { label: 'Events', value: 'event_count_in_period' },
    { label: 'Identified events', value: 'enhanced_persons_event_count_in_period' },
    { label: 'Group analytics', value: 'group_analytics' },
    { label: 'Recordings', value: 'recording_count_in_period' },
    { label: 'Mobile recordings', value: 'mobile_billable_recording_count_in_period' },
    { label: 'Feature flag requests', value: 'billable_feature_flag_requests_count_in_period' },
    { label: 'Exceptions', value: 'exceptions_captured_in_period' },
    { label: 'Survey responses', value: 'survey_responses_count_in_period' },
    { label: 'AI events', value: 'ai_event_count_in_period' },
    { label: 'Synced rows', value: 'rows_synced_in_period' },
    { label: 'Free synced rows', value: 'free_historical_rows_synced_in_period' },
    { label: 'Data pipelines (deprecated)', value: 'data_pipelines' },
    { label: 'Destinations trigger events', value: 'cdp_billable_invocations_in_period' },
    { label: 'Rows exported', value: 'rows_exported_in_period' },
    { label: 'PostHog AI', value: 'ai_credits_used_in_period' },
    { label: 'Self-driving inbox credits', value: 'signals_credits_used_in_period' },
    { label: 'Self-driving spend credits', value: 'signals_spend_credits_used_in_period' },
    { label: 'PostHog Desktop credits', value: 'posthog_code_credits_used_in_period' },
    { label: 'Replay vision credits', value: 'replay_vision_credits_used_in_period' },
    { label: 'Workflow emails', value: 'workflow_emails_sent_in_period' },
    { label: 'Workflow destinations', value: 'workflow_billable_invocations_in_period' },
    { label: 'Logs and traces ingested (MB)', value: 'logs_and_traces_mb_in_period' },
    { label: 'Logs 30-day retention (MB)', value: 'logs_retention_30d_mb_in_period' },
    { label: 'Logs retention (MB-days)', value: 'logs_retention_mb_days_in_period' },
] as const

export const USAGE_ONLY_TYPES = [
    { label: 'Logs ingested (MB)', value: 'logs_mb_in_period' },
    { label: 'Traces ingested (MB)', value: 'apm_tracing_mb_in_period' },
    { label: 'PostHog Desktop token spend (USD)', value: 'posthog_code_token_credits_used_in_period' },
    { label: 'Cloud compute spend (USD)', value: 'sandbox_compute_credits_used_in_period' },
    { label: 'Cloud compute CPU (core-seconds)', value: 'sandbox_compute_cpu_millicore_seconds_in_period' },
    { label: 'Cloud compute memory (GiB-seconds)', value: 'sandbox_compute_memory_mib_seconds_in_period' },
] as const

export const USAGE_TYPES = [...SPEND_TYPES, ...USAGE_ONLY_TYPES] as const

export type UsageTypeOption = (typeof USAGE_TYPES)[number]
export type UsageTypeValue = UsageTypeOption['value']

export const ALL_USAGE_TYPES: UsageTypeValue[] = USAGE_TYPES.map((opt) => opt.value)

// Date after which billing for data pipelines ends and add-on upgrades/downgrades are disabled,
// in sync with billing_end_date of data_pipelines in billing plans config
export const DATA_PIPELINES_CUTOFF_DATE = '2025-09-10'

/** The label billing gives the series that folds the projects beyond the cap; a count follows it. */
export const FOLDED_SERIES_LABEL = 'All other projects'