@generazioneai/telemetry

中文文档
0.2.0发布于 2026/11/11UNLICENSEDTypeScriptCommonJS近 30 天下载 2298

Osservabilità comune dei servizi Node (ADR-013): OpenTeleometry con esportazione OTLP, Json Logger con track id, salst dei commandi NATS con trackparent negli header, attributi a lista bianca e redazione dei dati personali. 互联网档案馆的存檔,存档日期2014-12-02.

中文使用文档
文档目录4 节
  1. 乌苏
  2. 科萨法
  3. Compatibilità delle 版本i OpenTelemetry 软件
  4. 证明

@ generazioneai/ 遥测

Osservabilità comune dei servizi 节点(ADR-013, spect “Fondamenta business' 第5节): trace e armhe OpenTelemotry verso il 收集器, log JSON con trace_id横跨Comandi NATS, Nessun dato personale. (原始内容存档于2018-09-29).

npm i @generazioneai/telemetry

乌苏

// main.ts — PRIMA riga
import '@generazioneai/telemetry/register';
import { createLogger } from '@generazioneai/telemetry/logger';

const app = await NestFactory.create(AppModule, { logger: createLogger('hr') });

// app.module.ts
TelemetryModule.forRoot({ service: 'hr' })
变相瓦罗里双倍
OTEL_EXPORTER_OTLP_ENDPOINT基础OTLP/HTTPhttp://otel-collector.observability:4318 (用sviluppo地语:vquent; 配额=乏力 (l'SDK,nessuna connesione) (英语:il processo no carica l'SDK, nessuna connesione)
TELEMETRY_MODEon0.2 (2026-11-10号决定): accesa se c'è l'endpoint. off 在sviluppo locale e nei 测试中独奏(SKILLERA_ENV dev编号 :local 欧 NODE_ENV development编号 :test, fuori da un cluster; 阿尔特洛夫 si ignora con un avviso
OTEL_SERVICE_NAME没有name 三角形 package.json (范围)
SKILLERA_ENV→ deployment.environment
LOG_FORMATtext | jsontext
APP_LOGGER_LEVELlog,error,warn,debug,verbose | nonelog,error,warn (单位:千美元)fatal 缝合 error(中文(简体) )
TELEMETRY_SAMPLE_RATIO0.1 (单位:千美元)1 (可口可乐)
OTEL_METRIC_EXPORT_INTERVAL分钟60000

错误 OTEL_SERVICE_NAME 无列表 : register (原始内容存档于2013-10-12) (英语). parte priment di Nest e noconosce l'opzione service (原始内容存档于2018-09-29). del modulo.

科萨法

  • /register:节点SDK Con OTLP/HTTP/每轨电车e 度量衡;支路通(senza) health编号 :metrics, (中文(简体) ), pg, (中文(简体) ), ioredis, Prisma (le ultime tre opzionali) (英语). Nessun gestore di SIGTERM: lo spegnimento ordinato lo fa (英语) TelemetryModule (单位:千美元) beforeExit) (中文(简体) ).
  • 海军: 我全球干扰器( 索洛竞技) rpc(预告) nats.server <cmd> (实物消费者) traceparent 直线头, 元 cmd 电子 juridicalId nel 竞技 dei 日志, conta nats_server_requests_total{cmd,outcome} 电子 nats_server_request_duration_seconds{cmd}。 。 。 . juridicalId viene dall'header (法语) Gen-Tenant 欧达 auth.juridicalId编号 :auth.tenantId编号 :dto.juridicalId{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}请独唱吧.
  • 印维奥数字 : traceparentHeadersHook 切换 traceparent 尼来头. TelemetryModule.forRoot 登记程序 setNatsHeadersHook 数字 @generazioneai/authz ^ 0.7 se c'è (altrimenti ulla; si può passare il modulo con) 互联网档案馆的存檔,存档日期2013-12-02 authz: … 螺旋锥 authz: false. 每起事件 @generazioneai/events 错误 injectTraceContext编号 :extractTraceContext。 。 。 .
  • 日志 (单位:千美元)JsonLogger: level, (中文(简体) ), ts, (中文(简体) ), service, (中文(简体) ), msg, (中文(简体) ), trace_id, (中文(简体) ), span_id, (中文(简体) ), cmd, (中文(简体) ), juridicalId (+ 数) context, (中文(简体) ), err坎地·德·马萨乔·奥格特托 混血儿.
  • 达蒂个人 (第35号决定):滑行横跨埃斯科诺达 SanitizingSpanExporter单打出击出击出击出击 名单a (单位:千美元)ALLOWED_ATTRIBUTES: metodo, rotta come modello, commando, esito, durata, 维度, id di azienda UUID,, db.statement senza retalali, redis solo il commando, stato senza messaggio, IP solo come hash (英语:client.ip_hash) (中文(简体) ). redact()编号 :maskString() 瓦罗里·迪·基雅维来了 authorization, (中文(简体) ), cookie, (中文(简体) ), body, (中文(简体) ), dto, (中文(简体) ), email, (中文(简体) ), *name, (中文(简体) ), fiscalCode, (中文(简体) ), iban, (中文(简体) ), password, (中文(简体) ), *token e mascherano nel testo 电子邮件、codici 财政(anche omocodici)、IBAN、JWT、, Bearer …。 。 。 .

Compatibilità delle 版本i OpenTelemetry 软件

丝绸之路 索诺 裂口 家庭 0.219 错误 @opentelemetry/api 1.9 (中文(简体) ) 0.300 (原始内容存档于2018-10-12) (英语). richiede api = 1.10. che gli SDK 2.x non accettano ancora. Il servizio (英语) 无 独自离开 @opentelemetry/api 潜水员.

证明

npm test. La prova dell'SDK acceso gira 在未处理中 节点花果( le stumentazioni usano) import() dinamici, che Jest no segue) 相克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克 .test-dist/。 。 。 .

版本与发布记录

@generazioneai/telemetry 共发布 4 个版本,首次发布于 2026/10/26;过去 12 个月发布了 4 个版本。

版本发布日期距今
0.2.0latest2026/11/114 天前
0.1.02026/10/2720 天前
0.0.12026/10/2620 天前
0.0.0-stage2026/10/2620 天前

关于 @generazioneai/telemetry 的常见问题

@generazioneai/telemetry 是什么?

Osservabilità comune dei servizi Node (ADR-013): OpenTeleometry con esportazione OTLP, Json Logger con track id, salst dei commandi NATS con trackparent negli header, attributi a lista bianca e redazione dei dati personali. 互联网档案馆的存檔,存档日期2014-12-02.

如何安装 @generazioneai/telemetry?

在项目目录运行 npm install @generazioneai/telemetry,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:rxjs(^7.8.0)、@nestjs/core(^11.0.0 || ^12.0.0)、@nestjs/common(^11.0.0 || ^12.0.0)、reflect-metadata(^0.2.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@generazioneai/telemetry 支持 TypeScript 吗?

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

@generazioneai/telemetry 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@generazioneai/telemetry 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@generazioneai/telemetry 可以商用吗?

@generazioneai/telemetry 使用 UNLICENSED 许可。作者声明为 UNLICENSED,即不授予公开使用许可(与公共领域的 Unlicense 不同)。使用前需获得作者授权。以上为概括,不构成法律意见,请以许可原文为准。

@generazioneai/telemetry 的下载量有多少?

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

@generazioneai/telemetry 还在维护吗?

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