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.