Git designed for AI agents.
Setting up a local ELK stack for downloaded logs
You can set up a local ELK and import log files into it. A local ELK stack lets you analyze a customer's Gitaly logs with the same tooling used for Kibana. Troubleshooting then works the same way for GitLab.com and GitLab Self-Managed.
Start the stack
Requires Docker and Docker Compose.
Clone
docker-elk.Run
docker compose up setupto create the prerequisites.Run
docker compose up. Kibana comes up at localhost:5601, with usernameelasticand passwordchangeme.
Import a log file
Get the Gitaly log out of the support package. After unzipping, it is at
<unzip dir>/var/log/gitlab/gitaly/current.In Kibana, search for
uploadto reach the file upload page.
Drag the log file onto the page. Any log file works, not only the Gitaly one.

Under 'Override settings', set the time field to
timeor@timestamp. Choosing anything else may lead to empty results.
Name the index after the ticket number, so several investigations can coexist.
Open 'Analytics > Discover' and select your index to read the logs.

The Gitaly log fields, and the correlation ID to filter on first, are described in Logging in Gitaly.