Skip to content

Update KFL reference pages to match kfl2 specification#94

Open
alongir wants to merge 1 commit into
masterfrom
docs/kfl2-reference-update
Open

Update KFL reference pages to match kfl2 specification#94
alongir wants to merge 1 commit into
masterfrom
docs/kfl2-reference-update

Conversation

@alongir
Copy link
Copy Markdown
Member

@alongir alongir commented Apr 9, 2026

Summary

  • v2/kfl2.md: Complete rewrite of the KFL reference with all variables from the kfl2 spec — adds GraphQL, WebSocket, SCTP, ICMP, L4 connection/flow tracking, capture source, cross-reference, and resolution status variables. Adds map_get(), time functions (now(), timestamp(), duration()), type safety, default values, and negation sections. Fixes unsafe label access examples.
  • filtering.md: Replaces outdated KFL1 syntax (and/or, response.status, r"..." regex, old helpers like datetime(), json(), xml(), redact()) with modern KFL2/CEL syntax and a pointer to the full reference.
  • display_filters.md: Updates time filter example to use duration() instead of raw microseconds.

Test plan

  • Verify all three pages render correctly in the docs site
  • Confirm KFL examples use valid CEL syntax
  • Check internal links resolve correctly

- Rewrite v2/kfl2.md with complete variable reference: add GraphQL,
  WebSocket, SCTP, ICMP, L4 connection/flow tracking, capture source,
  cross-reference, and resolution status variables
- Add missing Kafka fields (kafka_api_key_name, kafka_request_summary),
  Redis total_size, HTTP header sizes, DNS sizes, TLS total_size
- Add map_get() function docs and fix unsafe label access examples
- Add type safety, default values, and negation sections
- Add time functions (now(), timestamp(), duration()) with modern examples
- Rewrite filtering.md from outdated KFL1 syntax (and/or, response.status,
  r"..." regex) to KFL2 CEL syntax with pointer to full reference
- Update display_filters.md time example to use duration()
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 9, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Apr 9, 2026 10:16pm

Request Review

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.

1 participant