@ancplua/qyl-semantic-conventions

中文文档
15.0.5发布于 2026/10/22Apache-2.0TypeScriptES Module零依赖近 30 天下载 2755

由共享的 OpenTeleometry 登记处生成的qyl语义常数

中文使用文档

@ancplua/qyl-semantic-conventions (英语)

ES模块和TypeScript字面声明由与qyl的C#包相同的解析Weaver注册生成. 没有运行时间依赖 。 个别的出品是可动摇的.

import { ATTR_SERVICE_NAME, SCHEMA_URL } from '@ancplua/qyl-semantic-conventions';
import {
  ATTR_MCP_METHOD_NAME,
  METRIC_MCP_SERVER_OPERATION_DURATION,
  METRIC_MCP_SERVER_OPERATION_DURATION_UNIT,
} from '@ancplua/qyl-semantic-conventions/incubating';

根出口含有稳定和贬值的移徙公约. ./incubating 包含完整的词汇,包括稳定的出口和qyl所有的发展公约。 上游不稳定的常规可以改变少量排放。 已贬值的密钥仍然是迁移符号;导入这些符号并不能使遥测正常化.

导出遵循 OpenTelemotry JavaScript 名称 : ATTR_*语句 *_VALUE_*, (中文(简体) ), METRIC_* 财务报告和审定财务报表 EVENT_*。计量也导出 METRIC_*_UNIT 财务报告和审定财务报表 METRIC_*_DEFINITION (名称、仪器、单位和稳定性). SCHEMA_URL (一) 确定qyl计划; REGISTRY_SNAPSHOT_SHA256 识别共享的解析输入,不包括源位置元数据,如临时出账路径。 C# 歌声# RegistrySnapshot.Sha256 常数带有相同的指纹。 字义 .d.ts 声明和TypeScript源与JavaScript并列.

导入 findAttribute 财务报告和审定财务报表 findMetric 从 @ancplua/qyl-semantic-conventions/catalog 用于数值类型、模板扩展、单位、稳定性和折旧元数据。 查询 归还与C#相同、正常的Weaver事实的被冻结记录 RegistryCatalog。 。 。 . 未知的自定义名称返回未定义, 并且仍然有效 。 所需资源 属于选定的信号定义; 登记册成员资格不确立范围所有权. 单独的导出将完整的目录保存在恒定只进口的外.

导入 getCapturedFieldPersistence 从 @ancplua/qyl-semantic-conventions/policy 将捕获的 HTTP 信头和 RPC 元数据名称使用相同的注册政策进行分类 C# (韩语) RegistryPolicy.TryGetCapturedFieldPersistence返回时返回 true 有效名称, false 用于这些家庭中的裸根或无效姓名 undefined 用于不相关的密钥. 匹配对于ASCII来说是大小写不敏感. 呼叫者仍然拥有捕获选择和值形状检查.

代代相传 scripts/generate.sh 在寄存器根部,使用被绑定的官方语言独立的OpenTeleometry注册和qyl/vendor定义. 这些绑定可以独立地发布OpenTeleometter SDK版本. SDKs/出口商和正式的OTLP电线定义仍然是单独的依赖关系. 仅凭注册计划 URL 并不能改变属性 .

版本与发布记录

@ancplua/qyl-semantic-conventions 共发布 22 个版本,首次发布于 2026/10/12;过去 12 个月发布了 22 个版本。

版本发布日期距今
15.0.5latest2026/10/2216 天前
15.0.42026/10/2216 天前
15.0.32026/10/2018 天前
15.0.22026/10/1919 天前
15.0.12026/10/1919 天前
15.0.02026/10/1919 天前

关于 @ancplua/qyl-semantic-conventions 的常见问题

@ancplua/qyl-semantic-conventions 是什么?

由共享的 OpenTeleometry 登记处生成的qyl语义常数

如何安装 @ancplua/qyl-semantic-conventions?

在项目目录运行 npm install @ancplua/qyl-semantic-conventions,或使用 pnpm add / yarn add / bun add。

@ancplua/qyl-semantic-conventions 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@ancplua/qyl-semantic-conventions 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@ancplua/qyl-semantic-conventions 可以商用吗?

@ancplua/qyl-semantic-conventions 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@ancplua/qyl-semantic-conventions 的下载量有多少?

根据 npm 官方下载统计,@ancplua/qyl-semantic-conventions 在 2026/10/06 – 2026/11/04 这 30 天内被下载 2,755 次,日均约 92 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@ancplua/qyl-semantic-conventions 还在维护吗?

最新版本 15.0.5 发布于 2026/10/22(16 天前);至今共发布 22 个版本,其中过去 12 个月发布了 22 个;首次发布于 2026/10/12。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。