> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/traceable/agent-docs/haproxy.md).

# HAProxy Integration

Traceable supports HAProxy deployments through multiple integration methods. Choose the one that fits your deployment.

## Integration Options

### Lua Agent (Recommended)

Uses HAProxy's native Lua scripting to capture request/response data and send it to TPA via HTTP. Supports both capture-only and blocking modes.

* [Overview and Architecture](https://github.com/harness/harness-developer-hub/tree/main/traceable-dc-agent/agent-docs/haproxy/lua-agent/README.md)
* [Installation Guide](https://github.com/harness/harness-developer-hub/tree/main/traceable-dc-agent/agent-docs/haproxy/lua-agent/InstallationSteps.md)
* [Configuration Reference](https://github.com/harness/harness-developer-hub/tree/main/traceable-dc-agent/agent-docs/haproxy/lua-agent/Configuration.md)
* [Troubleshooting](https://github.com/harness/harness-developer-hub/tree/main/traceable-dc-agent/agent-docs/haproxy/lua-agent/Troubleshooting.md)

### SPOE Integration (Deprecated)

Uses HAProxy's Stream Processing Offload Engine (SPOE) with a binary protocol (port 5444) to push data to TPA.

> **Deprecation Notice:** The SPOE integration is deprecated. Use the [Lua Agent](https://github.com/harness/harness-developer-hub/tree/main/traceable-dc-agent/agent-docs/haproxy/lua-agent/README.md) for new installations. Existing SPOE deployments continue to function but will not receive new features.

* [Installation Guide](https://github.com/harness/harness-developer-hub/tree/main/traceable-dc-agent/agent-docs/haproxy/InstallationSteps.md)
* [Configuration Reference](https://github.com/harness/harness-developer-hub/tree/main/traceable-dc-agent/agent-docs/haproxy/Configuration.md)
* [Troubleshooting](https://github.com/harness/harness-developer-hub/tree/main/traceable-dc-agent/agent-docs/haproxy/Troubleshooting.md)

### [Ingress Controller](https://github.com/harness/harness-developer-hub/tree/main/traceable-dc-agent/agent-docs/haproxy/ingress-controller/README.md) (Kubernetes)

For HAProxy Ingress Controller deployments in Kubernetes:

* [Installation Guide](https://github.com/harness/harness-developer-hub/tree/main/traceable-dc-agent/agent-docs/haproxy/ingress-controller/InstallationSteps.md)

## Vulnerability Reports

* [Vulnerability Reports](https://github.com/harness/harness-developer-hub/tree/main/traceable-dc-agent/agent-docs/haproxy/vulnerability-reports/README.md)