InfluxDB源码阅读之snapshotter服务

操作系统： CentOS7.3.1611_x64

go语言版本：1.8.3 linux/amd64

InfluxDB版本：1.1.0

服务模块介绍

源码路径： github.com/influxdata/influxdb/services/snapshotter

service.go ： snapshotter服务的实现

service_test.go : snapshotter服务的测试代码

client.go ：提供snapshotter服务的客户端访问API

快照服务主要提供如下功能：

TSM碎片文件备份
Meta文件备份

拥有独特的标记（ BackupMagicHeader ，针对meta文件）： 0x59590101

数据库信息备份
数据库存储策略信息备份

Service结构

该结构所在文件：service.go

snapshotter主服务结构如下：

1type Service struct {
2    wg  sync.WaitGroup
3    err chan error
4
5    Node *influxdb.Node
6
7    MetaClient interface {
8        encoding.BinaryMarshaler
9        Database(name string) *meta.DatabaseInfo
10    }
11
12    TSDBStore *tsdb.Store
13
14    Listener net.Listener
15    Logger   *log.Logger
16}

解释如下：

使用锁机制进行数据同步

服务收到连接请求后，首先计数器加1，然后在独立的goroutine中处理该连接，处理完成时计数器减1；

调用Close接口时，wg进行阻塞操作，保证服务关闭时所有任务都完成。

error通道，暂时不知道怎么用。

Node

InfluxDB节点信息，集群相关功能。

MetaClient

Meta服务客户端接口，获取Meta的信息，用于备份Meta文件、数据库信息、数据库存储策略。

TSDBStore

InfluxDB存储引擎指针，用于备份数据库的TSM碎片文件。

Listener

socket对象，用于监听服务端口、接收客户端放来的请求。

Logger

日志指针，用于记录快照服务在运行过程中产生的日志。

Request结构

该结构所在文件：service.go

snapshotter客户端请求的数据结构如下：

1type Request struct {
2    Type            RequestType
3    Database        string
4    RetentionPolicy string
5    ShardID         uint64
6    Since           time.Time
7}

解释如下：

Type

用于区别数据备份的类型。

Database

Meta文件备份、数据库信息备份、存储策略备份时使用，用于指定需要备份的数据库名称。

RetentionPolicy

存储策略备份时使用，用于指定需要备份的数据库存储策略的名称。

ShardID

TSM碎片文件备份时使用，用于指定碎片ID。

Since

TSM碎片文件备份时使用，用于指定起始时间。

Response结构

结构如下：

1type Response struct {
2    Paths []string
3}

该服务在InfluxDB中的应用

该服务在InfluxDB主服务器程序（influxd）中使用，具体如下：

1[root@localhost influxdb]# grep "github.com/influxdata/influxdb/services/snapshotter" * -rn
2cmd/influxd/backup/backup.go:18:        "github.com/influxdata/influxdb/services/snapshotter"
3cmd/influxd/restore/restore.go:20:      "github.com/influxdata/influxdb/services/snapshotter"
4cmd/influxd/run/server.go:28:   "github.com/influxdata/influxdb/services/snapshotter"
5services/snapshotter/service.go:1:package snapshotter // import "github.com/influxdata/influxdb/services/snapshotter"
6[root@localhost influxdb]#

1、服务流程

在 Server->Open 中通过 Server->appendSnapshotterService 加载SnapshotterService。

通过 Server->SnapshotterService 对外提供服务。

2、备份流程

备份流程如下：

通过控制台获取用户指令；

连接SnapshotterService，并发送请求；

执行备份过程；

snapshotter在该流程中充当SnapshotterService的客户端，负责转发请求及获取响应。

3、恢复流程

snapshotter在恢复流程中主要验证下 BackupMagicHeader 是否正确。

好，就这些了，希望对你有帮助。

本文github地址：

https://github.com/mike-zhang/mikeBlogEssays/blob/master/2018/20180208_InfluxDB源码阅读之snapshotter服务.rst

欢迎补充