Skip to content

Add missing VRL functions to Custom Processor doc [WEB-7892]#37611

Merged
Jackie-Robson merged 4 commits into
masterfrom
jackie.robson/web-7892-add-missing-vrl-functions
Jun 24, 2026
Merged

Add missing VRL functions to Custom Processor doc [WEB-7892]#37611
Jackie-Robson merged 4 commits into
masterfrom
jackie.robson/web-7892-add-missing-vrl-functions

Conversation

@Jackie-Robson

@Jackie-Robson Jackie-Robson commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

What does this PR do?

Adds four VRL functions that exist in the Vector docs but were missing from the Observability Pipelines Custom Processor function reference.

Functions added:

  • pop (Array) — removes the last item from an array
  • encrypt_ip (IP) — encrypts an IP address using AES-128 or prefix-preserving mode
  • decrypt_ip (IP) — decrypts an IP address previously encrypted with encrypt_ip
  • haversine (Map, new category) — calculates great-circle distance and bearing between two geographic coordinates

Motivation

Reported in WEB-7892: these functions were visible in Vector VRL docs but missing from the OP Custom Processor page.

Additional notes

  • haversine introduces a new Map category (sourced from Category::Map in the VRL stdlib). The category nav in custom_processor.md has been updated accordingly.
  • encrypt_ip / decrypt_ip are fallible (require ! suffix).
  • pop and haversine are infallible.

Review checklist

  • Previewed in staging
  • Function signatures verified against VRL stdlib source

Adds four VRL functions that exist in Vector but were missing from the
OP Custom Processor reference: pop (Array), encrypt_ip (IP), decrypt_ip
(IP), and haversine (new Map category).
@github-actions

Copy link
Copy Markdown
Contributor

Preview links (active after the build_preview check completes)

Modified Files

@StefonSimmons

Copy link
Copy Markdown
Contributor

@Jackie-Robson Jackie-Robson marked this pull request as ready for review June 22, 2026 14:44
@Jackie-Robson Jackie-Robson requested review from a team as code owners June 22, 2026 14:44

@rtrieu rtrieu left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

just a few small suggestions but otherwise this looks great. thanks so much!

Comment thread content/en/observability_pipelines/processors/custom_processor.md Outdated
Comment thread data/reference/functions.json Outdated
Comment thread data/reference/functions.json Outdated
Jackie-Robson and others added 3 commits June 23, 2026 11:20
Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>
Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>
Co-authored-by: Rosa Trieu <107086888+rtrieu@users.noreply.github.com>

@rtrieu rtrieu left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@Jackie-Robson Jackie-Robson merged commit 52bacbd into master Jun 24, 2026
19 checks passed
@Jackie-Robson Jackie-Robson deleted the jackie.robson/web-7892-add-missing-vrl-functions branch June 24, 2026 16:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants