.. _param-mmnormalize-debugfile:
.. _mmnormalize.parameter.action.debugfile:

.. meta::
   :description: Select a dedicated file for mmnormalize liblognorm debug tracing.
   :keywords: rsyslog, mmnormalize, liblognorm, debug, trace file

debugFile
=========

.. index::
   single: mmnormalize; debugFile
   single: debugFile

.. summary-start

Writes per-action liblognorm debug records to an append-only dedicated file.

.. summary-end

This parameter applies to :doc:`../../configuration/modules/mmnormalize`.

:Name: debugFile
:Scope: action
:Type: word
:Default: none
:Required?: no
:Introduced: 8.2608.0

Description
-----------
Sets an append-only output file for liblognorm debug records generated by this
action. It requires :ref:`param-mmnormalize-debug` to be enabled. rsyslog opens
the file while loading the configuration and fails configuration processing if
the file cannot be opened.

The file path is administrator-controlled configuration. Select a path whose
directory and permissions are appropriate for the rsyslog service account.

Action usage
------------
.. _param-mmnormalize-action-debugfile:
.. _mmnormalize.parameter.action.debugfile-usage:

.. code-block:: rsyslog

   action(type="mmnormalize"
          rulebase="/path/to/rules.rb"
          debug="on"
          debugFile="/path/to/mmnormalize-debug.log")

YAML usage
----------

.. code-block:: yaml

   actions:
     - type: mmnormalize
       rulebase: /path/to/rules.rb
       debug: on
       debugFile: /path/to/mmnormalize-debug.log

See also
--------
See also :doc:`../../configuration/modules/mmnormalize` and
:ref:`param-mmnormalize-debug`.
