---
title: "Send OpenLineage Events"
description: "It reads lineage events recorded by the platform and pushes them to your lineage backend using the OpenLineage standard"
url: https://docs.ovhcloud.com/de/guides/public-cloud/data-platform/dpe-actions-send-openlineage-events
lang: de
lastUpdated: 2026-09-14
---
> For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/de/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/de/llms-full.txt.

# Send OpenLineage Events

## Objective

The **Send OpenLineage Events** action forwards data lineage events from your Data Platform project to an external lineage solution connected via the [OpenLineage consumer](https://docs.ovhcloud.com/de/guides/public-cloud/data-platform/connectors-consumers-openlineage.md). It reads lineage events recorded by the platform and pushes them to your lineage backend using the [OpenLineage](https://openlineage.io/) standard.

![Send open lineage action](/images/public-cloud/data-platform/product/dpe/actions/send-openlineage-events/picts/send-open-lineage-action.png)
:::info
Before using this action, you must configure an [OpenLineage consumer](https://docs.ovhcloud.com/de/guides/public-cloud/data-platform/connectors-consumers-openlineage.md) in the Connectors to define where events should be sent.
:::

## Requirements

1. You have an external lineage solution with an OpenLineage-compatible HTTP API (e.g. [Marquez](https://marquezproject.ai/)).
2. You have configured an [OpenLineage consumer](https://docs.ovhcloud.com/de/guides/public-cloud/data-platform/connectors-consumers-openlineage.md) with the endpoint URL and auth token of your lineage backend.

## Create a Send OpenLineage Events action

1. Navigate to the **Actions** tab in the Data Processing Engine.
2. Click **New action**.
3. Select **Send OpenLineage Events** from the action store.

This action requires no additional configuration. It automatically reads the endpoint and authentication token from your [OpenLineage Consumer](https://docs.ovhcloud.com/de/guides/public-cloud/data-platform/connectors-consumers-openlineage.md) settings and uses them to forward events.

### How it works

Once triggered, the action processes all events stored in the `queued/` folder of the **DWH Bucket** and sends them to the configured OpenLineage endpoint.

### File handling

- **Successful sends**:
  - If `keep events` is set to `true` in the [OpenLineage Consumer](https://docs.ovhcloud.com/de/guides/public-cloud/data-platform/connectors-consumers-openlineage.md), successfully sent files are moved to the `success/` folder in the DWH Bucket.
  - Additionally, a summary log file is created under `openlineage/events/success/log/`.

- **Errors**:\
  In case of failure, the events are moved to the `error/` folder, and a detailed log file is generated under `error/logs/` containing more information about the error.

## Execution modes

You can run the _Send OpenLineage Events_ action in two ways depending on how frequently you want your lineage solution to be updated.

### Cron job

Schedule the action to run at a fixed interval using a cron expression. This is the recommended mode for most use cases where near-real-time lineage is not required.

To configure a cron schedule, open the action's **Settings** tab and set the trigger to **Cron**. Enter your desired cron expression (e.g. `0 * * * *` for every hour).

:::info
See [Time-Based Trigger configuration](https://docs.ovhcloud.com/de/guides/public-cloud/data-platform/dpe-jobs-preferences.md#time-based-trigger) for more details on scheduling jobs.
:::

### Always-up

Set the action to run continuously as a long-running process. In this mode the action stays active and forwards lineage events as soon as they are produced, keeping your lineage solution in near real time sync with Data Platform.

To enable always-up mode, open the action's **Settings** tab and set the trigger to **Always up**.

:::warning
Always-up actions consume compute resources continuously. Use this mode only when near real-time lineage is a requirement.
:::

## Go further

If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](https://www.ovhcloud.com/de/professional-services/) to get a quote and ask our Professional Services experts for a custom analysis of your project.

Ask questions, give your feedback and interact directly with the team building the Data Platform on the dedicated [Discord channel](https://discord.gg/ovhcloud).

If you need support with your OVHcloud services, create a request in our [Help Centre](https://help.ovhcloud.com/csm?id=csm_get_help).

Join our [community of users](https://community.ovhcloud.com/).