Skip to content

📈 Open source, privacy-first web analytics — a cookie-less Google Analytics alternative with built-in error tracking and performance monitoring. Self-host it or use our cloud. Get started for free!

feature flag usage statistics

Blue Mousec762b5960163
diff --git a/backend/apps/cloud/src/feature-flag/dto/feature-flag.dto.ts b/backend/apps/cloud/src/feature-flag/dto/feature-flag.dto.ts
index 724b50fd9..15152a641 100644
--- a/backend/apps/cloud/src/feature-flag/dto/feature-flag.dto.ts
+++ b/backend/apps/cloud/src/feature-flag/dto/feature-flag.dto.ts
@@ -216,3 +216,30 @@ export class EvaluatedFlagsResponseDto {
})
flags: Record<string, boolean>
}
+
+export class FeatureFlagProfileDto {
+ @ApiProperty({ description: 'Profile ID' })
+ profileId: string
+
+ @ApiProperty({
+ description: 'Whether profile is identified (has user-provided ID)',
+ })
+ isIdentified: boolean
+
+ @ApiProperty({ description: 'Last evaluation result' })
+ lastResult: boolean
+
+ @ApiProperty({ description: 'Total number of evaluations for this profile' })
+ evaluationCount: number
+
+ @ApiProperty({ description: 'Most recent evaluation timestamp' })
+ lastEvaluated: string
+}
+
+export class FeatureFlagProfilesResponseDto {
+ @ApiProperty({ type: [FeatureFlagProfileDto] })
+ profiles: FeatureFlagProfileDto[]
+
+ @ApiProperty({ description: 'Total number of profiles' })
+ total: number
+}
diff --git a/backend/apps/cloud/src/feature-flag/feature-flag.controller.ts b/backend/apps/cloud/src/feature-flag/feature-flag.controller.ts
index e282718aa..f0aa9ff81 100644
--- a/backend/apps/cloud/src/feature-flag/feature-flag.controller.ts
+++ b/backend/apps/cloud/src/feature-flag/feature-flag.controller.ts
@@ -47,6 +47,7 @@ import {
FeatureFlagDto,
FeatureFlagStatsDto,
EvaluatedFlagsResponseDto,
+ FeatureFlagProfilesResponseDto,
} from './dto/feature-flag.dto'
import { FeatureFlagService } from './feature-flag.service'
import { clickhouse } from '../common/integrations/clickhouse'
@@ -549,4 +550,124 @@ export class FeatureFlagController {
}
}
}
+
+ @ApiBearerAuth()
+ @Get('/:id/profiles')
+ @Auth()
+ @ApiResponse({ status: 200, type: FeatureFlagProfilesResponseDto })
+ @ApiOperation({
+ summary: 'Get profiles who have evaluated a feature flag',
+ description:
+ 'Returns a list of profiles ordered by most recent evaluation time',
+ })
+ async getFeatureFlagProfiles(
+ @CurrentUserId() userId: string,
+ @Param('id') id: string,
+ @Query('period') period: string,
+ @Query('from') from?: string,
+ @Query('to') to?: string,
+ @Query('timezone') timezone?: string,
+ @Query('take', new ParseIntPipe({ optional: true })) take?: number,
+ @Query('skip', new ParseIntPipe({ optional: true })) skip?: number,
+ ) {
+ this.logger.log(
+ { userId, id, period, from, to, take, skip },
+ 'GET /feature-flag/:id/profiles',
+ )
+
+ const flag = await this.featureFlagService.findOneWithRelations(id)
+
+ if (_isEmpty(flag)) {
+ throw new NotFoundException('Feature flag not found')
+ }
+
+ const project = await this.projectService.getFullProject(flag.project.id)
+ this.projectService.allowedToView(project, userId)
+
+ const safeTimezone = this.analyticsService.getSafeTimezone(timezone)
+ const timeBucket = getLowestPossibleTimeBucket(period, from, to)
+
+ const { groupFromUTC, groupToUTC } = this.analyticsService.getGroupFromTo(
+ from,
+ to,
+ timeBucket,
+ period,
+ safeTimezone,
+ )
+
+ const safeTake = Math.min(take || 15, 50)
+ const safeSkip = skip || 0
+
+ // Query to get profiles with their most recent evaluation
+ const profilesQuery = `
+ SELECT
+ profileId,
+ max(created) as lastEvaluated,
+ argMax(result, created) as lastResult,
+ count(*) as evaluationCount
+ FROM feature_flag_evaluations
+ WHERE
+ pid = {pid:FixedString(12)}
+ AND flagId = {flagId:String}
+ AND created BETWEEN {groupFrom:String} AND {groupTo:String}
+ GROUP BY profileId
+ ORDER BY lastEvaluated DESC
+ LIMIT {take:UInt32} OFFSET {skip:UInt32}
+ `
+
+ const countQuery = `
+ SELECT uniqExact(profileId) as total
+ FROM feature_flag_evaluations
+ WHERE
+ pid = {pid:FixedString(12)}
+ AND flagId = {flagId:String}
+ AND created BETWEEN {groupFrom:String} AND {groupTo:String}
+ `
+
+ const queryParams = {
+ pid: flag.project.id,
+ flagId: flag.id,
+ groupFrom: groupFromUTC,
+ groupTo: groupToUTC,
+ take: safeTake,
+ skip: safeSkip,
+ }
+
+ try {
+ const [profilesResult, countResult] = await Promise.all([
+ clickhouse
+ .query({ query: profilesQuery, query_params: queryParams })
+ .then(resultSet =>
+ resultSet.json<{
+ profileId: string
+ lastEvaluated: string
+ lastResult: number
+ evaluationCount: number
+ }>(),
+ ),
+ clickhouse
+ .query({ query: countQuery, query_params: queryParams })
+ .then(resultSet => resultSet.json<{ total: number }>()),
+ ])
+
+ const profiles = profilesResult.data.map(row => ({
+ profileId: row.profileId,
+ isIdentified: row.profileId.startsWith('usr_'),
+ lastResult: row.lastResult === 1,
+ evaluationCount: Number(row.evaluationCount),
+ lastEvaluated: row.lastEvaluated,
+ }))
+
+ return {
+ profiles,
+ total: Number(countResult.data[0]?.total || 0),
+ }
+ } catch (err) {
+ this.logger.warn({ err }, 'Failed to get flag profiles')
+ return {
+ profiles: [],
+ total: 0,
+ }
+ }
+ }
}
diff --git a/web/app/api/index.ts b/web/app/api/index.ts
index ed40a5462..645f25425 100644
--- a/web/app/api/index.ts
+++ b/web/app/api/index.ts
@@ -1348,6 +1348,34 @@ export const getFeatureFlagStats = (
throw _isEmpty(error.response.data?.message) ? error.response.data : error.response.data.message
})
+export interface FeatureFlagProfile {
+ profileId: string
+ isIdentified: boolean
+ lastResult: boolean
+ evaluationCount: number
+ lastEvaluated: string
+}
+
+export const DEFAULT_FEATURE_FLAG_PROFILES_TAKE = 15
+
+export const getFeatureFlagProfiles = (
+ flagId: string,
+ period: string,
+ from: string = '',
+ to: string = '',
+ timezone?: string,
+ take: number = DEFAULT_FEATURE_FLAG_PROFILES_TAKE,
+ skip: number = 0,
+) =>
+ api
+ .get(`/feature-flag/${flagId}/profiles`, {
+ params: { period, from, to, timezone, take, skip },
+ })
+ .then((response): { profiles: FeatureFlagProfile[]; total: number } => response.data)
+ .catch((error) => {
+ throw _isEmpty(error.response.data?.message) ? error.response.data : error.response.data.message
+ })
+
export const reGenerateCaptchaSecretKey = (pid: string) =>
api
.post(`project/secret-gen/${pid}`)
diff --git a/web/app/pages/Project/FeatureFlags/View/FeatureFlagsView.tsx b/web/app/pages/Project/FeatureFlags/View/FeatureFlagsView.tsx
index fd65865a7..98b94eca4 100644
--- a/web/app/pages/Project/FeatureFlags/View/FeatureFlagsView.tsx
+++ b/web/app/pages/Project/FeatureFlags/View/FeatureFlagsView.tsx
@@ -1,5 +1,7 @@
import { XCircleIcon } from '@heroicons/react/24/outline'
import cx from 'clsx'
+import dayjs from 'dayjs'
+import relativeTime from 'dayjs/plugin/relativeTime'
import _isEmpty from 'lodash/isEmpty'
import _map from 'lodash/map'
import {
@@ -13,22 +15,30 @@ import {
PercentIcon,
UsersIcon,
ActivityIcon,
+ ChevronDownIcon,
+ DownloadIcon,
+ CheckIcon,
+ XIcon,
} from 'lucide-react'
import { useState, useEffect, useMemo, useRef } from 'react'
import { useTranslation } from 'react-i18next'
-import { Link } from 'react-router'
+import { Link, useLocation } from 'react-router'
import { toast } from 'sonner'
import {
deleteFeatureFlag as deleteFeatureFlagApi,
getProjectFeatureFlags,
getFeatureFlagStats,
+ getFeatureFlagProfiles,
DEFAULT_FEATURE_FLAGS_TAKE,
+ DEFAULT_FEATURE_FLAG_PROFILES_TAKE,
type ProjectFeatureFlag,
type FeatureFlagStats,
+ type FeatureFlagProfile,
} from '~/api'
import { useViewProjectContext } from '~/pages/Project/View/ViewProject'
import { useCurrentProject } from '~/providers/CurrentProjectProvider'
+import { Badge } from '~/ui/Badge'
import Button from '~/ui/Button'
import Spin from '~/ui/icons/Spin'
import Loader from '~/ui/Loader'
@@ -37,20 +47,117 @@ import Modal from '~/ui/Modal'
import Pagination from '~/ui/Pagination'
import { Text } from '~/ui/Text'
import { nFormatter } from '~/utils/generic'
+import { getProfileDisplayName, ProfileAvatar } from '~/utils/profileAvatars'
import routes from '~/utils/routes'
import FeatureFlagSettingsModal from './FeatureFlagSettingsModal'
+dayjs.extend(relativeTime)
+
+interface FeatureFlagProfileRowProps {
+ profile: FeatureFlagProfile
+ timeFormat: '12-hour' | '24-hour'
+}
+
+const FeatureFlagProfileRow = ({ profile, timeFormat }: FeatureFlagProfileRowProps) => {
+ const {
+ t,
+ i18n: { language },
+ } = useTranslation('common')
+ const location = useLocation()
+
+ const displayName = useMemo(() => {
+ return getProfileDisplayName(profile.profileId, profile.isIdentified)
+ }, [profile.profileId, profile.isIdentified])
+
+ const lastEvaluatedText = useMemo(() => {
+ return dayjs(profile.lastEvaluated)
+ .toDate()
+ .toLocaleDateString(language, {
+ day: 'numeric',
+ month: 'short',
+ hour: 'numeric',
+ minute: 'numeric',
+ hourCycle: timeFormat === '12-hour' ? 'h12' : 'h23',
+ })
+ }, [profile.lastEvaluated, language, timeFormat])
+
+ const params = new URLSearchParams(location.search)
+ params.set('profileId', profile.profileId)
+
+ return (
+ <Link to={{ search: params.toString() }}>
+ <li className='relative mb-2 flex cursor-pointer items-center justify-between gap-x-4 overflow-hidden rounded-lg border border-gray-200 bg-white px-3 py-2.5 transition-colors hover:bg-gray-100 dark:border-slate-700/50 dark:bg-slate-800/50 dark:hover:bg-slate-700/50'>
+ <div className='flex min-w-0 items-center gap-x-3'>
+ {/* Avatar */}
+ <ProfileAvatar profileId={profile.profileId} size={32} className='shrink-0' />
+
+ <div className='min-w-0 flex-auto'>
+ <p className='flex items-center text-xs leading-5 font-semibold text-gray-900 dark:text-gray-50'>
+ <span className='truncate'>{displayName}</span>
+ {profile.isIdentified ? (
+ <Badge label={t('project.identified')} colour='indigo' className='ml-1.5' />
+ ) : null}
+ </p>
+ <p className='mt-0.5 text-xs text-gray-500 dark:text-gray-400'>
+ {t('featureFlags.xEvaluations', { count: profile.evaluationCount })} · {lastEvaluatedText}
+ </p>
+ </div>
+ </div>
+ <div className='flex shrink-0 items-center gap-x-2'>
+ {/* Result indicator */}
+ <span
+ className={cx(
+ 'inline-flex items-center rounded-full px-2 py-0.5 text-xs font-medium',
+ profile.lastResult
+ ? 'bg-green-100 text-green-700 dark:bg-green-900/30 dark:text-green-400'
+ : 'bg-gray-100 text-gray-600 dark:bg-gray-700 dark:text-gray-400',
+ )}
+ >
+ {profile.lastResult ? (
+ <CheckIcon className='mr-1 size-3' strokeWidth={2} />
+ ) : (
+ <XIcon className='mr-1 size-3' strokeWidth={2} />
+ )}
+ {profile.lastResult ? 'true' : 'false'}
+ </span>
+ </div>
+ </li>
+ </Link>
+ )
+}
+
interface FeatureFlagRowProps {
flag: ProjectFeatureFlag
stats: FeatureFlagStats | null
statsLoading: boolean
+ isExpanded: boolean
+ profiles: FeatureFlagProfile[]
+ profilesLoading: boolean
+ canLoadMoreProfiles: boolean
onDelete: (id: string) => void
onEdit: (id: string) => void
onToggle: (id: string, enabled: boolean) => void
+ onToggleExpand: (id: string) => void
+ onLoadMoreProfiles: (id: string) => void
+ timeFormat: '12-hour' | '24-hour'
}
-const FeatureFlagRow = ({ flag, stats, statsLoading, onDelete, onEdit, onToggle }: FeatureFlagRowProps) => {
+const FeatureFlagRow = ({
+ flag,
+ stats,
+ statsLoading,
+ isExpanded,
+ profiles,
+ profilesLoading,
+ canLoadMoreProfiles,
+ onDelete,
+ onEdit,
+ onToggle,
+ onToggleExpand,
+ onLoadMoreProfiles,
+ timeFormat,
+}: FeatureFlagRowProps) => {
const { t } = useTranslation()
const [showDeleteModal, setShowDeleteModal] = useState(false)
@@ -59,7 +166,11 @@ const FeatureFlagRow = ({ flag, stats, statsLoading, onDelete, onEdit, onToggle
return (
<>
<li className='relative mb-3 overflow-hidden rounded-xl border border-gray-200 bg-gray-50 transition-colors dark:border-slate-800/25 dark:bg-slate-800/70'>
- <div className='flex justify-between gap-x-6 px-4 py-4 sm:px-6'>
+ {/* Main row - clickable to expand */}
+ <div
+ onClick={() => onToggleExpand(flag.id)}
+ className='flex cursor-pointer justify-between gap-x-6 px-4 py-4 transition-colors hover:bg-gray-200/70 sm:px-6 dark:hover:bg-slate-700/60'
+ >
<div className='flex min-w-0 gap-x-4'>
<div className='min-w-0 flex-auto'>
<div className='flex items-center gap-x-2'>
@@ -215,9 +326,64 @@ const FeatureFlagRow = ({ flag, stats, statsLoading, onDelete, onEdit, onToggle
>
<Trash2Icon className='size-4' strokeWidth={1.5} />
</button>
+ <ChevronDownIcon
+ className={cx('size-5 text-gray-500 transition-transform dark:text-gray-400', {
+ 'rotate-180': isExpanded,
+ })}
+ strokeWidth={1.5}
+ />
</div>
</div>
</div>
+
+ {/* Expanded profiles section */}
+ {isExpanded ? (
+ <div className='border-t border-gray-200 px-4 py-4 sm:px-6 dark:border-slate-700'>
+ {profilesLoading && profiles.length === 0 ? (
+ <div className='flex h-[120px] items-center justify-center'>
+ <Spin className='size-8' />
+ </div>
+ ) : profiles.length === 0 ? (
+ <div className='flex h-[120px] items-center justify-center'>
+ <Text as='p' colour='muted'>
+ {t('featureFlags.noProfiles')}
+ </Text>
+ </div>
+ ) : (
+ <>
+ <ul>
+ {_map(profiles, (profile) => (
+ <FeatureFlagProfileRow key={profile.profileId} profile={profile} timeFormat={timeFormat} />
+ ))}
+ </ul>
+ {canLoadMoreProfiles ? (
+ <button
+ type='button'
+ onClick={(e) => {
+ e.preventDefault()
+ e.stopPropagation()
+ onLoadMoreProfiles(flag.id)
+ }}
+ disabled={profilesLoading}
+ className={cx(
+ 'relative mx-auto mt-2 flex items-center rounded-md border border-transparent p-2 text-sm font-medium text-gray-700 hover:border-gray-300 hover:bg-white focus:z-10 focus:ring-1 focus:ring-indigo-500 focus:outline-hidden dark:bg-slate-900 dark:text-gray-50 hover:dark:border-slate-700/80 dark:hover:bg-slate-800 focus:dark:ring-gray-200',
+ {
+ 'cursor-not-allowed opacity-50': profilesLoading,
+ },
+ )}
+ >
+ {profilesLoading ? (
+ <Spin className='mr-2 size-5' />
+ ) : (
+ <DownloadIcon className='mr-2 h-5 w-5' strokeWidth={1.5} />
+ )}
+ {t('featureFlags.loadMore')}
+ </button>
+ ) : null}
+ </>
+ )}
+ </div>
+ ) : null}
</li>
<Modal
onClose={() => setShowDeleteModal(false)}
@@ -246,7 +412,7 @@ interface FeatureFlagsViewProps {
const FeatureFlagsView = ({ period, from = '', to = '', timezone }: FeatureFlagsViewProps) => {
const { id } = useCurrentProject()
- const { featureFlagsRefreshTrigger } = useViewProjectContext()
+ const { featureFlagsRefreshTrigger, timeFormat } = useViewProjectContext()
const { t } = useTranslation()
const [isLoading, setIsLoading] = useState<boolean | null>(null)
@@ -260,6 +426,12 @@ const FeatureFlagsView = ({ period, from = '', to = '', timezone }: FeatureFlags
const [error, setError] = useState<string | null>(null)
const [filterQuery, setFilterQuery] = useState('')
+ // Expanded flag state
+ const [expandedFlagId, setExpandedFlagId] = useState<string | null>(null)
+ const [flagProfiles, setFlagProfiles] = useState<Record<string, FeatureFlagProfile[]>>({})
+ const [flagProfilesTotal, setFlagProfilesTotal] = useState<Record<string, number>>({})
+ const [profilesLoading, setProfilesLoading] = useState<Record<string, boolean>>({})
+
// Modal state
const [isModalOpen, setIsModalOpen] = useState(false)
const [editingFlagId, setEditingFlagId] = useState<string | null>(null)
@@ -327,6 +499,58 @@ const FeatureFlagsView = ({ period, from = '', to = '', timezone }: FeatureFlags
}
}
+ const loadFlagProfiles = async (flagId: string, append = false) => {
+ const currentProfiles = flagProfiles[flagId] || []
+ const skip = append ? currentProfiles.length : 0
+
+ setProfilesLoading((prev) => ({ ...prev, [flagId]: true }))
+ try {
+ const result = await getFeatureFlagProfiles(
+ flagId,
+ period,
+ from,
+ to,
+ timezone,
+ DEFAULT_FEATURE_FLAG_PROFILES_TAKE,
+ skip,
+ )
+ if (isMountedRef.current) {
+ setFlagProfiles((prev) => ({
+ ...prev,
+ [flagId]: append ? [...currentProfiles, ...result.profiles] : result.profiles,
+ }))
+ setFlagProfilesTotal((prev) => ({ ...prev, [flagId]: result.total }))
+ }
+ } catch (err) {
+ console.error('Failed to load flag profiles:', err)
+ if (isMountedRef.current) {
+ setFlagProfiles((prev) => ({ ...prev, [flagId]: append ? currentProfiles : [] }))
+ setFlagProfilesTotal((prev) => ({ ...prev, [flagId]: 0 }))
+ }
+ } finally {
+ if (isMountedRef.current) {
+ setProfilesLoading((prev) => ({ ...prev, [flagId]: false }))
+ }
+ }
+ }
+
+ const handleToggleExpand = (flagId: string) => {
+ if (expandedFlagId === flagId) {
+ // Collapse if already expanded
+ setExpandedFlagId(null)
+ } else {
+ // Expand and load profiles if not already loaded
+ setExpandedFlagId(flagId)
+ if (!flagProfiles[flagId] && !profilesLoading[flagId]) {
+ loadFlagProfiles(flagId)
+ }
+ }
+ }
+
+ const handleLoadMoreProfiles = (flagId: string) => {
+ loadFlagProfiles(flagId, true)
+ }
+
useEffect(() => {
loadFlags(DEFAULT_FEATURE_FLAGS_TAKE, (page - 1) * DEFAULT_FEATURE_FLAGS_TAKE)
// eslint-disable-next-line react-hooks/exhaustive-deps
@@ -338,6 +562,14 @@ const FeatureFlagsView = ({ period, from = '', to = '', timezone }: FeatureFlags
loadFlags(DEFAULT_FEATURE_FLAGS_TAKE, (page - 1) * DEFAULT_FEATURE_FLAGS_TAKE)
// Clear cached stats data to force reload
setFlagStats({})
+ // Refresh profiles for expanded flag
+ if (expandedFlagId) {
+ setFlagProfiles((prev) => ({ [expandedFlagId]: prev[expandedFlagId] }))
+ loadFlagProfiles(expandedFlagId)
+ } else {
+ setFlagProfiles({})
+ setFlagProfilesTotal({})
+ }
}
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [featureFlagsRefreshTrigger])
@@ -350,6 +582,14 @@ const FeatureFlagsView = ({ period, from = '', to = '', timezone }: FeatureFlags
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [flags, period, from, to, timezone])
+ // Reload profiles when period changes for expanded flag
+ useEffect(() => {
+ if (expandedFlagId && flagProfiles[expandedFlagId]) {
+ loadFlagProfiles(expandedFlagId)
+ }
+ // eslint-disable-next-line react-hooks/exhaustive-deps
+ }, [period, from, to, timezone])
+
const handleNewFlag = () => {
setEditingFlagId(null)
setIsModalOpen(true)
@@ -478,17 +718,30 @@ const FeatureFlagsView = ({ period, from = '', to = '', timezone }: FeatureFlags
{/* Flags list */}
<ul className='mt-4'>
- {_map(filteredFlags, (flag) => (
- <FeatureFlagRow
- key={flag.id}
- flag={flag}
- stats={flagStats[flag.id] || null}
- statsLoading={statsLoading[flag.id] || false}
- onDelete={handleDeleteFlag}
- onEdit={handleEditFlag}
- onToggle={handleToggleFlag}
- />
- ))}
+ {_map(filteredFlags, (flag) => {
+ const profiles = flagProfiles[flag.id] || []
+ const profilesTotal = flagProfilesTotal[flag.id] || 0
+ const canLoadMore = profiles.length < profilesTotal
+
+ return (
+ <FeatureFlagRow
+ key={flag.id}
+ flag={flag}
+ stats={flagStats[flag.id] || null}
+ statsLoading={statsLoading[flag.id] || false}
+ isExpanded={expandedFlagId === flag.id}
+ profiles={profiles}
+ profilesLoading={profilesLoading[flag.id] || false}
+ canLoadMoreProfiles={canLoadMore}
+ onDelete={handleDeleteFlag}
+ onEdit={handleEditFlag}
+ onToggle={handleToggleFlag}
+ onToggleExpand={handleToggleExpand}
+ onLoadMoreProfiles={handleLoadMoreProfiles}
+ timeFormat={timeFormat}
+ />
+ )
+ })}
</ul>
{filteredFlags.length === 0 && filterQuery ? (
diff --git a/web/public/locales/en.json b/web/public/locales/en.json
index 47c3d63fb..5cb714b35 100644
--- a/web/public/locales/en.json
+++ b/web/public/locales/en.json
@@ -1048,7 +1048,11 @@
"noStats": "No data yet",
"targetingRulesCount": "{{count}} targeting rule(s)",
"howToImplement": "How to implement",
- "implementationDescription": "Use the code snippets below to check feature flags in your application."
+ "implementationDescription": "Use the code snippets below to check feature flags in your application.",
+ "noProfiles": "No profiles have evaluated this flag yet",
+ "loadMore": "Load more",
+ "xEvaluations": "{{count}} evaluation(s)",
+ "lastEvaluated": "Last evaluated"
},
"error": {
"status": {