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