Configuration Reference

Environment Variables

Variable	Description	Default
`SIGNALPICK_API_KEY`	Your API key	Required
`COLLECTOR_ENDPOINT`	Downstream collector	`localhost:4317`
`LISTEN_ADDR`	Agent listen address	`0.0.0.0:4317`
`LOG_LEVEL`	Logging verbosity	`info`

Configuration File

api_key: ${SIGNALPICK_API_KEY}

receiver:
  grpc:
    endpoint: 0.0.0.0:4317
  http:
    endpoint: 0.0.0.0:4318

processor:
  buffer_size: 10000
  batch_timeout: 5s

exporter:
  endpoint: ${COLLECTOR_ENDPOINT}
  compression: gzip

filtering:
  # Keep all errors regardless of frequency
  always_keep:
    - status_code: ERROR
    - status_code: UNSET

  # Aggregate high-frequency success patterns
  aggregate:
    min_occurrences: 100
    window: 60s

Filtering Rules

Always Keep

Traces matching these rules are always forwarded:

always_keep:
  - status_code: ERROR          # All errors
  - latency_ms: ">1000"         # Slow traces (>1s)
  - attribute.priority: high    # Custom priority attribute

Aggregate

Patterns matching these rules are aggregated:

aggregate:
  - operation: /health
  - operation: /ping
  - attribute.synthetic: true