# Audit Logs

Audit logs, also known as audit trails, are records that chronologically document a sequence of activities or changes within a system. They capture detailed information such as the time of the event, the user involved, the action performed, and the outcome of the action.

### **Uses:**

1. **Security Monitoring:** Detect unauthorized access or suspicious activities.
2. **Compliance:** Ensure adherence to regulatory standards and internal policies.
3. **Forensic Analysis:** Investigate security breaches or incidents.
4. **Accountability:** Track user actions to ensure responsible use of resources.
5. **Troubleshooting:** Diagnose and resolve system errors or issues.

### Permission Required

Users need `Audit Logs` permission under [Organisational Level Permissions ](https://support.squadcast.com/manage-users/user-permissions-access-controls)to use this feature.

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-146a634989db1bbc0cc991a33d9c4f388492b89d%2F1.png?alt=media" alt=""><figcaption></figcaption></figure>

### Usage

You can access Audit logs under **Settings -> Audit Logs** and directly view the **Live Logs** for the selected duration.

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-056793e0c4e363d5b64d74780d5aa9b84009d22c%2F2.png?alt=media" alt=""><figcaption></figcaption></figure>

#### View Logs

You can hover over the log and click on **View Logs** to view the details of a specific event.

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-a8dbcc260fc23733665ba6989ed97c51653e300c%2F3.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-5774df867a5d1daf42b7a1bc1b08bc5bc4e251f3%2F4.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Filter Logs

You can filter and search for a specific log by clicking on the **Filter** icon and then applying the specific filters.

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-764e9f62efbd17ff39462ddda32c969f8ea7afbb%2Ffilter.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-3878ba958beef270587a250b878144fd9e6cb21e%2F5.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-e3a0d4b7386b07d9064c9ff17730d2d5db7a4646%2F6.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Export Logs

You can export your specific filtered logs by clicking on the **Export** button and fill the details such as a Name of the export and then choose the exported document type between **CSV** or **JSON.**

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-9dfaef20faf48a1535c2fc5aba138f189d87fe84%2Fexport.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-24449fdcdb76ed8f8247edba5163aa7ccf82ab76%2F7.png?alt=media" alt=""><figcaption></figcaption></figure>

Then you can go to the **Export History** tab and then download the audit log by hovering over the name and click on the **Download** button. It might take some time for the export to be ready and you can download it once it's status becomes **Completed.**

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-f5a49add93cda254ca046e57b052075e2e2aedd6%2F8.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-cbc1ffc8efd4f99427f59845ffb047f04795dd7f%2F9.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-dd07a5800dcd9076a0ffe786161ff7402d8f42e4%2F10.png?alt=media" alt=""><figcaption></figcaption></figure>

### Availability

This feature is only available on the **Enterprise** plan

### Audit Log History

You can view or download only the data for the past 1 year and a maximum of 3 months at a time.

If you need access to data more than 1 year old, please reachout to our Support team.

### Limitations

* This feature will only record data of events after it has been released to Production, events before the release of this feature will not be available.


---

# Agent Instructions: 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:

```
GET https://support.squadcast.com/managing-your-squadcast-account/audit-logs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
