Skip to content

DOCS-1852 - Document colon-delimited Metric Rules match expressions - #7096

Open
JV0812 wants to merge 4 commits into
mainfrom
DOCS-1852
Open

DOCS-1852 - Document colon-delimited Metric Rules match expressions#7096
JV0812 wants to merge 4 commits into
mainfrom
DOCS-1852

Conversation

@JV0812

@JV0812 JV0812 commented Sep 3, 2026

Copy link
Copy Markdown
Collaborator

Purpose of this pull request

Documents the colon-delimiter support for Metric Rules match expressions and variable extractions, per SUMO-292913 (enabling the metrics.rules.parser.enable.extended.delimiters flag).

  • Renamed "Dot-delimited match expressions" → "Dot- and colon-delimited match expressions" (and the matching "Extract variables from..." section) to cover both delimiters, with a colon example using an AWS ARN string (the motivating use case per the SCR).
  • Added a note that a colon-delimited match expression matching no time series may mean the flag isn't enabled for the account yet (per SUMO-292913, colon-delimited expressions fail silently without it).
  • Updated internal anchor links and the greedy-matching and step-by-step sections to reflect that colon works the same as dot.

Verified via yarn build (no broken links/anchors).

Select the type of change

  • Minor Changes - Typos, formatting, slight revisions
  • Update Content - Revisions, updating sections
  • New Content - New features, sections, pages, tutorials
  • Site and Tools - .clabot, version updates, maintenance, dependencies, new packages for the site (Docusaurus, Gatsby, React, etc.)

Ticket (if applicable)

https://sumologic.atlassian.net/browse/DOCS-1852

Metric Rules match expressions and variable extractions now also
support colon (:) as a segment delimiter, alongside dot, gated
behind metrics.rules.parser.enable.extended.delimiters (SUMO-292913).
Useful for colon-separated identifiers like AWS ARNs. Adds a note
that a colon-delimited expression matching nothing may mean the flag
isn't enabled yet for the account.
@JV0812 JV0812 self-assigned this Sep 3, 2026
@cla-bot cla-bot Bot added the cla-signed Contributor approved, listed in .clabot file label Sep 3, 2026
Microsoft Manual of Style outranks Chicago in our style guide's
reference precedence, and Microsoft recommends against suspended
compound modifiers outside space-constrained contexts. Spells out
"dot-delimited or colon-delimited" in full instead of "dot- or
colon-delimited", and adds a Word List entry so this doesn't need
re-litigating.
Comment thread docs/contributing/word-list.md Outdated
Comment thread docs/metrics/metric-rules-editor.md Outdated
Comment thread docs/contributing/word-list.md Outdated
- metric-rules-editor.md: "a match expression can be a dot-delimited
  or colon-delimited string" (was "one or more ... string",
  singular/plural mismatch).
- word-list.md: closing period now inside the quote, matching the
  first example and the file's existing convention.
@JV0812
JV0812 requested a review from kimsauce September 4, 2026 06:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed Contributor approved, listed in .clabot file

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants