Anatomy of a scanning group
The group form has two steps.1. Describe the scanning group
2. Telemetry to scan
Pick a scanning method for Logs and, if sampling, a rate:Logs is the only product available for scanning today. Support for APM spans and API analytics is planned, and this page will be updated when they are available.
Filters
The filter query restricts a group to a subset of your logs. It is made up of space separatedkey:value pairs, and a log event has to match for the group’s rules to run against it.
Filtering is worth using when:
- Only some services log regulated data, and scanning everything would be wasteful.
- You want different match actions for different environments, for example redact in production and no action in staging.
- You are rolling a new rule out to one service before applying it everywhere.
An empty filter means the group sees all of your log traffic. That is the right default for a broad rule such as credit card detection, where you do not want a gap in coverage.
Sampling
Sampling limits how much of the matched traffic is actually scanned. It is a tuning and cost control, not a security control.100%scans everything the group sees. Use this for any rule you rely on for compliance.Samplescans the given percentage, between 10 and 90.Noneremoves Logs from the group, so the group scans nothing.
Group order
Groups are evaluated in the order they appear in the list, and you can drag them to reorder. Order matters when more than one group could act on the same event, since an earlier group’s match action changes the text that later groups see. A practical pattern is to put narrow, high confidence groups first and broad catch-all groups last.Enabling and disabling
Both the group and its individual rules have their own enabled state, and both are off when first created.
Disabling a group is the clean way to pause scanning. Your rules, filters, and sampling settings are all kept.
Deleting a group
Deleting a scanning group deletes every rule inside it. Custom rules you wrote are removed along with the group and cannot be recovered.When configuration takes effect
Changes to groups and rules apply to newly received logs. Already stored events are not rescanned, so data that arrived before you enabled a rule stays as it was received.Next steps
- Scanning Rules covers what goes inside a group.
- Library Rules lists the built-in patterns you can add.