# errorfile

Specifies a file where omhttp records HTTP requests that return error responses.

This parameter applies to omhttp: HTTP Output Module.

Name:

  errorfile

Scope:

  input

Type:

  word

Default:

  input=none

Required?:

  no

Introduced:

  Not specified

## Description

Here you can set the name of a file where all errors will be written to. Any request that returns a 4XX or 5XX HTTP code is recorded in the error file. Each line is JSON formatted with `"request"` and `"response"` fields, example pretty-printed below.

    {
        "request": {
            "url": "https://example.com:443/path",
            "postdata": "mypayload"
        },
        "response" : {
            "status": 400,
            "message": "error string"
        }
    }

It is intended that a full replay of failed data is possible by processing this file.

## Input usage

    module(load="omhttp")

    action(
        type="omhttp"
        errorFile="/var/log/rsyslog/omhttp.error"
    )

## See also

See also omhttp: HTTP Output Module.

Support: rsyslog Assistant | GitHub Discussions | GitHub Issues: rsyslog source project

Contributing: Source & docs: rsyslog source project

© 2008–2025 Rainer Gerhards and others. Licensed under the Apache License 2.0.