> For the complete documentation index, see [llms.txt](https://engineering-ing-inf-rd.gitbook.io/true-connector/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://engineering-ing-inf-rd.gitbook.io/true-connector/advanced-configuration/auditlogs.md).

# Audit logs

Audit logs must be turned on for a proper and secure deployment of the connector. All audit events are stored in database (H2 with default configuration, possible to replace with PostgreSQL, more information can be found [here](/true-connector/advanced-doc/postgreconfiguration.md)), this way tampering of the logs is prohibited. Entries in database are done only by the Execution Core Container. Column for storing auditLog entry is encrypted using *AES/GCM/NoPadding* algorithm which requires user to set valid password. It must be done setting OS environment variable with following name: *AES-SECRET-KEY*.\
When ECC inserts audit entry into Database, AuditLog value will be encrypted using provided algorithm, and when data is requested, it will be decrypted.<br>

If you wish to configure it or even turn off please follow this [document](https://github.com/Engineering-Research-and-Development/true-connector-execution_core_container/blob/1.14.8/doc/AUDIT.md) .

**Accessing audit logs**

ECC exposes protected endpoint, for API user, to fetch all audit logs, or audit logs for specific date:

```
https://localhost:8090/api/audit/
```

or for specific date

```
https://localhost:8090/api/audit/?date=2024-02-12
```

NOTE: date format must be in YYYY-MM-DD format. Otherwise response will be https 400 - bad request.

**Trace log file**

Trace log file contains logs that can be useful when debugging or investigating what was incorrect and why connector is not responding as expected.

User might try to solve the problem, in most cases problem will be configuration related or that invalid values are passed.

More information about OS logs on Host machine and how to configure it can be found [here](https://github.com/Engineering-Research-and-Development/true-connector/blob/main/doc/advancedConfiguration/os-logs-configuration.md)


---

# 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://engineering-ing-inf-rd.gitbook.io/true-connector/advanced-configuration/auditlogs.md?ask=<question>&goal=<endgoal>
```

`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.