{"id":18335823,"url":"https://github.com/epickrram/object-tracker","last_synced_at":"2025-04-09T19:50:44.899Z","repository":{"id":6336644,"uuid":"7572344","full_name":"epickrram/object-tracker","owner":"epickrram","description":"Tracking object creation in the JVM","archived":false,"fork":false,"pushed_at":"2013-01-12T06:30:17.000Z","size":136,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-15T12:17:02.919Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/epickrram.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-01-12T06:15:01.000Z","updated_at":"2017-06-15T14:18:28.000Z","dependencies_parsed_at":"2022-09-02T21:50:17.281Z","dependency_job_id":null,"html_url":"https://github.com/epickrram/object-tracker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epickrram%2Fobject-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epickrram%2Fobject-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epickrram%2Fobject-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epickrram%2Fobject-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/epickrram","download_url":"https://codeload.github.com/epickrram/object-tracker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248103931,"owners_count":21048244,"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":[],"created_at":"2024-11-05T20:05:02.613Z","updated_at":"2025-04-09T19:50:44.870Z","avatar_url":"https://github.com/epickrram.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"object-tracker\n==============\n\nTracking object creation in the JVM\n\nIntroduction\n------------\n\nObject-tracker consists of a JVM agent that modifies your java objects in order to track their creation. This information can then be written to a file for later analysis.\n\n\nUsage\n-----\n\nDownload the bundle with dependencies from the download page, and unzip. Add the following arguments to the command line when starting java:\n\n    -javaagent:./object-tracker-agent-0.1/object-tracker-agent-0.1.jar\n    -cp ./object-tracker-agent-0.1/javassist.jar:./object-tracker-agent-0.1/juxtapose-1.0.jar\n\nOpening jconsole, look for the MBean named `com.epickrram.tools:type=ObjectInstanceCounter`. To write object count data to disk, invoke the `dumpObjectCreationCounts` method, supplying a target filename.\n\nObject-tracker will write out a csv containing the current snapshot of the tracked object creation counts:\n\n    classname,count\n    com.epickrram.testing.TestObjectTwo,48\n    com.epickrram.testing.TestObjectOne,24\n\n\nConfiguration\n-------------\n\nYou must specify at least an inclusion filter to tell Object-tracker what classes to track.\n\nConfiguration by file\n---------------------\n\nSpecify a system property `com.epickrram.tool.object-tracker.config.file` that points to  a properties file with the following entries:\n\n* `com.epickrram.tool.object-tracker.config.include` Semi-colon separated regexes to specify classes to include (e.g. `com.mycompany;com.external.library`)\n\n* `com.epickrram.tool.object-tracker.config.exclude` Semi-colon separated regexes to specify classes to exclude\n\nConfiguration by property\n-------------------------\n\nFor simple regexes, just use the above system property keys to specify a single include/exclude regex.\n\nCaveats\n-------\n\nAttempting to monitor creation of any of the JDK classes (i.e. `java.lang`, `java.util`) will fail with a nasty exception.\n\nDependencies\n------------\n\nObject-tracker uses:\n  * [juxtapose](https://github.com/epickrram/juxtapose) for MBean management\n  * [javassist](http://www.jboss.org/javassist) for byte-code manipulation\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fepickrram%2Fobject-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fepickrram%2Fobject-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fepickrram%2Fobject-tracker/lists"}