M3DB快速入门：使用Docker搭建单节点集群

M3DB快速入门：使用Docker搭建单节点集群

m3 M3 monorepo - Distributed TSDB, Aggregator and Query Engine, Prometheus Sidecar, Graphite Compatible, Metrics Platform 项目地址: https://gitcode.com/gh_mirrors/m31/m3

前言

M3DB是一个分布式时序数据库系统，专为大规模指标存储和分析而设计。本文将指导您使用Docker快速搭建一个M3DB单节点集群环境，适合开发测试和初步评估使用。

重要说明

生产环境警告：本文介绍的Docker单节点部署方式仅适用于学习和测试目的，不具备高可用性和扩展性。生产环境请考虑使用多节点集群部署方案。

环境准备

在开始之前，请确保您的系统满足以下要求：

1. Docker环境：需要安装Docker引擎

   • 推荐Docker Desktop资源配置：
     • CPU：至少2核
     • 内存：至少8GB
     • 交换空间：1GB
     • 磁盘镜像大小：16GB

2. 辅助工具（可选但推荐）：

   • jq：用于格式化JSON输出
   • curl：用于API调用测试

启动M3DB容器

M3DB官方Docker镜像包含以下组件：

• M3DB存储实例：负责时序数据存储
• 嵌入式etcd服务器：存储集群拓扑和运行时配置
• M3 Coordinator：提供写入、查询和管理接口

容器会暴露两个重要端口：

• 7201：集群管理API端口
• 7203：Prometheus指标采集端口

执行以下命令启动容器：

docker run -p 7201:7201 -p 7203:7203 --name m3db -v $(pwd)/m3db_data:/var/lib/m3db quay.io/m3db/m3dbnode:latest

这个命令做了以下几件事：

1. 映射主机7201和7203端口到容器
2. 创建名为m3db的容器实例
3. 挂载本地目录作为数据持久化存储

配置说明

容器默认使用内置的配置文件，主要包含两个部分：

1. coordinator配置：控制M3Coordinator的行为
2. db配置：控制M3DB存储实例的行为

对于大多数测试场景，默认配置已经足够。如需自定义配置，可以通过挂载自定义配置文件到容器中。

基本操作指南

1. 创建命名空间

M3DB使用命名空间(namespace)来组织数据，类似于传统数据库中的"数据库"概念。创建命名空间是使用M3DB的第一步。

curl -X POST http://localhost:7201/api/v1/database/create -d '{
  "type": "local",
  "namespaceName": "default",
  "retentionTime": "24h"
}' | jq .

2. 写入测试数据

使用以下命令写入示例指标数据：

curl -X POST http://localhost:7201/api/v1/json/write -d '{
  "tags": {
    "__name__": "http_requests_total",
    "job": "api-server",
    "instance": "0",
    "group": "production"
  },
  "timestamp": '"$(date +%s)"',
  "value": 42.5
}' | jq .

3. 查询数据

查询刚刚写入的指标：

curl -X POST http://localhost:7201/api/v1/query_range -d '{
  "query": "http_requests_total",
  "start": '"$(date -d '1 hour ago' +%s)"',
  "end": '"$(date +%s)"',
  "step": "15s"
}' | jq .

监控与维护

M3DB容器会自动暴露监控指标，您可以通过以下方式访问：

1. 直接查看容器指标：

   curl http://localhost:7203/metrics
   

2. 或者配置Prometheus采集这些指标

常见问题处理

1. 启动时出现警告信息：在Mac/Windows上的Docker Desktop环境中，可能会看到一些配置警告，这些通常可以忽略。

2. 性能问题：如果遇到查询响应慢的情况，可以尝试：

   • 增加Docker资源分配
   • 检查数据目录是否挂载正确

3. 数据持久化：确保使用了-v参数挂载数据目录，否则容器删除后数据会丢失。

后续步骤

完成本教程后，您可以：

1. 尝试写入更多样化的指标数据
2. 探索M3DB的聚合和降采样功能
3. 了解如何配置多节点集群部署

通过这个Docker单节点部署，您已经可以开始体验M3DB的核心功能，为后续的生产环境部署打下基础。

m3 M3 monorepo - Distributed TSDB, Aggregator and Query Engine, Prometheus Sidecar, Graphite Compatible, Metrics Platform 项目地址: https://gitcode.com/gh_mirrors/m31/m3