Function trackOrganizationUsageMetrics

packages/billing/src/org-monitoring.ts:319–379

(params: {
  organizationId: string
  totalCreditsConsumed: number
  uniqueUsers: number
  repositoryCount: number
  averageCreditsPerUser: number
  topRepository: string
  timeframe: 'daily' | 'weekly' | 'monthly'
  logger: Logger
})

 * Tracks organization usage metrics for analytics
 */
export async function trackOrganizationUsageMetrics(params: {
  organizationId: string
  totalCreditsConsumed: number
  uniqueUsers: number
  repositoryCount: number
  averageCreditsPerUser: number
  topRepository: string
  timeframe: 'daily' | 'weekly' | 'monthly'
  logger: Logger
}): Promise<void> {
  const {
    organizationId,
    totalCreditsConsumed,
    uniqueUsers,
    repositoryCount,
    averageCreditsPerUser,
    topRepository,
    timeframe,
    logger,
  } = params

  try {
    logger.info(
      {
        organizationId,
        totalCreditsConsumed,
        uniqueUsers,
        repositoryCount,
        averageCreditsPerUser,
        topRepository,
        timeframe,
      },
      'Organization usage metrics tracked',
    )

    // Track analytics event
    trackEvent({
      event: AnalyticsEvent.CREDIT_GRANT,
      userId: organizationId,
      properties: {
        type: 'usage_metrics',
        timeframe,
        totalCreditsConsumed,
        uniqueUsers,
        repositoryCount,
      },
      logger,
    })

    // TODO: Store metrics in time-series database for dashboards
    // TODO: Generate usage reports
    // TODO: Identify usage patterns and optimization opportunities
  } catch (error) {
    const obj: any = {
      ...params,
      error: getErrorObject(error),
    }
    delete obj.logger