> This is the implementation issue that came out of the conversation (https://gitlab.com/gitlab-data/analytics/-/issues/4291#note_375641166) on how to more accurately track Plan TMAU ## Goal Track user interactions with issues within the usage ping so that we can calculate Monthly Active Users (MAU) for Plan. It is important that we have an accurate reflect of MAU as it is one of the primary metrics that GitLab leadership uses to [make informed investment decisions](https://about.gitlab.com/handbook/product/investment/) across the product. ## Project Management MAU Definition The sum of all unique users that took an action within an Issue over a given period of time. ## Proposal Implement a counter in the usage ping that aggregates the total count of unique users that took an action on an issue. Based on this conversation (https://gitlab.com/gitlab-data/analytics/-/issues/4291#note_365848816), it appears as though most events can be tracked via: - `system_note_metadata` - `resource_milestone_events` - `resource_state_events` - `resource_weight_events` Record the aggregate unique MAU counts under `issue_events` in the usage ping. ## Events To Aggregate In Usage Ping **Question:** Do these actions include issue created? There is currently no system note generated when an issue is created. - Answer: Yes (https://gitlab.com/gitlab-org/gitlab/-/issues/229918#note_382421100) | Action | Description | Added To Counter | |--------|-----------|-------------| | created | Issue created | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/43228 | | title | Changed the title of the issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/40904 | | description | Changed the description of the issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/40904 | | task | Checked / unchecked a task list item in the description | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/43828 | | closed* | Closed the issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/43228 | | opened* | Reopened the issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/43228 | | label* | Changed the labels of the issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/43228 | | milestone* | Changed the milestone of the issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/43228 | | iteration* | Changed the iteration of the issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/43228 | | weight* | Changed the weight of the issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/43228 | | assignee | Changed the assignees of the issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/40904 | | due_date | Changed the due date of the issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/44404 | | confidential | Marked the issue as confidential | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/40904 | | visible | Marked the issue as not confidential | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/40904 | | time_estimate_added | Add a time estimate | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/44404 | | time_spent_recorded | Time spent entry recorded | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/44404 | | health_status | Changed the health status of the issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/44417 | | cross_reference | Mentioned the issue somewhere else | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/43828 | | moved | Moved the issue or promoted the issue to an Epic | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/43828 | | relate | Marked the issue as related to another | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/43828 | | unrelate | Removed a related issue relation | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/43828 | | duplicate | Marked the issue as a duplicate of another | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/43828 | | locked | Locked the discussions of the issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/43828 | | unlocked | Unlocked the discussions of the issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/43828 | | issue_added_to_epic | Set the parent epic of an issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/44371 | | issue_changed_epic | Changed the parent epic to another epic | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/44371 | | issue_removed_from_epic | Removed the parent epic | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/44371 | | designs_added | Added a design to the issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/44373 | | designs_modified | Changed a design belonging to the issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/44373 | | designs_removed | Removed a design from the issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/44373 | | comment_added | Added a comment to the issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/45609 | | comment_edited | Edited a comment on the issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/45609 | | commend_removed | Removed (deleted) a comment on the issue | https://gitlab.com/gitlab-org/gitlab/-/merge_requests/45609 | Note: Those marked with `*` are now being tracked using resource events. So we must also account for records in those tables. ## Bonus Figure out how to add individual usage ping counters for each action that reports: - Count unique MAU - Count aggregate actions <!-- triage-serverless v3 PLEASE DO NOT REMOVE THIS SECTION --> *This page may contain information related to upcoming products, features and functionality. It is important to note that the information presented is for informational purposes only, so please do not rely on the information for purchasing or planning purposes. Just like with all projects, the items mentioned on the page are subject to change or delay, and the development, release, and timing of any products, features, or functionality remain at the sole discretion of GitLab Inc.* <!-- triage-serverless v3 PLEASE DO NOT REMOVE THIS SECTION -->