Promscale 安装与使用教程

Promscale 安装与使用教程

promscale[DEPRECATED] Promscale is a unified metric and trace observability backend for Prometheus, Jaeger and OpenTelemetry built on PostgreSQL and TimescaleDB.项目地址:https://gitcode.com/gh_mirrors/pr/promscale

1. 项目目录结构及介绍

Promscale 的源码仓库包含了多个子目录，下面是主要的目录结构和它们的功能：

promscale/

这是 Promscale 连接器的代码所在。连接器负责将 Prometheus 和其他数据源的数据传输到 Promscale 数据库。

promscale-extension/

这个目录包含了 Promscale 扩展，该扩展是安装在 PostgreSQL/TimescaleDB 数据库中的，用于设置数据库模式和优化查询性能。

docker-compose/promscale-demo/

这是一个演示环境的 Docker Compose 配置，用于快速体验 Promscale。通过运行这里的脚本，可以在本地启动一个带有 Promscale、Jaeger 和 Grafana 的环境。

prom-migrator/

这是 prom-migrator 工具的源码，它是一个用于迁移 Prometheus 数据到 Promscale 或其他存储系统的工具。

tobs/

tobs(Timescale OBS) 是一个用于部署观测性栈的工具，包括 Promscale 在内的组件可以通过它快速部署。

2. 项目启动文件介绍

要启动 Promscale 示例环境，可以按照以下步骤进行：

# 克隆仓库
git clone https://github.com/timescale/promscale.git

# 导航到示例目录
cd promscale/docker-compose/promscale-demo/

# 启动容器
docker-compose up -d

这将会启动 Promscale 连接器、PostgreSQL 数据库、Jaeger 和 Grafana，你可以访问本地的 http://localhost:3000（Grafana）和 http://localhost:16686（Jaeger UI）来查看和操作数据。

3. 项目配置文件介绍

Promscale 使用 Docker Compose 文件(docker-compose.yml) 来配置和管理其服务。此文件中定义了各个服务的镜像、端口映射、环境变量和依赖关系。

例如，在 docker-compose/promscale-demo/docker-compose.yml 中：

• promscale 服务指定了 Promscale 连接器的镜像和暴露的端口。
• postgres 服务配置了 PostgreSQL/TimescaleDB 数据库，包括数据卷挂载以持久化数据。
• jaeger-collector 和 jaeger-agent 分别是 Jaeger 收集器和代理的配置。
• grafana 服务设置了 Grafana 配置，包括默认的用户名和密码。

每个服务的环境变量部分用来设置服务的行为，比如在 promscale 服务中，可能有用于配置 Prometheus 远程写入的参数。

若需自定义 Promscale 连接器或数据库的配置，可以直接修改 Docker Compose 文件中的环境变量或使用单独的配置文件，并通过 -v 参数挂载到容器内。

请注意，实际生产环境中，配置可能会更复杂，包括认证、网络策略以及与 Prometheus、Jaeger 和其他服务的集成等。对于详细配置信息，建议参考官方文档。

以上就是 Promscale 的基本安装和配置教程，希望对你有所帮助。如需进一步了解或遇到问题，可以参考项目文档或者加入相关社区进行交流。

promscale[DEPRECATED] Promscale is a unified metric and trace observability backend for Prometheus, Jaeger and OpenTelemetry built on PostgreSQL and TimescaleDB.项目地址:https://gitcode.com/gh_mirrors/pr/promscale