Get instance information
GET /api/admin/insights
Gets high level information about the usage of this Unleash instance, including user, project, and flag information.
Request
- 200
instanceInsightsSchema
- application/json
- Schema
- Example (from schema)
Schema
users objectrequired
High level user count statistics
total number requiredThe number of actual Unleash users
active number requiredThe number of active Unleash users who have user Unleash in the past 60 days
inactive number requiredThe number of inactive Unleash users who have not used Unleash in the past 60 days.
flags objectrequired
High level flag count statistics
total number requiredThe number of non-archived flags
userTrends object[]required
How number of users changed over time
Array [date date-time requiredA UTC date when the stats were captured. Time is the very end of a given day.
total number requiredThe number of actual Unleash users on a particular day
active number requiredThe number of active Unleash users on a particular day
inactive number requiredThe number of inactive Unleash users on a particular day
]flagTrends object[]required
How number of flags changed over time
Array [date date-time requiredA UTC date when the stats were captured. Time is the very end of a given day.
total number requiredThe number of all flags on a particular day
active number requiredThe number of active flags on a particular day
stale number requiredThe number of user marked stale flags on a particular day
potentiallyStale number requiredThe number of time calculated potentially stale flags on a particular day
]projectFlagTrends object[]required
How number of flags per project changed over time
Array [week string requiredYear and week in a given year for which the stats were calculated
project string requiredProject id of the project the flag trends belong to
health numberAn indicator of the project's health on a scale from 0 to 100
timeToProduction numberThe average time from when a feature was created to when it was enabled in the "production" environment during the current window
date date-time requiredA UTC date when the stats were captured. Time is the very end of a given day.
total number requiredThe number of all flags on a particular day
active number requiredThe number of active flags on a particular day
stale number requiredThe number of user marked stale flags on a particular day
potentiallyStale number requiredThe number of time calculated potentially stale flags on a particular day
users numberThe number of users who have access to the project
]metricsSummaryTrends object[]required
How metrics data per project changed over time
Array [week string requiredYear and week in a given year for which the metrics summary was calculated
date date-time requiredA UTC date when metrics summary was captured. Time is the very end of a given day.
project string requiredProject id of the project the impressions summary belong to
totalRequests number requiredTotal number of times all project flags were requested
totalYes number requiredTotal number of times all project flags were exposed across all environments
totalNo number requiredTotal number of times all project flags were not exposed across all environments
totalApps number requiredTotal number of applications the impression data belong to
totalFlags number requiredTotal number of flags the impression data belong to
totalEnvironments number requiredTotal number of environments the impression data belong to
]environmentTypeTrends object[]required
How updates per environment type changed over time
Array [date date-time requiredA UTC date when the stats were captured. Time is the very end of a given day.
week string requiredYear and week in a given year for which the stats were calculated
environmentType string requiredEnvironment type the data belongs too
totalUpdates number requiredTotal number of times configuration has been updated in the environment type
]
{
"users": {
"total": 100,
"active": 98,
"inactive": 2
},
"flags": {
"total": 100
},
"userTrends": [
{
"date": "2024-01-12T23:59:59.999Z",
"total": 100,
"active": 98,
"inactive": 2
}
],
"flagTrends": [
{
"date": "2024-01-12T23:59:59.999Z",
"total": 100,
"active": 98,
"stale": 0,
"potentiallyStale": 2
}
],
"projectFlagTrends": [
{
"week": "2024-40",
"project": "default",
"health": 50,
"timeToProduction": 10,
"date": "2024-01-12T23:59:59.999Z",
"total": 100,
"active": 98,
"stale": 0,
"potentiallyStale": 2,
"users": 30
}
],
"metricsSummaryTrends": [
{
"week": "2024-01",
"date": "2024-01-12T23:59:59.999Z",
"project": "default",
"totalRequests": 50,
"totalYes": 50,
"totalNo": 50,
"totalApps": 50,
"totalFlags": 50,
"totalEnvironments": 50
}
],
"environmentTypeTrends": [
{
"date": "2024-01-12T23:59:59.999Z",
"week": "2024-01",
"environmentType": "production",
"totalUpdates": 50
}
]
}