Skip to main content

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.

​
Supported Data Types

đŸ“˜ Logs | đŸ“ˆ Metrics
Traces are not supported through the Datadog source. Traces must be sent directly to Datadog. See the Datadog Agent Configuration guide for details.

​
Supported Metric Types

The Datadog source accepts standard Datadog metric series types:
Metric TypeDescription
GaugeRepresents the current value of a metric at a point in time
CountTracks the number of events over a flush interval
RateTracks the per-second rate of events over a flush interval
HistogramAgent-side aggregated percentiles, averages, and counts
The Datadog distributions endpoint /api/v1/distribution_points is not currently supported.

​
Supported Ingestion Paths

The Datadog source accepts Datadog HTTP intake requests directly. You can send Datadog metrics payloads to the Sawmills Collector without running a Datadog Agent. Supported metrics endpoints:
  • /api/v1/series
  • /api/v2/series
  • /api/v1/check_run
  • /api/v1/sketches
  • /api/beta/sketches
This means you can either:
  • send Datadog HTTP metrics payloads directly to the Sawmills Collector from your own service or job
  • configure a Datadog Agent to send metrics to the Sawmills Collector
For Datadog Agent configuration, see How to send data from Datadog agent.

​
Direct API Example

curl -X POST http://<collector-host>:8126/api/v2/series \
  -H 'Content-Type: application/json' \
  -d '{
    "series": [{
      "metric": "example.metric",
      "type": 3,
      "points": [{"timestamp": 1710000000, "value": 1.0}],
      "resources": [{"name": "example-host", "type": "host"}],
      "tags": ["env:test"]
    }]
  }'

​
Configuration

NameTypeDefaultRequiredDescription
NameStringnonetrueUnique identifier within Sawmills
Logs AddressString${env:MY_POD_IP}trueAddress the Datadog source should listen to for logs
Logs PortInt10518truePort the Datadog source should listen to for logs
Metrics AddressString${env:MY_POD_IP}trueAddress to which the Datadog Metrics source should bind. Defaults to ${env:MY_POD_IP}.
Metrics PortInt8126truePort to which the Datadog Metrics source should bind.
The pod’s IP address is retrieved by defining an environment variable MY_POD_IP from the pod’s status field status.podIP. You can access this value using ${env:MY_POD_IP} in your configuration to dynamically reference the pod’s IP at runtime.
For instructions on configuring the Datadog agent to send data to this source, see How to send data from Datadog agent.