> For the complete documentation index, see [llms.txt](https://meetbill.gitbook.io/butterfly-user-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://meetbill.gitbook.io/butterfly-user-doc/app/13-wuxing.md). # 配置管理 WuXing(五行) ## 1 简介 ### 1.1 特性 五行 -- 统一存储巡检类 / 配置类 / 统计类等数据服务 > * 操作追溯 > * 操作轨迹可追踪 > * 历史配置可查询和回溯 > * 缓存加持 > * 重要接口缓存 > * 查询方便 > * 细粒度化到 key-value 配置项层级 > * 支持模糊匹配检索 ### 1.1 名称说明 > * namespace: 名字空间 > * 在 section 中，同一个名字空间内的 section\_name+section\_version 是唯一的 > * 在 instance 中，同一个名字空间内的 instance\_name 是唯一的 > * section: 相当于 MySQL 中的表名 > * instance: 相当于 MySQL 中的记录 > * item: 相当于 MySQL 中的字段 ## 2 部署 ### 2.1 建表 五行需要 8 张表，分别为 ``` +-----------------------+ | wuxing_section | | wuxing_instance | | wuxing_instance_item | | wuxing_history_bool | | wuxing_history_float | | wuxing_history_int | | wuxing_history_string | | wuxing_history_text | +-----------------------+ ``` #### 2.1.1 五行 8 张表之间关系 ``` +namespace1-------------------------------------------------------+ | +section1-----------------+ | | |+section_template-------+| | | ||+-----+ +-----+ +-----+|| | | |||item1| |item2| |item3||| version:1.0.1 | | ||+-----+ +-----+ +-----+|| | | |+-----------------------+| | | +------+---------+--------+ | | | | | | | +---------+ | | | | | | | | | | +instance1-------------V--+ +instance2----V-----------+ | | |+instance_template------+| |+instance_template------+| | | ||+id:1-+ +id:2-+ +id:3-+|| ||+id:4-+ +id:5-+ +id:6-+|| | | |||item1| |item2| |item3||| |||item1| |item2| |item3||| | | ||+----++ +---+-+ +---+-+|| ||+--+--+ +---+-+ +---+-+|| | | |+-----|------|-------|--+| |+---|--------|-------|--+| | | +------|------|-------|---+ +----|--------|-------|---+ | | | | | | | | | | +item--|------|-------|-----------|--------|-------+---+ | | | +id:1V--+ | | | | | | | | | +-------+ | | | | | | | | | +id:2V--+ | | | | | | | | +-------+ | | | | | | | | +id:3-V-+ | | | | | | | +-------+ | | | | | | | +id:4-V-+ | | | | | | +-------+ | | | | | | +id:5-V-+ | | | | | +-------+ | | | | | +id:6-V-+ | | | | +-------+ | | | +------------------------------------------------------+ | +-----------------------------------------------------------------+ (1) wuxing_section 表存储 section 记录 (2) wuxing_instance 表存储 instance 记录 [创建] 创建 instance 时会涉及如下行为: 1> 关联 section 及对应版本，继承 section 模板 2> 根据 item value 数据类型，在 item 表中以模板默认值创建记录 (3) wuxing_instance_item 表存储 instance 的 item 具体 value 值 +history----------------------------------------------------------+ |+------------------------+ +-------------------------+ | ||wuxing_history_bool | |wuxing_history_float | | |+------------------------+ +-------------------------+ | |+------------------------+ +-------------------------+ | 此五个表记录 instance item 的 value 变更历史 ||wuxing_history_int | |wuxing_history_string | | |+------------------------+ +-------------------------+ | |+------------------------+ | ||wuxing_history_text | | |+------------------------+ | +-----------------------------------------------------------------+ 备注: (1) namespace 表是命名空间，同一个 namespace 下 (section_name, section_version) 实例以及 instance 实例 是唯一的 (2) instance 只会关联一个 (section_name, section_version) (3) item 的类型是固定的 (4) section-instance-instance_item 关系 section 类似 Python 中的类 instance 类似 Python 中类实例化后的对象，会继承 section 这个类的属性 instance_item 类似 Python 中类实例化后对象的属性，会根据 item 的数据类型存储在不同的 value 字段中 ``` #### 2.1.2 建表 SQL ``` # 此处替换为自己的 database use {database}; CREATE TABLE `wuxing_section` ( `namespace` varchar(16) NOT NULL COMMENT "section 所在的 namespace", `section_name` varchar(64) NOT NULL COMMENT "section 名称", `section_version` varchar(16) NOT NULL COMMENT "section version", `section_template` varchar(4096) NOT NULL COMMENT "section 模板，是个 json", `section_md5` varchar(64) NOT NULL COMMENT "section 模板 md5 值", `is_enabled` tinyint(1) NOT NULL COMMENT "section 是否是启用状态", `user` varchar(32) NOT NULL COMMENT "操作用户", `u_time` datetime NOT NULL COMMENT "更新时间", `c_time` datetime NOT NULL COMMENT "创建时间", PRIMARY KEY (`namespace`,`section_name`,`section_version`), KEY `wuxingsection_section_md5` (`section_md5`), KEY `wuxingsection_is_enabled` (`is_enabled`), KEY `wuxingsection_user` (`user`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT "五行 section, 相当于 Python 中的类"; CREATE TABLE `wuxing_instance` ( `namespace` varchar(16) NOT NULL COMMENT "实例所在的 namespace", `instance_name` varchar(64) NOT NULL COMMENT "instance 名称", `instance_template` varchar(4096) NOT NULL COMMENT "instance 模板，在 section 模板基础上加了 item_id", `section_name` varchar(64) NOT NULL COMMENT "instance 所绑定的 section", `section_version` varchar(64) NOT NULL COMMENT "instance 所绑定的 section 版本", `section_md5` varchar(64) NOT NULL COMMENT "section 模板 md5 值", `is_valid` tinyint(1) NOT NULL COMMENT "是否有效，预留字段", `c_time` datetime NOT NULL COMMENT "创建时间", `u_time` datetime NOT NULL COMMENT "更新时间", PRIMARY KEY (`namespace`,`instance_name`), KEY `wuxinginstance_section_name` (`section_name`), KEY `wuxinginstance_section_version` (`section_version`), KEY `wuxinginstance_section_md5` (`section_md5`), KEY `wuxinginstance_c_time` (`c_time`), KEY `wuxinginstance_u_time` (`u_time`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT "五行 instance, 相当于 Python 中的类实例化后的对象"; CREATE TABLE `wuxing_instance_item` ( `id` int(11) NOT NULL AUTO_INCREMENT COMMENT "主键，自增 id, 也就是 item_id", `namespace` varchar(16) NOT NULL COMMENT "item 所在的 namespace", `section_name` varchar(64) NOT NULL COMMENT "item 所在的 section_name", `instance_name` varchar(64) NOT NULL COMMENT "item 所在的 instance_name", `item_name` varchar(64) NOT NULL COMMENT "item 名称", `item_type` varchar(64) NOT NULL COMMENT "item value 类型", `item_value_bool` tinyint(1) DEFAULT NULL COMMENT "item 为 bool 时，此字段有值", `item_value_float` double DEFAULT NULL COMMENT "item 为 float 时，此字段有值", `item_value_int` int(11) DEFAULT NULL COMMENT "item 为 int 时，此字段有值", `item_value_string` varchar(128) DEFAULT NULL COMMENT "item 为 string 时，此字段有值", `item_value_text` varchar(20000) DEFAULT NULL COMMENT "item 为 text 时，此字段有值", `user` varchar(32) NOT NULL COMMENT "操作用户", `c_time` datetime NOT NULL COMMENT "创建时间", `u_time` datetime NOT NULL COMMENT "更新时间", PRIMARY KEY (`id`), KEY `wuxinginstanceitem_namespace` (`namespace`), KEY `wuxinginstanceitem_section_name` (`section_name`), KEY `wuxinginstanceitem_instance_name` (`instance_name`), KEY `wuxinginstanceitem_item_name` (`item_name`), KEY `wuxinginstanceitem_item_type` (`item_type`), KEY `wuxinginstanceitem_item_value_bool` (`item_value_bool`), KEY `wuxinginstanceitem_item_value_float` (`item_value_float`), KEY `wuxinginstanceitem_item_value_int` (`item_value_int`), KEY `wuxinginstanceitem_item_value_string` (`item_value_string`), KEY `wuxinginstanceitem_c_time` (`c_time`), KEY `wuxinginstanceitem_u_time` (`u_time`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT "五行 instance item, 相当于 Python 中实例的属性"; CREATE TABLE `wuxing_history_bool` ( `id` int(11) NOT NULL AUTO_INCREMENT COMMENT "主键，自增 id", `item_id` int(11) NOT NULL COMMENT "item_id", `item_value` tinyint(1) NOT NULL COMMENT "item value", `cmd` varchar(8) NOT NULL COMMENT "变更操作命令/create/update", `user` varchar(32) NOT NULL COMMENT "操作用户", `c_time` datetime NOT NULL COMMENT "创建时间", PRIMARY KEY (`id`), KEY `wuxinghistorybool_item_id` (`item_id`) KEY `wuxinghistorybool_c_time` (`c_time`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT "五行 bool 类型 item 数据变更历史"; CREATE TABLE `wuxing_history_float` ( `id` int(11) NOT NULL AUTO_INCREMENT COMMENT "主键，自增 id", `item_id` int(11) NOT NULL COMMENT "item_id", `item_value` double NOT NULL COMMENT "item value", `cmd` varchar(8) NOT NULL COMMENT "变更操作命令/create/update", `user` varchar(32) NOT NULL COMMENT "操作用户", `c_time` datetime NOT NULL COMMENT "创建时间", PRIMARY KEY (`id`), KEY `wuxinghistoryfloat_item_id` (`item_id`), KEY `wuxinghistoryfloat_c_time` (`c_time`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT "五行 float 类型 item 数据变更历史"; CREATE TABLE `wuxing_history_int` ( `id` int(11) NOT NULL AUTO_INCREMENT COMMENT "主键，自增 id", `item_id` int(11) NOT NULL COMMENT "item_id", `item_value` int(11) NOT NULL COMMENT "item value", `cmd` varchar(8) NOT NULL COMMENT "变更操作命令/create/update", `user` varchar(32) NOT NULL COMMENT "操作用户", `c_time` datetime NOT NULL COMMENT "创建时间", PRIMARY KEY (`id`), KEY `wuxinghistoryint_item_id` (`item_id`), KEY `wuxinghistoryint_c_time` (`c_time`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT "五行 int 类型 item 数据变更历史"; CREATE TABLE `wuxing_history_string` ( `id` int(11) NOT NULL AUTO_INCREMENT COMMENT "主键，自增 id", `item_id` int(11) NOT NULL COMMENT "item_id", `item_value` varchar(128) NOT NULL COMMENT "item value", `cmd` varchar(8) NOT NULL COMMENT "变更操作命令/create/update", `user` varchar(32) NOT NULL COMMENT "操作用户", `c_time` datetime NOT NULL COMMENT "创建时间", PRIMARY KEY (`id`), KEY `wuxinghistorystring_item_id` (`item_id`), KEY `wuxinghistorystring_c_time` (`c_time`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT "五行 string 类型 item 数据变更历史"; CREATE TABLE `wuxing_history_text` ( `id` int(11) NOT NULL AUTO_INCREMENT COMMENT "主键，自增 id", `item_id` int(11) NOT NULL COMMENT "item_id", `item_value` varchar(20000) NOT NULL COMMENT "item value", `cmd` varchar(8) NOT NULL COMMENT "变更操作命令/create/update", `user` varchar(32) NOT NULL COMMENT "操作用户", `c_time` datetime NOT NULL COMMENT "创建时间", PRIMARY KEY (`id`), KEY `wuxinghistorytext_item_id` (`item_id`), KEY `wuxinghistorytext_c_time` (`c_time`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT "五行 text 类型 item 数据变更历史"; ``` ## 3 接口文档 ### 3.1 section #### 3.1.1 section 增 > /wuxing/section\_create ``` 说明：创建 section 方法：POST 参数： namespace : (string) 名字空间（最长 16 个字节） section_name : (string) section 名字 section_version: (string) section 版本 约束： 同一个 namespace 下的 (section_name+section_version) 是唯一的 例子： $ curl -v -d '{"namespace":"zh_host", "section_name":"ip", "section_version":"1.0.1"}' "http://127.0.0.1:8501/wuxing/section_create" {"stat": "OK"} ``` #### 3.1.2 section 删 > /wuxing/section\_delete ``` 说明：创建 section 方法：POST 参数： namespace : (string) 名字空间 section_name : (string) section 名字 section_version: (string) section 版本 约束： 同一个 namespace 下的 (section_name+section_version) 是唯一的 例子： $ curl -v -d '{"namespace":"zh_host", "section_name":"ip", "section_version":"1.0.1"}' "http://127.0.0.1:8501/wuxing/section_delete" {"stat": "OK"} ``` #### 3.1.3 section 改 **3.1.3.1 section 改之添加 item** > /wuxing/section\_item\_add ``` 说明：给 section 模板中增加 item, section 需要是未启用状态，已启用状态的 section 则无法进行变更 方法：POST 参数： namespace : (string) 名字空间 section_name : (string) section 名字 section_version : (string) section 版本 item_name : (string) item 名称 item_default ：(string) item 默认值 item_description : (string) item 说明 例子： $ data_json='{"namespace":"zh_host", "section_name":"ip", "section_version":"1.0.1", "item_name":"s|machine_status", "item_default": "OK", "item_description":"status"}' $ curl -v -d "${data_json}" "http://127.0.0.1:8501/wuxing/section_item_add" {"stat": "OK"} ``` **3.1.3.2 section 改之删除 item** > /wuxing/section\_item\_delete ``` 说明: section 模板中删除 item 参数: namespace : (string) 名字空间 section_name : (string) section 名字 section_version : (string) section 版本 item_name : (string) item 名称 ``` **3.1.3.3 section 改之 enable** > /wuxing/section\_enable ``` 说明：启用 section 方法：POST 参数： namespace : (string) 名字空间 section_name : (string) section 名字 section_version : (string) section 版本 例子： $ curl -v -d '{"namespace":"zh_host", "section_name":"ip", "section_version":"1.0.1"}' "http://127.0.0.1:8501/wuxing/section_enable" {"stat": "OK"} ``` #### 3.1.4 section 查 **3.1.4.1 section 查之 list** > /wuxing/section\_list ``` 说明：获取 section 列表 方法：GET 参数： namespace : (string) 『可选』名字空间 page_index : (int) 『可选』页码，默认为 1 page_size : (int) 『可选』单页记录条数，默认是 10 例子： $ curl "http://127.0.0.1:8501/wuxing/section_list" ------- { "data" : { "total" : 5, "list" : [ { "section_md5" : "be31d9a7", "is_enabled" : true, "section_name" : "group_appid", "namespace" : "group_qingnang", "section_version" : "1.0.1", "u_time" : "2021-01-25 07:54:33" }, { "section_md5" : "af91d160", "is_enabled" : true, "section_name" : "group_appid", "namespace" : "group_qingnang", "section_version" : "1.0.2", "u_time" : "2021-01-25 07:54:33" }, { "section_md5" : "43e7521f", "is_enabled" : true, "section_name" : "group_appid", "namespace" : "group_qingnang", "section_version" : "1.0.3", "u_time" : "2021-01-25 07:54:33" }, { "section_md5" : "99914b93", "is_enabled" : false, "section_name" : "group_appid", "namespace" : "group_qingnang", "section_version" : "1.0.4", "u_time" : "2021-01-25 07:54:33" }, { "section_md5" : "101d7795", "is_enabled" : true, "section_name" : "ip", "namespace" : "zh_host", "section_version" : "1.0.1", "u_time" : "2021-02-01 11:25:47" } ] }, "stat" : "OK" } ``` **3.1.4.2 section 查之 get** > /wuxing/sectin\_get ``` 说明：获取 section 详情 方法：GET 参数： namespace : (string) 名字空间 section_name : (string) section 名字 section_version : (string) section 版本 例子： $ curl "http://127.0.0.1:8501/wuxing/section_get?namespace=zh_host§ion_name=ip§ion_version=1.0.1" ---- { "data" : { "is_enabled" : true, "section_template" : { "s|niepan_status" : { "item_type" : "string", "item_default" : "OK", "item_description" : "status" }, "s|machine_status" : { "item_type" : "string", "item_default" : "OK", "item_description" : "status" } } }, "stat" : "OK" } ``` ### 3.2 instance #### 3.2.1 instance 增 > /wuxing/instance\_create ``` 说明：创建 instance 方法：POST 参数： namespace : (str) 必传，命名空间 instance_name : (str) 必传，instance name section_name : (str) 必传，section name section_version : (str) 必传，section 版本 items_data : (dict) 选传，item 的 value 值 : {"item_value": "item_value"} 约束： 同一个 namespace 下的 instance_name 是唯一的 例子 1：创建 instance 时，使用 section 模板默认值进行创建 $ data_json='{"namespace":"zh_host", "instance_name":"127.0.0.5", "section_name":"ip", "section_version":"1.0.1"}' $ curl -v -d "${data_json}" "http://127.0.0.1:8501/wuxing/instance_create" {"stat": "OK"} 例子 2：创建 instance 时，使用指定 item_value 进行创建 data_json='{"namespace":"zh_host", "instance_name":"127.0.0.6", "section_name":"ip", "section_version":"1.0.1", "items_data": {"s|machine_status": "ERROR"}}' curl -v -d "${data_json}" "http://127.0.0.1:8501/wuxing/instance_create" {"stat": "OK"} ``` #### 3.2.2 instance 删 > /wuxing/instance\_delete ``` 说明：删除 instance 方法：POST 参数： namespace : (str) 必传，命名空间 instance_name : (str) 必传，instance name 例子： data_json='{"namespace":"zh_host", "instance_name":"127.0.0.6"}' curl -v -d "${data_json}" "http://127.0.0.1:8501/wuxing/instance_delete" {"stat": "OK"} ``` #### 3.2.3 instance 改 **3.2.3.1 更新 instance 的 section 版本** > /wuxing/instance\_update\_section ``` 说明: 更新 instance 的 section 的版本 场景: 有新的需求接入，需要对 instance 增加些 item, 则需要发布新的 section 版本，然后更新对应的 instance 版本 参数: namespace : (str) 必传，命名空间 instance_name : (str) 必传，instance name section_version : (str) 必传，section 版本 ``` **3.2.3.2 更新 instance 的 item value** > /wuxing/instance\_update\_item ``` 说明: 更新 instance 的 item value 参数: namespace : (str) 必传，命名空间 instance_name : (str) 必传, instance name item_name : (str) 必传, item name item_value : (str/int/float/bool) 必传，值 ``` #### 3.2.4 instance 查 **3.2.4.1 instance 查询之 instance 列表** > /wuxing/instance\_list ``` 说明：获取 instance 列表 参数： namespace : (str) 必传，命名空间，匹配时进行完全匹配 section_name : (str) 必传，section name, 匹配时进行完全匹配 instance_name : (str) 选传，instance name, 匹配时进行模糊匹配 section_version : (str) 选传，section 版本，匹配时进行完全匹配 section_md5 : (str) 选传，section md5, 匹配时进行完全匹配 extra_items : (str) 选传，此参数用于获取额外 item 进行列表展示，多个 item 使用冒号 ":" 进行分割 sort : (str) {item_name}/-{item_name} 或者 instance_name, u_time : 如果是 {item_name}/-{item_name} ，应该转换为 item_value_bool/item_value_int/ item_value_string/item_value_float 如果 sort 值是 "-" 开头，则是以降序进行排序 item_conditions : (str) 选传，值为 item_conditions=key=value 多个值可以使用逗号分割，如 item_conditions=i|unit_appid=5526,s|unit_version=- item_name : (str) 选传 item_value : (str) 选传 page_index : (int) 页数 page_size : (int) 每页显示条数，默认为 10 例子 1： $ curl "http://127.0.0.1:8501/wuxing/instance_list?namespace=group_qingnang§ion_name=group_appid" ------ { "data" : { "total" : 3, "list" : [ { "section_md5" : "be31d9a7", "section_name" : "group_appid", "namespace" : "group_qingnang", "instance_name" : "3001", "section_version" : "1.0.1", "u_time" : "2021-02-07 14:07:56" }, { "section_md5" : "be31d9a7", "section_name" : "group_appid", "namespace" : "group_qingnang", "instance_name" : "3002", "section_version" : "1.0.1", "u_time" : "2021-02-07 14:07:56" }, { "section_md5" : "be31d9a7", "section_name" : "group_appid", "namespace" : "group_qingnang", "instance_name" : "3003", "section_version" : "1.0.1", "u_time" : "2021-02-07 14:07:56" } ] }, "stat" : "OK" } 例子 2：根据 instance_name 排序 $ curl "http://127.0.0.1:8501/wuxing/instance_list?namespace=group_qingnang§ion_name=group_appid&sort=-instance_name" ------ { "data" : { "total" : 3, "list" : [ { "section_md5" : "be31d9a7", "section_name" : "group_appid", "namespace" : "group_qingnang", "instance_name" : "3003", "section_version" : "1.0.1", "u_time" : "2021-02-07 14:07:56" }, { "section_md5" : "be31d9a7", "section_name" : "group_appid", "namespace" : "group_qingnang", "instance_name" : "3002", "section_version" : "1.0.1", "u_time" : "2021-02-07 14:07:56" }, { "section_md5" : "be31d9a7", "section_name" : "group_appid", "namespace" : "group_qingnang", "instance_name" : "3001", "section_version" : "1.0.1", "u_time" : "2021-02-07 14:07:56" } ] }, "stat" : "OK" } ``` **3.2.4.1 instance 查询之 instance 详情** > /wuxing/instance\_get ``` 说明: instance 详情 参数: namespace : (string) 必须，namespace instance_name : (string) 必须，instance_name items : (string) item name, 多个 item 使用 `,` 分割 value_format : (String) detail/simple(default) eg: $ curl "http://127.0.0.1:8501/wuxing/instance_get?namespace=zh_host&instance_name=127.0.0.5" { "data" : { "s|machine_status" : { "item_type" : "string", "item_value" : "OK", "item_description" : "status", "u_time" : "2021-02-28 17:27:31", "item_name" : "s|machine_status", "item_id" : 29 } }, "stat" : "OK" } ``` ### 3.3 item #### 3.3.1 item 查 > /wuxing/item\_list ``` 说明: 通过 item 反查 instance 列表 参数: namespace : (str) 选传，命名空间 section_name : (str) 选传，section name instance_name : (str) 选传，instance name item_name : (str) 选传，item name item_value_operator : (str) 选传，item value operator(=//>=/!=) item_value : (str) 选传，item_value start_time : (str) 选传，example: 20210124194805 end_time : (str) 选传，example: 20210124195005 sort : (str) 选传，{item_name}/-{item_name} 或者 instance_name, u_time : 如果是 {item_name}/-{item_name} ，应该转换为 item_value_bool/item_value_int/ item_value_string/item_value_float 如果 sort 值是 "-" 开头，则是以降序进行排序 page_index : (int) 选传，页数 page_size : (int) 选传，每页显示条数 eg: $ curl "http://127.0.0.1:8501/wuxing/item_list?namespace=zh_host§ion_name=ip&item_name=s|machine_status" { "data" : { "total" : 1, "list" : [ { "namespace" : "zh_host", "instance_name" : "127.0.0.5", "item_value" : "OK", "item_name" : "s|machine_status", "u_time" : "2021-02-28 19:08:39", "item_id" : 29, "section_name" : "ip", "user" : "-", "c_time" : "2021-02-28 19:08:39" } ] }, "stat" : "OK" } ``` ### 3.4 item\_history #### 3.4.1 查 > /wuxing/item\_history\_list > > ``` > 说明：获取 item 变更历史 > 参数： > item_type: item 类型 > item_id：item id > page_index=1 > page_size=10 > ``` ### 3.5 item\_ratio #### 3.5.1 获取 item 比例 > /wuxing/get\_item\_ratio ``` 说明：获取 item 比例情况 参数： 'namespace'：命名空间 'section_name'：section 名字 'item_name'：item 名字 'condition1=None'：条件1，格式：condition1=item_key1=item_value2 'condition2=None': 条件2 'report_type=None': pie 'item_value=None': item value keywords 例子： curl "http://127.0.0.1:8501/wuxing/get_item_ratio?namespace=bq_m_state§ion_name=unit_redis&item_name=s|service_bns" ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://meetbill.gitbook.io/butterfly-user-doc/app/13-wuxing.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.