Skip to content
HALOWERK

Codewerk

log normalize

Parses each line with the matching grammar, also in mixed files, and returns records with ISO 8601 UTC timestamp, level (syslog severity, JSON level or derived from the HTTP status), host, client IP, method, path, protocol, status, bytes, duration in milliseconds, user agent, referrer, application, PID and message. Client IPs are masked by default (IPv4 last octet, IPv6 to /48) and secret query parameters such as token, key, password or signature are redacted. RFC 3164 lines carry no year;.

POST https://code.halowerk.com/v1/log-normalize

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
linesstringYesLog text, one entry per line (mixed formats allowed).
formatstringNo
yearintegerNoYear for RFC 3164 timestamps, which carry none (default: current UTC year).
mask_ipbooleanNo
limitintegerNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "lines"
  ],
  "properties": {
    "lines": {
      "type": "string",
      "minLength": 1,
      "maxLength": 5000000,
      "description": "Log text, one entry per line (mixed formats allowed)."
    },
    "format": {
      "type": "string",
      "enum": [
        "auto",
        "clf",
        "json",
        "caddy_json",
        "syslog3164",
        "syslog5424",
        "logfmt"
      ],
      "default": "auto"
    },
    "year": {
      "type": "integer",
      "minimum": 1990,
      "maximum": 2100,
      "description": "Year for RFC 3164 timestamps, which carry none (default: current UTC year)."
    },
    "mask_ip": {
      "type": "boolean",
      "default": true
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5000,
      "default": 1000
    }
  }
}

Open original schema

Published input example

{
  "lines": "203.0.113.7 - - [31/Oct/2026:23:59:01 +0100] \"GET /api/orders?token=abc HTTP/1.1\" 500 512 \"-\" \"curl/8.5.0\"\n<34>1 2026-10-31T23:00:00.003Z web1 app 4711 ID47 - Database connection lost",
  "mask_ip": true
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’