S17 Phase 8: statistics

Summary

Statistics endpoints per ADR-009: aggregate and per-format at namespace level (/api/v1/:slug/statistics, /api/v1/:slug/:format/statistics), plus per-repository and per-artifact figures.

Gated on

• S18 and S22 (storage accounting): the counters and accounting model these endpoints expose. S22 spec tracked in #265 (closed).

This phase patches the S17 spec and follows the repo gate: spec MR, plan MR, implementation. Part of &22341.

Status — 2026-08-28

graph TD
    S7["Step 7: Format statistics"]
    S10["Step 10: Repository statistics: container"]
    S20["Step 20: Version statistics: npm"]

    classDef planned fill:#e0e0e0,stroke:#888888,color:#333333;
    classDef inBuild fill:#ffcc66,stroke:#996600,color:#333333;
    classDef open fill:#66ccff,stroke:#006699,color:#003344;

    class S7,S10,S20 open

    click S7 "https://gitlab.com/gitlab-org/ops/artifact-registry/-/merge_requests/2002"
    click S10 "https://gitlab.com/gitlab-org/ops/artifact-registry/-/merge_requests/2030"
    click S20 "https://gitlab.com/gitlab-org/ops/artifact-registry/-/merge_requests/2035"

#	Step	Status
1	Contract: aggregate statistics	Merged (feat(api): aggregate statistics contract (S17 P... (!1964 - merged) • Hayley Swimelar • 19.4)
2	Contract: artifact statistics	Merged (feat(api): version statistics contract (S17 Pha... (!1986 - merged) • Hayley Swimelar • 19.4)
3	Statistics route scaffold	Merged (chore(managementapi): statistics scaffold (S17 ... (!1961 - merged) • Hayley Swimelar • 19.4)
4	Repository statistics resolution gate	Merged (chore(managementapi): repository stats gate (S1... (!1994 - merged) • Hayley Swimelar • 19.4)
5	Repositories aggregate reader	Merged (chore(datastore): repositories aggregate (S17 P... (!1970 - merged) • Hayley Swimelar • 19.4)
6	Namespace statistics	Merged (feat(managementapi): namespace statistics (S17 ... (!2001 - merged) • Hayley Swimelar • 19.4)
7	Format statistics	Open, pipeline success, in review: radbatnag (feat(managementapi): format statistics (S17 Pha... (!2002 - merged) • Hayley Swimelar • 19.4)
8	Repository statistics: Maven	Merged (feat(managementapi): maven repo statistics (S17... (!2028 - merged) • Hayley Swimelar • 19.4)
9	Repository statistics: npm	Merged (feat(managementapi): npm repo statistics (S17 P... (!2027 - merged) • Hayley Swimelar • 19.4)
10	Repository statistics: container	Open, pipeline success, in review: 10io (feat(managementapi): container repo stats (S17 ... (!2030) • Hayley Swimelar • 19.4)
11	Blob-footprint sum helper	Merged (chore(datastore): blob-footprint sum (S17 Phase... (!1965 - merged) • Hayley Swimelar • 19.4)
19	Version statistics: Maven	Merged (feat(managementapi): maven version stats (S17 P... (!2021 - merged) • Hayley Swimelar • 19.4)
20	Version statistics: npm	Draft (feat(managementapi): npm version stats (S17 Pha... (!2035) • Hayley Swimelar • 19.4)