Skip to main content

Log StreamLog Stream Guide

Parser Dependencies

The Dependencies column on the Log Stream Parsers Overview tab provides feedback about the quality and completeness of parsers that are ingesting detection events. For easy reference, this information is provided directly in the parser list so that you don't need to enter an individual parser and follow the workflow to discover missing fields or detection rules.

Note

License Requirement

Currently, the Dependencies column is available only if you have the New-Scale Analytics license.

The Dependencies column can show the following types of information:

  • Empty – The parser does not include detection rules in the event builder.

  • dependency-none.png – The parser is not missing any fields required by a detection rule.

  • dependency-missing.png – The parser is missing fields required by a detection rule. The number of missing fields is indicated next to the icon.

If a parser is missing fields required by a detection rule, you can click on the icon (dependency-missing.png) in the Dependencies column to display a popup message with more information. A Detection quality issues message like the following image is displayed.

detection-quality-issue.png

In the popup message, click on the View details link to open a detailed diagram that shows the relationship between the missing fields and the detection rules that depend on each missing field. As shown in the sample image below, the missing fields are listed on the left and the detection rules are listed on the right. The lines between them show which rules depend on each field.

dependecy-details.png

In the diagram, you can highlight specific information by hovering your cursor over different elements. Hover over a specific missing field, over a specific detection rule, or over a specific line. The other information will fade so that the item you hover over is clearly visible. This can be useful when many fields are missing and the matching diagram becomes complex, as in the example below.

dependecy-details-selected.png

When you have identified fields that are missing, and the detection rules that depend on them, you can edit the parser to include the missing fields as follows:

  1. If the parser is active, you will need to disable it before editing.

  2. Select the Edit option for the parser you want to update.

  3. Navigate to the Extract Fields step of the parser workflow.

  4. Map the missing fields for extraction. (See Extract Event Fields.)

  5. Update the Event Builder Rules, if necessary. (See Add Event Builder Rules.)

  6. Review and Save the updated parser. (See Review and Save Parser.)