> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sawmills.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Processor

> Add, insert, or duplicate processors in a Sawmills pipeline with step-by-step instructions for configuring filtering, masking, and enrichment rules.

### 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.

<Note>Changes take effect immediately after saving.</Note>