Skip to main content

​
Add Processor

Sawmills allows you to configure processors to manage telemetry data efficiently by filtering, aggregating, masking, or modifying log attributes. You can do this by clicking the Add Processor button, or by clicking the + on the top right of the processors list under Processors in the Destination header. Processors created this way will appear at the end of the execution order.

​
Insert Processor

You can also choose to “Insert Processor” by clicking that option on an existing processor’s Actions menu. Processors that are created this way will appear before the currently selected processor in execution order.

​
Duplicate Processor

Alternatively, you can select Duplicate Processor from the processor’s Actions menu, which will duplcate that selected processor and it’s various settings. This might be quicker than creating a processor from scratch in certain scenarios.

​
Step-by-Step Configuration

Follow these steps to configure a processor:

​
Step 1: Open Processor Configuration Page

  1. Go to the Processor page.
  2. Click Create New Processor. The system will create a new, empty processor.
  3. Select Pipeline from the dropdown.
  4. Select Destination from the dropdown.
  5. Select Processor Type.

​
Step 2: Explore Logs with Live Tail

  • Use the Live Tail panel on the left to observe real-time log entries.
  • Inspect log attributes and utilize the filter option to pinpoint specific logs.
  • When you expand a log entry to view all its keys and values, a context menu appears on hover to the left of each row:
    • Copy Value – copy just the value to your clipboard.
    • Copy Key & Value – copy the pair in key=value form.
    • Show Logs with This Value – add an equals filter for this field to the Live Tail filter bar.
    • Exclude Logs with This Value – add a not equals filter for this field.
    • Add Filter to Processor – add key and value to the processor panel on the right side.

​
Step 3: Set Processor Parameters

  • In the configuration panel to the right, define the rules and actions your processor will apply.
  • Adjust processor-specific settings such as filters, attributes to modify, etc.

​
Step 4: Simulate Configuration

  • Once you’ve set up your configuration, click on the Simulate button.
  • The system will generate simulation results based on the current log snapshot (coming from the live tail on the left side) and your processor settings.

​
Step 5: Review Simulation Results

  • Simulation results appear in a new panel to the right of the processor configuration.
  • Logs are color-coded for clarity:
    • Red: Logs that will be removed.
    • Blue: Logs modified by the processor. Expand these logs to see detailed changes.
    • White: Logs unaffected by the configuration.

​
Step 6: Save Configuration

  • Click the Save button to save your processor configuration.
  • The system will save your configuration and you will be redirected to the processor list page.
Changes take effect immediately after saving.