On This Page

Home / Cribl Detect/ Build Detections (Preview)/View Detections in Inventory

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.Read access 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.

StatusMeaning
EnabledThe detection is running on the engine for its type.
DisabledThe 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.
TuningAnalyzing past alerts and applying exclusions to improve detection accuracy.
PendingTuning 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:

ActionResult
TuneTunes the selected detections.
DeleteRemoves 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.

  1. In the row’s Actions menu, select Tune.
  2. 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.
  3. Select Review Tuning. Impact Analysis shows the alerts the detection would have produced from historical data, and the events that matched.
  4. Select Accept Changes to apply the recommendations, or Reject Changes to keep the current query.
  5. 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.