# @generazioneai/telemetry 中文文档

规范地址：https://npmcn.com/package/%40generazioneai/telemetry/

版本：0\.2\.0
npm 元数据更新时间：2026-11-11T10:04:38.082Z
中文译文更新时间：2026-11-16T03:22:51.481Z
软件包许可：UNLICENSED

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40generazioneai/telemetry
原文对照：https://npmcn.com/package/%40generazioneai/telemetry/?lang=original
项目主页：https://github.com/GenerazioneAI-SRL/authz/tree/main/packages/telemetry#readme
源码仓库：https://github.com/GenerazioneAI-SRL/authz

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：103 kB，59 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.0\.0
- 运行依赖：11 个
- 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
- 首次发布：2026-10-26T10:45:13.751Z
- 最新版本发布：2026-11-11T10:04:37.869Z
- 近 30 天下载量：2298（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

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.

## 安装

```sh
npm install @generazioneai/telemetry
```

也可以使用：`pnpm add @generazioneai/telemetry`、`yarn add @generazioneai/telemetry`、`bun add @generazioneai/telemetry`

## README

# @ 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).

```bash
npm i @generazioneai/telemetry
```

## 乌苏

```ts
// 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/HTTP | `http://otel-collector.observability:4318` (用sviluppo地语:vquent; **配额=乏力** (l'SDK,nessuna connesione) (英语:il processo no carica l'SDK, nessuna connesione) |
| `TELEMETRY_MODE` | `on` | 0.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_FORMAT` | `text` | `json` | `text` |
| `APP_LOGGER_LEVEL` | `log,error,warn,debug,verbose` | `none` | `log,error,warn` (单位:千美元)`fatal` 缝合 `error`(中文(简体) ) |
| `TELEMETRY_SAMPLE_RATIO` | 0.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 是什么？

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 和提交记录判断。

