# log.file

Writes impstats statistics records to the specified local file in addition to other outputs.

This parameter applies to impstats: Generate Periodic Statistics of Internal Counters.

Name:

  log.file

Scope:

  module

Type:

  word

Default:

  module=none

Required?:

  no

Introduced:

  at least 5.x, possibly earlier

## Description

If specified, statistics data is written to the specified file. For robustness, this should be a local file. The file format cannot be customized; it consists of a date header, followed by a colon, followed by the actual statistics record, all on one line. Only very limited error handling is done, so if things go wrong stats records will probably be lost. Logging to file can be a useful alternative if for some reasons (e.g. full queues) the regular syslog stream method shall not be used solely. Note that turning on file logging does NOT turn off syslog logging. If that is desired, log.syslog (`logSyslog` in camelCase examples) must be explicitly set to `off`.

## Module usage

    module(load="impstats" logFile="/var/log/rsyslog-stats")

## See also

See also impstats: Generate Periodic Statistics of Internal Counters.

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.