# Observability

Sydekyks user and operator guide. Check feature availability and release-specific installation requirements.

Sydekyks exports structured logs via evlog. Each API request and worker job execution emits a single wide-event JSON object including duration, status, and sampling context.

## ​Log Export Variables

 | Variable | Description | Default Value | Example

 | AP_OTEL_ENABLED | Export logs via the OTLP log drain | false | true

 | AP_OTEL_QUEUE_METRICS_ENABLED | Export BullMQ queue metrics via OTLP | false | true

 | OTEL_EXPORTER_OTLP_ENDPOINT | OTLP endpoint for log and metric export | None | https://your-collector:4318

 | OTEL_EXPORTER_OTLP_HEADERS | Headers for OTLP exporter (comma-separated key=value pairs) | None | Authorization=Bearer token

## ​Queue Metrics

When AP_OTEL_QUEUE_METRICS_ENABLED=true and OTEL_EXPORTER_OTLP_ENDPOINT is set, the app container also exports BullMQ queue metrics to <endpoint>/v1/metrics every 60 seconds, so your monitoring stack receives queue depth without exposing any HTTP admin surface.

 | Metric | Type | Attributes | Description

 | bullmq.job.count | Gauge | queue, state | Number of jobs per queue and state (waiting, active, failed, delayed, paused, and other BullMQ states)

The gauge covers all queues, including dedicated worker-group queues. Each data point carries service.name=activepieces-api and host.name resource attributes, so replicas of the app container produce distinguishable series.

Outbound requests from the app go through an SSRF filter that blocks private, loopback, and link-local IPs. If your OTLP collector resolves to a private IP (for example an in-cluster collector), add its IP or CIDR to the AP_SSRF_ALLOW_LIST environment variable.

## ​Sampling Variables

 | Variable | Description | Default Value

 | AP_LOG_SAMPLE_RATE_INFO | Percentage of info-level events to keep (0-100) | 100

 | AP_LOG_KEEP_SLOW_MS | Always keep requests slower than this threshold (ms) | 2000

Events with level warn or error are always kept regardless of sampling configuration.
AP_OTEL_ENABLED=true enables the OTLP log drain; AP_OTEL_QUEUE_METRICS_ENABLED=true enables queue metrics export. OpenTelemetry tracing is not emitted.