Adding PDF Render to LogScale Configuration

Once the PDF Render Service has been deployed, the LogScale service must be configured to point to the service using the DEFAULT_PDF_RENDER_SERVICE_URL configuration variable. This will need to be added to the configuration. For more information, see Basic Configuration.

If you are using a single PDF Render node, set the URL to match the hostname and port of the deployed service:

ini
DEFAULT_PDF_RENDER_SERVICE_URL="https://pdfrender.local:5123"

If using multiple PDF Render nodes and a load balancer, use the name of the load balancer:

ini
DEFAULT_PDF_RENDER_SERVICE_URL="https://pdfrenderlb.local:5123"

In addition, the following other environment variables should be set:

  • The ENABLE_SCHEDULED_REPORT variable must be set to true:

    ini
    ENABLE_SCHEDULED_REPORT=true

    This enables the scheduled report functionality.

  • Set the PUBLIC_URL to the URL of the LogScale deployment. This is shared with the PDF auxiliary node so that data can sent back to the cluster:

    ini
    PUBLIC_URL=https://logscale.local

    If you do not wish to use the public URL for render service callbacks, then you can configure the PDF_RENDER_SERVICE_CALLBACK_BASE_URL variable. This ensures that callbacks are confined to within your cluster.

  • Configure an email service, see Email Configuration for more information. An SMTP configuration might look like the following example:

    ini
    SMTP_HOST=localhost
SMTP_PORT=25
SMTP_SENDER_ADDRESS=noreply@example.com

A full example configuration:

ini
DEFAULT_PDF_RENDER_SERVICE_URL="https://pdfrender.local:5123"  
ENABLE_SCHEDULED_REPORT=true
PUBLIC_URL=https://logscale.local
SMTP_HOST=localhost
SMTP_PORT=25
SMTP_SENDER_ADDRESS=noreply@example.com

This configuration value must be set on each node within the cluster.

For users to be able to create scheduled PDF reports, they should have the Change Scheduled Reports permission.