SigNoz 是一个开源可观测性平台,将 traces、metrics 和 logs 统一在由 ClickHouse 驱动的单一后端中。它原生构建于 OpenTelemetry 之上,提供 APM 仪表盘、带火焰图的分布式链路追踪、带管道的日志管理、自定义指标、跨所有信号的告警以及异常监控,且无供应商锁定。SigNoz 可作为托管云服务使用,也可通过 Docker 或 Kubernetes 自托管。
用途
当用户需要设置或配置 SigNoz(云服务或自托管)、为应用埋点以向 SigNoz 发送 traces、logs 或 metrics、询问 SigNoz 的 OpenTelemetry Collector 配置、在 SigNoz 中创建仪表盘、面板或可视化、配置告警(基于指标、日志、链路或异常)、询问 SigNoz 查询构建器语法、聚合或过滤器、监控异常或将 traces 与 logs 关联、从 Datadog、Grafana、New Relic 或 ELK 迁移到 SigNoz 时,可触发本技能。不适用于不涉及 SigNoz 的通用可观测性概念,也不适用于不以 SigNoz 为后端的 OpenTelemetry 埋点。
主要能力
- 三大信号统一:Traces 以火焰图和甘特图可视化分布式请求流,每个 trace 包含带属性、事件和状态码的 spans;Metrics 涵盖应用埋点产生的 p99 延迟、错误率、Apdex 以及通过 hostmetrics receiver 采集的 CPU、内存、磁盘、网络等基础设施指标;Logs 支持通过 OTel SDK、FluentBit、Logstash 或基于文件的采集方式摄入,并通过日志管道进行解析和丰富。三种信号可相互关联:traces 通过 trace ID 链接到 logs,异常嵌入在 spans 中。
- 查询构建器:提供统一界面,跨所有信号类型进行过滤、聚合和可视化。支持 Count、Count Distinct、Sum、Avg、Min、Max、P05-P99、Rate 系列等聚合函数,过滤器支持 =、!=、IN、NOT_IN 与 AND 组合,高级功能包括 EWMA 平滑(3/5/7 周期)、时间偏移对比、截断最小/最大阈值以及链式函数应用。
- 仪表盘与面板:通过 Dashboards > New Dashboard 添加面板,选择信号类型、添加过滤器(如 service.name = my-app)、选择聚合方式、按属性分组、设置可视化类型(时间序列、柱状图、饼图、表格)。图例格式中可使用 {{attributeName}} 实现动态标签,多个查询可通过数学函数(log、sqrt、exp、时间偏移)组合。GitHub 上提供预构建的仪表盘 JSON 模板可导入。
- 告警:支持六种告警类型——基于指标、基于日志、基于链路、基于异常、基于异常值(自动异常检测)以及 Apdex 告警。通知渠道包括 Slack、PagerDuty、邮件和 webhook,支持路由策略和计划维护窗口,并提供 Terraform provider 用于基础设施即代码的告警管理。
- 异常监控:对 Python、Java、Ruby 和 JavaScript 自动记录异常,其他语言可手动记录。异常按服务名、类型和消息分组;启用 clickhousetraces exporter 的 low_cardinal_exception_grouping 可仅按服务和类型分组,降低动态消息导致的高基数。
使用方式
云服务
在 https://signoz.io/teams/ 注册获取云实例,将获得区域端点(如 ingest.us.signoz.cloud:443)和用于数据认证的 SIGNOZ_INGESTION_KEY。
自托管部署
Docker 单机(本地/开发最快):
git clone -b main https://github.com/SigNoz/signoz.git && cd signoz/deploy/
docker compose -f docker/clickhouse-setup/docker-compose.yaml up -d
Kubernetes 通过 Helm:
helm repo add signoz https://charts.signoz.io
helm install my-release signoz/signoz
自托管支持 Docker Standalone、Docker Swarm、Kubernetes(AWS/GCP/Azure/DigitalOcean/OpenShift)以及原生 Linux 安装。
应用埋点
以 Node.js 为例:
npm install @opentelemetry/api @opentelemetry/sdk-node @opentelemetry/auto-instrumentations-node @opentelemetry/exporter-trace-otlp-grpc
const { NodeSDK } = require("@opentelemetry/sdk-node");
const { getNodeAutoInstrumentations } = require("@opentelemetry/auto-instrumentations-node");
const { OTLPTraceExporter } = require("@opentelemetry/exporter-trace-otlp-grpc");
const sdk = new NodeSDK({
traceExporter: new OTLPTraceExporter({
url: process.env.OTEL_EXPORTER_OTLP_ENDPOINT || "http://localhost:4317",
}),
instrumentations: [getNodeAutoInstrumentations()],
});
sdk.start();
支持语言:Java、Python、Go、.NET、Ruby、PHP、Rust、Elixir、C++、Deno、Swift,以及移动端(React Native、Android、iOS、Flutter)和前端。
OTel Collector 配置
配置 receivers(otlp 的 gRPC 4317 和 HTTP 4318,以及 hostmetrics)、processors(batch、resourcedetection)、exporters(otlp)和 service pipelines。云服务需设置 endpoint 为 ingest.<region>.signoz.cloud:443 并在 headers 中传入 signoz-ingestion-key;自托管替换为实例 URL 并移除 headers。
日志发送
三种方式:OTel SDK 直接埋点、基于文件(FluentBit 或 Logstash 通过 OTLP 转发)、容器 stdout 管道到 OTel Collector 的 filelog receiver。日志管道可在存储前解析、转换、丰富、丢弃不需要的日志以及擦除 PII。
适用场景
适用于需要统一 traces、metrics、logs 进行应用监控与分布式追踪的团队,希望摆脱供应商锁定或从 Datadog、Grafana、New Relic、ELK 迁移的组织,以及需要自托管可观测性方案或基于 OpenTelemetry 标准进行埋点的项目。
限制与注意事项
- OTel SDK 必须在其他导入之前初始化,否则相关库无法自动埋点。Node.js 可使用 --require ./instrument.js 提前加载 SDK,Python 需在入口顶部初始化。
- 端口 4317 的 gRPC 常被云防火墙默认阻止。若 traces 未到达,可先将 exporter 切换为 4318 端口的 OTLP/HTTP 进行排查。
- 缺少 service.name 属性会导致数据无法识别。应在环境变量中设置 OTEL_SERVICE_NAME 或在 SDK 配置中指定服务名。
- 自托管 ClickHouse 存储可能静默写满:自托管部署没有内置磁盘告警,ClickHouse 会填满磁盘后停止写入。应配置主机磁盘利用率告警并在 SigNoz 设置中配置数据保留策略(traces 默认 15 天)。
- 高基数 span 属性会破坏仪表盘:将用户 ID、请求 ID 或原始查询字符串作为 span 属性键(而非值)会产生无界基数。基数应放在属性值中而非键中,使用固定键集如 user.id、request.id 配合可变值。