據(jù)收集（Usage Data Collection）機(jī)制完全指南：字段含義、上報(bào)流程與開(kāi)啟關(guān)閉方法)
數(shù)據(jù)庫(kù)后端前端協(xié)作【免費(fèi)下載鏈接】mathesarAn intuitive spreadsheet-like interface that lets users of all technical skill levels view, edit, query, and collaborate on Postgres data directly. 100% open source and self hosted, with native Postgres access control.項(xiàng)目地址https://gitcode.com/gh_mirrors/ma/mathesar點(diǎn)擊查看免費(fèi)下載本文圍繞 Mathesar 的匿名使用數(shù)據(jù)收集Usage Data Collection功能展開(kāi)講解其 opt-in 原則、每 24 小時(shí)上報(bào)的全部數(shù)據(jù)字段及其統(tǒng)計(jì)口徑、后臺(tái)收集與上傳的完整流程并給出通過(guò)安裝向?qū)?、管理設(shè)置頁(yè)、RPC 接口與 Web 頁(yè)面查看/開(kāi)關(guān)該功能的實(shí)戰(zhàn)方法。讀完本文你將能準(zhǔn)確判斷該功能是否符合自身部署場(chǎng)景并能在任何時(shí)間查看本實(shí)例生成的匿名報(bào)告、隨時(shí)關(guān)閉數(shù)據(jù)上報(bào)。功能概述為什么需要匿名使用數(shù)據(jù)Mathesar 是一款基于 PostgreSQL 的開(kāi)源數(shù)據(jù)庫(kù)管理 Web 應(yīng)用為了讓用戶對(duì)是否上報(bào)數(shù)據(jù)做出知情選擇它內(nèi)置了一套可選的opt-in匿名使用數(shù)據(jù)收集機(jī)制。開(kāi)啟后Mathesar 會(huì)在后臺(tái)收集去標(biāo)識(shí)化的使用統(tǒng)計(jì)信息并定期上報(bào)幫助開(kāi)發(fā)團(tuán)隊(duì)了解功能使用情況、定位體驗(yàn)問(wèn)題并改進(jìn)穩(wěn)定性和性能。該機(jī)制的核心原則非常清晰從 mathesar/analytics.py 的模塊注釋即可確認(rèn)基本邏輯是只要存在installation_idAnalytics 即為開(kāi)啟狀態(tài)可以且將會(huì)被收集否則不會(huì)收集。因此disable_analytics函數(shù)只是刪除該 ID如果存在。也就是說(shuō)收集行為完全由是否存在 Installation ID這一個(gè)開(kāi)關(guān)決定不存在其他隱式上報(bào)路徑。該 ID 是一個(gè)隨機(jī)生成的 UUIDuuid4()與你的 Mathesar 安裝實(shí)例一一對(duì)應(yīng)不包含任何可識(shí)別個(gè)人身份的信息。每 24 小時(shí)上報(bào)的數(shù)據(jù)字段當(dāng)實(shí)例處于開(kāi)啟狀態(tài)時(shí)Mathesar 會(huì)每 24 小時(shí)生成并上報(bào)一份匿名報(bào)告。原文檔docs/docs/user-guide/usage-data-collection.md列出的全部字段如下字段含義created_at報(bào)告創(chuàng)建時(shí)間的時(shí)間戳installation_id隨機(jī)生成的 UUID唯一標(biāo)識(shí)你的 Mathesar 安裝mathesar_versionMathesar 版本號(hào)字符串例如0.2.0user_countMathesar 安裝上的用戶賬戶數(shù)量active_user_count最近 14 天內(nèi)登錄過(guò) Mathesar 的用戶數(shù)量sso_connected_user_count在 Mathesar 安裝上配置了 SSO 的用戶數(shù)量configured_role_count在 Mathesar 安裝上配置的 PostgreSQL 角色數(shù)量connected_database_count已連接到 Mathesar 的數(shù)據(jù)庫(kù)數(shù)量connected_database_schema_count連接到 Mathesar 的所有 schema 總數(shù)connected_database_table_count連接到 Mathesar 的所有表總數(shù)connected_database_record_count所有連接表中的記錄總數(shù)近似值exploration_count在 Mathesar 中創(chuàng)建的 Explorations數(shù)據(jù)探索數(shù)量form_count在 Mathesar 中創(chuàng)建的 Forms表單數(shù)量public_form_count在 Mathesar 中公開(kāi)發(fā)布的 Forms 數(shù)量注原文檔中connected_database_record_count字段列在created_at之后但為便于理解上表按數(shù)據(jù)歸屬重新歸類排序字段名與含義與原文檔完全一致。字段的統(tǒng)計(jì)口徑源碼級(jí)說(shuō)明每個(gè)字段并非憑空統(tǒng)計(jì)而是有明確的底層數(shù)據(jù)來(lái)源見(jiàn) mathesar/analytics.py 中prepare_analytics_report()的實(shí)現(xiàn)mathesar_version取自mathesar.__version__user_count統(tǒng)計(jì)User.objects.filter(is_activeTrue)即激活狀態(tài)的用戶賬戶數(shù)active_user_count統(tǒng)計(jì)is_activeTrue且last_login在ACTIVE_USER_DAYS常量值為 14天內(nèi)登錄過(guò)的用戶sso_connected_user_count統(tǒng)計(jì)allauth的SocialAccount中關(guān)聯(lián)激活用戶的數(shù)量對(duì)應(yīng) SSO 登錄配置configured_role_count統(tǒng)計(jì)ConfiguredRole模型記錄數(shù)數(shù)據(jù)庫(kù)相關(guān)四個(gè)字段遍歷所有Database對(duì)象逐個(gè)累加其object_countsschema 數(shù)、表數(shù)、記錄數(shù)記錄數(shù)是近似值若某個(gè)數(shù)據(jù)庫(kù)無(wú)法取到統(tǒng)計(jì)信息如連接異常會(huì)打印警告并跳過(guò)不會(huì)中斷整個(gè)報(bào)告生成exploration_count/form_count/public_form_count分別統(tǒng)計(jì)Explorations與Form模型記錄數(shù)其中public_form_count僅統(tǒng)計(jì)publish_publicTrue的表單。這些字段對(duì)應(yīng)數(shù)據(jù)庫(kù)模型定義在 mathesar/models/analytics.py 中InstallationID與AnalyticsReportAnalyticsReport的所有統(tǒng)計(jì)字段均允許為空nullTrue, blankTrue并在遷移 0006_analyticsreport_sso_connected_user_count.py 中補(bǔ)充了sso_connected_user_count字段。收集與上報(bào)的完整工作流程觸發(fā)機(jī)制非阻塞的后臺(tái)線程Analytics 的收集由裝飾器wire_analytics觸發(fā)。它在每次 RPC 調(diào)用由 mathesar/rpc/decorators.py 的調(diào)用鏈注入時(shí)利用 Django 緩存設(shè)置一個(gè) 30 分鐘有效的analytics_done標(biāo)志并啟動(dòng)一個(gè)后臺(tái)線程執(zhí)行run_analytics()從而避免阻塞用戶請(qǐng)求。這一非阻塞設(shè)計(jì)有專門(mén)測(cè)試驗(yàn)證test_non_blocking_wrapper見(jiàn) mathesar/tests/test_analytics.py斷言被裝飾函數(shù)返回耗時(shí)遠(yuǎn)小于后臺(tái)任務(wù)中的模擬耗時(shí)。24 小時(shí)間隔與上傳清理后臺(tái)線程run_analytics()的執(zhí)行邏輯為檢查是否存在InstallationID不存在則直接返回不收集任何數(shù)據(jù)檢查當(dāng)天是否已生成過(guò)報(bào)告ANALYTICS_FREQUENCY 1即每天至多保存一份報(bào)告滿足條件后依次執(zhí)行save_analytics_report()調(diào)用prepare_analytics_report()生成報(bào)告并落庫(kù)upload_analytics_reports()將所有未上傳uploadedFalse的報(bào)告批量 POST 到settings.MATHESAR_ANALYTICS_URL成功后批量標(biāo)記uploadedTruedelete_stale_reports()清理過(guò)期報(bào)告——已上傳且超過(guò) 2 天的報(bào)告以及無(wú)論上傳狀態(tài)如何、更新超過(guò)ANALYTICS_REPORT_MAX_AGE30 天的報(bào)告都會(huì)被刪除。安裝時(shí)的首次上報(bào)除了周期上報(bào)外Mathesar 在首次安裝完成時(shí)還會(huì)發(fā)送一次性的安裝確認(rèn)安裝向?qū)П韱沃衞ne_time_installation_confirmation復(fù)選框被勾選時(shí)調(diào)用upload_initial_report()向MATHESAR_INIT_REPORT_URL發(fā)送僅含mathesar_version的初始報(bào)告見(jiàn) complete_installation.py。如何開(kāi)啟與關(guān)閉匿名數(shù)據(jù)收集方式一安裝完成向?qū)状尾渴鹪谑状尾渴?Mathesar 的Finish Setting Up Mathesar頁(yè)面模板 complete_installation.html中有兩個(gè)與數(shù)據(jù)相關(guān)的復(fù)選框Send a one-time confirmation to let us know youve installed Mathesar默認(rèn)勾選僅發(fā)送一次安裝確認(rèn)Enable anonymous usage data collection啟用匿名使用數(shù)據(jù)收集默認(rèn)勾選勾選后在創(chuàng)建管理員用戶時(shí)調(diào)用initialize_analytics()生成 Installation ID。表單處理邏輯位于 mathesar/views/installation/complete_installation.pyusage_stats為真時(shí)創(chuàng)建隨機(jī) UUID 作為 Installation ID并在異常時(shí)記錄錯(cuò)誤日志而不影響安裝流程。方式二管理設(shè)置頁(yè)面運(yùn)行期隨時(shí)調(diào)整運(yùn)行中的實(shí)例可以在Admin Settings管理設(shè)置頁(yè)面切換開(kāi)關(guān)。前端實(shí)現(xiàn)見(jiàn) mathesar_ui/src/pages/admin-settings/SettingsPage.svelte頁(yè)面加載時(shí)調(diào)用 RPCanalytics.get_state獲取當(dāng)前狀態(tài)勾選開(kāi)關(guān)時(shí)調(diào)用analytics.initialize開(kāi)啟取消勾選時(shí)調(diào)用analytics.disable關(guān)閉操作成功會(huì)彈出提示Anonymous usage data collection enabled/disabled successfully。前端 RPC 封裝定義在 mathesar_ui/src/api/rpc/analytics.ts共暴露get_state、initialize、disable、upload_feedback四個(gè)方法。方式三RPC 接口開(kāi)發(fā)者/自動(dòng)化方式Analytics 的全部 RPC 方法實(shí)現(xiàn)在 mathesar/rpc/analytics.py方法名與語(yǔ)義如下RPC 方法作用analytics.get_state返回當(dāng)前狀態(tài){enabled: bool}analytics.initialize開(kāi)啟收集創(chuàng)建 Installation IDanalytics.disable關(guān)閉收集刪除 Installation ID同時(shí)級(jí)聯(lián)刪除所有已保存的報(bào)告analytics.view_report查看一份示例報(bào)告與真實(shí)報(bào)告使用同一生成函數(shù)analytics.upload_feedback向 Mathesar 服務(wù)器上傳一條反饋消息需登錄其中disable的語(yǔ)義值得一提RPC 文檔注明關(guān)閉目前等同于刪除 Installation ID從而保證不可能再保存 Analytics 報(bào)告任何已保存的報(bào)告也會(huì)隨 ID 刪除而被級(jí)聯(lián)清除on_deletemodels.CASCADE。查看實(shí)際生成的報(bào)告原文檔docs/docs/user-guide/usage-data-collection.md提供了兩種查看真實(shí)報(bào)告的方法方法一訪問(wèn)示例報(bào)告頁(yè)面在運(yùn)行中的 Mathesar 實(shí)例上訪問(wèn)路徑/info/analytics_sample_report/該路徑在 mathesar/urls.py 中注冊(cè)路由名analytics_sample_report視圖定義于 mathesar/views/init.py 的analytics_sample_report渲染模板 mathesar/templates/analytics/sample_report.html。該模板頁(yè)面加載時(shí)通過(guò)前端腳本向/api/rpc/v0/發(fā)起analytics.view_reportRPC 調(diào)用將返回的 JSON 報(bào)告以格式化形式渲染在頁(yè)面上方便管理員直觀判斷開(kāi)啟后會(huì)上報(bào)哪些數(shù)據(jù)。方法二直接調(diào)用 RPC可以調(diào)用 RPC 函數(shù)analytics.view_reportAPI 索引見(jiàn) docs/docs/api/methods.md。該函數(shù)使用與真實(shí)報(bào)告完全相同的prepare_analytics_report()生成數(shù)據(jù)因此查看結(jié)果即代表實(shí)際會(huì)上報(bào)的內(nèi)容。其返回值類型AnalyticsReport是 TypedDict包含上述全部統(tǒng)計(jì)字段installation_id、mathesar_version、user_count等見(jiàn) mathesar/rpc/analytics.py。上報(bào)目的地與自定義配置報(bào)告與反饋消息最終通過(guò) HTTP POST 發(fā)送到配置的 URL。相關(guān)設(shè)置定義在 config/settings/common_settings.py配置項(xiàng)環(huán)境變量默認(rèn)值開(kāi)發(fā)環(huán)境生產(chǎn)環(huán)境默認(rèn)值MATHESAR_ANALYTICS_URLMATHESAR_ANALYTICS_URLhttps://example.com/collectorhttps://analytics.mathesar.dev/collect-analytics-reportsMATHESAR_INIT_REPORT_URLMATHESAR_INIT_REPORT_URLhttps://example.com/hellohttps://analytics.mathesar.dev/collect-initial-reportMATHESAR_FEEDBACK_URLMATHESAR_FEEDBACK_URLhttps://example.com/feedbackhttps://analytics.mathesar.dev/collect-feedback-message生產(chǎn)環(huán)境的真實(shí)上報(bào)地址見(jiàn) config/settings/production.py。這些 URL 均支持通過(guò)同名環(huán)境變量覆蓋自托管用戶可以據(jù)此將數(shù)據(jù)重定向到自己的收集端點(diǎn)實(shí)現(xiàn)完全自控。隱私與安全邊界從源碼可以確認(rèn)以下幾點(diǎn)隱私邊界純匿名報(bào)告中唯一涉及實(shí)例身份的是隨機(jī)生成的installation_idUUID不含用戶名、郵箱、密碼、數(shù)據(jù)庫(kù)內(nèi)容或任何個(gè)人數(shù)據(jù)可隨時(shí)關(guān)閉關(guān)閉后 Installation ID 被刪除且級(jí)聯(lián)清除已保存報(bào)告系統(tǒng)不會(huì)再生成新報(bào)告后臺(tái)線程因無(wú) ID 直接返回統(tǒng)計(jì)信息不敏感所有字段均為數(shù)量級(jí)統(tǒng)計(jì)用戶數(shù)、表數(shù)、記錄數(shù)等其中記錄數(shù)還是近似值異常隔離生成報(bào)告過(guò)程中某個(gè)數(shù)據(jù)庫(kù)統(tǒng)計(jì)失敗不會(huì)導(dǎo)致整個(gè)流程中斷只會(huì)記錄警告見(jiàn)prepare_analytics_report中的except Exception分支。測(cè)試與驗(yàn)證倉(cāng)庫(kù)自帶的測(cè)試 mathesar/tests/test_analytics.py 覆蓋了該機(jī)制的完整生命周期包括非阻塞后臺(tái)包裝器、initialize → save → disable全流程驗(yàn)證關(guān)閉后報(bào)告被清空、重復(fù)初始化 Installation ID 會(huì)觸發(fā)唯一性約束異常IntegrityError以及上傳后報(bào)告字段內(nèi)容與批量標(biāo)記uploadedTrue的準(zhǔn)確性。如果你想深入驗(yàn)證行為可以基于該測(cè)試文件了解各字段的序列化格式與上傳載荷結(jié)構(gòu)。小結(jié)Mathesar 的匿名使用數(shù)據(jù)收集是一套設(shè)計(jì)透明、開(kāi)關(guān)明確的機(jī)制以InstallationID的存在與否作為唯一開(kāi)關(guān)每 24 小時(shí)通過(guò)后臺(tái)線程生成并上報(bào) 14 項(xiàng)去標(biāo)識(shí)化統(tǒng)計(jì)字段同時(shí)提供安裝向?qū)А⒐芾碓O(shè)置頁(yè)、RPC 接口三種開(kāi)關(guān)方式以及示例報(bào)告頁(yè)面和analytics.view_report兩種查看方式。自托管用戶既可以在部署時(shí)直接取消勾選也可以在運(yùn)行期隨時(shí)關(guān)閉或通過(guò)環(huán)境變量將上報(bào)端點(diǎn)指向自己的服務(wù)完全掌控?cái)?shù)據(jù)去向。贊分享數(shù)據(jù)庫(kù)后端前端協(xié)作【免費(fèi)下載鏈接】mathesarAn intuitive spreadsheet-like interface that lets users of all technical skill levels view, edit, query, and collaborate on Postgres data directly. 100% open source and self hosted, with native Postgres access control.項(xiàng)目地址https://gitcode.com/gh_mirrors/ma/mathesar點(diǎn)擊查看免費(fèi)下載相關(guān)推薦JuiceFS 匿名用量上報(bào)Usage Tracking機(jī)制解析數(shù)據(jù)字段、上報(bào)原理與 --no-usage-report 關(guān)閉指南JuiceFS 匿名用量上報(bào)Usage Tracking機(jī)制解析數(shù)據(jù)字段、上報(bào)原理與 no usage report 關(guān)閉指南 JuiceFS 客戶端默認(rèn)云原生容器運(yùn)行時(shí)Tabby 用量收集Usage Collection機(jī)制詳解采集內(nèi)容、上報(bào)原理與關(guān)閉方法Tabby 用量收集Usage Collection機(jī)制詳解采集內(nèi)容、上報(bào)原理與關(guān)閉方法 TabbySelf hosted AI coding assi人工智能大模型本地部署模型推理服務(wù)后端RAG交互助手Grafana Pyroscope 匿名使用統(tǒng)計(jì)上報(bào)收集內(nèi)容、底層機(jī)制與關(guān)閉方法Grafana Pyroscope 匿名使用統(tǒng)計(jì)上報(bào)收集內(nèi)容、底層機(jī)制與關(guān)閉方法 導(dǎo)讀 Grafana Pyroscope 默認(rèn)會(huì)向遠(yuǎn)程統(tǒng)計(jì)服務(wù)器上報(bào)匿名的可觀測(cè)性性能剖析后端運(yùn)維觀測(cè)上一篇yuzu模擬器內(nèi)存修改技術(shù)深度解析金手指功能實(shí)現(xiàn)原理與實(shí)踐指南下一篇GitHubDesktop2Chinese5分鐘極速漢化GitHub Desktop告別英文界面困擾創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 Mathesar 匿名使用數(shù)據(jù)收集（Usage Data Collection）機(jī)制完全指南：字段含義、上報(bào)流程與開(kāi)啟關(guān)閉方法
數(shù)據(jù)庫(kù)后端前端協(xié)作【免費(fèi)下載鏈接】mathesarAn intuitive spreadsheet-like interface that lets users of all technical skill levels view, edit, query, and collaborate on Postgres data directly. 100% open source and self hosted, with native Postgres access control.項(xiàng)目地址https://gitcode.com/gh_mirrors/ma/mathesar點(diǎn)擊查看免費(fèi)下載本文圍繞 Mathesar 的匿名使用數(shù)據(jù)收集Usage Data Collection功能展開(kāi)講解其 opt-in 原則、每 24 小時(shí)上報(bào)的全部數(shù)據(jù)字段及其統(tǒng)計(jì)口徑、后臺(tái)收集與上傳的完整流程并給出通過(guò)安裝向?qū)?、管理設(shè)置頁(yè)、RPC 接口與 Web 頁(yè)面查看/開(kāi)關(guān)該功能的實(shí)戰(zhàn)方法。讀完本文你將能準(zhǔn)確判斷該功能是否符合自身部署場(chǎng)景并能在任何時(shí)間查看本實(shí)例生成的匿名報(bào)告、隨時(shí)關(guān)閉數(shù)據(jù)上報(bào)。功能概述為什么需要匿名使用數(shù)據(jù)Mathesar 是一款基于 PostgreSQL 的開(kāi)源數(shù)據(jù)庫(kù)管理 Web 應(yīng)用為了讓用戶對(duì)是否上報(bào)數(shù)據(jù)做出知情選擇它內(nèi)置了一套可選的opt-in匿名使用數(shù)據(jù)收集機(jī)制。開(kāi)啟后Mathesar 會(huì)在后臺(tái)收集去標(biāo)識(shí)化的使用統(tǒng)計(jì)信息并定期上報(bào)幫助開(kāi)發(fā)團(tuán)隊(duì)了解功能使用情況、定位體驗(yàn)問(wèn)題并改進(jìn)穩(wěn)定性和性能。該機(jī)制的核心原則非常清晰從 mathesar/analytics.py 的模塊注釋即可確認(rèn)基本邏輯是只要存在installation_idAnalytics 即為開(kāi)啟狀態(tài)可以且將會(huì)被收集否則不會(huì)收集。因此disable_analytics函數(shù)只是刪除該 ID如果存在。也就是說(shuō)收集行為完全由是否存在 Installation ID這一個(gè)開(kāi)關(guān)決定不存在其他隱式上報(bào)路徑。該 ID 是一個(gè)隨機(jī)生成的 UUIDuuid4()與你的 Mathesar 安裝實(shí)例一一對(duì)應(yīng)不包含任何可識(shí)別個(gè)人身份的信息。每 24 小時(shí)上報(bào)的數(shù)據(jù)字段當(dāng)實(shí)例處于開(kāi)啟狀態(tài)時(shí)Mathesar 會(huì)每 24 小時(shí)生成并上報(bào)一份匿名報(bào)告。原文檔docs/docs/user-guide/usage-data-collection.md列出的全部字段如下字段含義created_at報(bào)告創(chuàng)建時(shí)間的時(shí)間戳installation_id隨機(jī)生成的 UUID唯一標(biāo)識(shí)你的 Mathesar 安裝mathesar_versionMathesar 版本號(hào)字符串例如0.2.0user_countMathesar 安裝上的用戶賬戶數(shù)量active_user_count最近 14 天內(nèi)登錄過(guò) Mathesar 的用戶數(shù)量sso_connected_user_count在 Mathesar 安裝上配置了 SSO 的用戶數(shù)量configured_role_count在 Mathesar 安裝上配置的 PostgreSQL 角色數(shù)量connected_database_count已連接到 Mathesar 的數(shù)據(jù)庫(kù)數(shù)量connected_database_schema_count連接到 Mathesar 的所有 schema 總數(shù)connected_database_table_count連接到 Mathesar 的所有表總數(shù)connected_database_record_count所有連接表中的記錄總數(shù)近似值exploration_count在 Mathesar 中創(chuàng)建的 Explorations數(shù)據(jù)探索數(shù)量form_count在 Mathesar 中創(chuàng)建的 Forms表單數(shù)量public_form_count在 Mathesar 中公開(kāi)發(fā)布的 Forms 數(shù)量注原文檔中connected_database_record_count字段列在created_at之后但為便于理解上表按數(shù)據(jù)歸屬重新歸類排序字段名與含義與原文檔完全一致。字段的統(tǒng)計(jì)口徑源碼級(jí)說(shuō)明每個(gè)字段并非憑空統(tǒng)計(jì)而是有明確的底層數(shù)據(jù)來(lái)源見(jiàn) mathesar/analytics.py 中prepare_analytics_report()的實(shí)現(xiàn)mathesar_version取自mathesar.__version__user_count統(tǒng)計(jì)User.objects.filter(is_activeTrue)即激活狀態(tài)的用戶賬戶數(shù)active_user_count統(tǒng)計(jì)is_activeTrue且last_login在ACTIVE_USER_DAYS常量值為 14天內(nèi)登錄過(guò)的用戶sso_connected_user_count統(tǒng)計(jì)allauth的SocialAccount中關(guān)聯(lián)激活用戶的數(shù)量對(duì)應(yīng) SSO 登錄配置configured_role_count統(tǒng)計(jì)ConfiguredRole模型記錄數(shù)數(shù)據(jù)庫(kù)相關(guān)四個(gè)字段遍歷所有Database對(duì)象逐個(gè)累加其object_countsschema 數(shù)、表數(shù)、記錄數(shù)記錄數(shù)是近似值若某個(gè)數(shù)據(jù)庫(kù)無(wú)法取到統(tǒng)計(jì)信息如連接異常會(huì)打印警告并跳過(guò)不會(huì)中斷整個(gè)報(bào)告生成exploration_count/form_count/public_form_count分別統(tǒng)計(jì)Explorations與Form模型記錄數(shù)其中public_form_count僅統(tǒng)計(jì)publish_publicTrue的表單。這些字段對(duì)應(yīng)數(shù)據(jù)庫(kù)模型定義在 mathesar/models/analytics.py 中InstallationID與AnalyticsReportAnalyticsReport的所有統(tǒng)計(jì)字段均允許為空nullTrue, blankTrue并在遷移 0006_analyticsreport_sso_connected_user_count.py 中補(bǔ)充了sso_connected_user_count字段。收集與上報(bào)的完整工作流程觸發(fā)機(jī)制非阻塞的后臺(tái)線程Analytics 的收集由裝飾器wire_analytics觸發(fā)。它在每次 RPC 調(diào)用由 mathesar/rpc/decorators.py 的調(diào)用鏈注入時(shí)利用 Django 緩存設(shè)置一個(gè) 30 分鐘有效的analytics_done標(biāo)志并啟動(dòng)一個(gè)后臺(tái)線程執(zhí)行run_analytics()從而避免阻塞用戶請(qǐng)求。這一非阻塞設(shè)計(jì)有專門(mén)測(cè)試驗(yàn)證test_non_blocking_wrapper見(jiàn) mathesar/tests/test_analytics.py斷言被裝飾函數(shù)返回耗時(shí)遠(yuǎn)小于后臺(tái)任務(wù)中的模擬耗時(shí)。24 小時(shí)間隔與上傳清理后臺(tái)線程run_analytics()的執(zhí)行邏輯為檢查是否存在InstallationID不存在則直接返回不收集任何數(shù)據(jù)檢查當(dāng)天是否已生成過(guò)報(bào)告ANALYTICS_FREQUENCY 1即每天至多保存一份報(bào)告滿足條件后依次執(zhí)行save_analytics_report()調(diào)用prepare_analytics_report()生成報(bào)告并落庫(kù)upload_analytics_reports()將所有未上傳uploadedFalse的報(bào)告批量 POST 到settings.MATHESAR_ANALYTICS_URL成功后批量標(biāo)記uploadedTruedelete_stale_reports()清理過(guò)期報(bào)告——已上傳且超過(guò) 2 天的報(bào)告以及無(wú)論上傳狀態(tài)如何、更新超過(guò)ANALYTICS_REPORT_MAX_AGE30 天的報(bào)告都會(huì)被刪除。安裝時(shí)的首次上報(bào)除了周期上報(bào)外Mathesar 在首次安裝完成時(shí)還會(huì)發(fā)送一次性的安裝確認(rèn)安裝向?qū)П韱沃衞ne_time_installation_confirmation復(fù)選框被勾選時(shí)調(diào)用upload_initial_report()向MATHESAR_INIT_REPORT_URL發(fā)送僅含mathesar_version的初始報(bào)告見(jiàn) complete_installation.py。如何開(kāi)啟與關(guān)閉匿名數(shù)據(jù)收集方式一安裝完成向?qū)状尾渴鹪谑状尾渴?Mathesar 的Finish Setting Up Mathesar頁(yè)面模板 complete_installation.html中有兩個(gè)與數(shù)據(jù)相關(guān)的復(fù)選框Send a one-time confirmation to let us know youve installed Mathesar默認(rèn)勾選僅發(fā)送一次安裝確認(rèn)Enable anonymous usage data collection啟用匿名使用數(shù)據(jù)收集默認(rèn)勾選勾選后在創(chuàng)建管理員用戶時(shí)調(diào)用initialize_analytics()生成 Installation ID。表單處理邏輯位于 mathesar/views/installation/complete_installation.pyusage_stats為真時(shí)創(chuàng)建隨機(jī) UUID 作為 Installation ID并在異常時(shí)記錄錯(cuò)誤日志而不影響安裝流程。方式二管理設(shè)置頁(yè)面運(yùn)行期隨時(shí)調(diào)整運(yùn)行中的實(shí)例可以在Admin Settings管理設(shè)置頁(yè)面切換開(kāi)關(guān)。前端實(shí)現(xiàn)見(jiàn) mathesar_ui/src/pages/admin-settings/SettingsPage.svelte頁(yè)面加載時(shí)調(diào)用 RPCanalytics.get_state獲取當(dāng)前狀態(tài)勾選開(kāi)關(guān)時(shí)調(diào)用analytics.initialize開(kāi)啟取消勾選時(shí)調(diào)用analytics.disable關(guān)閉操作成功會(huì)彈出提示Anonymous usage data collection enabled/disabled successfully。前端 RPC 封裝定義在 mathesar_ui/src/api/rpc/analytics.ts共暴露get_state、initialize、disable、upload_feedback四個(gè)方法。方式三RPC 接口開(kāi)發(fā)者/自動(dòng)化方式Analytics 的全部 RPC 方法實(shí)現(xiàn)在 mathesar/rpc/analytics.py方法名與語(yǔ)義如下RPC 方法作用analytics.get_state返回當(dāng)前狀態(tài){enabled: bool}analytics.initialize開(kāi)啟收集創(chuàng)建 Installation IDanalytics.disable關(guān)閉收集刪除 Installation ID同時(shí)級(jí)聯(lián)刪除所有已保存的報(bào)告analytics.view_report查看一份示例報(bào)告與真實(shí)報(bào)告使用同一生成函數(shù)analytics.upload_feedback向 Mathesar 服務(wù)器上傳一條反饋消息需登錄其中disable的語(yǔ)義值得一提RPC 文檔注明關(guān)閉目前等同于刪除 Installation ID從而保證不可能再保存 Analytics 報(bào)告任何已保存的報(bào)告也會(huì)隨 ID 刪除而被級(jí)聯(lián)清除on_deletemodels.CASCADE。查看實(shí)際生成的報(bào)告原文檔docs/docs/user-guide/usage-data-collection.md提供了兩種查看真實(shí)報(bào)告的方法方法一訪問(wèn)示例報(bào)告頁(yè)面在運(yùn)行中的 Mathesar 實(shí)例上訪問(wèn)路徑/info/analytics_sample_report/該路徑在 mathesar/urls.py 中注冊(cè)路由名analytics_sample_report視圖定義于 mathesar/views/init.py 的analytics_sample_report渲染模板 mathesar/templates/analytics/sample_report.html。該模板頁(yè)面加載時(shí)通過(guò)前端腳本向/api/rpc/v0/發(fā)起analytics.view_reportRPC 調(diào)用將返回的 JSON 報(bào)告以格式化形式渲染在頁(yè)面上方便管理員直觀判斷開(kāi)啟后會(huì)上報(bào)哪些數(shù)據(jù)。方法二直接調(diào)用 RPC可以調(diào)用 RPC 函數(shù)analytics.view_reportAPI 索引見(jiàn) docs/docs/api/methods.md。該函數(shù)使用與真實(shí)報(bào)告完全相同的prepare_analytics_report()生成數(shù)據(jù)因此查看結(jié)果即代表實(shí)際會(huì)上報(bào)的內(nèi)容。其返回值類型AnalyticsReport是 TypedDict包含上述全部統(tǒng)計(jì)字段installation_id、mathesar_version、user_count等見(jiàn) mathesar/rpc/analytics.py。上報(bào)目的地與自定義配置報(bào)告與反饋消息最終通過(guò) HTTP POST 發(fā)送到配置的 URL。相關(guān)設(shè)置定義在 config/settings/common_settings.py配置項(xiàng)環(huán)境變量默認(rèn)值開(kāi)發(fā)環(huán)境生產(chǎn)環(huán)境默認(rèn)值MATHESAR_ANALYTICS_URLMATHESAR_ANALYTICS_URLhttps://example.com/collectorhttps://analytics.mathesar.dev/collect-analytics-reportsMATHESAR_INIT_REPORT_URLMATHESAR_INIT_REPORT_URLhttps://example.com/hellohttps://analytics.mathesar.dev/collect-initial-reportMATHESAR_FEEDBACK_URLMATHESAR_FEEDBACK_URLhttps://example.com/feedbackhttps://analytics.mathesar.dev/collect-feedback-message生產(chǎn)環(huán)境的真實(shí)上報(bào)地址見(jiàn) config/settings/production.py。這些 URL 均支持通過(guò)同名環(huán)境變量覆蓋自托管用戶可以據(jù)此將數(shù)據(jù)重定向到自己的收集端點(diǎn)實(shí)現(xiàn)完全自控。隱私與安全邊界從源碼可以確認(rèn)以下幾點(diǎn)隱私邊界純匿名報(bào)告中唯一涉及實(shí)例身份的是隨機(jī)生成的installation_idUUID不含用戶名、郵箱、密碼、數(shù)據(jù)庫(kù)內(nèi)容或任何個(gè)人數(shù)據(jù)可隨時(shí)關(guān)閉關(guān)閉后 Installation ID 被刪除且級(jí)聯(lián)清除已保存報(bào)告系統(tǒng)不會(huì)再生成新報(bào)告后臺(tái)線程因無(wú) ID 直接返回統(tǒng)計(jì)信息不敏感所有字段均為數(shù)量級(jí)統(tǒng)計(jì)用戶數(shù)、表數(shù)、記錄數(shù)等其中記錄數(shù)還是近似值異常隔離生成報(bào)告過(guò)程中某個(gè)數(shù)據(jù)庫(kù)統(tǒng)計(jì)失敗不會(huì)導(dǎo)致整個(gè)流程中斷只會(huì)記錄警告見(jiàn)prepare_analytics_report中的except Exception分支。測(cè)試與驗(yàn)證倉(cāng)庫(kù)自帶的測(cè)試 mathesar/tests/test_analytics.py 覆蓋了該機(jī)制的完整生命周期包括非阻塞后臺(tái)包裝器、initialize → save → disable全流程驗(yàn)證關(guān)閉后報(bào)告被清空、重復(fù)初始化 Installation ID 會(huì)觸發(fā)唯一性約束異常IntegrityError以及上傳后報(bào)告字段內(nèi)容與批量標(biāo)記uploadedTrue的準(zhǔn)確性。如果你想深入驗(yàn)證行為可以基于該測(cè)試文件了解各字段的序列化格式與上傳載荷結(jié)構(gòu)。小結(jié)Mathesar 的匿名使用數(shù)據(jù)收集是一套設(shè)計(jì)透明、開(kāi)關(guān)明確的機(jī)制以InstallationID的存在與否作為唯一開(kāi)關(guān)每 24 小時(shí)通過(guò)后臺(tái)線程生成并上報(bào) 14 項(xiàng)去標(biāo)識(shí)化統(tǒng)計(jì)字段同時(shí)提供安裝向?qū)А⒐芾碓O(shè)置頁(yè)、RPC 接口三種開(kāi)關(guān)方式以及示例報(bào)告頁(yè)面和analytics.view_report兩種查看方式。自托管用戶既可以在部署時(shí)直接取消勾選也可以在運(yùn)行期隨時(shí)關(guān)閉或通過(guò)環(huán)境變量將上報(bào)端點(diǎn)指向自己的服務(wù)完全掌控?cái)?shù)據(jù)去向。贊分享數(shù)據(jù)庫(kù)后端前端協(xié)作【免費(fèi)下載鏈接】mathesarAn intuitive spreadsheet-like interface that lets users of all technical skill levels view, edit, query, and collaborate on Postgres data directly. 100% open source and self hosted, with native Postgres access control.項(xiàng)目地址https://gitcode.com/gh_mirrors/ma/mathesar點(diǎn)擊查看免費(fèi)下載相關(guān)推薦JuiceFS 匿名用量上報(bào)Usage Tracking機(jī)制解析數(shù)據(jù)字段、上報(bào)原理與 --no-usage-report 關(guān)閉指南JuiceFS 匿名用量上報(bào)Usage Tracking機(jī)制解析數(shù)據(jù)字段、上報(bào)原理與 no usage report 關(guān)閉指南 JuiceFS 客戶端默認(rèn)云原生容器運(yùn)行時(shí)Tabby 用量收集Usage Collection機(jī)制詳解采集內(nèi)容、上報(bào)原理與關(guān)閉方法Tabby 用量收集Usage Collection機(jī)制詳解采集內(nèi)容、上報(bào)原理與關(guān)閉方法 TabbySelf hosted AI coding assi人工智能大模型本地部署模型推理服務(wù)后端RAG交互助手Grafana Pyroscope 匿名使用統(tǒng)計(jì)上報(bào)收集內(nèi)容、底層機(jī)制與關(guān)閉方法Grafana Pyroscope 匿名使用統(tǒng)計(jì)上報(bào)收集內(nèi)容、底層機(jī)制與關(guān)閉方法 導(dǎo)讀 Grafana Pyroscope 默認(rèn)會(huì)向遠(yuǎn)程統(tǒng)計(jì)服務(wù)器上報(bào)匿名的可觀測(cè)性性能剖析后端運(yùn)維觀測(cè)上一篇yuzu模擬器內(nèi)存修改技術(shù)深度解析金手指功能實(shí)現(xiàn)原理與實(shí)踐指南下一篇GitHubDesktop2Chinese5分鐘極速漢化GitHub Desktop告別英文界面困擾創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考