Skip to content

Enable Debug Logs for Starburst Trino

This section explains how to enable debug logging for Starburst Trino to help troubleshoot access management issues.

Prerequisites

  • Starburst Trino setup is completed successfully

Steps to Enable Debug Logs

  1. Navigate to the privacera-starburst-trino-plugin

    Bash
    cd ~/privacera-starburst-trino-plugin
    

  2. Edit the values.yaml file

    Bash
    vi values.yaml
    

  3. Add the debug log configuration to the coordinator section in values.yaml.

    Add the following configuration directly under the coordinator section:

Bash
1
2
3
4
5
6
etcFiles:
   properties:
      log.properties: |
         io.trino=INFO
         org.apache.ranger=INFO
         org.apache.ranger.authorization.trino=DEBUG
4. Save the values.yaml file.

Install or Upgrade Starburst Trino on Kubernetes Cluster

After adding the debug log configuration to the values.yaml file, upgrade the existing Helm release—or install it if it is not already present—using the specified chart, version, and values file:

Bash
1
2
3
4
5
helm upgrade my-sep oci://harbor.starburstdata.net/starburstdata/charts/starburst-enterprise \
  --version <SBT_VERSION_TAG> \
  --install \
  --values ./values.yaml \
  --namespace <STARBURST_TRINO_NAMESPACE>

Verify Debug Logs

  1. Wait for the pods to restart and confirm they are in Running state
    Bash
    kubectl get pods -n <STARBURST_TRINO_NAMESPACE>
    
  2. Run the following command and ensure the configuration is updated
    Bash
    cat /etc/starburst/log.properties
    
  3. Check the coordinator pod logs to verify that debug logs are being generated:
    Bash
    kubectl logs <COORDINATOR_POD_NAME> -n <STARBURST_TRINO_NAMESPACE> 
    

Debug logging is set on the connector, not in values.yaml. Turn on Enable debug logging while configuring the connector, then set the levels:

Field Definition Default
Plugin log level Level for the Privacera plugin classes. INFO
Trino log level Level for everything else on the cluster. INFO
Ranger log level Level for the Ranger policy engine and audit client. INFO

Save the connector and download the bundle again, then rebuild the image and restart the coordinator. The levels only reach the plugin through a freshly downloaded bundle.