SuperAPI AI 工具集

cx-service-catalog

通用与其它

查看项目

更新于 10-15 20:28

技能介绍

用途:通过 cx service-catalog CLI 只读查询 Coralogix Service Catalog(APM v2 实体)及其实体的列式指标,如延迟、错误率、健康、资源使用等。

主要命令:entity-types 列出账户有数据的实体类型;schema <entity-type> 查看某类型的列/标签结构;entities <entity-type> 列出已知实体;data <entity-type> 对某类型所有实体聚合查询;entity-data <entity-type> <entity-id> 对单个命名实体下钻查询。所有命令只读,支持 -o json 与 -o toon。

必要用法:实体类型支持短形式 service、database、operation、database-operation、jvm、jvm-gc、k8s-pod、transaction,大小写不敏感,连字符或下划线均可;--start/--end 支持 now、now-1h 式相对表达或 RFC3339 时间戳;--column 必填且可重复,需先用 schema 查询有效列 id;--filter label=value1,value2 可跨不同标签重复,同标签多值用逗号;--aggregation 为 table(默认)或 timeseries,--limit、--sort-column、--sort-order 仅对 table 生效。

推荐流程:先 entity-types 拿有效实体类型,再 schema 拿有效列 id 与可过滤/分组标签,然后 entities 拿实体 id,最后执行 data 或 entity-data 查询。

限制:列 id、过滤/分组标签和实体 id 因账户和实体类型而异,不可跨类型假设;未知实体类型或重复同一标签会在客户端被拒绝;timeseries 与 limit/sort 组合会被预先拒绝;列级错误不代表命令失败,需逐列检查;table 结果在 .rows,timeseries 在 .series。多 profile 扇出可通过重复 -p <profile> 实现。相关技能包括 cx-infra、cx-telemetry-querying、cx-alerts、cx-dashboards。官方未提供的收费、价格、平台、效果等信息暂未提供。