@grafana/alloy-pipeline-graph

中文文档
0.2.2发布于 2026/09/11Apache-2.0TypeScriptES Module近 30 天下载 1.5万

Grafana合金和舰队管理共用合金管道图可视化

中文使用文档
文档目录7 节
  1. 使用量
  2. 点击处理
  3. 可选字段
  4. 他们
  5. 发展
  6. 释放
  7. 许可证

@ grafana/ 团结- 管道- graph

NPM Version

共享合金管道图可视化 格拉法纳合金 财务报告和审定财务报表 格拉法纳舰队管理。 。 。 .

使用量

import { PipelineGraph, type PipelineGraphData } from '@grafana/alloy-pipeline-graph';
import '@grafana/alloy-pipeline-graph/style.css';

const graph: PipelineGraphData = {
  nodes: [/* ... */],
  edges: [/* ... */],
};

// Graph-level handler — fires for every node click.
<PipelineGraph graph={graph} onNodeClick={(node) => console.log(node.id)} />

消费者建设 PipelineGraph 从它们自己的数据来源输入:

  • 合金 - 运行时间部分 API(/api/v0/web/components(中文(简体) )
  • 收集器应用程序 - 解析合金配置通过 @grafana-cloud/alloy-configurator

一个可运行 demo/ 使该组件与若干示例数据集相匹配 文档输入形状 - 见 demo/README.md。 。 。 .

点击处理

节点在有图形级时是交互式的 onNodeClick 和/或节点带有 拥有 onClick。点击时两次起火(每个节点处理器先运行),因此单个节点可以 覆盖或增强默认行为 :

const graph: PipelineGraphData = {
  nodes: [
    { id: 'a', /* ... */, onClick: (node) => openDrawerFor(node) }, // per-node
  ],
  edges: [/* ... */],
};

可选字段

  • PipelineEdge.metric ——单一总活流量率. 当存在时,在边缘标签上显示并倒塌边缘为一行.
  • PipelineEdge.signalMetrics ——每个信号的活率({ signal, value, unit? }[]) (中文(简体) ). 每个条目都用其速率标出自己的有色线,将多信号风扇放入活数据中。 胜过 metric。当单个边缘以独立的速度携带若干个信号(例如OTLP接收器排放度量衡、日志和痕迹)时使用此功能.
  • SignalKind.Targets ——服务发现输出(目标计数),颜色与遥测信号相区别. discovery.* 组件指 Targets。 。 。 .
  • PipelineNode.kind 编号 : parentId ——可扩展自定义组件容器.
  • PipelineNode.description 编号 : docsUrl ——显示在节点的悬浮工具提示中(docsUrl 添加了"View docs"链接.
  • PipelineNode.onClick ——每个节点点击处理器(见上文).
  • PipelineNode.health 编号 : meta 消费者节点(例如: onClick;未由默认节点提供.
  • PipelineGraphProps.ui - 给格拉法纳注射 Icon 编号 : Tooltip 应用中的一致性.

他们

捆绑的浅/暗主题 镜像 Grafana 的 GrafanaTheme2 数值(颜色、半径、阴影、, 因此,图表在Grafana内外看起来完全相同,而不取决于 @grafana/ui 编号 : @grafana/data。通过 theme="light" | "dark",或全数 PipelineGraphTheme 从活中映射对象 GrafanaTheme2 当运行在应用中.

发展

npm install
npm run build
npm test

释放

释放使用情况 更改。 。 。 .

对于任何面向用户的更改,请在PR中添加一个更改器:

npm run changeset

选择 patch, (中文(简体) ), minor,或 major 被催促的时候 这一选择决定了下一个版本.

公关合并后 main 和CI通过,发布工作打开/更新发布PR 与版本的凸起和更改日志。 合并发布 PR 发布软件包到 npm .

说明: package.json 已包含新的未出版版本, 没有待决 更改 , 发布任务将发布该版本到 npm .

许可证

阿帕奇 - 2.0

版本与发布记录

@grafana/alloy-pipeline-graph 共发布 4 个版本,首次发布于 2026/06/23;过去 12 个月发布了 4 个版本。

版本发布日期距今
0.2.2latest2026/09/112 个月前
0.2.12026/07/074 个月前
0.2.02026/07/024 个月前
0.1.02026/06/234 个月前

关于 @grafana/alloy-pipeline-graph 的常见问题

@grafana/alloy-pipeline-graph 是什么?

Grafana合金和舰队管理共用合金管道图可视化

如何安装 @grafana/alloy-pipeline-graph?

在项目目录运行 npm install @grafana/alloy-pipeline-graph,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.0.0 || ^19.0.0)、react-dom(^18.0.0 || ^19.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@grafana/alloy-pipeline-graph 支持 TypeScript 吗?

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

@grafana/alloy-pipeline-graph 支持 ESM 还是 CommonJS?

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

@grafana/alloy-pipeline-graph 可以商用吗?

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

@grafana/alloy-pipeline-graph 的下载量有多少?

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

@grafana/alloy-pipeline-graph 还在维护吗?

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