Astro Observe delivers pipeline-aware data observability purpose-built for Airflow, giving your team visibility into the health, quality, and performance of your business critical data products across the modern data stack. This guide outlines the fundamental requirements and steps to onboard.Documentation Index
Fetch the complete documentation index at: https://astronomer-preview.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Prerequisites
- Astro Deployment running Astro Runtime 9 or later (
apache-airflow>=2.7.0) - OpenLineage Airflow provider (
apache-airflow-providers-openlineage>=1.12.1) and OpenLineage client (openlineage-python>=1.38.0) specified in project dependencies (for example, inrequirements.txt) - At least one asset running in Airflow
- Observe Member, Billing Admin, or higher role required to create data products (see user permissions reference)
- OpenLineage enabled for Remote Execution Agents if using Remote Execution
Astronomer recommends using the latest possible OpenLineage provider version and the latest OpenLineage client version. The client can be updated regardless of your Airflow version. See Configure OpenLineage on Astro for more information and upgrade instructions.
Set up Astro Observe
Confirm your Deployments are running the recommended OpenLineage client and provider versions by checking your Astro project’s
requirements.txt. See Configure OpenLineage on Astro for instructions on upgrading to the recommended client and provider versions.A data product is a composition of assets that, taken together, deliver a result with business relevance.For guidance on identifying data products in your organization, see how to identify data products in your organization.
In the Astro UI, navigate to Observe > Data Products. Select + Data Product and follow the prompts to define your product and choose assets.
See Create a data product for more information.
Add an SLA to your data product to monitor freshness or timeliness of your data product. See Create an SLA.
Set up alerts to be notified of SLA violations or potential failures. To monitor the SLA you just created, click the SLAs tab in your data product, and select the SLA you want to monitor. Click + Alert to set up a Data Product SLA Violation Alert. See Create an alert for details on alert configuration settings.
To allow others to create data products, SLAs, and monitors in Observe, grant the Observe Member or Observe Admin role to any teammates who need to set up and manage these features.
See user permissions reference for instructions on managing roles.
Next steps and resources
- For in-depth guides, advanced configuration, and best practices, see the full Create and use data products documentation.
- Explore how to work with assets, monitor data products, and set up notifications.
- Review permissions to ensure your team has the right access.