Hub
Web & Access

Nginx Access & Error Logs

Nginx reverse proxy and web server — access logs with upstream timing, error logs with module context, bot/crawler traffic, scanner probes, and correlated 4xx/5xx error entries.

Quick Start

uv tool install eventum-generator
git clone https://github.com/eventum-generator/content-packs.git
cd content-packs
eventum generate \
  --path generators/web-nginx/generator.yml \
  --id nginx \
  --live-mode true

Event Types

Event IDDescriptionFrequencyCategory
access-successHTTP 2xx/3xx responses~84%web
access-failureHTTP 4xx/5xx responses~11%web
error-upstreamUpstream connect/timeout/reset~2.5%web
error-filesystemFile not found, permission denied~1.5%web
error-clientBody too large, premature close~0.5%web
error-sslTLS handshake failures~0.3%web
error-systemBind failures, worker crashes~0.2%web

Realism Features

  • Weighted event distribution matching production nginx traffic (~95% access, ~5% error)
  • URL category distribution — static assets (40%), HTML pages (30%), API endpoints (18%), well-known files (12%)
  • HTTP method correlation — GET 85%, POST 10%, with method-specific status codes
  • User agent distribution — desktop browsers (55%), mobile (20%), bots (10%), tools (8%)
  • Scanner probe simulation — wp-login.php, .env, .git/config with realistic 404 responses

Sample Output

{
  "@timestamp": "2026-02-21T14:32:07.123456+00:00",
  "event": {
    "category": [
      "web"
    ],
    "dataset": "nginx.access",
    "kind": "event",
    "module": "nginx",
    "outcome": "success",
    "type": [
      "access"
    ]
  },
  "http": {
    "request": {
      "method": "GET"
    },
    "response": {
      "body": {
        "bytes": 18432
      },
      "status_code": 200
    }
  },
  "url": {
    "original": "/products",
    "path": "/products"
  },
  "user_agent": {
    "name": "Chrome",
    "original": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) Chrome/133.0.0.0"
  }
}

Parameters

ParameterDefaultDescription
hostnameweb-srv-01Nginx server hostname
server_nameexample.comVirtual host domain name
upstream_addr127.0.0.1:8080Backend upstream address
agent_ida7b8c9d0-...Filebeat agent ID
agent_version8.17.0Filebeat version string

Related Generators