Skip to main content

​
Overview

​
Manage a Sawmills Pipeline

  1. Log in to the Sawmills dashboard.
  2. Navigate to Pipeline Mangement.
  3. Click on an existing pipeline to navigate to that pipeline’s management page.
The Pipeline page consists of three main areas:
  1. Pipeline Toolbar
    • Pipeline Name Name of this Pipeline
    • Live/Draft Switches between “Edit” and “Live View” modes.
    • Settings Opens a dialog where you can either edit or delete a Pipeline ‘s Name and optional Description or Delete the Pipeline
    • Activity Log Opens a dialog where you can view an Audit Trail of all activity from a human in regards to this Pipeline. Each entry has a button on the right that displays changes made to this pipeline.
    • Deployement Enables you to deploy this Pipeline to one or more Controllers
  2. Pipeline Flow Presents a visual depiction of the pipeline (Sources, Processors and Destinations). When in “Live” mode, it is read only. When in “Draft” mode, you can edit the Pipeline’s Source, Processors and Destinations.

​
Previewing Destination Output

In Live mode, supported destinations include a Preview Output button in the destination drawer. Use it to inspect sampled telemetry for a specific destination after the pipeline has applied destination-specific handling. This is useful when a supported destination such as Datadog or Elasticsearch changes how telemetry is shaped before export. Instead of only checking the data earlier in the pipeline, you can preview what is being sent for that destination. To preview destination output:
  1. Set the Live/Draft toggle to Live.
  2. Click the destination in the pipeline flow.
  3. Click Preview Output in the destination drawer.
The preview opens a sampled stream for that destination so you can compare the output with the data seen earlier in the pipeline.

​
Editing a Pipeline Source

​
To edit a Pipeline’s Source

  1. Set the Live/Draft Toggle to Draft
  2. Open the pipeline’s source dialog
    • When adding a new pipeline source, click on the `+’ icon located under a last Source in the diagram.
    • When editing an existing pipeline source, click on the source icon itself.
For specifics on a Pipeline Source’s configuration, refer to the source type’s configurations. For a list of supported sources, refer to Pipeline Sources

​
Editing a Pipeline Destination

​
To edit a Pipeline’s Destination

  1. Set the Live/Draft Toggle to Draft
  2. Open the pipeline’s destination dialog
    • When adding a new pipeline destination, click on the `+’ icon located under a last destination in the diagram.
    • When editing an existing pipeline destination, click on the destination icon itself.
For specifics on a Pipeline Destination’s configuration, refer to the destination type’s configurations. For a list of supported destinations, refer to Pipeline Destinations
After you save your updates, you must redeploy the pipeline to all associated collectors for your changes to take effect.