> For the complete documentation index, see [llms.txt](https://docs.uibakery.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.uibakery.io/on-premise/git-source-control/git-audit-log-events.md).
# Git audit log events
UI Bakery records audit log entries for Git repository integration changes and Git branch operations. These events are available in **Audit logs** and can be filtered by the same audit log filters as other events, including time period, app, user, environment, and log level.
| Git: connect | `GIT_CONNECT` | Log | A Git repository is connected to an existing app. | `gitUrl`, `defaultBranch` |
| --------------------------- | --------------------------- | ----------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------- |
| Git: import | `GIT_IMPORT` | Log | A new app is imported from a Git repository. | `gitUrl`, `defaultBranch` |
| Git: disconnect | `GIT_DISCONNECT` | Warn | A Git repository is disconnected from an app. | `gitUrl` |
| Git: default branch updated | `GIT_DEFAULT_BRANCH_UPDATE` | Log | The configured default Git branch is changed. | `gitUrl`, `previousBranch`, `newBranch` |
| Git: SSH keys generated | `GIT_SSH_KEYS_GENERATED` | Log or Warn | Git SSH keys are generated for an app. The level is Warn when an existing key is replaced. | `gitUrl`, `replacedExistingKey` |
| Git: branches synced | `GIT_BRANCHES_SYNC` | Log | Git branches are synchronized from the repository by an explicit sync action. | `gitUrl`, `createdBranches`, `branchesCount` |
| Git: branch created | `GIT_BRANCH_CREATE` | Log | A Git branch is created from another branch. | `gitUrl`, `branch`, `baseBranch` |
| Git: branch deleted | `GIT_BRANCH_DELETE` | Warn | A Git branch is deleted locally, or locally and remotely. | `gitUrl`, `branch`, `deleteRemote` |
| Git: commit | `GIT_COMMIT` | Log | App changes are committed and pushed to Git. | `gitUrl`, `branch`, `commitHash`, `commitMessage` |
| Git: pull | `GIT_PULL` | Log | A regular pull is performed for a Git branch. | `gitUrl`, `branch`, `force` |
| Git: force pull | `GIT_FORCE_PULL` | Warn | A force pull is performed for a Git branch. | `gitUrl`, `branch`, `force` |
### Details fields
Git audit log entries use the **Details** column to show extra context for the action.
| `gitUrl` | String | Repository URL used by the app. The value is sanitized before it is written to audit logs: credentials/userinfo, query parameters, and URL fragments are removed. SSH keys, access tokens, and passwords are never logged. |
| --------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `defaultBranch` | String | Default branch configured after Git connect or Git import. |
| `previousBranch` | String | Default branch before an update. |
| `newBranch` | String | Default branch after an update. |
| `replacedExistingKey` | Boolean | `true` when generating Git SSH keys replaced a previously stored key; `false` when keys were generated for the first time. |
| `createdBranches` | String array | Branch names that were created in UI Bakery during the branch synchronization. |
| `branchesCount` | Number | Total number of branches after synchronization. |
| `branch` | String | Git branch affected by the action. |
| `baseBranch` | String | Source branch used when creating a new branch. |
| `deleteRemote` | Boolean | `true` when the delete action also requested deletion of the remote Git branch; `false` when only the local UI Bakery branch was deleted. |
| `commitHash` | String | Hash of the Git commit that was pushed. |
| `commitMessage` | String | Commit message. Long commit messages are trimmed before being written to audit logs. |
| `force` | Boolean | `false` for regular pull events and `true` for force pull events. |
### Examples
Git connect details:
```json
{
"gitUrl": "https://github.com/company/internal-tools.git",
"defaultBranch": "main"
}
```
Git SSH key generation details:
```json
{
"gitUrl": "https://github.com/company/internal-tools.git",
"replacedExistingKey": true
}
```
Git commit details:
```json
{
"gitUrl": "https://github.com/company/internal-tools.git",
"branch": "main",
"commitHash": "abc123",
"commitMessage": "Update dashboard filters"
}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.uibakery.io/on-premise/git-source-control/git-audit-log-events.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.