4 releases (breaking)

new 0.7.0 Sep 25, 2023
0.6.0 Aug 2, 2023
0.5.0 Jun 28, 2023
0.4.0 May 12, 2023

#23 in Programming languages

Download history 3377/week @ 2023-06-09 2716/week @ 2023-06-16 5188/week @ 2023-06-23 2511/week @ 2023-06-30 1971/week @ 2023-07-07 2072/week @ 2023-07-14 2083/week @ 2023-07-21 1728/week @ 2023-07-28 1876/week @ 2023-08-04 1733/week @ 2023-08-11 2274/week @ 2023-08-18 3349/week @ 2023-08-25 1954/week @ 2023-09-01 2479/week @ 2023-09-08 2003/week @ 2023-09-15 1730/week @ 2023-09-22

8,963 downloads per month

MPL-2.0 license

54K SLoC

Vector Remap Language (VRL)

Crates.io docs.rs GitHub Workflow Status

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 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


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_grok
  • parse_groks
  • log
  • get_hostname
  • reverse_dns


~764K SLoC