Sharing logs with

You can automatically share logs from your on-premises installation with Tonic engineers in a secure and safe way.

How uses the Tonic logs

By default, logs are shared with uses these logs to diagnose issues, troubleshoot bugs, help identify when performance can be improved, and to generally improve Tonic and its features.
If you do not share logs with, then identifying problems and troubleshooting issues becomes a slower, more manual process.

Log file architecture

Tonic log architecture
Tonic log files are stored in an Amazon S3 bucket for one year. uses a log aggregator to make the log files searchable. On the log aggregator, job logs are deleted after six months. API logs are deleted after 60 days.

What is in the log data

Schema information

Tonic logs include detailed schema information for your database, including:
  • Table, schema, and column names
  • Data types
  • Table sizes

Usage information

Tonic includes many types of usage information in the logs, including information related to:
  • Actions in the user interface, from web requests that the web server sees
  • Details related to data generation
  • Workspace configuration details, such as the generators that are applied to each column

Performance data collects detailed performance data for the generation process, including data transfer rates and code profiler results.

What is NOT in the log data

Tonic has strong safeguards in place to ensure that actual data does not leak into logs.
Logs that are shared with are always redacted. Tonic does not send diagnostic logs to
Tonic does not log information related to the database connection, such as the database username, password, and host.

Verifying whether log sharing is enabled and connected

Required global permission: Update Tonic
From Tonic Settings, you can check the status of log sharing with Tonic.
On the System Status tab, under Data Sharing, the Logging panel indicates whether:
  • Log sharing is enabled.
  • If it is enabled, then whether Tonic can make the connection to send the logs.
Data Sharing section of the System Status tab on Tonic Settings

Re-enabling log sharing

Log sharing is enabled on each individual Tonic container.
If log sharing becomes disabled, then to enable log sharing in a container, add the following environment settings to the Tonic web server container:
ENVIRONMENT_NAME: "your company's name, in lowercase with no spaces"

Viewing what is sent to

Tonic writes all logs to STDOUT. To view the exact logs that are collected and shared, view what is written to STDOUT.
If the Tonic container runs in Docker, you can run:
docker logs tonic_worker
Last modified 2mo ago