.. _logs:

Service Logs
=====================================

Service logs provide a complete record of each FindFace component activity. Consulting logs is one of the first things you should do to identify a cause for any system problem.


Use the ``journalctl -u <component>`` command to consult a component log, for example as follows:

.. code::

   journalctl -u findface-extraction-api

.. important::

   In order to enable saving ``journald`` logs to your hard drive, uncomment and edit the ``Storage`` parameter in the ``/etc/systemd/journald.conf`` file:

   .. code::

      sudo vi /etc/systemd/journald.conf
      ...
      [Journal]
      Storage=persistent
 
   If necessary, uncomment and edit the ``SystemMaxUse`` parameter as well. This parameter determines the maximum volume of log files on your hard drive (10% by default).

   .. code::

      SystemMaxUse=15

.. seealso::
   :ref:`audit-logs`