We envision Data Prepper as an open source data collector for observability data (trace, logs, metrics) that can filter, enrich, transform, normalize, and aggregate data for downstream analysis and visualization. It will support stateful processing across multiple instances of data pipelines for observability use cases such as distributed tracing and multi-line log events (e.g. stack traces, aggregations, and log-to-metric transformations). Currently Data Prepper supports processing of distributed trace data and log ingestion with plans to support metric data in the future.

Please read the Overview to understand what Data Prepper is and how it works.

Our Getting Started guide is the best starting point for anybody who wants to run Data Prepper.

Please read the Trace Analytics guide or Log Analytics to get started with using Data Prepper for trace or log analytics use cases.

• Downloads
• Documentation
• Configuration Reference
• Need help? Try the Data Prepper category in the OpenSearch forums
• Project Principles

We invite developers from the larger OpenSearch community to contribute and help improve test coverage and give us feedback on where improvements can be made in design, code and documentation. You can look at contribution guide for more information on how to contribute.

If you are looking to contribute code, or just to build from source, please see our Developer Guide.

This project has adopted an Open Source Code of Conduct.

If you discover a potential security issue in this project, please refer to the security policy.

This library is licensed under the Apache 2.0 License

Copyright OpenSearch Contributors. See NOTICE for details.