debian-mirror-gitlab/doc/university/training/topics/git_log.md

---
comments: false
---

# Git Log

----------

Git log lists commit history. It allows searching and filtering.

* Initiate log
```
git log
```

* Retrieve set number of records:
```
git log -n 2
```

* Search commits by author. Allows user name or a regular expression.
```
git log --author="user_name"
```

----------

* Search by comment message.
```
git log --grep="<pattern>"
```

* Search by date
```
git log --since=1.month.ago --until=3.weeks.ago
```


----------

## Git Log Workflow

1. Change to workspace directory
2. Clone the multi runner projects
3. Change to project dir
4. Search by author
5. Search by date
6. Combine

----------

## Commands

```
cd ~/workspace
git clone git@gitlab.com:gitlab-org/gitlab-runner.git
cd gitlab-runner
git log --author="Travis"
git log --since=1.month.ago --until=3.weeks.ago
git log --since=1.month.ago --until=1.day.ago --author="Travis"
```