crunchydata/crunchy-collect

Crunchy Collect

镜像概述和主要用途

crunchy-collect容器是由Crunchy Data开发维护的组件，用于通过API接口提供PostgreSQL数据库的实时性能指标。这些指标可被Prometheus时序数据库抓取并存储，随后通过开源数据可视化工具Grafana进行图表展示和分析，帮助用户实时监控PostgreSQL数据库状态。

核心功能和特性

• 实时指标采集：提供PostgreSQL数据库的实时性能指标，包括连接数、查询性能、资源使用率等
• API接口暴露：通过标准化API接口对外提供指标数据，支持Prometheus等监控系统抓取
• 生态集成：无缝对接Prometheus（指标存储）和Grafana（数据可视化）
• 官方维护：由PostgreSQL领域专业厂商Crunchy Data官方维护，确保稳定性和兼容性

使用场景和适用范围

适用于需要对PostgreSQL数据库进行实时监控的各类场景：

• 数据库管理员监控数据库运行状态和性能瓶颈
• DevOps团队构建数据库监控告警体系
• 开发团队分析应用与数据库交互性能
• 企业级PostgreSQL集群的集中化监控管理

使用方法和配置说明

前提条件

• 运行中的PostgreSQL数据库实例
• Prometheus服务（用于指标抓取和存储）
• Grafana服务（用于指标可视化）

部署示例

Docker Run命令

bash
docker run -d \
  --name crunchy-collect \
  -e PGHOST=postgres-instance \
  -e PGPORT=5432 \
  -e PGUSER=monitoring_user \
  -e PGPASSWORD=secure_password \
  -p 9187:9187 \
  docker.xuanyuan.run/crunchydata/crunchy-collect:latest

Docker Compose配置

yaml
version: '3'
services:
  crunchy-collect:
    image: docker.xuanyuan.run/crunchydata/crunchy-collect:latest
    container_name: crunchy-collect
    environment:
      - PGHOST=postgres
      - PGPORT=5432
      - PGUSER=monitoring
      - PGPASSWORD=monitoring-pass
      - METRICS_PORT=9187
    ports:
      - "9187:9187"
    depends_on:
      - postgres

配置参数说明

crunchy-collect通过环境变量进行配置，关键参数如下：

指标访问

启动容器后，可通过 http://<container-ip>:9187/metrics 访问指标数据，Prometheus可配置该地址进行定期抓取。

官方资源

• 完整文档：https://access.crunchydata.com/documentation/crunchy-postgres-containers/latest/
• 示例代码：https://github.com/CrunchyData/crunchy-containers/tree/master/examples

维护与许可

本容器由[***]