logprox 0.2.0

A blazing-fast HTTP proxy with conditional logging and request control
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

# LogProx Configuration Documentation

## Overview
LogProx uses a YAML configuration file to define logging and request dropping rules. The configuration supports environment variable substitution using `${VAR_NAME}` syntax.

## Configuration Structure

### Server Configuration
```yaml
server:
  port: 3000                    # Server port (can be overridden by PORT env var)
  config_file: config.yaml      # Config file path (can be overridden by CONFIG_FILE env var)
```

## Configuration Structure

### Response Logging Configuration
```yaml
response_logging:
  # Default behavior if no rules match
  default: false

  # Rules for what responses to log, processed in order
  rules:
    - name: "Log error responses"
      match_conditions:
        # Match responses by status code
        status_codes:
          - 400
          - 401
          - 403
          - 404
          - 500
        # Match responses by headers (regex)
        headers:
          "content-type": "application/json.*"
        # Match responses by body content (regex)
        body:
          patterns:
            - "error.*"
      capture:
        # What to capture in logs when rule matches
        headers:
          - "content-type"
          - "x-request-id"
        body: true
        status_code: true
        timing: true
```

## API Endpoints
- GET /health - Health check endpoint
- GET /config - Returns current configuration
- GET /config/docs - Returns this documentation
- POST /config/reload - Reloads configuration from file