Info Kotlin Process Plugin

Includes information about Kotlin processes in the Build Scans or in the build output. The plugin is compatible with configuration cache.

Usage

Apply the plugin in settings.gradle(.kts) so it observes the whole build, including all projects:

Kotlin (settings.gradle.kts)

Using the plugins DSL:

plugins {
  id("io.github.cdsap.kotlinprocess") version "0.3.0"
}

Groovy (settings.gradle)

Using the plugins DSL:

plugins {
  id "io.github.cdsap.kotlinprocess" version "0.3.0"
}

The legacy project-plugin application in build.gradle(.kts) remains supported for published consumers, but settings-plugin application is preferred for multi-project builds.

Legacy project application (build.gradle.kts)

plugins {
  id("io.github.cdsap.kotlinprocess") version "0.3.0"
}

Using legacy plugin application:

buildscript {
  repositories {
    gradlePluginPortal()
  }
  dependencies {
    classpath("io.github.cdsap:infokotlinprocess:0.3.0")
  }
}

apply(plugin = "io.github.cdsap.kotlinprocess")

Legacy project application (build.gradle)

plugins {
  id "io.github.cdsap.kotlinprocess" version "0.3.0"
}

Using legacy plugin application:

buildscript {
  repositories {
    gradlePluginPortal()
  }
  dependencies {
    classpath "io.github.cdsap:infokotlinprocess:0.3.0"
  }
}

apply plugin: "io.github.cdsap.kotlinprocess"

Output

Build Scans

If you are using Develocity, the information about the Kotlin processes will be included as custom value in the Build Scan:

The field Usage represents the value obtained at the end of the build using jstat on the JVM process.

GBOS observations

GBOS file sinks and the GBOS Develocity projection are enabled together with one opt-in property:

infoKotlinProcess.gbos.enabled=true

or configure it in the settings script:

infoKotlinProcess {
    gbos {
        enabled.set(true)
    }
}

Develocity is detected automatically. Without the opt-in, legacy Kotlin-Process-* custom values remain unchanged. With the opt-in, the legacy values are replaced by the gbos.* projection:

Develocity	GBOS opt-in	Custom values
absent	either	no custom values; GBOS files are written only when enabled
present	off	legacy Kotlin-Process-* values
present	on	only gbos.* values

Each Kotlin daemon is reported as a jvm.process entity observation.

The JSON and NDJSON files are written atomically to ${rootDir}/build/info-kotlin-process/gbos.json and ${rootDir}/build/info-kotlin-process/gbos.ndjson. Each build replaces both files with the observations generated by that build.

Build Output

If you are not using Develocity, the information about the Kotlin processes will be included at the end of the build:

> Task :core:ui:compileProdDebugKotlin
┌─────────────────────────────────────────────────────────────────────────────┐
│  Kotlin processes                                                           │
├─────────┬──────────┬───────────┬────────────┬───────────────┬───────────────┤
│  PID    │  Max     │  Usage    │  Capacity  │  GC Time      │  Uptime       │
├─────────┼──────────┼───────────┼────────────┼───────────────┼───────────────┤
│  10865  │  1.0 Gb  │  0.66 Gb  │  1.0 Gb    │  0.0 minutes  │  0.0 minutes  │
├─────────┼──────────┼───────────┼────────────┼───────────────┼───────────────┤
│  9011   │  0.5 Gb  │  0.2 Gb   │  0.5 Gb    │  0.0 minutes  │  0.0 minutes  │
└─────────┴──────────┴───────────┴────────────┴───────────────┴───────────────┘
BUILD SUCCESSFUL in 35s

Requirements

• Gradle 7.5

Libraries

• com.gradle:develocity-gradle-plugin
• com.jakewharton.picnic:picnic