Gradle build insights {#gradle-build-insights}

[!WARNING] Requirements

• The <.localized_link href="/guides/install-gradle-plugin">Tuist Gradle plugin</.localized_link> installed and configured

Tuist's Gradle plugin can send build analytics to Tuist, giving you visibility into task execution and build performance.

Configure upload behavior {#configure-upload-behavior}

By default:

• Build analytics are uploaded in the background for local builds.
• Build analytics are uploaded in the foreground for CI runs to avoid losing telemetry on short-lived agents.

You can control this behavior using uploadInBackground inside the tuist extension:

tuist {
    uploadInBackground = false // always upload in the foreground
}

Configuration reference {#configuration-reference}

The uploadInBackground option is available in the tuist extension block in settings.gradle.kts:

This setting does not affect remote cache settings in the buildCache block.