> ## Documentation Index
> Fetch the complete documentation index at: https://www.qovery.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Logs

> Access deployment and service logs

Qovery provides you with the logs of your deployments and services through the Qovery Console.

## Two Types of Logs

Qovery provides you with two types of logs:

1. **Deployment logs**: Every time a deployment is triggered, Qovery provides you with the log of its execution and the errors if any
2. **Service logs**: Real-time logs of your application streamed directly from your application (not stored on Qovery's infrastructure)

## How to Access Logs

You can access logs from three different entry points in the Qovery Console:

<img src="https://mintcdn.com/qovery/ziWdn5St6rf4bcBc/images/deployment/access_logs.png?fit=max&auto=format&n=ziWdn5St6rf4bcBc&q=85&s=2da26ead02e9b848c8714091f5c6fb51" alt="Access Logs" width="3164" height="2070" data-path="images/deployment/access_logs.png" />

1. **Scroll icon** next to the service: Access the service logs (runtime logs from your application)
2. **Last Deployment section**: Access the deployment pipeline view showing all stages of the deployment
3. **Deployment status label**: Access the deployment logs for a specific deployment

## Pipeline View

The pipeline view provides a centralized overview of your deployment process, showing all deployment stages including pre-check validations.

<img src="https://mintcdn.com/qovery/yDPPPWPKgIjFS10L/images/deployment/pipeline_view.png?fit=max&auto=format&n=yDPPPWPKgIjFS10L&q=85&s=f0bb3e2e9099dbc93adc2f930b0a018b" alt="Pipeline View" width="3164" height="2070" data-path="images/deployment/pipeline_view.png" />

**Features:**

* Stage-by-stage visibility of deployment phases
* Pre-check logs for validation processes
* Direct access to specific deployment logs per service
* Automatic filtering of services not involved in the deployment

## Deployment Logs

By default, the deployment logs view shows the most recent deployment execution.

<img src="https://mintcdn.com/qovery/ziWdn5St6rf4bcBc/images/deployment/deployment_logs_view.png?fit=max&auto=format&n=ziWdn5St6rf4bcBc&q=85&s=f9c8659a3255e26c356a4b16fe54af75" alt="Deployment Logs View" width="3164" height="2070" data-path="images/deployment/deployment_logs_view.png" />

**What's included:**

* Build logs when Qovery CI pipeline builds your service
* Deployment status updates during Kubernetes execution
* Final success/failure confirmation with issue guidance

### Build Runner Usage

For services that include a build step (applications and jobs with a git source), a **Build runner usage** button appears in the deployment logs header alongside "Go to pipeline" and "Go to service logs".

Clicking this button generates a temporary Grafana snapshot showing build pod resource usage (CPU, memory, network I/O) and opens it in a new tab. The link is publicly accessible and expires after **1 hour**.

The snapshot covers from build start to \~40 minutes after, scoped to the specific build pod. This helps identify resource-constrained builds and right-size build infrastructure.

<Note>
  This button is only visible for services with a build step. It does not appear for services deployed from a pre-built container image.
</Note>

You can access historical deployments through the "Deployment log switch" or the Deployment history tab.

<img src="https://mintcdn.com/qovery/ziWdn5St6rf4bcBc/images/deployment/deployment_history.png?fit=max&auto=format&n=ziWdn5St6rf4bcBc&q=85&s=206db6f0bd4d2fffa82e61f4510d0378" alt="Deployment History" width="3164" height="2070" data-path="images/deployment/deployment_history.png" />

<Note>
  Qovery retains logs for **the last 20 deployments executed** plus the latest failure.
</Note>

## Service Logs (Live Logs)

Real-time application logs are streamed directly from your running applications.

<img src="https://mintcdn.com/qovery/yDPPPWPKgIjFS10L/images/deployment/live_logs.png?fit=max&auto=format&n=yDPPPWPKgIjFS10L&q=85&s=601138982d2e163fb195110b9f0adc6f" alt="Live Logs" width="3164" height="2070" data-path="images/deployment/live_logs.png" />

Each log entry displays:

* **Timestamp**: When the log was generated
* **Pod name**: Which instance generated the log (filterable for multi-instance applications)
* **Version**: Commit ID or image tag
* **Container**: Container name
* **Message**: The actual log content

### Filtering Logs

<img src="https://mintcdn.com/qovery/yDPPPWPKgIjFS10L/images/deployment/live_logs_filtered.png?fit=max&auto=format&n=yDPPPWPKgIjFS10L&q=85&s=b0ea6253b8e357b28a66c4e299c111f5" alt="Filtered Logs" width="3164" height="2070" data-path="images/deployment/live_logs_filtered.png" />

You can filter logs using:

* **Search by keyword**: Locate specific messages
* **Filter by time range**: Isolate specific periods
* **Filter by log level**: Prioritize by severity
* **Filter by pod**: View logs from specific instances
* **Filter by deployment ID**: Isolate logs from a specific deployment

#### Filter by Deployment ID

When troubleshooting a failed deployment, you can filter logs using the `deployment_id` to see only the logs produced during that specific deployment. This removes noise from other deployments and helps you get to the root cause faster.

To use this feature:

1. Navigate to the deployment history and find the deployment ID you want to investigate
2. Apply the deployment ID filter in the logs view
3. Review only the logs generated during that specific deployment's bootstrap process

<Tip>
  When viewing deployment logs, clicking "Go to service logs" automatically applies the deployment ID filter, seamlessly transitioning you from deployment logs to the filtered service logs for that specific deployment.
</Tip>

This is especially useful when:

* A deployment fails during application startup
* You need to isolate issues from a specific deployment attempt
* Multiple deployments have occurred and you want to focus on one particular execution

## Log Retention

Log retention depends on whether you have an observability package enabled:

| Feature          | With Observability Package   | Without Package               |
| ---------------- | ---------------------------- | ----------------------------- |
| **History**      | 12 weeks complete            | 24 hours maximum              |
| **Volume**       | Unlimited lines              | Latest 1000 lines per service |
| **Capabilities** | Advanced filtering & metrics | Real-time only                |

Configuration is available through cluster advanced settings.

## Nginx Logs

For publicly exposed applications, Nginx logs are also accessible through the same interface, displaying request management information.

## Next Steps

<CardGroup cols={2}>
  <Card title="Deployment History" icon="clock-rotate-left" href="/configuration/deployment/history">
    Review past deployments
  </Card>

  <Card title="Deployment Statuses" icon="circle-info" href="/configuration/deployment/statuses">
    Understand deployment statuses
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/getting-started/troubleshoot/overview">
    Troubleshoot deployment issues
  </Card>

  <Card title="Observability" icon="chart-line" href="/configuration/integrations/observability/qovery-observe">
    Advanced logging and monitoring
  </Card>
</CardGroup>
