View Detections in Inventory
Preview Feature
Cribl is still developing this Preview feature. We don’t recommend using it in a production environment, because the feature might not be fully tested or optimized for performance, and related documentation could be incomplete.
Access requires App Platform, the Cribl Detect feature, and a Role that grants
Apps.Readaccess to the Cribl Detect app.Please continue to submit feedback through normal Cribl support channels, but assistance might be limited while the feature remains in Preview.
Use Inventory to view the list of detections that belong to your Organization. From Inventory, you can compare rules, open a detection for review, enable or disable detections, tune a detection, delete detections, and export the list.
Templates become Inventory rows after you create them. Detections from Detection Lab appear here after you save them and are enabled on save. Custom detections also appear here.
Inventory Table
Each row includes:
- Detection name
- Severity
- Type (the detection engine, single-event or correlation)
- Status
- MITRE mapping (tactic, technique, and sub-technique)
- Actions
The table loads more rows as you scroll.
Filter the list by Status, Severity, MITRE Techniques, or MITRE Sub Techniques. See Filter Detections.
Detection Status
Status shows where the detection is in its lifecycle. Hover over a status to see its description.
| Status | Meaning |
|---|---|
| Enabled | The detection is running on the engine for its type. |
| Disabled | The detection exists but is not running. Detections you create from a template’s detail panel start as Disabled unless you turn on Enable detection on Review. Detections you add in bulk with Add to Inventory start as Enabled. |
| Tuning | Analyzing past alerts and applying exclusions to improve detection accuracy. |
| Pending | Tuning is complete. Review and accept the recommended changes. |
A tuned detection moves from Tuning to Pending. After you review the tuning, it returns to Enabled. If you later disable it, it shows Disabled.
Enable a detection to start it on the engine for its type. Disable a detection to stop it.
Manage Detections in Bulk
Select one or more detections with the checkboxes in the table, then choose an action:
| Action | Result |
|---|---|
| Tune | Tunes the selected detections. |
| Delete | Removes the selected detections from Inventory. Cribl Detect asks you to confirm before it deletes them. |
Deleting a detection can’t be undone. To stop a detection that you might need later, disable it instead.
Export Detections
Export Inventory to a CSV file to review or share it outside Cribl Detect. The export includes every column in the table and the details shown when you open a detection.
Tune a Detection
Tuning analyzes historical matches for a detection and recommends exclusions or other query changes to reduce noisy or overly broad matches. You can tune a detection that’s already in Inventory, or create and tune one from a template. See Create and Tune.
- In the row’s Actions menu, select Tune.
- Wait for tuning to finish. The row shows Tuning while Cribl Detect analyzes past events. When tuning finishes, Cribl Detect notifies you and the row shows Pending.
- Select Review Tuning. Impact Analysis shows the alerts the detection would have produced from historical data, and the events that matched.
- Select Accept Changes to apply the recommendations, or Reject Changes to keep the current query.
- Select Complete.
Cribl Detect saves your choice, and the row returns to Enabled.
If tuning finds nothing to change, the detection keeps its current query.
View and Edit
Open a detection to review details that the table doesn’t show:
- Tags
- Detection description
- Query
- Validation steps
Edit opens the shared detection wizard, which adapts its fields to the detection type. Save your changes, or cancel to leave the detection unchanged.