=======
Journal
=======

.. sidebar:: Contents

  .. contents::
      :depth: 3
      :local:

This chapter covers some aspects related to the :osdx:cfg:`system journal` configuration tool,
which allows you to configure the behaviour of the journal command in OSDx.

Journal is a tool that is responsible for collecting and managing systemd logs, allowing the user to access the data,
for example to identify errors or to monitorize the system.

The :osdx:cfg:`system journal` configuration must be configured using one of the following values:

* ``max-use``: This option accepts a value between 0 and 100. This value will be the percentage of memory used by the system to store journal logs, 1% is the default value. The system will store 4 GB at most, so if you choose a percentage whose memory is higher than this value, the system will store 4GB anyway.

:doc:`Here </management/monitoring/logging/index>`, you can find more information about journal operational commands.

Configuration
=============

This is the syntax to configure the behaviour of the :osdx:cfg:`system journal` configuration in OSDx:

.. code-block:: none

  set system journal max-use [ ... ]


Examples
========

Configure journal limit
-----------------------

Imagine you want to configure the memory used to store logs.
So to achieve this goal, you have to change this value to another between 0 and 100:

.. code-block:: none

  set system journal max-use 10

.. important::  If you have stored more memory than your limit, the memory will be flushed. In any other case, you will keep your journal files.

Command Summary
===============

.. osdx:cmdtree:: op

  system journal

.. osdx:cmdtree:: cfg

  system journal