后端前端【免费下载链接】flagsmithFlagsmith is an open-source feature flag platform with remote config, experimentation, and self-hosted or cloud deployment options.项目地址https://gitcode.com/gh_mirrors/fl/flagsmith点击查看免费下载Flagsmith 自托管实例内置了面向 Prometheus 的监控能力设置PROMETHEUS_ENABLEDtrue后API 会在 9100 端口暴露/metrics端点供 Prometheus、Grafana 等监控系统采集。本文以官方指标目录_metrics-catalogue.md为骨架逐一解读每一个指标的类型、语义与标签并结合仓库内各模块的metrics.py源码说明指标在何处被记录、记录在哪个数据路径上帮助你在自托管部署中围绕这些指标搭建告警与容量监控体系。快速上手如何开启/metrics端点根据官方文档 metrics.mdx 与 monitoring.md启用 Prometheus 指标只需一个环境变量PROMETHEUS_ENABLEDtrue启用后Flagsmith 会在9100 端口提供/metrics端点Prometheus 的scrape_configs可这样配置scrape_configs: - job_name: flagsmith metrics_path: /metrics static_configs: - targets: [flagsmith-api-host:9100]除 Prometheus 外WSGI worker 还支持通过 StatsD 发送每请求的访问日志指标请求计数、耗时、HTTP 状态码。StatsD 的启用方式是设置STATSD_HOST可选参数包括STATSD_PORT— 默认8125STATSD_PREFIX— 默认flagsmith.api。指标类型速览Gauge、Counter 与 Histogram官方指标目录将每个指标标注为三种类型之一理解它们才能正确书写 PromQL 查询Gauge可增可减的瞬时值例如当前进程的版本/构建信息Counter只增不减的累计计数通常用于总次数如flagsmith_cohorts_csv_syncs。注意 Prometheus 客户端库会自动为 Counter 追加_total后缀如源码中的flagsmith_cohorts_csv_syncs_total抓取端展示为..._totalHistogram观测值分布可同时得到样本数量_count、样本总和_sum与各桶计数_bucket{le...}适合描述耗时、体积、比率这类数值型指标可用于计算百分位数如 P95、P99。指标目录逐项解读以下按业务域分组完整覆盖指标目录中的全部条目。每个指标均包含类型、语义、标签三要素并补充仓库源码中的定义与调用位置作为佐证。一、构建与运行信息flagsmith_build_infoGaugeFlagsmith 版本与构建信息指标。标签ci_commit_sha、version该指标以标签形式暴露当前部署对应的 Git commit SHA 与版本号适合在 Grafana 中按版本维度区分实例、或用于发布后确认版本已生效的检查。二、HTTP 服务层API 网关/服务入口flagsmith_http_server_requestsCounterHTTP 请求总数。标签route、method、response_statusflagsmith_http_server_request_duration_secondsHistogramHTTP 请求耗时秒。标签route、method、response_statusflagsmith_http_server_response_size_bytesHistogramHTTP 响应体大小字节。标签route、method、response_status这三个指标构成 API 层的三件套均按route路由、methodGET/POST/...、response_statusHTTP 状态码三个维度打标签。典型告警用法请求量异常sum(rate(flagsmith_http_server_requests_total[5m])) by (route)延迟 P95 超阈值histogram_quantile(0.95, sum(rate(flagsmith_http_server_request_duration_seconds_bucket[5m])) by (le, route))5xx 错误率sum(rate(flagsmith_http_server_requests_total{response_status~5..}[5m])) / sum(rate(flagsmith_http_server_requests_total[5m]))。三、任务处理器Task Processorflagsmith_task_processor_enqueued_tasksCounter入队任务总数。标签task_identifierflagsmith_task_processor_finished_tasksCounter完成任务总数。仅由 Task Processor 采集task_type标签取值recurring周期任务或standard普通任务。标签task_identifier、task_type、resultflagsmith_task_processor_task_duration_secondsHistogram任务处理器任务耗时秒。仅由 Task Processor 采集task_type标签取值recurring或standard。标签task_identifier、task_type、result任务处理器是 Flagsmith 后台异步任务如用户群组同步、分段成员刷新、Webhook 派发等的执行者仓库根目录 api/app/settings/common.py 中可见task_processor作为独立 Django App 注册。这三个指标能直接回答队列是否积压、任务是否在堆积、哪些任务失败失败任务量sum(rate(flagsmith_task_processor_finished_tasks_total{result!success}[5m])) by (task_identifier)任务耗时 P99histogram_quantile(0.99, sum(rate(flagsmith_task_processor_task_duration_seconds_bucket[5m])) by (le, task_identifier))。监控文档 monitoring.md 还提示Task Processor 容器额外暴露/health/readiness与/health/liveness探针端点设置ENABLE_TASK_PROCESSOR_HEALTH_CHECKTrue后就绪探针还会真正入队一个任务并验证其执行完成API 与任务处理器均提供GET /processor/monitoring返回 JSON 队列统计如{waiting: 1}。四、环境文档缓存与 DynamoDB 存储层flagsmith_environment_document_cache_queriesCounter环境文档缓存检索结果计数result标签取值hit或miss。标签resultflagsmith_dynamo_environment_document_size_bytesHistogram写入 DynamoDB 的环境文档大小字节。标签table、compressedflagsmith_dynamo_environment_document_compression_ratioHistogram环境文档压缩比compressed_size / uncompressed_size。标签table这一组指标反映了 Flagsmith SDK 所需环境文档environment document的读取路径先查缓存缓存未命中再回源到 DynamoDB。源码 api/environments/metrics.py 定义了全部三个指标flagsmith_environment_document_cache_queries_total带[result]标签flagsmith_dynamo_environment_document_size_bytes带[table, compressed]标签flagsmith_dynamo_environment_document_compression_ratio带[table]标签。其中缓存命中/未命中计数在 api/environments/models.py 处按CACHE_HIT/CACHE_MISS写入文档大小与压缩比直方图的桶bucket定义在 api/environments/dynamodb/constants.pyDOCUMENT_SIZE_HISTOGRAM_BUCKETS (1_000, 5_000, 10_000, 25_000, 50_000, 100_000, 200_000, 300_000, 409_600)— 上限409_600字节对应DynamoDB 单条目 400 KB 上限可用于提前发现即将超限的环境文档COMPRESSION_RATIO_HISTOGRAM_BUCKETS (0.05, 0.1, 0.15, 0.2, 0.25, 0.3, 0.4, 0.5, 0.6, 0.8, 1.0)— 压缩比接近 1.0 表示压缩收益趋近于零接近 0 表示压缩效果显著。实用告警示例缓存命中率监控sum(rate(flagsmith_environment_document_cache_queries_total{resulthit}[5m])) / sum(rate(flagsmith_environment_document_cache_queries_total[5m]))命中率骤降往往意味着缓存失效或流量模式变化。五、用户群组同步Cohort CSV Syncflagsmith_cohorts_csv_syncsCounter被接受的用户群组cohortCSV 同步总次数即上传中至少产生一个有效标识符、且已入队成员同步任务的同步。标签无flagsmith_cohorts_csv_sync_identifiersHistogram每次被接受的 cohort CSV 同步中提取的唯一标识符数量。标签无flagsmith_cohorts_membership_deltas_appliedCounter用户群组成员账本membership ledger行在对应身份文档写入后转为已应用状态的总行数operation标签取add或remove。标签operation三个指标全部定义于 api/cohorts/metrics.pyflagsmith_cohorts_membership_deltas_applied_total带[operation]标签flagsmith_cohorts_csv_syncs_total无标签flagsmith_cohorts_csv_sync_identifiersHistogrambuckets(10, 100, 1_000, 10_000, 100_000, 1_000_000)并在 api/cohorts/services.py 处以observe(len(incoming))记录单次同步提取的标识符数量。通过flagsmith_cohorts_csv_sync_identifiers的直方图分布可以判断单次 CSV 同步的规模是否接近系统可承受上限flagsmith_cohorts_membership_deltas_applied_total的add/remove拆分则能反映群组规模的整体增减趋势。六、实验功能数据仓库连接验证flagsmith_experimentation_warehouse_connection_verificationsCounter针对客户自有数据仓库如 Snowflake、BigQuery 等的连接验证尝试结果计数result标签取值success或failure。标签result该指标定义于 api/experimentation/metrics.pyCounter 带[result]标签。它服务于实验Experimentation模块中验证数据仓库凭据是否可用的流程告警可关注失败比例sum(rate(flagsmith_experimentation_warehouse_connection_verifications_total{resultfailure}[5m]))。七、分段成员同步Segment Membershipflagsmith_segment_membership_backfill_duration_secondsHistogram单个环境的分段成员回填backfill耗时。标签无flagsmith_segment_membership_backfill_identitiesCounter分段成员回填任务在所有环境下从 Dynamo 镜像到 ClickHouse 的身份总数。标签无flagsmith_segment_membership_read_duration_secondsHistogram单次分段成员分页读取耗时。标签无flagsmith_segment_membership_refresh_duration_secondsHistogram单个项目的分段成员计数刷新count-refresh耗时。标签无flagsmith_segment_membership_refresh_failuresCounter因任何原因失败的分段成员刷新运行总数。标签无五个指标均定义于 api/segment_membership/metrics.py覆盖回填backfill— 分页读取read— 计数刷新refresh整条链路。其中回填任务在 api/segment_membership/tasks.py 中以flagsmith_segment_membership_backfill_identities_total.inc(row_count)按批次累计已镜像的身份数量。回填是数据量最大的批处理操作建议对其耗时backfill_duration_seconds与刷新失败数refresh_failures设置告警以便在 Dynamo→ClickHouse 数据同步链路异常时第一时间发现。八、OAuth2 动态客户端注册flagsmith_oauth2_dcr_registrationsCounterOAuth2 动态客户端注册Dynamic Client RegistrationDCR请求总数按请求的 token 端点认证方式与注册被接受/拒绝的结果打标签。标签token_endpoint_auth_method、outcome该指标定义于 api/oauth2_metadata/metrics.pyCounter 带[token_endpoint_auth_method, outcome]标签。可用于观察 OAuth2 客户端注册的接受/拒绝比例若outcomerejected占比异常升高通常意味着配置错误或存在异常注册请求。指标定义源码一览上述大部分指标都能在仓库各模块独立的metrics.py中找到标准 Prometheus 客户端库定义便于对照验证语义指标前缀源码文件flagsmith_cohorts_*api/cohorts/metrics.pyflagsmith_dynamo_environment_document_*、flagsmith_environment_document_cache_queriesapi/environments/metrics.pyflagsmith_experimentation_warehouse_connection_verificationsapi/experimentation/metrics.pyflagsmith_oauth2_dcr_registrationsapi/oauth2_metadata/metrics.pyflagsmith_segment_membership_*api/segment_membership/metrics.py从源码结构看flagsmith_build_info、flagsmith_http_server_*与flagsmith_task_processor_*并非由上述业务模块直接定义而是分别对应运行环境基础信息、HTTP 服务中间件以及 Task Processor 组件task_processorDjango App见 api/app/settings/common.py在采集端暴露的指标其命名与标签遵循 Prometheus 约定可直接按前文给出的 PromQL 模式使用。监控配套与最佳实践全维度打标签HTTP 层指标按route/method/response_status拆分排查慢接口与错误码分布时无需再逐条翻日志区分采集端flagsmith_task_processor_*仅由 Task Processor 进程采集若 API 与任务处理器分离部署需分别配置 Prometheus 抓取目标结合健康探针与队列统计除指标外还可使用/health/readiness、/health/liveness配合ENABLE_TASK_PROCESSOR_HEALTH_CHECKTrue与GET /processor/monitoring的waiting队列深度做进程级与队列级告警详见 monitoring.md关注 DynamoDB 条目上限flagsmith_dynamo_environment_document_size_bytes的直方图上限桶设于409_600字节DynamoDB 单条目 400 KB 限制当样本高频落入最末桶时说明环境文档已逼近存储上限需要排查环境规模或压缩配置给批处理任务设告警分段成员回填与刷新、cohort CSV 同步均属于后台批处理*_failures类 Counter 与*_duration_seconds类 Histogram 是判断数据管道健康度的第一信号。借助上述指标你可以用一套 Prometheus Grafana 栈覆盖 Flagsmith 自托管实例的 API 可用性、任务处理队列、缓存命中、DynamoDB 存储水位、用户群组与分段数据同步等关键环节实现从能跑到可观测、可告警、可容量规划的监控闭环。赞分享后端前端【免费下载链接】flagsmithFlagsmith is an open-source feature flag platform with remote config, experimentation, and self-hosted or cloud deployment options.项目地址https://gitcode.com/gh_mirrors/fl/flagsmith点击查看免费下载相关推荐JuiceFS 监控指标完全指南Prometheus 指标体系详解与源码级解读JuiceFS 监控指标完全指南Prometheus 指标体系详解与源码级解读 JuiceFS 作为一款构建在对象存储与元数据引擎之上的分布式 POSIX 文存储分布式文件系统云原生大数据终极指南Trivy监控指标与Prometheus集成的完整实践终极指南Trivy监控指标与Prometheus集成的完整实践 Trivy作为一款强大的开源容器安全扫描工具不仅能检测容器镜像中的安全漏洞和配置问题还提供应用安全漏洞扫描SBOM供应链安全云原生Kubeshark Worker 指标Metrics监控指南Prometheus 采集配置与完整指标解读Kubeshark Worker 指标Metrics监控指南Prometheus 采集配置与完整指标解读 Kubeshark 是一款基于 eBPF 的 K可观测性云原生网络MCP 服务上一篇OCLP-Mod安全机制详解SIP、FileVault与安全启动在旧Mac上如何协同工作下一篇5分钟给Windows 11 24H2 LTSC装回Microsoft StoreLTSC-Add-MicrosoftStore快速上手教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考