Troubleshooting and Diagnostics

Debug pipelines, inspect live data, and diagnose issues across your Edge Delta deployment.

  3 minute read  

Overview

Edge Delta provides comprehensive debugging and diagnostic capabilities that help you identify and resolve issues across your pipelines and agents. From live data inspection to detailed agent logs, these tools enable rapid troubleshooting without disrupting production workloads.

Live Debugging

Edge Delta provides in-stream debugging capabilities without disrupting production. Live Capture allows you to:

  • Capture live data matching specific criteria
  • Inspect event structure and attributes
  • Validate filter and processor logic
  • Debug issues without log aggregation

Live Capture is particularly useful for:

  • Validating that processors transform data correctly
  • Confirming that filters match expected patterns
  • Debugging parsing issues with new log formats
  • Testing pipeline changes before deployment

Learn more: Live Capture In-Stream Debugging

Agent Logs

Access detailed agent logs for troubleshooting. Log levels include:

LevelDescription
INFONormal operational messages
WARNPotential issues or degraded performance
ERRORFailed operations requiring attention
DEBUGVerbose logging during deep troubleshooting

Accessing Agent Logs

Access agent logs using the following commands:

Kubernetes:

kubectl logs -n edgedelta <agent-pod-name>

Docker:

docker logs <agent-container-id>

Systemd:

journalctl -u edgedelta-agent

Common Troubleshooting Scenarios

Agent Connectivity Issues

When an agent cannot connect to the backend:

  1. Verify network connectivity to Edge Delta endpoints
  2. Check firewall rules and proxy configuration
  3. Validate API key configuration
  4. Review agent logs for specific error messages

High Resource Usage

When agents consume excessive CPU or memory:

  1. Review pipeline complexity and processor chains
  2. Check for high-cardinality metric extraction
  3. Consider disabling resource-intensive features like eBPF sources
  4. Profile the agent using pprof

See: Reducing Agent Resource Consumption

Destination Connection Failures

When data is not reaching destinations:

  1. Verify destination credentials and endpoints
  2. Check network connectivity to destination
  3. Review circuit breaker status
  4. Inspect agent logs for retry or error messages

Configuration Errors

When pipeline configuration fails to apply:

  1. Validate YAML syntax
  2. Check for required fields in node configurations
  3. Review agent logs for specific validation errors
  4. Use the pipeline builder’s validation feature

Missing or Duplicate Data

When expected data is not appearing or appears multiple times:

  1. Verify source configuration and filters
  2. Check for overlapping source patterns
  3. Review processor conditions for conflicts
  4. Inspect Live Capture to trace data flow

Profiling and Performance Analysis

For deep performance analysis, Edge Delta supports profiling with pprof:

  1. Enable profiling in the Edge Delta UI for specific agents
  2. Analyze CPU and memory profiles
  3. Identify hotspots in pipeline processing
  4. Correlate with self-telemetry metrics

See: Profiling Agents with pprof

Troubleshooting Guides

For detailed troubleshooting procedures, refer to these guides:

Agent and Pipeline Troubleshooting

Performance and Resource Issues

Configuration and Data Flow