{"id":13608948,"url":"https://github.com/microsoft/gctoolkit","last_synced_at":"2025-05-14T08:06:48.122Z","repository":{"id":37812247,"uuid":"387930408","full_name":"microsoft/gctoolkit","owner":"microsoft","description":"Tool for parsing GC logs","archived":false,"fork":false,"pushed_at":"2025-04-30T01:01:40.000Z","size":1897,"stargazers_count":1258,"open_issues_count":65,"forks_count":157,"subscribers_count":36,"default_branch":"main","last_synced_at":"2025-04-30T02:19:08.510Z","etag":null,"topics":["gc","heap","java","jvm","memory","memory-management","performance"],"latest_commit_sha":null,"homepage":"https://github.com/microsoft/gctoolkit","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/microsoft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-07-20T22:44:17.000Z","updated_at":"2025-04-30T01:01:44.000Z","dependencies_parsed_at":"2023-11-10T11:31:01.486Z","dependency_job_id":"fa8ec89d-b57f-4fa7-aab2-3e2f8b6674bb","html_url":"https://github.com/microsoft/gctoolkit","commit_stats":{"total_commits":332,"total_committers":36,"mean_commits":9.222222222222221,"dds":0.8554216867469879,"last_synced_commit":"de9d91d4c73d30a636b42fd7ab12fbfbdcebf4ea"},"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fgctoolkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fgctoolkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fgctoolkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fgctoolkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microsoft","download_url":"https://codeload.github.com/microsoft/gctoolkit/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254101618,"owners_count":22014909,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gc","heap","java","jvm","memory","memory-management","performance"],"created_at":"2024-08-01T19:01:31.231Z","updated_at":"2025-05-14T08:06:43.112Z","avatar_url":"https://github.com/microsoft.png","language":"Java","readme":"# Microsoft GCToolKit\n\nGCToolkit is a set of libraries for analyzing HotSpot Java garbage collection (GC) log files. The toolkit parses GC log files into discrete events and provides an API for aggregating data from those events. This allows the user to create arbitrary and complex analyses of the state of managed memory in the Java Virtual Machine (JVM) represented by the garbage collection log.\n\nFor more detail you can read our [Launch Blog Post](https://devblogs.microsoft.com/java/introducing-microsoft-gctoolkit/).\n\n[![GCToolKit build with Maven](https://github.com/microsoft/gctoolkit/actions/workflows/maven.yml/badge.svg)](https://github.com/microsoft/gctoolkit/actions/workflows/maven.yml)\n\n---\n\n## Introduction\n\nManaged memory in the Java Virtual Machine (JVM) is composed of 3 main pieces:\n\n1. Memory buffers known as Java heap\n1. Allocators which perform the work of getting data into Java heap\n1. Garbage Collection (GC).\n\nWhile GC is responsible for recovering memory in Java heap that is no longer in use, the term is often used as a euphemism for memory management. The phrasing of _Tuning GC_ or _tuning the collector_ are often used with the understanding that it refers to tuning the JVM’s memory management subsystem. The best source of telemetry data for tuning GC comes from GC Logs and GCToolKit has been helpful in making this task easier by providing parsers, models and an API to build analytics with. You can run the Maven project [HeapOccupancyAfterCollectionSummary sample](./sample/README.md) as an example of this.\n\n## Usage\n\nIn order to use this library you'll need to add its dependencies to your project. We provide the instructions for Maven below.\n\n### Maven Coordinates\n\n[![Maven Central](https://img.shields.io/maven-central/v/com.microsoft.gctoolkit/gctoolkit-parser.svg?label=Maven%20Central)](https://search.maven.org/search?q=g:%22com.microsoft.gctoolkit%22%20AND%20a:%22gctoolkit-api%22)\n\nThe GCToolKit artifacts are in [Maven Central](https://search.maven.org/search?q=g:com.microsoft.gctoolkit). You'll then need to add the `api`, `parser` and `vertx` modules to your project in the `dependencyManagement` and/or `dependencies` section as you see fit.\n\n```xml\n\u003cdependencies\u003e\n    ...\n    \n    \u003cdependency\u003e\n        \u003cgroupId\u003ecom.microsoft.gctoolkit\u003c/groupId\u003e\n        \u003cartifactId\u003eapi\u003c/artifactId\u003e\n        \u003cversion\u003e3.0.4\u003c/version\u003e\n    \u003c/dependency\u003e\n    \n    \u003cdependency\u003e\n        \u003cgroupId\u003ecom.microsoft.gctoolkit\u003c/groupId\u003e\n        \u003cartifactId\u003eparser\u003c/artifactId\u003e\n        \u003cversion\u003e3.0.4\u003c/version\u003e\n    \u003c/dependency\u003e\n    \n    \u003cdependency\u003e\n        \u003cgroupId\u003ecom.microsoft.gctoolkit\u003c/groupId\u003e\n        \u003cartifactId\u003evertx\u003c/artifactId\u003e\n        \u003cversion\u003e3.0.4\u003c/version\u003e\n    \u003c/dependency\u003e\n\n    ...\n\u003c/dependencies\u003e\n```\n\n## User Discussions\n\nMeet other developers working with GCToolKit, ask questions, and participate in the development of this project by visiting the [Discussions](https://github.com/microsoft/gctoolkit/discussions) tab.\n\n### Example\n\nSee the sample project: [sample/README](./sample/README.md)\n\n## Contributing\n\nSee [CONTRIBUTING](CONTRIBUTING.md) for full details including more options for building and testing the project.\n\n### Test Coverage Report\n\n**Core API Coverage** \u003c/br\u003e![Coverage](.github/badges/jacoco-api-coverage.svg)\n\n**Core :: Parser\u003c/br\u003e**![Coverage::Core::Parser](.github/badges/jacoco-parser-coverage.svg)\n\n**Core :: Vertx**\u003c/br\u003e![Coverage::Core::Parser](.github/badges/jacoco-vertx-coverage.svg)\n\n## License\n\nMicrosoft GCToolKit is licensed under the [MIT](https://github.com/microsoft/gctoolkit/blob/master/LICENSE) license.\n","funding_links":[],"categories":["Java"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fgctoolkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrosoft%2Fgctoolkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fgctoolkit/lists"}