# Sawmills ## Docs - [Sawmills Changelog](https://docs.sawmills.ai/changelog/changelog.md): All Sawmills product updates, new features, improvements, and bug fixes organized by version and release date for the telemetry management platform - [API Keys](https://docs.sawmills.ai/docs/api-keys.md): Create, manage, and revoke user API keys for programmatic authentication with the Sawmills platform using JWT tokens and REST API calls. - [Authentication Quick Reference](https://docs.sawmills.ai/docs/authentication-quick-reference.md): Copy-paste curl commands for creating API keys, listing active keys, revoking credentials, and exchanging keys for access tokens in Sawmills. - [Building Pipelines](https://docs.sawmills.ai/docs/build-pipelines.md): Build Sawmills pipelines end-to-end by connecting sources, processors, and destinations to control how telemetry data flows through your stack. - [Create a Processor](https://docs.sawmills.ai/docs/building-processor.md): Add, insert, or duplicate processors in a Sawmills pipeline with step-by-step instructions for configuring filtering, masking, and enrichment rules. - [Collector Customization](https://docs.sawmills.ai/docs/collector-customization.md): Customize your Sawmills Collector deployment in Kubernetes using Helm values for resource limits, environment variables, and advanced configuration. - [Collector Management](https://docs.sawmills.ai/docs/collector-management.md): View collector status, track versions, manage API key rotation, and monitor associated pipelines from the Sawmills Collector Management page. - [Configure Invitation Method](https://docs.sawmills.ai/docs/configure-invitation-method.md): Configure your organization's user invitation method in Sawmills, choosing between manual invitations, automatic enrollment, or automatic suggestions. - [Analytics Dashboard](https://docs.sawmills.ai/docs/dashboard.md): Monitor telemetry volume, measure data reduction ratios, and compare received versus forwarded log and metric usage across pipelines and destinations. - [Enable Datadog Integration](https://docs.sawmills.ai/docs/datadog-integration.md): Connect your Datadog API and Application Key credentials to Sawmills with step-by-step setup instructions and automatic permission validation. - [AWS S3 Destination](https://docs.sawmills.ai/docs/destination-aws-s3.md): Export logs, metrics, and traces to AWS S3 buckets in Sawmills. Configure region, Role ARN, file prefix, and marshaler format for object storage. - [Coralogix Destination](https://docs.sawmills.ai/docs/destination-coralogix.md): Forward logs, metrics, and traces to Coralogix from Sawmills. Configure API private key, application name, and multi-region domain for ingestion. - [Datadog Destination](https://docs.sawmills.ai/docs/destination-datadog.md): Export logs, metrics, and traces to Datadog from Sawmills. Configure your Datadog API key, site selector, and enabled data types for forwarding. - [Debug (/dev/null) Destination](https://docs.sawmills.ai/docs/destination-debug.md): Use the Debug (/dev/null) destination in Sawmills to discard all telemetry data during testing. Validate pipeline configurations without exporting data. - [Elasticsearch Destination](https://docs.sawmills.ai/docs/destination-elasticsearch.md): Export logs to Elasticsearch from Sawmills. Configure endpoint URLs, Cloud ID, authentication via basic auth or API key, and Logstash index routing. - [Google Cloud Storage Destination](https://docs.sawmills.ai/docs/destination-google-cloud-storage.md): Export logs to Google Cloud Storage from Sawmills in OTLP JSON format. Configure bucket name, project ID, authentication method, and compression. - [Grafana Loki Destination](https://docs.sawmills.ai/docs/destination-grafana-loki.md): Forward logs to Grafana Loki from Sawmills with optional basic authentication, customizable default labels, and configurable endpoint URLs. - [Logz.io Destination](https://docs.sawmills.ai/docs/destination-logzio.md): Export logs and traces to Logz.io from Sawmills. Configure your account token, region, and optional custom endpoint for development or testing. - [New Relic Destination](https://docs.sawmills.ai/docs/destination-new-relic.md): Export OpenTelemetry metrics to New Relic via the native Metric API and agent listener endpoint for time-slice metrics in Sawmills pipelines. - [OTLP Destination](https://docs.sawmills.ai/docs/destination-otlp.md): Export logs, metrics, and traces via OTLP gRPC or HTTP from Sawmills. Configure endpoints, TLS settings, compression, and custom headers. - [Prometheus Destination](https://docs.sawmills.ai/docs/destination-prometheus.md): Export metrics via Prometheus Remote-Write from Sawmills. Configure endpoint URL, namespace prefix, external labels, headers, and batch size. - [S3 Tables Destination](https://docs.sawmills.ai/docs/destination-s3-tables.md): Export logs to AWS S3 Tables in Apache Iceberg format from Sawmills. Configure the table contract plus advanced batching and partition-buffering knobs. - [Snowflake Destination](https://docs.sawmills.ai/docs/destination-snowflake.md): Export logs, metrics, and traces to Snowflake from Sawmills. Configure account ID, credentials, data warehouse, database, schema, and table settings. - [Splunk HEC Destination](https://docs.sawmills.ai/docs/destination-splunk-hec.md): Export logs, metrics, and traces to Splunk via the HTTP Event Collector protocol from Sawmills. Configure endpoint URL, token, and index settings. - [Sumo Logic Destination](https://docs.sawmills.ai/docs/destination-sumologic.md): Export logs to Sumo Logic from Sawmills via an OTLP/HTTP source endpoint. Configure log format, compression, batch size, and advanced options. - [Getting Started with Sawmills](https://docs.sawmills.ai/docs/getting-started.md): Introduction to Sawmills, an AI-powered telemetry management platform. Learn the core concepts of Collectors, Pipelines, Processors, and Destinations. - [Enable GitHub Integration](https://docs.sawmills.ai/docs/github-integration.md): Install the Sawmills GitHub App and connect your repositories so the Instrumentation Reviewer can analyze telemetry changes in pull requests. - [Enable GitLab Integration](https://docs.sawmills.ai/docs/gitlab-integration.md): Connect your GitLab projects or groups to Sawmills so the Instrumentation Reviewer can analyze telemetry changes in merge requests via webhook. - [Monitor Sawmills with Prometheus](https://docs.sawmills.ai/docs/guide-how-to-monitor-with-prometheus.md): Scrape Sawmills Collector metrics with any Prometheus-compatible scraper. - [Autoscale Sawmills Collector with KEDA](https://docs.sawmills.ai/docs/guide-how-to-setup-keda.md): Configure KEDA event-driven autoscaling for the Sawmills Collector in Kubernetes using Prometheus metrics and Helm chart values for dynamic scaling. - [How to send logs to VictoriaLogs](https://docs.sawmills.ai/docs/guide-send-logs-to-victorialogs.md): A guide on configuring Sawmills to send logs to VictoriaLogs (managed or self-hosted) using the OTLP HTTP destination - [Insights](https://docs.sawmills.ai/docs/insights.md): Automatically detect telemetry data quality and cost issues in your pipelines. Review impact, view affected logs, and apply recommended optimizations. - [Installation Guide](https://docs.sawmills.ai/docs/install-guide.md): Deploy the Sawmills OpenTelemetry Collector into your Kubernetes cluster using Helm. Covers prerequisites, namespace setup, and the installation wizard. - [Capacity Planning](https://docs.sawmills.ai/docs/installation/capacity-planning.md): Plan Kubernetes resource requirements for your Sawmills Collector deployment with recommended CPU, memory, and instance types for AWS, Azure, and GCP. - [KEDA External Scaler](https://docs.sawmills.ai/docs/keda-scaler.md): Understand the Sawmills KEDA External Scaler architecture that bridges OpenTelemetry metrics with Kubernetes event-driven autoscaling for dynamic workloads. - [Live Tail](https://docs.sawmills.ai/docs/live-tail.md): Stream logs in real time through your Sawmills pipeline. Compare events before and after each processor to validate filters and troubleshoot issues. - [Load Balancer Setup](https://docs.sawmills.ai/docs/load-balancer-setup.md): Add an optional load balancing layer with queue-based buffering between telemetry sources and Sawmills Collector backends for improved resilience and scaling. - [Network Requirements](https://docs.sawmills.ai/docs/network-requirments.md): Required FQDNs, firewall rules, and DNS configuration needed to allow outbound access from the Sawmills Collector and agent to Sawmills cloud services. - [Enable New Relic Integration](https://docs.sawmills.ai/docs/newrelic-integration.md): Connect your New Relic User API Key and Account ID to Sawmills for metrics usage features with step-by-step setup and automatic permission validation. - [OKTA Workforce](https://docs.sawmills.ai/docs/okta-workforce.md): Configure Okta Workforce as a SAML 2.0 identity provider for single sign-on into Sawmills, including app creation and attribute mapping steps. - [Configure Outbound Proxy for Remote Operator and Collector](https://docs.sawmills.ai/docs/outbound-proxy.md): Configure HTTP/HTTPS outbound proxy settings for the Sawmills Remote Operator and Collector using Helm values for HTTP_PROXY, HTTPS_PROXY, and NO_PROXY. - [Ownership Groups](https://docs.sawmills.ai/docs/ownership-groups.md): Define Ownership Groups with attribute-based matching rules to assign telemetry data to teams and route notifications to the right Slack channels or emails. - [Sawmills Pipeline Destinations](https://docs.sawmills.ai/docs/pipeline-destinations.md): Browse all supported Sawmills pipeline destinations including AWS S3, Datadog, Elasticsearch, Splunk HEC, Snowflake, Prometheus, and more. - [Manage an Existing Pipeline](https://docs.sawmills.ai/docs/pipeline-manage.md): Monitor and manage an existing Sawmills pipeline, including live and draft modes, flow visualization, activity logs, and deployment to collectors. - [Pipeline Management](https://docs.sawmills.ai/docs/pipeline-management.md): View all pipelines in your Sawmills organization, check deployment status, see associated collectors, and navigate to individual pipeline management pages. - [Sawmills Pipeline Sources](https://docs.sawmills.ai/docs/pipeline-sources.md): Browse all supported Sawmills pipeline sources including Datadog, OTLP, Elasticsearch, Fluent Forward, Splunk HEC, Syslog, Prometheus, and more. - [Aggregation Processor](https://docs.sawmills.ai/docs/processor-aggregation.md): Group and summarize similar log events over a configurable time window using the Sawmills Aggregation Processor to reduce noise and storage costs. - [Drop Attributes Processor](https://docs.sawmills.ai/docs/processor-drop-attribute.md): Remove specific attributes from log data using the Sawmills Drop Attributes Processor to reduce payload size or strip sensitive information. - [Drop Metric Datapoints Processor](https://docs.sawmills.ai/docs/processor-drop-metric-datapoints.md): Remove specific metric datapoints by name and optional label filters using the Sawmills Drop Metric Datapoints Processor to reduce metric volume. - [Filter Processor](https://docs.sawmills.ai/docs/processor-filter.md): Selectively include, exclude, or sample logs based on attribute conditions using the Sawmills Filter Processor to reduce noise and control volume. - [Aggregate Metric Labels Processor](https://docs.sawmills.ai/docs/processor-label-aggregation.md): Reduce metric cardinality by aggregating datapoints across specified labels for gauge and sum metric types using the Sawmills Label Aggregation Processor. - [Lookup Processor](https://docs.sawmills.ai/docs/processor-lookup.md): Enrich log records by matching attributes against a CSV file using the Sawmills Lookup Processor. Supports dot notation and EFS-mounted lookup files. - [Processor Management](https://docs.sawmills.ai/docs/processor-management.md): View, create, edit, delete, and monitor all processors across your Sawmills organization from the centralized Processor Management interface. - [Mask Sensitive Data/PII Processor](https://docs.sawmills.ai/docs/processor-mask.md): Identify and mask sensitive data like credit cards, SSNs, emails, and IP addresses in telemetry streams using the Sawmills Mask Processor with regex patterns. - [Modify Attribute Processor](https://docs.sawmills.ai/docs/processor-modify-attribute.md): Update, transform, standardize, enrich, or truncate log attribute values using the Sawmills Modify Attribute Processor with flexible action types. - [Parse Log Processor](https://docs.sawmills.ai/docs/processor-parse-logs.md): Extract structured fields from unstructured log messages using the Sawmills Parse Log Processor with regex patterns and named capture groups. - [Processor Reordering](https://docs.sawmills.ai/docs/processor-reordering.md): Change the execution order of processors within a Sawmills pipeline using drag-and-drop or move buttons to optimize cost, latency, and data quality. - [Sawmills Processors Types](https://docs.sawmills.ai/docs/processors.md): Browse all available Sawmills processor types including Aggregation, Filter, Mask, Drop Attribute, Lookup, Parse Log, Logs to Metrics, and more. - [SAML](https://docs.sawmills.ai/docs/saml.md): Enable enterprise single sign-on for Sawmills using the SAML protocol. Supports both SP-initiated and IdP-initiated authentication with your identity provider. - [Collaboration](https://docs.sawmills.ai/docs/sawmills-agent-collaboration.md): Share Sawmills Agent conversations with teammates for incident handoffs, collaborative investigations, and asynchronous follow-up on telemetry issues. - [Conversations](https://docs.sawmills.ai/docs/sawmills-agent-conversations.md): Start and continue Sawmills Agent conversations to investigate telemetry issues, ask follow-up questions, and keep related context in one thread. - [Instrumentation Reviewer](https://docs.sawmills.ai/docs/sawmills-agent-instrumentation-reviewer.md): Automatically review telemetry-related code changes in GitHub pull requests and GitLab merge requests to catch observability issues before production. - [Memory](https://docs.sawmills.ai/docs/sawmills-agent-memory.md): Learn how Sawmills Agent retains conversation context to support follow-up questions, longer investigations, and continuity across related queries. - [Notifications](https://docs.sawmills.ai/docs/sawmills-agent-notifications.md): Deliver Sawmills Agent results and task outputs to users or teams via supported notification channels including Slack, email, and webhook integrations. - [Sawmills Agent](https://docs.sawmills.ai/docs/sawmills-agent-overview.md): Sawmills Agent is a conversational AI interface for investigating telemetry, automating recurring work, and collaborating with your team. - [Roles and Access](https://docs.sawmills.ai/docs/sawmills-agent-roles.md): Learn how Member and Administrator roles control which Sawmills Agent capabilities are available, including skill creation and task management permissions. - [Skills](https://docs.sawmills.ai/docs/sawmills-agent-skills.md): Define and use Skills to give Sawmills Agent predefined, repeatable workflows for recurring investigations, standard summaries, and common tasks. - [Use Sawmills Agent in Slack](https://docs.sawmills.ai/docs/sawmills-agent-slack.md): Interact with Sawmills Agent directly in Slack using direct messages, channel mentions, and threaded conversations for telemetry investigations. - [Tasks](https://docs.sawmills.ai/docs/sawmills-agent-tasks.md): Create and manage Sawmills Agent tasks that run in the background on demand, on a schedule, or at a recurring interval for automated telemetry workflows. - [Sawmills CLI](https://docs.sawmills.ai/docs/sawmills-cli.md): Install the Sawmills sm CLI via Homebrew, authenticate with your account, and explore the full command reference for managing collectors and pipelines. - [Sawmills MCP](https://docs.sawmills.ai/docs/sawmills-mcp.md): Connect the hosted Sawmills MCP server to AI coding agents like Codex and Claude Code for AI-assisted telemetry management and pipeline configuration. - [How to send data from Datadog agent](https://docs.sawmills.ai/docs/send-data-from-datadog-agent.md): Configure the Datadog Agent to send logs and metrics to the Sawmills Collector using Helm values or environment variables, with single and dual shipping options. - [How to send data to the Sawmills collector?](https://docs.sawmills.ai/docs/send-data-to-collector.md): Send telemetry data to the Sawmills Collector from inside or outside your Kubernetes cluster using internal services or external ingress endpoints. - [How to send logs from Vector](https://docs.sawmills.ai/docs/send-logs-from-vector.md): Configure Vector to send logs to the Sawmills Collector using OTLP, with clear single-shipping and dual-shipping examples. - [Setup fallback endpoint](https://docs.sawmills.ai/docs/setup-fallback-endpoint-for-sources.md): Configure fallback endpoints on pipeline sources so an HAProxy sidecar automatically reroutes telemetry data when the primary collector is unavailable. - [Enable Slack Integration](https://docs.sawmills.ai/docs/slack-integration.md): Connect Sawmills to your Slack workspace to receive Insight notifications and automated action updates directly in your team's Slack channels. - [Datadog Source](https://docs.sawmills.ai/docs/source-datadog.md): Configure the Datadog source in Sawmills to receive logs and metrics from the Datadog Agent via HTTP intake endpoints. Traces are not supported. - [Elasticsearch Source](https://docs.sawmills.ai/docs/source-elasticsearch.md): Configure the Elasticsearch source in Sawmills to receive log data from Elasticsearch clusters and Logstash with optional fallback endpoint support. - [Fluent Forward](https://docs.sawmills.ai/docs/source-fluent-forward.md): Configure the Fluent Forward source in Sawmills to receive log data from Fluent Bit or Fluentd agents on a configurable address and port. - [Grafana Loki Source](https://docs.sawmills.ai/docs/source-grafana-loki.md): Configure the Grafana Loki source in Sawmills to receive log data over HTTP and gRPC with timestamp handling and multi-tenant header support. - [New Relic Source](https://docs.sawmills.ai/docs/source-new-relic.md): Configure the New Relic source in Sawmills to receive metrics from the New Relic Metric API and Agent protocol on configurable HTTP endpoints. - [OTLP Source](https://docs.sawmills.ai/docs/source-otlp.md): Configure the OTLP source in Sawmills to receive logs, metrics, and traces over both HTTP and gRPC using the OpenTelemetry protocol standard. - [Prometheus Source](https://docs.sawmills.ai/docs/source-prometheus.md): Configure the Prometheus Remote-Write source in Sawmills to receive metrics data with optional X-Scope-OrgID header forwarding for multi-tenancy. - [Splunk HEC Source](https://docs.sawmills.ai/docs/source-splunk-hec.md): Configure the Splunk HEC source in Sawmills to ingest logs, metrics, and traces via the Splunk HTTP Event Collector protocol with TLS support. - [Syslog Source](https://docs.sawmills.ai/docs/source-syslog.md): Configure the Syslog source in Sawmills to receive log data via TCP-based syslog using RFC 5424 or RFC 3164 formats with configurable encoding. - [TCP Logs Source](https://docs.sawmills.ai/docs/source-tcplog.md): Configure the TCP Logs source in Sawmills to receive raw log data over a TCP connection on a configurable address, port, and encoding. - [Obtaining Tokens](https://docs.sawmills.ai/docs/tokens.md): Exchange a long-lived Sawmills API key for a short-lived JWT access token and use it to authenticate REST API requests to Sawmills platform services. - [Invite Users](https://docs.sawmills.ai/docs/user-invite.md): Invite users to your Sawmills organization based on the configured invitation method, assign Admin or Member roles, and manage existing team members. - [User Management](https://docs.sawmills.ai/docs/user-management.md): Manage users in your Sawmills organization with Admin and Member roles, three invitation methods, and controls for editing or removing team members. - [Enable Webhook Integration](https://docs.sawmills.ai/docs/webhook-integration.md): Configure the Sawmills Webhook integration to receive Insight notifications and automated action updates at a custom HTTP endpoint for your team. ## OpenAPI Specs - [openapi](https://docs.sawmills.ai/openapi.json) ## Optional - [Home site](https://www.sawmills.ai/) - [System Status](https://sawmills.statuspage.io/)