Breadcrumbs

Logs

The NDD Print Agent logs are used to analyze the component's performance.

They can have different logging levels:

Level

Contents

VERBOSE

Displays all log messages (default).

ERROR

Displays the issues that caused errors, as well as the lower-level message in this list.

WARNING

It highlights potential issues that are not yet errors, as well as the lower-level messages in this list.

INFO

Displays the log messages expected during normal operation, as well as the lower-level messages in this list.

DEBUG

Displays debug log messages that are useful only during development, as well as the lower-level messages in this list.

NONE

Disabled.

The logs will be saved to the path specified in the Directory field, located in the Tools / Logs menu.

Only administrator users can enable or disable logs.

Enable Logs

  1. Open Terminal (⌘ + Space → enter Terminal)

  2. Type the command:NDDPrintAgentAdmin

  3. Access the Tools menu

  4. Click Logs

  5. Select the log level

  6. Click Apply

The directory path where the logs will be saved is already set to /opt/ndd-print-agent/log. This path can be changed.

Analyzing Logs

To analyze the logs, you must elevate the Terminal to Administrator privileges

  1. Open Terminal (⌘ + Space → enter Terminal)

  2. Elevate the session to Administrator (enter the administrator password when prompted):

Bash
sudo su

  1. Access the logs directory:

Bash
cd /opt/ndd-print-agent/log -> (caminho padrão)

  1. List the files:

    Bash
    ls -l

  2. Open the desired file using the command:

Bash
cat NOME_DO_ARQUIVO
💡

Use the command cat FILE_NAME | grep "KEYWORD" para filtrar o log.

Example of how to read a file by filtering for errors:

cat FILE_NAME | grep "ERR"

Delete the Logs

  1. Open Terminal (⌘ + Space → enter Terminal)

  2. Type the following commands:

Bash
rm FILE_NAME

Use the command echo "" > FILE_NAME to clear the log without restarting the services.