Skip to main content
The ServerService provides methods for retrieving information about the Gitaly server, storage statistics, and clock synchronization status.

ServerInfo

Retrieves information about the Gitaly server and its storage.

Request

Empty request.

Response

server_version
string
The version of the Gitaly server
git_version
string
The version of Git installed on the server
storage_statuses
StorageStatus[]
Array of storage status information for each configured storage

StorageStatus

storage_name
string
The name of the storage
readable
bool
Whether the storage is readable
writeable
bool
Whether the storage is writeable
fs_type
string
The filesystem type of the storage
filesystem_id
string
The unique identifier of the filesystem
replication_factor
uint32
The replication factor for the storage (used in Praefect setups)

DiskStatistics

Retrieves disk usage statistics for configured storage.

Request

Empty request.

Response

storage_statuses
StorageStatus[]
Array of storage disk statistics

StorageStatus

storage_name
string
The name of the storage
available
int64
Available disk space in bytes. When both available and used are 0, Gitaly was unable to determine storage stats.
used
int64
Used disk space in bytes. When both available and used are 0, Gitaly was unable to determine storage stats.

ClockSynced

Checks if the machine clock is synchronized with an NTP server (within the specified drift threshold).

Request

ntp_host
string
URL to the external NTP service for clock sync check. Defaults to ntp.pool.org if not specified.
drift_threshold_millis
int64
Allowed drift from the NTP service in milliseconds

Response

synced
bool
True if the system clock has an acceptable drift compared to the NTP service, false otherwise

Build docs developers (and LLMs) love