# Pipeline logs

Pipeline logs are detailed records that let you inspect what is happening at each step of a pipeline's execution cycle. In the Pipeline logs tab, you can track the event logs recorded during pipeline execution.

### Environment

Select the desired environment in the upper left corner of the page. When you select an environment, the page refreshes to display the corresponding data.

{% hint style="warning" %}
Log history expires after **3 days** in the test environment and after **10 days** in the production (prod) environment.
{% endhint %}

### Search fields

Use the fields below to filter pipeline logs. The results list displays logs that match the selected criteria.

| Field                      | Description                                                                                                         |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Log message**            | The information sent by a connector that returns logs during pipeline execution. Search for whole words only.       |
| **Pipeline name**          | The pipeline name as defined by the user. Search for whole words only.                                              |
| **Pipeline version**       | The pipeline version number. Must be used together with the pipeline name, otherwise the search returns no results. |
| **Pipeline execution key** | The unique identifier of a pipeline execution.                                                                      |

#### Using the pipeline version field

The pipeline version field only works in combination with the pipeline name field.

| Pipeline name | Version | Result               |
| ------------- | ------- | -------------------- |
| John          | 1.0     | ✅ Returns results    |
| *(empty)*     | 1.0     | ❌ Returns no results |

### Filters

#### Log level

Filter executions by log classification:

| Level     | Description                                                    |
| --------- | -------------------------------------------------------------- |
| **ALL**   | Any kind of log information.                                   |
| **INFO**  | Information about ordinary events during pipeline execution.   |
| **WARN**  | Information about possible problems during pipeline execution. |
| **ERROR** | Information about errors during pipeline execution.            |

#### Logs by source

Filter results by log origin:

* **Digibee Internals** — Shows only internal platform logs.
* **Log Connector** — Shows only logs explicitly added by the user in the pipeline.

#### Time period

Filter pipelines by execution time. Select from the last **5**, **15**, or **60 minutes**, or define a custom time interval.

### Logs table

The logs table displays results according to the selected filters.

* Click a log to open its details in a modal.
* Hover over any cell to reveal the **copy icon**, then click to copy the information.


---

# Agent Instructions: 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:

```
GET https://docs.digibee.com/documentation/developer-guide/development-cycle/dashboards/pipeline-logs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.