监控

您可以使用 Prometheus 和可视化工具（如 Grafana）来收集 Tuist 服务器的指标数据，并创建满足您需求的定制化仪表板。Prometheus 指标通过 9091 端口的/metrics 端点提供服务。Prometheus 的 scrape_interval 应设置为小于 10_000 秒（我们建议保持默认的 15 秒）。

PostHog 分析#

Tuist 与 PostHog 集成，提供用户行为分析和事件跟踪功能。这使您能够了解用户如何与您的 Tuist 服务器交互，跟踪功能使用情况，并深入了解用户在营销网站、仪表板和 API 文档中的行为模式。

配置#

PostHog 集成是可选的，可以通过设置相应的环境变量来启用。配置后，Tuist 将自动跟踪用户事件、页面浏览和用户行为路径。

功能特性#

启用 PostHog 后，Tuist 会自动跟踪：

• 用户身份识别：通过用户的唯一 ID 和邮箱地址来识别用户
• 用户别名：通过账户名称为用户设置别名，便于识别
• 分组分析：根据用户选择的项目和组织进行分组，实现细分分析
• 页面区域：事件包含超级属性，指示生成事件的应用程序区域：
  • marketing - 来自营销页面和公共内容的事件
  • dashboard - 来自主应用仪表板和认证区域的事件
  • api-docs - 来自 API 文档页面的事件
• 页面浏览：使用 Phoenix LiveView 自动跟踪页面导航
• 自定义事件：用于功能使用和用户交互的应用程序特定事件

隐私注意事项#

• 对于已认证用户，PostHog 使用用户的唯一 ID 作为明确标识符，并包含其邮箱地址
• 对于匿名用户，PostHog 使用仅内存持久化来避免在本地存储数据
• 所有分析功能都尊重用户隐私，并遵循数据保护最佳实践
• PostHog 数据根据 PostHog 的隐私政策和您的配置进行处理

Elixir 指标#

默认情况下，我们包含 Elixir 运行时、BEAM、Elixir 以及我们使用的一些库的指标。以下是您可以期望看到的一些指标：

• Application
• BEAM
• Phoenix
• Phoenix LiveView
• Ecto
• Oban

我们建议查看这些页面，以了解有哪些可用的指标以及如何使用它们。

运行指标#

与 Tuist 运行相关的一组指标。

tuist_runs_total (计数器)#

Tuist 运行的总次数。

标签#

tuist_runs_duration_milliseconds (直方图)#

每次 tuist 运行的总持续时间（以毫秒为单位）。

标签#

缓存指标#

与 Tuist 缓存相关的一组指标。

tuist_cache_events_total (计数器)#

二进制缓存事件的总数。

标签#

tuist_cache_uploads_total (计数器)#

上传到二进制缓存的次数。

tuist_cache_uploaded_bytes (求和)#

上传到二进制缓存的总字节数。

tuist_cache_downloads_total (计数器)#

从二进制缓存下载的次数。

tuist_cache_downloaded_bytes (求和)#

从二进制缓存下载的总字节数。

预览指标#

与预览功能相关的一组指标。

tuist_previews_uploads_total (求和)#

上传的预览总数。

tuist_previews_downloads_total (求和)#

下载的预览总数。

存储指标#

与在远程存储（如 S3）中存储构建产物相关的一组指标。

tuist_storage_get_object_size_size_bytes (直方图)#

从远程存储获取的对象的大小（以字节为单位）。

标签#

tuist_storage_get_object_size_duration_miliseconds (直方图)#

从远程存储获取对象大小的持续时间（以毫秒为单位）。

标签#

tuist_storage_get_object_size_count (计数器)#

从远程存储获取对象大小的次数。

标签#

tuist_storage_delete_all_objects_duration_milliseconds (直方图)#

从远程存储删除所有对象的持续时间（以毫秒为单位）。

标签#

tuist_storage_delete_all_objects_count (计数器)#

从远程存储删除所有项目对象的次数。

标签#

tuist_storage_multipart_start_upload_duration_milliseconds (直方图)#

开始向远程存储上传的持续时间（以毫秒为单位）。

标签#

tuist_storage_multipart_start_upload_duration_count (计数器)#

向远程存储开始上传的次数。

标签#

tuist_storage_get_object_as_string_duration_milliseconds (直方图)#

从远程存储获取对象字符串的持续时间（以毫秒为单位）。

标签#

tuist_storage_get_object_as_string_count (计数)#

从远程存储获取对象字符串的次数。

标签#

tuist_storage_check_object_existence_duration_milliseconds (直方图)#

检查远程存储中对象存在的持续时间（以毫秒为单位）。

标签#

tuist_storage_check_object_existence_count (计数)#

检查远程存储中对象存在的次数。

标签#

tuist_storage_generate_download_presigned_url_duration_milliseconds (直方图)#

为远程存储中的对象生成下载预签名 URL 的持续时间（以毫秒为单位）。

标签#

tuist_storage_generate_download_presigned_url_count (计数)#

为远程存储中的对象生成下载预签名 URL 的次数。

标签#

tuist_storage_multipart_generate_upload_part_presigned_url_duration_milliseconds (直方图)#

为远程存储中的对象生成部分上传预签名 URL 的持续时间（以毫秒为单位）。

标签#

tuist_storage_multipart_generate_upload_part_presigned_url_count (计数)#

为远程存储中的对象生成部分上传预签名 URL 的次数。

标签#

tuist_storage_multipart_complete_upload_duration_milliseconds (直方图)#

完成向远程存储上传的持续时间（以毫秒为单位）。

标签#

tuist_storage_multipart_complete_upload_count (计数)#

完成向远程存储上传的总次数。

标签#

身份验证指标#

与身份验证相关的一组指标。

tuist_authentication_token_refresh_error_total (计数器)#

令牌刷新错误的总数。

标签#

项目指标#

与项目相关的一组指标。

tuist_projects_total (最新值)#

项目的总数。

账户指标#

与账户（用户和组织）相关的一组指标。

tuist_accounts_organizations_total (最新值)#

组织的总数。

tuist_accounts_users_total (最新值)#

用户的总数。

数据库指标#

与数据库连接相关的一组指标。

tuist_repo_pool_checkout_queue_length (最新值)#

在队列中等待分配数据库连接的数据库查询数量。

tuist_repo_pool_ready_conn_count (最新值)#

准备好分配给数据库查询的数据库连接数量。

tuist_repo_pool_db_connection_connected (计数器)#

已建立到数据库的连接数量。

tuist_repo_pool_db_connection_disconnected (计数器)#

已从数据库断开的连接数量。

HTTP 指标#

与 Tuist 通过 HTTP 与其他服务交互相关的一组指标。

tuist_http_request_count (计数器)#

发出的 HTTP 请求的数量。

tuist_http_request_duration_nanosecond_sum (求和)#

发出请求的持续时间总和（包括等待分配到连接所花费的时间）。

tuist_http_request_duration_nanosecond_bucket (分布)#

发出请求持续时间的分布（包括等待分配到连接所花费的时间）。

tuist_http_queue_count (计数器)#

从连接池中检索到的请求数量。

tuist_http_queue_duration_nanoseconds_sum (求和)#

从连接池检索连接所需的时间。

tuist_http_queue_idle_time_nanoseconds_sum (求和)#

连接空闲等待检索的时间。

tuist_http_queue_duration_nanoseconds_bucket (分布)#

从连接池检索连接所需的时间。

tuist_http_queue_idle_time_nanoseconds_bucket (分布)#

连接空闲等待检索的时间。

tuist_http_connection_count (计数器)#

已建立的连接数量。

tuist_http_connection_duration_nanoseconds_sum (求和)#

与主机建立连接所需的时间。

tuist_http_connection_duration_nanoseconds_bucket (分布)#

与主机建立连接所需时间的分布。

tuist_http_send_count (计数器)#

一旦分配了来自连接池的连接后已发送的请求数量。

tuist_http_send_duration_nanoseconds_sum (求和)#

一旦分配了来自连接池的连接后请求完成所需的时间。

tuist_http_send_duration_nanoseconds_bucket (分布)#

一旦分配了来自连接池的连接后请求完成所需时间的分布。

tuist_http_receive_count (计数器)#

从已发送请求收到的响应数量。

tuist_http_receive_duration_nanoseconds_sum (求和)#

接收响应所花费的时间。

tuist_http_receive_duration_nanoseconds_bucket (分布)#

接收响应所花费时间的分布。

tuist_http_queue_available_connections (最新值)#

队列中可用的连接数量。

tuist_http_queue_in_use_connections (最新值)#

正在使用的队列连接数量。