26 breaking releases
Uses new Rust 2024
| 0.30.0 | Jan 22, 2026 |
|---|---|
| 0.29.0 | Dec 11, 2025 |
| 0.28.1 | Nov 10, 2025 |
| 0.25.0 | Jun 26, 2025 |
| 0.5.0 | Jun 28, 2023 |
#31 in Programming languages
1,209,923 downloads per month
Used in 14 crates
(7 directly)
2.5MB
69K
SLoC
Vector Remap Language (VRL)
VRL is a scripting language for processing observability data (logs, metrics, traces). Although VRL was originally created for use in Vector, it was designed to be generic and re-usable in many contexts.
VRL is maintained by Datadog's Community Open Source Engineering team.
Features
VRL is broken up into multiple components, which can be enabled as needed.
| Feature | Default | Description |
|---|---|---|
| compiler | yes | The contains the core functionality of VRL. Compiling and running VRL programs. |
| parser | yes | Creates an abstract syntax tree (AST) from VRL source code. |
| value | yes | Contains the primary data type used in VRL. |
| diagnostic | yes | Logic related to errors and displaying info about them. |
| path | yes | Contains the parser, datatypes, and functions related to VRL paths. |
| stdlib | yes | All of the VRL functions from the standard library. |
| core | yes | Various data structures and utility methods (these may be renamed / moved in the future). |
| datadog_filter | yes | Implements the Datadog log search query filter syntax. |
| datadog_grok | yes | Implements the Datadog grok parser. (used with parse_grok and parse_groks in the stdlib). |
| datadog_search | yes | Implements the Datadog log search syntax. |
| cli | no | Contains functionality to create a CLI for VRL. |
| test_framework | no | Contains the test framework for testing VRL functions. Useful for testing custom functions. |
| lua | no | Makes the Value type compatible with the mlua crate. |
| arbitrary | no | Implements Arbitrary (from the quickcheck crate) for the Value type |
| test | no | Enables testing utils and additional tests, including those with external dependencies such as network calls. |
Webassembly
All of the core features, and most of the standard library functions can be compiled with the wasm32-unknown-unknown target.
There are a few stdlib functions that are unsupported. These will still compile, but abort at runtime.
Unsupported functions:
parse_grokparse_grokslogget_hostnamereverse_dnshttp_request
Dependencies
~18–50MB
~684K SLoC