@cloudcare/guance-front-tools 1.0.20 → 1.0.21

package/skills/grafana-to-guance-dashboard/references/unit-inference-cheatsheet.md

@@ -1,174 +0,0 @@
-# Unit Inference Cheatsheet
-
-Use this reference when Grafana panels do not provide explicit units and the LLM needs to infer likely Guance units.
-
-This file is a guide, not a source of truth. Prefer explicit Grafana panel units over any inference. When evidence conflicts, lower confidence and say so.
-
-## Confidence Guide
-
-- `high`
-  - explicit metric suffixes or very standard query/title combinations
-- `medium`
-  - multiple hints align, but at least one ambiguity remains
-- `low`
-  - weak or conflicting evidence
-
-## Common Metric Patterns
-
-### Bytes
-
-Strong hints:
-
-- metric names ending with `_bytes`, `_bytes_total`, `_byte`
-- names containing `memory`, `heap`, `rss`, `working_set`, `filesystem`, `disk_usage`
-- titles containing `memory`, `heap`, `disk usage`, `storage`
-
-Recommended unit:
-
-- `bytes`
-
-Typical confidence:
-
-- `high`
-
-### Seconds
-
-Strong hints:
-
-- metric names ending with `_seconds`
-- names containing `duration_seconds`, `response_seconds`, `latency_seconds`, `gc_pause_seconds`
-- titles explicitly mentioning `seconds`
-
-Recommended unit:
-
-- `s`
-
-Typical confidence:
-
-- `high`
-
-### Milliseconds
-
-Strong hints:
-
-- metric names ending with `_ms`
-- titles containing `latency`, `duration`, `response time`, `RT`, `耗时`
-- queries using `histogram_quantile` on latency-style histograms
-
-Recommended unit:
-
-- `ms`
-
-Typical confidence:
-
-- `high` when suffixes or title strongly support it
-- `medium` when inferred mostly from panel title and histogram structure
-
-### Percent
-
-Strong hints:
-
-- metric names ending with `_percent` or containing `_ratio`
-- queries multiplying by `100`
-- titles containing `error rate`, `success rate`, `utilization`, `usage ratio`, `占用率`
-
-Recommended unit:
-
-- `percent`
-
-Typical confidence:
-
-- `high` when the query includes `* 100` or explicit percent naming
-- `medium` for utilization-like panels without explicit scaling
-
-### Requests Per Second
-
-Strong hints:
-
-- titles containing `QPS`, `RPS`, `request rate`, `吞吐`
-- metrics containing `requests_total` together with `rate(...)` or `irate(...)`
-- legends or titles describing traffic volume over time
-
-Recommended unit:
-
-- `reqps`
-
-Typical confidence:
-
-- `high` when a monotonically increasing request counter is wrapped in a rate-like function
-- `medium` when only the title hints at request throughput
-
-### Operations Per Second
-
-Strong hints:
-
-- titles containing `OPS`, `IOPS`, `TPS`
-- counters combined with `rate(...)` where the operation is not clearly an HTTP request
-- disk or storage operation metrics over time
-
-Recommended unit:
-
-- `ops`
-
-Typical confidence:
-
-- `high` for standard IOPS/TPS counters
-- `medium` for generic operation counters
-
-### Count-Like Values
-
-Strong hints:
-
-- names containing `count`, `connections`, `goroutines`, `threads`, `fds`, `pending`, `queue_depth`
-- titles describing counts rather than rates or durations
-- no clear byte/time/percent signal
-
-Recommended unit:
-
-- `none`
-
-Typical confidence:
-
-- `medium`
-
-## Title Hints
-
-Titles can raise confidence when query naming is weak.
-
-- `latency`, `duration`, `响应时间`, `耗时`
-  - usually `ms` or `s`
-- `memory`, `heap`, `disk`, `storage`
-  - usually `bytes`
-- `qps`, `rps`, `throughput`, `吞吐`
-  - usually `reqps`
-- `error rate`, `success rate`, `utilization`, `占比`
-  - usually `percent`
-- `connections`, `goroutines`, `threads`, `count`
-  - usually `none`
-
-## PromQL Function Hints
-
-- `rate(...)`, `irate(...)`, `increase(...)`
-  - often indicates throughput if the underlying metric is a monotonically increasing counter
-- `histogram_quantile(...)`
-  - often indicates latency or duration distributions
-- `sum by (...)`
-  - does not determine the unit by itself
-- `count_over_time(...)`
-  - often suggests count-like `none`
-
-## Ambiguous Cases
-
-Use lower confidence when:
-
-- the title suggests time, but the metric suffix suggests bytes
-- the query mixes several metrics with different semantics
-- recording rules hide the original metric meaning
-- panel titles are generic, such as `Usage`, `Value`, or `Current`
-- PromQL was heavily rewritten and the original naming intent is unclear
-
-In these cases, prefer:
-
-- `medium` or `low` confidence
-- a one-sentence reason
-- manual review if the unit materially affects the chart interpretation

package/skills/grafana-to-guance-dashboard/schemas/charts/chart-schema.json

@@ -1,84 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-07/schema#",
-    "$id": "charts/chart-schema.json",
-    "type": "object",
-    "description": "图表完整结构",
-    "title": "ChartData",
-    "required": [
-        "extend",
-        "name",
-        "pos",
-        "type",
-        "queries"
-    ],
-    "properties": {
-        "extend": {
-            "type": "object",
-            "additionalProperties": true,
-            "properties": {
-                "links": {
-                    "$ref": "common/chart-links-schema.json"
-                },
-                "settings": {
-                    "$ref": "settings/settings-schema.json"
-                }
-            }
-        },
-        "group": {
-            "type": "object",
-            "properties": {
-                "name": {
-                    "oneOf": [
-                        {
-                            "type": "string",
-                            "description": "分组名称"
-                        },
-                        {
-                            "type": "null",
-                            "description": "分组名称"
-                        }
-                    ]
-                }
-            }
-        },
-        "name": {
-            "type": "string",
-            "description": "图表名称"
-        },
-        "pos": {
-            "description": "图表位置信息",
-            "type": "object",
-            "required": [
-                "h",
-                "w",
-                "x",
-                "y"
-            ],
-            "properties": {
-                "h": {
-                    "description": "图表高度,每行的高度默认为10像素,比如 h 为12, 则实际高度为 12 * 10",
-                    "type": "number"
-                },
-                "w": {
-                    "type": "number",
-                    "description": "图表宽度,栅格系统的最大列数为 24, 比如 w为12，则显示宽度则为容器宽度的 1/2 倍 "
-                },
-                "x": {
-                    "type": "number",
-                    "description": "图表距离容器的水平距离,栅格系统的最大列数为 24, 比如 x为12，则图表距离容器左边的水平距离为容器宽度 1/2 倍 "
-                },
-                "y": {
-                    "type": "number",
-                    "description": "图表距离容器垂直距离,每行的高度默认为10像素,比如 y为12, 则实际高度为 12 * 10"
-                }
-            }
-        },
-        "type": {
-            "description": "图表类型",
-            "$ref": "common/common-chart-types-schema.json"
-        },
-        "queries": {
-            "$ref": "query/queries-schema.json"
-        }
-    }
-}

package/skills/grafana-to-guance-dashboard/schemas/charts/common/chart-link-item-schema.json

@@ -1,48 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-07/schema#",
-    "$id": "charts/common/chart-link-item-schema.json",
-    "type": "object",
-    "description": "图表联动跳转项",
-    "required": [
-        "url",
-        "open",
-        "show",
-        "type",
-        "showChanged"
-    ],
-    "properties": {
-        "url": {
-            "type": "string",
-            "description": "跳转地址"
-        },
-        "open": {
-            "type": "string",
-            "description": "打开方式",
-            "enum": [
-                "newWin",
-                "curWin",
-                "drawerWin"
-            ]
-        },
-        "show": {
-            "type": "boolean",
-            "description": "是否展示"
-        },
-        "type": {
-            "type": "string",
-            "description": "跳转类型",
-            "enum": [
-                "logging",
-                "container",
-                "processes",
-                "tracing",
-                "host",
-                "custom"
-            ]
-        },
-        "showChanged": {
-            "type": "boolean",
-            "description": "是否修改过显示状态"
-        }
-    }
-}

package/skills/grafana-to-guance-dashboard/schemas/charts/common/chart-links-schema.json

@@ -1,9 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-07/schema#",
-    "$id": "charts/common/chart-links-schema.json",
-    "type": "array",
-    "description": "图表跳转链接列表",
-    "items": {
-        "$ref": "chart-link-item-schema.json"
-    }
-}

package/skills/grafana-to-guance-dashboard/schemas/charts/common/common-chart-types-schema.json

@@ -1,39 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-07/schema#",
-    "$id": "charts/common/common-chart-types-schema.json",
-    "type": "string",
-    "title": "ChartType",
-    "description": "支持图表类型枚举",
-    "enum": [
-        "group",
-        "sequence",
-        "singlestat",
-        "pie",
-        "bar",
-        "histogram",
-        "slo",
-        "toplist",
-        "gauge",
-        "scatter",
-        "bubble",
-        "table",
-        "treemap",
-        "funnel",
-        "chinamap",
-        "worldmap",
-        "hexgon",
-        "heatmap",
-        "topology",
-        "sankey",
-        "change",
-        "log",
-        "object",
-        "monitor",
-        "alarm",
-        "text",
-        "video",
-        "picture",
-        "command",
-        "iframe"
-    ]
-}

package/skills/grafana-to-guance-dashboard/schemas/charts/common/common-vars-item-schema.json

@@ -1,117 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-07/schema#",
-    "$id": "charts/common/common-vars-item-schema.json",
-    "title": "chartVarsItem",
-    "description": "图表视图变量完整结构",
-    "type": "object",
-    "additionalProperties": true,
-    "properties": {
-        "definition": {
-            "type": "object",
-            "properties": {
-                "tag": {
-                    "type": "string",
-                    "description": "定义 type 为 metrc 类型对应的指标 tag"
-                },
-                "field": {
-                    "type": "string",
-                    "description": "定义 type 为 metrc,object,custom_object, logging, tracing,rum,securit 类型对应的 field"
-                },
-                "value": {
-                    "type": "string",
-                    "description": "定义 type 为 dql,promql,custom_object类型对应的 dql、promql,或者以‘,’号分割的自定义字符串数据"
-                },
-                "metric": {
-                    "type": "string",
-                    "description": "1.type 为 metric 对应指标集 2. type 为 logging,rum 对应 source。"
-                },
-                "object": {
-                    "type": "string",
-                    "description": "type 为 object, custom_object 对应对象 source"
-                },
-                "defaultVal": {
-                    "description": "视图变量默认填充值",
-                    "type": "object",
-                    "properties": {
-                        "label": {
-                            "type": "string",
-                            "description": "默认填充值 label，如果没有则和 value 保持一致"
-                        },
-                        "value": {
-                            "type": "string",
-                            "description": "默认填充值 value"
-                        }
-                    }
-                }
-            }
-        },
-        "type": {
-            "description": "视图变量查询类型，对应关系分别为 QUERY:【DQL】,PROMQL_QUERY:【PROMQL】,TAG:【指标】,FIELD:【基础对象】,FIELD:【自定义对象】,LOGGING:【日志】,TRACING:【应用性能】,RUM:【用户访问】,SECURITY:【安全巡检】,CUSTOM_LIST:【自定义】",
-            "type": "string",
-            "enum": [
-                "QUERY",
-                "PROMQL_QUERY",
-                "FIELD",
-                "TAG",
-                "LOGGING",
-                "TRACING",
-                "RUM",
-                "SECURITY",
-                "CUSTOM_LIST"
-            ]
-        },
-        "code": {
-            "type": "string",
-            "description": "需要被替换的变量名"
-        },
-        "datasource": {
-            "type": "string",
-            "enum": [
-                "dataflux",
-                "ftinfluxdb",
-                "custom",
-                "object",
-                "custom_object"
-            ],
-            "description": "对应关系分别为 dataflux:【DQL】,dataflux:【PROMQL】,ftinfluxdb:【指标】,object:【基础对象】,custom_object:【自定义对象】,dataflux:【日志】,dataflux:【应用性能】,dataflux:【用户访问】,dataflux:【安全巡检】,custom:【自定义】"
-        },
-        "name": {
-            "type": "string",
-            "description": "视图变量显示名称"
-        },
-        "seq": {
-            "type": "integer",
-            "description": "当前项视图变量在列表中的顺序",
-            "examples": [
-                0,
-                1,
-                2
-            ]
-        },
-        "hide": {
-            "type": "integer",
-            "description": "是否隐藏该项视图变量",
-            "enum": [
-                0,
-                1
-            ]
-        },
-        "multiple": {
-            "type": "boolean",
-            "description": "设置视图变量是否能多选",
-            "default": true
-        },
-        "includeStar": {
-            "type": "boolean",
-            "description": "设置视图变量列出值是否包含 * "
-        },
-        "valueSort": {
-            "type": "string",
-            "description": "列出值排序",
-            "enum": [
-                "asc",
-                "desc"
-            ]
-        }
-    }
-}

package/skills/grafana-to-guance-dashboard/schemas/charts/common/common-vars-schema.json

@@ -1,10 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-07/schema#",
-    "$id": "charts/common/common-vars-schema.json",
-    "type": "array",
-    "title": "chartVarsSettings",
-    "description": "图表视图变量列表结构",
-    "items": {
-        "$ref": "common-vars-item-schema.json"
-    }
-}

package/skills/grafana-to-guance-dashboard/schemas/charts/dashboard-schema.json

@@ -1,80 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-07/schema#",
-    "$id": "charts/dashboard-schema.json",
-    "type": "object",
-    "title": "DashboardData",
-    "description": "观测云仪表板完整结构",
-    "additionalProperties": true,
-    "properties": {
-        "title": {
-            "type": "string",
-            "description": "仪表板标题"
-        },
-        "main": {
-            "type": "object",
-            "description": "仪表板图表结构",
-            "properties": {
-                "vars": {
-                    "$ref": "common/common-vars-schema.json"
-                },
-                "charts": {
-                    "type": "array",
-                    "description": "图表合集配置",
-                    "items": {
-                        "$ref": "chart-schema.json"
-                    }
-                },
-                "groups": {
-                    "type": "array",
-                    "description": "分组配置",
-                    "items": {
-                        "type": "object",
-                        "properties": {
-                            "name": {
-                                "type": "string",
-                                "description": "图表分组名称"
-                            },
-                            "extend": {
-                                "type": "object",
-                                "description": "分组的额外配置，比如背景颜色",
-                                "properties": {
-                                    "bgColor": {
-                                        "type": "string",
-                                        "description": "分组块的背景颜色"
-                                    }
-                                }
-                            }
-                        }
-                    }
-                },
-                "type": {
-                    "description": "仪表板主体类型，现有数据中常缺省，存在时固定为 template",
-                    "anyOf": [
-                        {
-                            "type": "string",
-                            "const": "template"
-                        },
-                        {
-                            "type": "null"
-                        }
-                    ]
-                }
-            }
-        },
-        "dashboardExtend": {
-            "description": "仪表板额外配置信息",
-            "type": "object",
-            "additionalProperties": true,
-            "properties": {
-                "groupUnfoldStatus": {
-                    "type": "object",
-                    "description": "分组是否收起打开配置信息,图表名称为 key， value 为 boolean。 false 为关闭，true 为打开",
-                    "additionalProperties": {
-                        "type": "boolean",
-                        "description": "图表名称"
-                    }
-                }
-            }
-        }
-    }
-}

package/skills/grafana-to-guance-dashboard/schemas/charts/query/queries-schema.json

@@ -1,10 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-07/schema#",
-    "$id": "charts/query/queries-schema.json",
-    "type": "array",
-    "title": "ChartQueries",
-    "description": "图表查询语句列表结构",
-    "items": {
-        "$ref": "query-item-schema.json"
-    }
-}

package/skills/grafana-to-guance-dashboard/schemas/charts/query/query-item-schema.json

@@ -1,60 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-07/schema#",
-    "$id": "charts/query/query-item-schema.json",
-    "type": "object",
-    "description": "图表查询语句结构",
-    "title": "ChartQueryItem",
-    "properties": {
-        "type": {
-            "description": "冗余字段，图表类型",
-            "$ref": "../common/common-chart-types-schema.json"
-        },
-        "datasource": {
-            "type": "string",
-            "description": "冗余字段,固定值",
-            "const": "dataflux"
-        },
-        "qtype": {
-            "type": "string",
-            "description": "查询语句类型，目前支持 dql 以及promql",
-            "enum": [
-                "dql",
-                "promql"
-            ]
-        },
-        "query": {
-            "type": "object",
-            "description": "查询语句的额外信息",
-            "additionalProperties": true,
-            "properties": {
-                "q": {
-                    "type": "string",
-                    "description": "图表查询语句，可以是 dql语句，也可以是 promql 语句"
-                },
-                "content": {
-                    "type": "string",
-                    "description": "文本图内容，支持 HTML 或 Markdown 文本"
-                },
-                "code": {
-                    "type": "string",
-                    "description": "查询语句的唯一标识，由单个大写英文字母构成"
-                },
-                "type": {
-                    "type": "string",
-                    "description": "查询语句类型冗余字段，实际数据中可能是 promql/dql，也可能是 default/simple 这类查询模式",
-                    "enum": [
-                        "default",
-                        "simple",
-                        "dql",
-                        "promql"
-                    ]
-                },
-                "promqlCode": {
-                    "type": "integer",
-                    "description": "PromQL 查询顺序编号"
-                }
-            }
-        }
-    },
-    "additionalProperties": true
-}

package/skills/grafana-to-guance-dashboard/schemas/charts/settings/_common-settings-connect-null-schema.json

@@ -1,7 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-07/schema#",
-    "$id": "charts/settings/_common-settings-connect-null-schema.json",
-    "title": "CommonChartConnectNullSettings",
-    "type": "boolean",
-    "default": true
-}