搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

replit/datacat

运维与部署

在自有服务器上存储指标、日志、链路、仪表盘和告警的自托管可观测平台,支持 PostgreSQL 或 ClickHouse。

119
9
TypeScript
Apache-2.0
创建于 1 天前

项目介绍

DataCat 把指标、日志、分布式链路、仪表盘、基础设施主机图和告警集中在一个自托管应用里。数据默认存进 PostgreSQL,也可以将遥测数据存放在 ClickHouse,运行在自己的基础设施上,不需要托管账号或外部服务。

功能包括带公式的指标浏览器、支持分面和实时尾随的日志搜索、日志与链路关联、APM 服务目录、链路瀑布图,以及可通过 Webhook 或 Slack 通知的指标、日志和链路监控器。平台提供组织、本地邮箱密码账号、一次性邀请链接和 API 密钥,方便团队共用一套实例。

数据入口有两条:OpenTelemetry 的 OTLP/HTTP 接口,以及兼容 Datadog 的接收 API。生产环境由单个进程同时提供 API、Web UI、安装程序和 Agent 下载。

快速使用

准备 Docker Engine(含 Compose 插件)、Git 和 OpenSSL。在仓库根目录执行:

git clone https://github.com/replit/datacat
cd datacat
cp .env.example .env
sed -i "s/^POSTGRES_PASSWORD=.*/POSTGRES_PASSWORD=$(openssl rand -hex 24)/" .env
sed -i "s/^SESSION_SECRET=.*/SESSION_SECRET=$(openssl rand -hex 32)/" .env
chmod 600 .env
mkdir -p downloads
docker compose up -d --build

打开 http://localhost:3000,创建管理员账号和组织,再到 Organization Settings 下生成 API 密钥。初始化会要求输入 setup token,除非事先设置了 DATACAT_SETUP_TOKEN,否则可从服务端日志获取(docker compose logs datacat | grep "setup token")。在邀请同事或到其他机器安装 Agent 之前,把 PUBLIC_URL 设为外部可访问的 HTTPS 地址。

Agent 二进制和 SDK 包属于单独的发布资产,需要连同 SHA256SUMS 一起放入 downloads/,实例才能提供下载。Ubuntu 安装、备份、systemd 和 Agent 配置详见自托管文档。

接入数据

OpenTelemetry Collector 或 SDK 可连接 /v1/traces、/v1/metrics 和 /v1/logs(同时也挂在 /otlp/v1/* 下),也可以将 Datadog Agent 指向兼容接收 API。README 列出的已测试版本为 Datadog Agent 7.56.2 和 7.85.4;7.57 到 7.84 未逐一测试,无法识别的链路格式会返回 422,而不是静默返回 202。GET /api/v1/intake/stats 可以查看各入口自服务启动以来存储和丢弃的数据量。

从源码运行

源码构建需要 Node.js 22.15+、pnpm 10.11.0 和 PostgreSQL 14+;当前 SDK 不支持 Node 20。

corepack enable
corepack prepare pnpm@10.11.0 --activate
pnpm install --frozen-lockfile
BASE_PATH=/ pnpm run build:selfhost
NODE_ENV=production PORT=3000 pnpm start

启动前需要在环境中设置 DATABASE_URL、SESSION_SECRET 和 PUBLIC_URL。服务监听前会自动迁移数据库结构,没有手动迁移步骤,也不需要单独启动前端服务。

使用约束

DataCat 面向自托管:服务器、数据库和 HTTPS 入口都由使用者自行运维。默认使用 PostgreSQL;ClickHouse 是遥测数据的可选存储,需要按自托管文档完成配置。认证只有本地邮箱密码,成员通过一次性邀请链接加入。远程安装 Agent 和邀请同事依赖 PUBLIC_URL 指向可访问的 HTTPS 地址。项目使用 Apache-2.0 许可证,并声明与 Datadog, Inc. 无隶属或背书关系。

HotRepo 点评

DataCat 在 2026-11-18 进入 HotRepo 新项目榜,约 1.5 小时的统计窗口内新增 11 个 Star,当时共 8 个 Fork,尚无 GitHub 全部语言日榜名次记录。对一个如此年轻的仓库来说,功能面铺得很广,判断成熟度时 bench 中带留存结果的可重复基准测试和端到端测试路径比早期 Star 数更有参考价值。兼容 Datadog 的接收接口是实用的迁移入口,但目前只点名了两个已测试的 Agent 版本。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. open-telemetry/opentelemetry-go为 Go 服务接入链路追踪、指标和日志,并通过统一 API 导出到可观测平台。Go6,581
  2. openobserve/openobserve一个自托管可观测性后端,把日志、指标、链路和前端监控收进单一二进制。TypeScript22,583
  3. ccfos/nightingale在已有监控数据之上做告警规则评估、事件处理与通知路由的自托管告警平台。Go13,438
  4. grafana/grafana开源可观测性平台,用于查询、可视化和告警多个数据源中的指标、日志与链路数据。TypeScript77,811
  5. open-telemetry/opentelemetry-collector用一条可配置的遥测管道替代每个后端各配一个代理,把接收、处理、导出集中到一处。Go7,704