Release notesAPI docs
Information portal
Structural CloudTonic.ai

Verifying and enabling telemetry sharing

Sharing of analytics telemetry is required and enforced. Log sharing is also enabled by default. If you do not share logs with Tonic.ai, then identifying problems and troubleshooting issues becomes a slower, more manual process.

For details about all of the data that Tonic.ai collects from Structural, go to Data that Tonic.ai collects.

Enabling telemetry sharing

To ensure that Tonic.ai receives telemetry from your instance, verify the following.

Allowlist the telemetry URLs

To ensure that Tonic.ai can receive telemetry from Structural, allowlist the telemetry URLs.

Enable log sharing

Log sharing is enabled on each individual Structural container.

If log sharing becomes disabled, then to enable log sharing in a container, add the following environment settings to the Structural web server container:

Environment:
    ENABLE_LOG_COLLECTION: true
    ENVIRONMENT_NAME: "your company's name, in lowercase with no spaces"

How Tonic.ai enforces analytics telemetry sharing

Tonic.ai continuously verifies that it receives analytics telemetry from Structural.

If Tonic.ai cannot receive analytics telemetry, then:

  • After it does not receive analytics telemetry for 5 days, Structural displays warnings as a banner and on the Confirm Generation panel. The warnings include the number of days until data generation is disabled, if analytics telemetry sharing is not enabled.

  • After it does not receive analytics telemetry for 15 days, Structural disables data generation. The warnings change to errors.

When Tonic.ai begins to receive analytics telemetry, data generation is re-enabled.

Verifying that telemetry sharing is enabled and connected

Required global permission: Update Tonic Structural

From Structural Settings, you can check the status of telemetry sharing with Tonic.ai.

On the System Status tab, under Data Sharing:

  • The Telemetry panel indicates whether:

    • Analytics telemetry sharing is enabled.

    • If it is enabled, then whether Structural can make the connection to send the analytics telemetry data.

  • The Logging panel indicates whether:

    • Log sharing is enabled.

    • If it is enabled, then whether Structural can make the connection to send the logs.

Last updated