Audit configuration
Set up the audit level and the audit log file name.
Read time 2 minutesLast updated 21 days ago
Set up the Unity Version Control (UVCS) audit level and the audit log file name in the server administration console.
Audit log levels
By default, the audit log is active and set to log level one in theaudit.logAudit Level | Description |
|---|---|
| 0. Do not log anything on the audit log | Doesn't log any operation. |
| 1. Log deleted objects | Only logs the operations related to deleting objects. |
| 2. Log access denied to objects | Logs operations if a user is denied access to objects and tries to access them. |
| 3. Log Added/Edited/Renamed objects | Logs any action related to the operations |
| 4. Log read access to revisions | Logs any access to any revision. For example, when a user switches to a changeset or a branch, or diffs two revisions. |
Note
Each audit level includes any previous levels.
Audit log files
An audit log file includes a line for any logged operation with the following structure:<HASH> <user> (<machine>) <timestamp> [<repository>]: <operation>
Parameter | Description |
|---|---|
| The unique identifier of the logged operation. |
| The user/developer who performed the operation. |
| The machine from which the operation is performed. |
| The time the operation was performed. |
| The repository that was affected by the operation. |
| The description of the performed operation. |
Example audit log file
MHXET08/RpZQaJWXLlU/v7ovDPugjEOBSG9/74HFgD8= maria (HERMES) 6/23/2017 5:11:31 PM [doom3src]: Branch deleted: scm15478 (7991)ZDSSKBGFy6SRg/O38WiyJzHbhqmUCq7SMoMp3Eqfiuc= maria (HERMES) 6/23/2017 5:44:06 PM [doom3src]: Deleted '/README.txt' (changeset 8375)dhZG9IWM10FoHTGF+amMEeErFmHkZ2KIIL1t/uwxtYI= sue (HERMES) 6/23/2017 5:49:46 PM [doom3src]: Access denied to object 'rep:10', operation 'view'q23jnDUDPZAicF2bYWZOWihMbXRn3/JLYSJDqOW1xJ4= maria (HERMES) 6/23/2017 5:56:14 PM [doom3src]: New label: BL064 (8408) applied to changeset 8398k2L9HjEMqktYo7tDZQuo9PghlHgs+BMH+q3oFspRm/8= maria (HERMES) 6/23/2017 5:58:04 PM [doom3src]: Comment changed on '8408' from '' to 'Label audit test'u84wRigufEZTKUcQrwJSjcLIxyV9b3LjwyyuX8pLUII= maria (HERMES) 6/23/2017 5:58:25 PM [doom3src]: New attribute: 'review' (8409)AJSY/4c4QeuHU8GKIYzIdI92k6JiZoa5/ye73YIzolI= maria (HERMES) 6/23/2017 6:04:49 PM [rep03]: New branch: /main (3)e7Mb3A49LcohQWzOCk9pAnT6Pvz5JgWNIuqthgh69BA= maria (HERMES) 6/23/2017 6:04:49 PM [rep03]: New repository: rep03 (577)3B4jcQwNsgpi7NueKwV6rFU7vgfH1rAAQ6t+hQyXZ6U= maria (HERMES) 6/23/2017 6:17:45 PM [doom3src]: Attribute 'review' renamed to 'reviewed' (8409)/BKLej1sb66/FlqJ/9Hr/8oiV/R50nP/oR5UEwCmbO4= maria (HERMES) 6/23/2017 6:19:58 PM [doom3src]: Comment changed on '8425' from 'Renamed' to 'File renamed'jvck2dfnGSosVXSeLYkSzNOaFZZY1Z8AcEJtWoSx59w= maria (HERMES) 6/23/2017 6:31:10 PM [doom3src]: Downloaded revision 22762YqWTWGEw+UbuZRYfo2ZiDEKYRMBZyGc+Tc+myQqtPc= maria (HERMES) 6/23/2017 6:31:10 PM [doom3src]: Downloaded revision 7343WrA0T9Pq276DqFxDLhoVI1gnfdWzKNEo69refw8q640= maria (HERMES) 6/23/2017 6:31:10 PM [doom3src]: Downloaded revision 8016FxFNosrb4XuAOyzwsOsiOsISgdy5S7kY5wXxPKyP/5E= maria (HERMES) 6/23/2017 6:31:10 PM [doom3src]: Downloaded revision 8320
Note
To collect hashes regularly, you can schedule the command. For example, .
tailtail -n 1 audit.log |mail admin@myorg.com