Files
logwisp/doc/networking.md
T

1.9 KiB

Networking

Note: Under redesign

TLS Configuration

Note: As of the latest architecture updates, network TLS, mTLS, and Rate Limiting features are undergoing a redesign and are currently acting as placeholders. The documentation below details the structure for future updates.

Connection Management

TCP Keep-Alive

[[pipelines.plugin_sinks]]
id = "tcp_out"
type = "tcp"
[pipelines.plugin_sinks.config]
keep_alive = true
keep_alive_period_ms = 30000  # 30 seconds

Connection Timeouts

[[pipelines.plugin_sinks]]
id = "http_out"
type = "http"
[pipelines.plugin_sinks.config]
write_timeout_ms = 10000  # 10 seconds

Heartbeat Configuration

Keep connections alive with periodic heartbeats. Note that Heartbeat is a flow-level feature in the new architecture.

[pipelines.flow.heartbeat]
enabled = true
interval_ms = 30000
include_timestamp = true
include_stats = false
format = "comment"  # comment|event|json

Network Protocols

HTTP/HTTPS

  • HTTP/1.1 support
  • Persistent connections
  • Server-Sent Events (SSE)

TCP

  • Raw TCP sockets
  • Newline-delimited protocol

Port Configuration

Default Ports

Service Default Port Protocol
HTTP Sink 8080 HTTP
TCP Sink 9090 TCP

Port Conflict Prevention

LogWisp validates port usage at startup:

  • Detects port conflicts across pipelines
  • Prevents duplicate bindings

Troubleshooting

Common Issues

Connection Refused

  • Check firewall rules
  • Verify service is running
  • Confirm correct port/host

TLS Handshake Failure

  • Verify certificate validity
  • Check certificate chain
  • Confirm TLS versions match

Rate Limit Exceeded

  • Adjust rate limit parameters
  • Add IP to whitelist
  • Implement client-side throttling

Connection Timeout

  • Increase timeout values
  • Check network latency
  • Verify keep-alive settings