--- title: "Get the resource usage of a Gradle build." method: GET path: "/api/builds/{id}/gradle-resource-usage" tags: ["Builds", "Develocity"] --- # Get the resource usage of a Gradle build. `GET /api/builds/{id}/gradle-resource-usage` ## Request - Base URL: `https://develocity.example.com` - URL: `https://develocity.example.com/api/builds/{id}/gradle-resource-usage` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) This model is Gradle specific and cannot be requested for another build tool. ## Response `200` The resource usage of a Gradle build. - GradleResourceUsage - `totalMemory` integer, nullable: The physical memory of the system in bytes. Can be `null` if the metrics could not be captured. - `total` ResourceUsageBreakdown - `allProcessesCpu` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `buildProcessCpu` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `buildChildProcessesCpu` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `allProcessesMemory` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `buildProcessMemory` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `buildChildProcessesMemory` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `diskReadThroughput` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `diskWriteThroughput` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `networkUploadThroughput` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `networkDownloadThroughput` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `nonExecution` ResourceUsageBreakdown - `allProcessesCpu` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `buildProcessCpu` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `buildChildProcessesCpu` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `allProcessesMemory` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `buildProcessMemory` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `buildChildProcessesMemory` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `diskReadThroughput` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `diskWriteThroughput` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `networkUploadThroughput` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `networkDownloadThroughput` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `execution` ResourceUsageBreakdown - `allProcessesCpu` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `buildProcessCpu` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `buildChildProcessesCpu` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `allProcessesMemory` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `buildProcessMemory` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `buildChildProcessesMemory` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `diskReadThroughput` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `diskWriteThroughput` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `networkUploadThroughput` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. - `networkDownloadThroughput` ResourceUsageMetric - `max` integer, required: The max value of the metric. - `average` integer, required: The average value of the metric. - `median` integer, required: The median (or 50th percentile) value of the metric. - `p5` integer, required: The 5th percentile value of the metric. - `p25` integer, required: The 25th percentile value of the metric. - `p75` integer, required: The 75th percentile value of the metric. - `p95` integer, required: The 95th percentile value of the metric. ## Other responses - `400`: The request cannot be fulfilled due to a problem. - `404`: The referenced resource either does not exist or the permissions to know about it are missing. - `500`: The server encountered an unexpected error. - `503`: The server is not ready to handle the request. --- [API](https://skmtc.dev/develocity/apis/develocity-api.md) - [All operations](https://skmtc.dev/develocity/apis/develocity-api/llms.txt) - [OpenAPI document](https://skmtc.dev/develocity/apis/develocity-api/revisions/b49835fbf065?raw)