用途:通过 Statsig Console API 创建或读取仪表盘,并借助配套脚本执行请求。
主要能力:提供四个脚本——create_dashboard.py(POST /console/v1/dashboards 创建仪表盘)、read_dashboard.py(GET /console/v1/dashboards/{id} 读取并默认输出可复用的创建结构)、add_dashboard_widgets.py(POST .../widgets 追加组件)、replace_dashboard_widgets.py(PUT .../widgets 替换全部组件)。支持的组件类型为 header、text、timeseries,组件可带可选 width 和 height。
使用方式:先导出 API 密钥 export STATSIG_CONSOLE_API_KEY="...",将请求体保存为 JSON 文件,再运行对应脚本,例如 python3 scripts/create_dashboard.py --body-file /tmp/dashboard.json。脚本默认 API 版本 20240601,默认地址 https://api.statsig.com/console/v1/dashboards,通过 statsig-api-key 与 statsig-api-version 头传递,均支持 --dry-run 与 --raw。
限制与注意:创建请求体仅支持 name、description、defaults、widgets,不要包含 id、layout、row、column;不要使用不支持的组件类型(如表格);timeseries 需严格满足查询约定(source 或 sources 二选一、type 为 event、包含 aggregation 等);按事件值分组或过滤时使用 !statsig_value;服务过滤建议用 custom.service;OTEL 指标需先采样查看 company_metadata.__metric_type 再选择对应聚合。修改已有仪表盘时不要用创建端点。
适用场景:需要以编程方式批量创建、读取或调整 Statsig 仪表盘及其组件的开发与数据工作流。