Auditability / Event Log - TeamViewer Support
<main> <article class="userContent"> <p><br></p><h3></h3><h2 data-id="general">General</h2><div class="blockquote"><div class="blockquote-content"><p class="blockquote-line"><em>This article applies to all TeamViewer customers with an Enterprise/Tensor </em><a href="https://www.teamviewer.com/en/pricing/" rel="nofollow noreferrer ugc"><em>license.</em></a></p><p class="blockquote-line"><em>This article applies to TeamViewer version 14.1 or higher</em></p><p class="blockquote-line"><em>This article applies to Windows, Mac, and Linux.</em></p></div></div><p>The Auditability feature provides you with information necessary for your audits and protects your business against abusive claims by showing the track of activities.</p><p><br></p><h3 data-id="-1"></h3><h2 data-id="prerequisite">Prerequisite</h2><p>To be able to use this feature, you must meet the following requirements:</p><ul><li>You are using TeamViewer version 13.2 or newer.</li><li>You have a TeamViewer company account in order to access the Management Console where you can activate the feature for your company</li><li>You/your company own(s) a TeamViewer Tensor license</li></ul><p><br></p><h3 data-id="-2"></h3><h2 data-id="what-kind-of-data-is-collected">What kind of data is collected</h2><p>You will find a complete overview in the list of events below at the end of this article.</p><p><br></p><h3 data-id="-3"></h3><h2 data-id="whose-data-is-collected-during-remote-control-sessions">Whose data is collected during remote control sessions?</h2><p>Event data during remote control sessions is only collected from users who are authenticated as a member of the company that has enabled event logging.</p><p>Examples of a remote control session with two users:</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/U7G3QYS52O5Q/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/U7G3QYS52O5Q/image.png" alt="image.png" height="248" width="736" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><h3 data-id="-4"></h3><h2 data-id="data-retention">Data retention</h2><p>All event data is logged for 1 year on TeamViewer servers (located in Frankfurt). This retention period can't be changed. After 1 year all data will be automatically and completely deleted.</p><p><br></p><h3 data-id="-5"></h3><h2 data-id="how-to-activate-event-logs">How to activate event logs</h2><p>By default, event logging is not activated for your company as you should get general consent within your company about the collection and usage of the data.</p><p>Activating event logging can only be done as a company admin. You can activate it in the Management Console by clicking on your user profile and then navigating to <strong>Company administration</strong> <strong>--> Advanced --> Event logging --> Save</strong>. Now certain activities of all users that belong to your company will be logged.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/CR9N2OI829V6/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/CR9N2OI829V6/image.png" alt="image.png" height="767" width="1123" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><h3 data-id="-6"></h3><h2 data-id="how-to-access-event-logs-for-auditing">How to access event logs for auditing</h2><p>In order to have access to the event logs, you need to have access to the <strong>Event Log</strong> dialog in the Management Console. Your company admin can grant you access to this page.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/ZU240Z1SIQOY/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/ZU240Z1SIQOY/image.png" alt="image.png" height="908" width="1334" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><strong>💡Info: </strong>Granting access to event logs only works with the 4-eye-principle. You need another company admin granting you access.</p><p><br></p><h3 data-id="-7"></h3><h2 data-id="how-to-watch-and-filter-event-logs">How to watch and filter event logs</h2><p>When you have access to the event logs of your company, navigate to → "Event logs" in the left navigation panel of the Management Console.</p><p>If event logging is active for your company you will see the following screen:</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/9LWEFVX3BGSS/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/9LWEFVX3BGSS/image.png" alt="image.png" height="385" width="715" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>You can now start to search for specific events by using the given filter possibilities:</p><p>1) Date range: use this filter if you need to search for events in a specific date range.</p><p>⚠Be aware that the maximum date range is one month! If you want to search for events throughout multiple months, you need to execute multiple searches.</p><p>2) User: use this filter if you need to search for events executed by a specific person.</p><p>3)Change: use this filter if you need to search for a certain change done by any user.</p><p>4) Event type: use this filter if you need to search for multiple events grouped under a certain category. It will help you, for example, to search for all changes done by any user in the User Management.</p><p>Now you can click on single events to see more details for each event.</p><p><br></p><h3 data-id="-8"></h3><h2 data-id="how-to-download-event-logs">How to download event logs</h2><p>When you have access to the event logs of your company, navigate to → "Event logs" in the left navigation panel of the Management Console.</p><p>In order to download events apply your filters and afterward click on "Download Events". You will receive a CSV file containing the filtered events. </p><p>In order to have a good overview of all the downloaded events, we recommend you to import the CSV file into Excel.</p><h4 data-id="csv-columns">CSV columns</h4><p>The CSV file contains multiple columns that provide details about the recorded event. The following columns exist:</p><ol><li>Date: the date when the event was logged. The date logged in this column reflects the server date. </li><li>Time: the time when the event was logged. </li><li>Datetime (ISO8601): the date, time and timezone in ISO8601 format of the logged event.</li><li>Author: this is the person that executed the event. The author is displayed by the user name or if that is not existing by the TeamViewer ID.</li><li>Change: This is the event the author performed (in a short and readable format).</li><li>Event type: this is a category each event belongs to. It will help to group for certain event types, e.g. when you are only interested in changes that have been done to user properties all over the company</li><li>Affected item: the object on which the change was made</li><li>Property: the detailed property that was changed on the affected item, e.g. the user name of a user object</li><li>Old value: this column is only filled when an object was changed or deleted, but not when it was created. In case an object was changed the old, changed value is listed in order for you to see how the value was changed. If an object gets deleted, the old value shows the value the object had before deletion.</li><li>New value: this column shows the (new) value of the changed property.</li></ol><p><br></p><h3 data-id="-9"></h3><h2 data-id="event-log-rest-api">Event log REST API</h2><p>The event log can also be retrieved via the REST API. You will find more information about how to use the API in our official API documentation:</p><div class="js-embed embedResponsive" data-embedjson="{"body":"Develop applications that integrate TeamViewer functionality into your own corporate environment using the TeamViewer API.","photoUrl":"https:\/\/static.teamviewer.com\/resources\/2018\/12\/Facebook_v1.png","url":"https:\/\/www.teamviewer.com\/en\/for-developers\/#api-documentation-section","embedType":"link","name":"Develop your own apps using the TeamViewer API"}"> <a href="https://www.teamviewer.com/en/for-developers/#api-documentation-section" rel="nofollow noreferrer ugc"> https://www.teamviewer.com/en/for-developers/#api-documentation-section </a> </div><p><br></p><h3 data-id="-10"></h3><h2 data-id="list-of-events">List of Events</h2><p>This is the list of events TeamViewer catches and stores:</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/IKYEKNH47H71/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/IKYEKNH47H71/image.png" alt="image.png" height="817" width="725" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/Y1SNOCE8VCPI/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/Y1SNOCE8VCPI/image.png" alt="image.png" height="565" width="725" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p> </p><p> </p> </article> </main>
