Skip to main content
Version: 0.1.17

Pebblo Configuration File

Introduction​

This configuration file specifies settings for various components of the Pebblo.

Configuration Details​

Server​

  • port: Specifies the port number on which the Pebblo server listens for incoming connections.
  • host: Specifies the host address on which the Pebblo server to run.

Notes:

  1. By default Pebblo Server runs at localhost:8000. When we change values of port and/or host , the Pebblo Safe DataLoader env variable PEBBLO_CLASSIFIER_URL needs to set to the correct URL.
  2. By default Pebblo UI runs at localhost:8000/pebblo. When we change values of port and/or host, the Pebblo UI would be running on the respective host:port/pebblo.

Logging​

  • level: Sets the logging level. Possible values are 'info', 'debug', 'error', 'warning', and 'critical'. Default value is info.
  • file: Sets the log file path. Default value is /tmp/logs/pebblo.log.
  • maxFileSize: Sets the maximum size of the log file. Default value is 8306688 bytes (8 MB).
  • backupCount: Sets the number of backup files to keep. Default value is 3.

Reports​

  • format: Specifies the format of generated reports. Available options include 'pdf'.

  • renderer: Specifies the rendering engine for generating reports. Options include 'weasyprint', 'xhtml2pdf'.

    Note
    Note: Using xhtml2pdf gives a report with basic UI elements, but WeasyPrint renderer creates a sleeker, better-aligned interface for your PDFs. See image below. If you put renderer as weasyprint, then you need to install Pango. Follow these instructions for the same.

    Pebblo Reports

  • cacheDir: Sets the directory where pebblo stores metadata, generated reports, and other temporary files. Default value is ~/.pebblo.

  • outputDir: Deprecated. Use cacheDir instead.

Classifier​

  • anonymizeSnippets: Flag to anonymize snippets in report. Possible values are 'True' and 'False'. When its value is 'True', snippets in reports will be shown as anonymized and vice versa.

Default Configuration​

daemon:
port: 8000
host: localhost
logging:
level: info
reports:
format: pdf
renderer: xhtml2pdf
outputDir: ~/.pebblo
classifier:
anonymizeSnippets: False

Note: Users have the option to maintain any section or even a single field within a section. For instance, the config file might appear as follows:

logging:
level: info

This flexibility empowers users to tailor configurations to their specific needs while retaining default values for other sections or fields.