Debug mode and logs

Enable debug mode and collect logs for CARTO Self-Hosted

Debug mode in CARTO allows you to gather additional information for troubleshooting and diagnosing issues.

Enable debug mode

To enable debug mode, enable the Debug Mode option in the configuration of your CARTO Self-Hosted platform through the Admin Console.

Update your customizations.yaml file and apply the changes:

CARTO SH Version 2025.1.10 or newer

appConfigValues:
  logLevel: "debug"

CARTO Self-Hosted version 2024.12.10 or older

importApi:
  extraEnvVars:
    - name: CARTO_TRACING_MODE
      value: "local"

importWorker:
  extraEnvVars:
    - name: CARTO_TRACING_MODE
      value: "local"

ldsApi:
  extraEnvVars:
    - name: CARTO_TRACING_MODE
      value: "local"

mapsApi:
  extraEnvVars:
    - name: CARTO_TRACING_MODE
      value: "local"

workspaceApi:
  extraEnvVars:
    - name: CARTO_TRACING_MODE
      value: "local"

workspaceSubscriber:
  extraEnvVars:
    - name: CARTO_TRACING_MODE
      value: "local"

Collecting logs

To collect logs from your CARTO Self-Hosted deployment:

Open a terminal.
Navigate to your CARTO Self-Hosted installation directory.
Run the following command to start a shell with permissions to check the logs:
```
./carto shell
```

Check the logs of each container:

kubectl logs -f <service_name> -n kotsadm

PreviousMonitoring & Observability NextGet debug information for support

Last updated 11 days ago

Was this helpful?

importApi:
  extraEnvVars:
    - name: CARTO_TRACING_MODE
      value: "local"

importWorker:
  extraEnvVars:
    - name: CARTO_TRACING_MODE
      value: "local"

ldsApi:
  extraEnvVars:
    - name: CARTO_TRACING_MODE
      value: "local"

mapsApi:
  extraEnvVars:
    - name: CARTO_TRACING_MODE
      value: "local"

workspaceApi:
  extraEnvVars:
    - name: CARTO_TRACING_MODE
      value: "local"

workspaceSubscriber:
  extraEnvVars:
    - name: CARTO_TRACING_MODE
      value: "local"