Edge Full

​

Supported Endpoints

​

Configuration

{
  "listen_address": "0.0.0.0",
  "listen_port": 8080,
  "upstream_url": "https://agent-http-intake.logs.datadoghq.com",
  "logs_url": "https://agent-http-intake.logs.datadoghq.com",
  "metrics_url": "https://api.datadoghq.com",
  "log_level": "info",
  "service": {
    "name": "edge",
    "namespace": "production",
    "resource_attributes": [
      { "key": "deployment.environment", "value": "production" }
    ],
    "labels": [{ "key": "team", "value": "platform" }]
  },
  "policy_providers": [
    {
      "id": "local",
      "type": "file",
      "path": "policies.json"
    }
  ]
}

​

Running

docker run -d \
  --name edge \
  -p 8080:8080 \
  -v $(pwd)/config.json:/etc/edge/config.json \
  -v $(pwd)/policies.json:/etc/edge/policies.json \
  ghcr.io/usetero/edge:latest \
  /etc/edge/config.json

./edge config.json

zig build run -- config.json

​

When to Use This Distribution

• Mixed telemetry sources: Some applications use Datadog agents, others use OpenTelemetry
• Migration: Transitioning from one protocol to another
• Multi-vendor: Sending data to multiple backends that prefer different protocols
• Flexibility: Want a single deployment that handles both protocols

• Edge Datadog for Datadog-only
• Edge OTLP for OpenTelemetry-only

​

Features

• Handles Datadog /api/v2/logs and /api/v1/series endpoints
• Handles OTLP /v1/logs and /v1/metrics endpoints
• Policy-based filtering (DROP/KEEP) for logs and metrics
• Separate upstream URLs for logs and metrics
• Async policy loading (server starts before policy loading completes)
• Fail-open behavior (errors pass data through unchanged)
• Lock-free policy updates via atomic snapshots
• Graceful shutdown with signal handling

​

Unified Policies

{
  "id": "drop-debug",
  "name": "Drop debug logs from all sources",
  "log": {
    "match": [{ "log_field": "severity_text", "regex": "^(debug|DEBUG)$" }],
    "keep": "none"
  }
}

​

Protocol-Specific Filtering

{
  "id": "sample-datadog-agent-logs",
  "name": "Sample logs from Datadog agents",
  "log": {
    "match": [{ "log_attribute": "ddsource", "exists": true }],
    "keep": "10%"
  }
}

​

Resource Considerations

• Has a larger binary size than focused distributions
• Loads all protocol modules at startup
• Uses more memory

​

Next Steps