# GitOps logs

GitOps logs serve as a valuable tool to understand and monitor changes made specifically through GitOps within your workspace. This feature provides a comprehensive record of changes made via GitOps. This record includes, but is not limited to, which repository a change was made in, the commit details, the number of commits made, the entities affected, and any validation errors that occurred during the change process.

GitOps logs are a great way for you to track changes, identify discrepancies, and gain a holistic view of changes that have been made in your workspace. You can access the GitOps log through the Cortex UI or the public API endpoint.

## Accessing GitOps logs through the Cortex UI

To view GitOps logs, navigate to [**Settings > GitOps** **logs**](https://app.getcortexapp.com/admin/settings/gitops-logs).

<figure><img src="https://826863033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJW7pYRxS4dHS3Hv6wxve%2Fuploads%2Fgit-blob-628668dd4e62864419db3dd7b28137fc7bb755c4%2Fgitops-logs.jpg?alt=media" alt=""><figcaption></figcaption></figure>

The GitOps logs page lists events and associated details. Click into a log to view a side panel with more information:

* **Repo:** Name of the repository a change was made in.
* **Timestamp**: When the change was made.
* **Commit sha:** Record of the changes made in associated repository.
* **Branch**: Which branch the change was made in.
* **# of commits:** Total number of commits.
* Under the **Changes** tab, a list of the affected files.
  * You can toggle on **Show only with impacted entities** to view changes that impacted entities.
* Under the **Omitted files** tab, a list of files that were omitted during the commit.
* Under the **Event processing tab**, a list of related events.

![A GitOps log displays relevant information about the activity.](https://826863033-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJW7pYRxS4dHS3Hv6wxve%2Fuploads%2Fgit-blob-a3012f1a96fe91511a7eb4bf4fd0fa10bbc9dc09%2Fgitops-log-example.jpg?alt=media)

### Accessing Audit logs through the public API endpoint

GitOps logs can also be accessed through the public API endpoint. Please refer to our [GitOps logs API documentation](https://app.gitbook.com/s/nPgS8L9MAPtoOtdWdeDp/readme/gitops-logs) to learn how to retrieve GitOps logs.
