Skip to main content
Operations covers the production behaviors you need to run Edge: logs, health checks, graceful shutdown, and resource sizing.

​
Logging

Edge outputs structured logs to stdout: 
2026-01-06T17:29:36.322Z [INFO] server.starting
2026-01-06T17:29:36.322Z [INFO] configuration.loaded path="config.json"
2026-01-06T17:29:36.323Z [INFO] listen.address.configured address="127.0.0.1" port=8080
2026-01-06T17:29:36.323Z [INFO] upstream.configured url="https://agent-http-intake.logs.datadoghq.com"
2026-01-06T17:29:36.323Z [INFO] policy.loader.starting provider_count=1
2026-01-06T17:29:36.324Z [INFO] policies.loading path="/etc/edge/policies.json"
2026-01-06T17:29:36.324Z [INFO] server.ready
2026-01-06T17:29:36.324Z [INFO] server.listening address="127.0.0.1" port=8080

​
Log Levels

Configure the log level in your config file or via environment variable: 
{
  "log_level": "info"
}
Or override with TERO_LOG_LEVEL: 
TERO_LOG_LEVEL=debug ./edge config.json
LevelDescription
traceMost verbose, includes all details
debugDebugging information
infoNormal operation messages
warnWarning conditions
errError conditions only

​
Health Checks

Edge exposes a health endpoint for load balancer and orchestrator integration: 
curl http://localhost:8080/_health
Returns 200 OK when Edge is healthy and ready to process requests.

​
Kubernetes Probes

Probes can begin as soon as the process starts: 
livenessProbe:
  httpGet:
    path: /_health
    port: 8080
  periodSeconds: 10

readinessProbe:
  httpGet:
    path: /_health
    port: 8080
  periodSeconds: 5

​
Graceful Shutdown

Edge handles SIGINT and SIGTERM for graceful shutdown:
  1. Stops accepting new connections
  2. Waits for in-flight requests to complete
  3. Exits cleanly
This shutdown sequence lets Edge finish accepted requests before the process exits during deployments and scaling events.

​
Kubernetes Termination

Edge exits as soon as in-flight requests drain. A short grace period is sufficient: 
terminationGracePeriodSeconds: 10

​
Resource Requirements

Recommended minimums:
ResourceMinimumRecommended
CPU0.5 core1+ cores
Memory10MB100MB
Disk10MB100MB (for logs)

​
Memory Scaling

Memory usage scales with:
  • Number of policies: Each policy consumes memory for its compiled matchers
  • Regex complexity: Hyperscan databases for complex patterns
  • Request body sizes: Buffered during processing

​
Kubernetes Resources

resources:
  requests:
    cpu: 100m
    memory: 64Mi
  limits:
    cpu: 1000m
    memory: 256Mi

​
Next Steps

Configuration

Full configuration reference

Architecture

Understand Edge internals