nano SIEM
Pipelines

pivt in Pipelines

Supported in:Self-hosted

Ask about a step and review proposed VRL changes

Use pivt to explain a processing step or propose VRL changes you can review. Choose Ask pivt about this pipeline to open it. Availability depends on the edition, AI configuration, and permissions; a disabled button explains why it is unavailable.

Ask with context

Load representative input and run a preview first. Select the step you want help with, then open pivt. It receives the source name and type, ordered steps, the selected step's VRL, enabled steps before it, later step context, and the last preview error or failing trace. Up to five qualifying sample messages are attached, each limited to 8 KiB.

Use Edit step to work on the selected step, or New step after to propose a new step after the selection. Example requests:

  • “Explain why this step fails on the selected sample.”
  • “Mask the email field while preserving its domain.”
  • “Draft a step that removes heartbeat events from these samples.”

Review a proposal

pivt shows proposed VRL, its diff, and any validation and test results returned. Review the code and sample outputs. Choose Apply to step or Insert step to accept it, or reject the proposal.

Applying a proposal changes only the draft. Replacing a structured step converts it to Advanced VRL, preserving its name, enabled state, and execution condition. Inserting creates a new Advanced VRL step after the chosen anchor. A proposal becomes stale if its target changes; obtain a fresh proposal before applying it.

Run the full pipeline preview again, save the draft, validate, and review a release before publishing. pivt does not publish a proposal automatically. Native stateful steps still need their structured configuration and isolated preview checked; a single VRL proposal is not a substitute for a complete native transform graph.

Troubleshoot

Need help with these checks? Contact support with the deployment, request ID and time with timezone.

A proposal is stale

Obtain a fresh proposal if its target changed. Review its diff and run the full pipeline preview before you save or publish.

The pivt button is disabled

Read the button's explanation. Availability depends on your edition, AI configuration, and permissions.

What's next

On this page