: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.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
import { isAiEventName } from '~/ingestion/common/ai-event-types'
export const EVENTS_USAGE_KEY = 'events'
export const AI_EVENTS_USAGE_KEY = 'ai_events'
export const EXCEPTIONS_USAGE_KEY = 'exceptions'
export const SURVEY_RESPONSES_USAGE_KEY = 'survey_responses'
/** Null means the event is not billed at all. */
export type UsageKeyResolver = (event: string) => string | null
// Mirrors BILLABLE_EVENT_EXCLUDED_EVENTS in posthog/tasks/usage_report.py. The two lists have to
// agree or the usage records and the org usage report bill the same team differently.
const NON_BILLABLE_EVENTS = new Set([
'$feature_flag_called',
'$experiment_exposure',
'survey shown',
'survey dismissed',
'$exception',
'$llm_prompt_fetched',
'$conversations_loaded',
'$conversations_widget_loaded',
'$conversations_message_sent',
'$conversations_user_identified',
'$conversations_restore_link_requested',
'$conversations_widget_state_changed',
'$conversations_back_to_tickets',
'$anomaly_score',
'$anomaly_score_shadow',
])
/**
* Bills each event under the key its own product owns, wherever the event turns up.
* Every `$ai_*` event bills as an AI event, matching the nightly report's
* `startsWith(event, '$ai_')` split between the two meters.
*/
export const resolveAnalyticsUsageKey: UsageKeyResolver = (event) => {
if (isAiEventName(event)) {
return AI_EVENTS_USAGE_KEY
}
if (event === 'survey sent') {
return SURVEY_RESPONSES_USAGE_KEY
}
return NON_BILLABLE_EVENTS.has(event) ? null : EVENTS_USAGE_KEY
}
export const resolveAiUsageKey: UsageKeyResolver = () => AI_EVENTS_USAGE_KEY
export const resolveExceptionUsageKey: UsageKeyResolver = () => EXCEPTIONS_USAGE_KEY