> 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-postgresql/db-services/readme-postgresql/homepage-postgresql/logs-postgresql.md).
# Logs
The Logs tab provides access to the `postgres_db_data_log` PostgreSQL DB logs 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.
***
## 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, view the log entries and select a log file to view its details on the right.
3. Use the **search bar** to find specific log terms.
4. Toggle **Show line numbers** to display line numbers alongside log entries.
5. Click **Go Live** to stream logs updated every 15 seconds. A **Live** indicator confirms you are viewing live logs.
6. Use **Load previous logs** to go back in the log history, or **Jump to bottom** to scroll to the latest entry.
7. 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**. For non-AWS subscriptions, the standard download behavior applies.
> **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.
Figure 1 — Logs tab
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.tessell.com/tessell/database-engines/tessell-for-postgresql/db-services/readme-postgresql/homepage-postgresql/logs-postgresql.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
