{"id":18608758,"url":"https://github.com/activeviam/mac","last_synced_at":"2025-07-07T07:34:49.752Z","repository":{"id":39862445,"uuid":"95088591","full_name":"activeviam/mac","owner":"activeviam","description":"🔔 Monitoring project to explore ActivePivot data consumption.","archived":false,"fork":false,"pushed_at":"2025-01-20T09:58:35.000Z","size":3522,"stargazers_count":9,"open_issues_count":3,"forks_count":2,"subscribers_count":21,"default_branch":"main","last_synced_at":"2025-03-25T05:41:29.579Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/activeviam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-06-22T07:43:27.000Z","updated_at":"2025-01-20T09:58:37.000Z","dependencies_parsed_at":"2024-01-11T16:51:49.228Z","dependency_job_id":"39893253-55cb-4433-b4fb-e52bc7a23d60","html_url":"https://github.com/activeviam/mac","commit_stats":{"total_commits":197,"total_committers":22,"mean_commits":8.954545454545455,"dds":0.5532994923857868,"last_synced_commit":"3f98018dff32e49ecd0883dc910843e953369e2a"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/activeviam%2Fmac","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/activeviam%2Fmac/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/activeviam%2Fmac/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/activeviam%2Fmac/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/activeviam","download_url":"https://codeload.github.com/activeviam/mac/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248309387,"owners_count":21082202,"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-07T03:04:08.666Z","updated_at":"2025-04-10T22:30:53.967Z","avatar_url":"https://github.com/activeviam.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Memory Analysis Cube\n\nThe Atoti Memory Analysis Cube (MAC) is an Atoti project that aims to provide\nthe necessary tools to explore and analyze the data consumption from any other\nAtoti application, starting from Atoti Server 5.8 onward.\n\nThe project is built as a standalone Spring Boot jar file with an embedded\nAtoti UI application available on `localhost:9092` by default.\n\n**This version is compatible with exports from Atoti Server 5.8+ servers.**\n\nThe MAC server uses the latest released versions of Atoti Server and Atoti UI by default,\nbut the dependency versions can be changed in the project's POM.\n\n## Main Features\n\n* Off Heap memory usage monitoring \n* Store/Field-related memory footprint\n* Cube-related memory footprint\n* Overview of structure-related memory footprint\n* Loading and comparing several Atoti applications' exported memory\n  dump files\n\n## Building \u0026 launching the application\n\n[![CircleCI](https://dl.circleci.com/status-badge/img/gh/activeviam/mac/tree/main.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/activeviam/mac/tree/main)\n\n### Build steps\nThe requirements for building the MAC application are the following : \n  - Maven 3.0 +\n  - Java 11 +\n  - Atoti Server artifacts\n  - Atoti UI artifacts\n\nThe SpringBoot JAR of the application can be built by running the following command line:\n\n```\nmvn clean install -DskipTests=true\n```\n\n### Launch steps\n\nThe requirements for launching the MAC application are the following :\n  - Java 11+\n  - The built MAC .jar file\n  - A valid Atoti Server license\n\nOnce the JAR file built on the `./target directory`, the MAC server can be launched by the following command line:\n\n```\njava -jar [path to the MAC .jar file]\n```\n\n## Prepare your Application for Analysis\n\nAtoti Server 5.8+ applications come with a number of ways to export their memory\nusage in the form of memory report files, that can then be imported and analyzed\nusing MAC.\n\nThe process is explained below:\n\n* [Exporting your application](docs/setting_up/exporting.md)\n* [Structure of memory statistics and decompressing generated\n  files](docs/setting_up/statistics.md)\n* [Importing data in MAC](docs/setting_up/importing.md)\n\n## MAC Data Model\n\nTo fully make use of MAC's capabilities for analyzing your project, it is\nimportant to get familiar with its [data model](docs/data_model.md).\n\n## Bookmarks\n\nMAC comes with a number of predefined Atoti UI bookmarks that each offer some insights to\nvarious aspects of the monitored application.\n\n* [Overview](docs/bookmarks/overview.md)\n* [Per-field Analysis](docs/bookmarks/fields.md)\n* [Vector Block Analysis](docs/bookmarks/vectors.md)\n* [Dictionary and Index\n  Analysis](docs/bookmarks/dictionaries_indexes.md)\n* [Aggregate Provider Analysis](docs/bookmarks/aggregate_providers.md)\n\n## Known limitations\n\n* This tool does not support projects with multiple datastores. It is possible\n  to import data from multiple datastores, but there are no ways to assign a\n  store to a given datastore nor prevent conflicts between store names.\n* On-heap memory analysis is currently not fully implemented. The application\n  only sums the memory used by Chunks. Please directly refer to the JMX beans of\n  your application or other analysis tools for a deeper investigation.\n\n## Planned Improvements\n\n- [ ] Display and use the consumed On-heap memory reported by the Memory\n  Analysis.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Factiveviam%2Fmac","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Factiveviam%2Fmac","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Factiveviam%2Fmac/lists"}