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

# Logs

> Stream and search real-time installation logs for server and job services from the Ryvn dashboard, powered by Grafana Alloy and Loki.

Ryvn provides **real-time access** to your installation logs through our dashboard. Logs are available for installations
with a service type of server or job.

> [!NOTE]
>
> Logs are retained for **7 days** by default for all installations. Need longer retention? [Contact
> support](https://ryvn.ai/docs/support/contact-us.md) to discuss extended retention options.

## Log collection

Logs are collected via [**Grafana Alloy**](https://grafana.com/docs/alloy/latest/), an open-source lightweight collector that we deploy (\< 1% CPU, \< 100MB memory).

## Log storage and management

Ryvn uses **Loki**, a highly efficient log aggregation system, to store and query your logs. Loki provides powerful search capabilities and efficient log storage while maintaining minimal resource overhead.

### Your cloud environments

By default, logs are stored in **Ryvn's systems**. View and search logs through the dashboard with filters for:

* Installation name
* Time range
* Custom search terms

When viewing logs, you can select specific pods to view their logs. For installations with multiple pods, each pod name is displayed with its creation timestamp, making it easier to identify newer vs. older pods during deployments or troubleshooting.

> [!NOTE]
>
> Want to keep logs in your own infrastructure? [Contact us](https://ryvn.ai/docs/support/contact-us.md) to discuss options.

### Customer cloud environments

By default, logs from your customers' installations are stored in **Ryvn's systems**. If your customers have specific
data handling requirements, you can:

1. Store logs in your **own infrastructure**
2. Use **on-demand log transfer** as described below

#### On-demand log transfer

For customers who need strict data isolation, **on-demand log transfer** enables temporary access during critical
incidents while keeping logs in their environment at all other times. Here's how it works:

**1. Storage**

Logs are stored in your customers' environments until needed

**2. Time window**

Your customers specify a time window (e.g., last hour or 24 hours)

**3. Transfer**

Logs are **securely transferred** to your designated storage location - either your cloud infrastructure or Ryvn's
systems

**4. Access**

Inspect the transferred logs through the Ryvn dashboard

**5. Cleanup**

You or your customer can purge the transferred logs at any time
