> For the complete documentation index, see [llms.txt](https://docs.tessell.com/tessell/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tessell.com/tessell/database-engines/tessell-for-oracle/db-services/my-services/database-service-home-page/logs.md).

# Logs

The Logs tab provides access to Oracle-specific log files for troubleshooting. Logs are stored in the customer's cloud subscription and streamed to the Tessell console for viewing only — Tessell does not store or move logs outside your cloud account.

Available log files:

* **Oracle Listener Logs**
* **Oracle Alert Logs**
* **Oracle DBCA Trace Logs**

***

## How do I view logs for my database service?

1. If the service has multiple instances, select an instance from the **instance dropdown** at the top.
2. On the left panel, select a log file from the list, or type its name in the **Search** bar.
3. The log contents appear on the right panel.
4. Use the **Search** bar in the right panel to find specific log terms.
5. Toggle **Show line numbers** to display line numbers alongside log entries.
6. Click **Go Live** to stream logs updated every 15 seconds. A **Live** indicator confirms you are viewing live logs.
7. Use **Load previous logs** to go back in the log history, or **Jump to bottom** to scroll to the latest entry.
8. Logs for the **last 1 hour** are displayed by default. Change the time range to 1h, 3h, 6h, 12h, or 24h using the time selector.

***

## How do I download log files?

Select the download button in the Logs tab. The log file downloads to your local **Downloads** folder.

### How do I download logs for a custom date range (AWS only)?

Custom range log downloads (using an asynchronous export flow) are supported for **AWS subscriptions only**.

> **Note:** The DB log export feature must be enabled for your AWS subscription. For new AWS subscriptions, it is enabled by default. For existing subscriptions, contact your administrator to enable it.

#### Steps to download logs for a custom date range (AWS only)

1. Select **Custom** in the time range selector, choose your start and end date/time, and click **Apply**.
2. Click the **download button**. A download request dialog opens.
3. Select an **expiry duration** for the exported file: 1, 2, 3, 7, or 30 days — or **No Expiry** to retain indefinitely.
4. Click **Submit** to queue the export.

   > The export is processed asynchronously. Availability depends on queue position and log volume.
5. Check export status in the **Download History** section of the Logs tab:

   | Status          | Description                                                                         |
   | --------------- | ----------------------------------------------------------------------------------- |
   | **Queued**      | Waiting to be processed. Only one export runs at a time per AWS account per region. |
   | **In Progress** | Export is being processed.                                                          |
   | **Completed**   | Ready to download. Click **Download** to retrieve via a pre-signed URL.             |
   | **Failed**      | Export could not complete. Retry or contact Tessell support.                        |
6. Once **Completed**, click **Download**.

   > The download link is valid for **1 hour**. If it expires, return to Download History and click **Download** again to generate a fresh link. The exported file remains available in storage until its expiry duration elapses.
7. To delete an exported file before it expires, click **Delete** next to the completed export in Download History.

***

> **Constraints for custom log exports (AWS only):**
>
> * **Size limit:** Export requests are limited to 5 GB of log data. Requests exceeding this are rejected at submission.
> * **Queue behaviour:** Only one export runs at a time per AWS account per region. Concurrent requests are queued.
> * **Non-AWS subscriptions:** Custom range download via the export flow is not available. Use the standard preset time ranges instead.


---

# 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.tessell.com/tessell/database-engines/tessell-for-oracle/db-services/my-services/database-service-home-page/logs.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.
