localrefdb count-refs utility to count the number of refs per project and register a metric called num_ref_per_project_<project name> localrefdb sha1-all-refs utility to combine the SHA1s of all refs into a new SHA1 and produce a numeric representation of it. This will also register a metric called: sha1_all_refs_per_project_<project name>
ssh -p <port> <host> localrefdb count-refs PROJECT [--verbose] ssh -p <port> <host> localrefdb sha1-all-refs PROJECT [--verbose]
A metric generated by a count of all refs in a project except for the user-edit refs, as these are not usually replicated.
A metric generated by combining all SHA1s in a project except for the user-edit refs, as these are not usually replicated. The SHA1 is then converted into a numerical value so that a metric can be registered.
This can be useful to avoid scenarios where refs are different but their counts match. In this case, the numerical value provided by this metric will be different for each node hence highlighting a discrepancy.
This command should be ideally executed during a readonly window, to avoid ongoing replication tasks affecting the result.
Any user who has been granted the ‘Administrate Server’ capability.
This command is intended to be used in scripts.
Count refs in project
$ ssh -p 29418 review.example.com localrefdb count-refs All-Users
Update global-refdb's sha1
$ ssh -p 29418 review.example.com localrefdb sha1-all-refs All-Users