DataCat
自托管可观测性:指标、日志、分布式追踪、仪表盘、基础设施和告警集于一处。DataCat 运行在你自己的基础设施上,数据存储在 PostgreSQL(如果你选择的话,遥测数据也可以存储在 ClickHouse;参见 docs/SELF_HOSTING.md),并接受 OpenTelemetry 和 Datadog 兼容的 agent 流量。无需托管账户或外部服务。
功能
- 指标浏览器、公式、仪表盘和主机地图
- 可搜索日志,支持分面、实时 tail 和追踪关联
- APM 服务目录、追踪浏览器和瀑布图
- 指标、日志和追踪监控器,支持 webhook/Slack 通知
- 组织、本地账户、一次性邀请、API/应用密钥
- 基于 OpenTelemetry Collector 的主机 agent,以及 Node.js/Python 埋点库
- 一个生产进程同时提供 API、Web UI、安装程序和下载

使用 Docker Compose 快速开始
要求:带 Compose 插件的 Docker Engine、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,该 token 会打印在服务器日志中(docker compose logs datacat | grep "setup token"),除非你设置了 DATACAT_SETUP_TOKEN。在邀请同事或远程安装 agent 之前,请将 PUBLIC_URL 设置为外部可访问的 HTTPS 源。
Agent 二进制文件和 SDK 包是独立的发布资产。将它们(包括 SHA256SUMS)放入 downloads/ 即可从你的实例提供下载。
发送数据
DataCat 接受 Datadog 公共 intake API 和 OTLP/HTTP:
| 发送方 | 状态 |
|---|---|
| Datadog Agent 7.56.2(指标、日志、检查运行、追踪) | 已在 CI 风格的运行中测试 |
| Datadog Agent 7.85.4(指标、日志、检查运行、追踪) | 已用捕获的载荷测试;包括较新的 string-table 追踪格式 |
| Datadog Agent 7.57–7.84 | 未逐一测试。以 DataCat 无法读取的格式发送追踪的 agent 会收到 422,绝不会收到静默的 202 |
| OpenTelemetry Collector / SDKs(OTLP/HTTP) | /v1/traces 、 /v1/metrics 、 /v1/logs(也可在 /otlp/v1/* 下) |
| DataCat Agent 和库 | 已在 CI 中测试 |
GET /api/v1/intake/stats 会按 intake 路径显示自服务器启动以来存储了多少项、丢弃了多少项。
登录使用本地电子邮件/密码账户;成员通过一次性邀请链接加入。
从源码构建
使用 Node.js 22.15+、pnpm 10.11.0 和 PostgreSQL 14+。Node 22 也满足 Node SDK 的要求;较旧的 Node 20 版本不受当前 SDK 支持。
corepack enable
corepack prepare [email protected] --activate
pnpm install --frozen-lockfile
BASE_PATH=/ pnpm run build:selfhost
# Set DATABASE_URL, SESSION_SECRET and PUBLIC_URL in your environment.
NODE_ENV=production PORT=3000 pnpm start
服务器在开始监听前会自动迁移其 schema。没有手动 schema push,也没有单独的前端服务器。
参见 Self-hosting 了解干净的 Ubuntu 安装、所有环境设置、备份、systemd、agent 安装、Node/Python 埋点以及 webhook 监控器演练。
开发
pnpm run typecheck:libs
pnpm --filter @workspace/api-server run dev
# In another terminal:
API_PROXY=http://localhost:3000 PORT=5173 pnpm --filter @workspace/web run dev
API 需要 DATABASE_URL;请使用单独的开发数据库。Agent 使用 Go 1.26.11+ 构建:
bash agent/build.sh
DESTDIR="$PWD/dist/downloads" bash agent/release.sh
Replit Datacat——其自托管可观测性是一堆 AI 垃圾,而且根本跑不起来
pnpm --filter @workspace/api-server test # server unit tests
DATACAT_URL=http://localhost:3000 DATACAT_SETUP_TOKEN=<token> bash scripts/e2e.sh # end-to-end known-answer checks against a fresh install
CI(.github/workflows/ci.yml)会在每个 pull request 上运行类型检查、单元测试、依赖与漏洞审计、针对两种存储选项的端到端检查、库测试与 agent 测试、一次 Docker 构建以及一次密钥扫描。
可运行的示例位于 examples/。参见 Contributing、Security 和 Changelog。
Benchmarks
bench/kit 会通过 DataCat 发送指标、日志和追踪数据,并将每个结果与已知值进行比对;它会针对两种存储选项分别报告吞吐量、查询延迟以及数据变为可搜索所需的时间。bench/ 下的其他文件夹存放正确性、韧性、告警、浸泡和隔离测试;已公布数字背后的原始结果位于 bench/evidence/。
License
Apache License 2.0。第三方依赖保留其各自的许可证。DataCat 是一个独立项目,与 Datadog, Inc. 无隶属关系,也未获其认可。Datadog 是 Datadog, Inc. 的商标;此处提及仅用于说明协议兼容性。