https://github.com/feedzai/traefikrequesttimestamps
https://github.com/feedzai/traefikrequesttimestamps
traefik-plugin
Last synced: 10 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/feedzai/traefikrequesttimestamps
- Owner: feedzai
- License: apache-2.0
- Created: 2025-08-12T10:23:35.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-08-12T15:43:16.000Z (11 months ago)
- Last Synced: 2025-08-14T17:15:15.999Z (11 months ago)
- Topics: traefik-plugin
- Language: Go
- Homepage:
- Size: 8.79 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# Traefik Request Timestamps Middleware
A Traefik plugin that adds request and response timestamp headers to HTTP responses, helping you track request processing times and latency.
This plugin injects both a REQUEST-TIMESTAMP and a RESPONSE-TIMESTAMP header into each HTTP response. The REQUEST-TIMESTAMP reflects when the request first reached Traefik, while the RESPONSE-TIMESTAMP marks when the response is sent back to the client. Both header names and the date format are fully configurable, supporting any Go time format. The plugin is lightweight, fast, and has no dependencies.
## Configuration Options
| Parameter | Description | Default |
|-----------|-------------|---------|
| `requestHeaderName` | Name of the request timestamp header | `"REQUEST-TIMESTAMP"` |
| `responseHeaderName` | Name of the response timestamp header | `"RESPONSE-TIMESTAMP"` |
| `dateFormat` | Go time format string | `"2006-01-02T15:04:05.000Z"` |
### Static Configuration (traefik.yml)
```yaml
experimental:
plugins:
timestampheaders:
moduleName: "github.com/feedzai/traefikRequestTimestamps"
version: "v1.0.0"
```
### Dynamic Configuration (dynamic.yml)
#### Basic Usage (Default Settings)
```yaml
http:
middlewares:
timestamp-headers:
plugin:
timestampheaders: {}
routers:
api:
rule: "Path(`/`)"
service: backend-service
middlewares:
- timestamp-headers
```
#### Custom Configuration
```yaml
http:
middlewares:
custom-timestamps:
plugin:
timestampheaders:
requestHeaderName: "X-Request-Time"
responseHeaderName: "X-Response-Time"
dateFormat: "2006-01-02 15:04:05 UTC"
```
## Requirements
- Traefik v3.0+
- Go 1.19+ (for development)