InfluxDB的应用场景
influxDB是一个时序数据库,通常用于监控每隔一段时间要记录数据的场景。最近要研究关于怎么样处理IOT数据时,偶然搜到了这个非关系型数据库,但网上关于influxDB的一些资料,需要到处找。因此为了之后省时间,故做个记录。
我觉得以下几篇文章也写的不错
InfluxDB-简介、理论原理介绍以及InfluxDB入门操作
有时间的话可以参考以上文章,没时间的话看以下快速入门——
实战
1)首先是在官网下载influxDB,我在英文文档中点击进入windows界面下载了influxDB v2,下载后如下图所示。
2)在这个文件夹下
3)此时会弹出一个shell窗口
4)输入./influxd.exe
此时influxDB服务打开,那我们就可以在vs中操作这个数据库了。
5)打开vs我们编写简易代码进行测试,新建一个winform程序
6)初始化环境变量和配置influxDB,这里可以借助ui或者控制台来看我们的试验是否成功。
首先是nuget:infulxDB.Client这个包
我们要知道,打开服务后,我们是可以访问这个数据库的,其在本机的默认端口是8086.当我们输入url时,可以看到
因为我已经注册过,所以直接输入用户名密码,一开始进入这个页面是要让你注册一个账号的。
我们要存数据,需要一个bucket,系统默认创建的是firstExample,我们可以
自己创建一个。然后还需要找到你的influxdb的token
点击右边clone复制token
此时在vs中进行代码编写,我们知道了这个token之后,我需要将其注入成环境变量,所以我的代码如下
然后我再通过influxDB.client这个包对数据库进行连接和访问。这里特别需要注意的是,一开始注册的时候,需要我们注册organization,这个名字需要注意,在后续的连接需要填写该值。
这样子,其实数据库就已经连上了,我不再赘述。
7)添加数据,通过webapi的形式将点位写入到influxDB中
此时,我们可以在web中看到加入了数据
如果WebUI中不会操作的话,我们可以在vs中写入C#代码来查询一下
当然,以上是入门操作,当我们想复用时,很难实现,因此我也写了一个帮助类来操作influxDB
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using InfluxDB.Client;
using InfluxDB.Client.Api.Domain;
using InfluxDB.Client.Writes;
using InfluxDB.Client.Flux.Domain;
public class InfluxDBHelper
{
private readonly string _url;
private readonly string _token;
private readonly string _org;
private readonly string _bucket;
private readonly InfluxDBClient _client;
public InfluxDBHelper(string url, string token, string org, string bucket)
{
_url = url;
_token = token;
_org = org;
_bucket = bucket;
_client = InfluxDBClientFactory.Create(_url, _token.ToCharArray());
}
// 插入数据
public async Task InsertDataAsync(string measurement, Dictionary<string, object> fields, Dictionary<string, string> tags = null)
{
var point = PointData.Measurement(measurement)
.Timestamp(DateTime.UtcNow, WritePrecision.Ns);
foreach (var field in fields)
{
point = point.Field(field.Key, field.Value);
}
if (tags != null)
{
foreach (var tag in tags)
{
point = point.Tag(tag.Key, tag.Value);
}
}
using (var writeApi = _client.GetWriteApiAsync())
{
await writeApi.WritePointAsync(point, _bucket, _org);
}
}
// 查询数据
public async Task<List<FluxTable>> QueryDataAsync(string fluxQuery)
{
var queryApi = _client.GetQueryApi();
var tables = await queryApi.QueryAsync(fluxQuery, _org);
return tables;
}
// 更新数据 (更新操作通常是通过插入新数据来实现)
public async Task UpdateDataAsync(string measurement, Dictionary<string, object> fields, Dictionary<string, string> tags = null)
{
await InsertDataAsync(measurement, fields, tags);
}
// 删除数据 (删除是通过时间范围或者标签过滤来实现的)
public async Task DeleteDataAsync(DateTime start, DateTime stop, string predicate)
{
var deleteApi = _client.GetDeleteApi();
await deleteApi.DeleteAsync(start, stop, predicate, _bucket, _org);
}
// 关闭客户端连接
public void Dispose()
{
_client.Dispose();
}
}
实际使用时
var helper = new InfluxDBHelper("http://localhost:8086", "your-token", "your-org", "your-bucket");
await helper.InsertDataAsync("temperature", new Dictionary<string, object>
{
{"value", 25.3}
}, new Dictionary<string, string>
{
{"location", "office"}
});
var result = await helper.QueryDataAsync(@"from(bucket: ""your-bucket"") |> range(start: -1h)");
foreach (var table in result)
{
foreach (var record in table.Records)
{
Console.WriteLine($"{record.GetField()} : {record.GetValue()}");
}
}
await helper.DeleteDataAsync(DateTime.UtcNow.AddHours(-2), DateTime.UtcNow, "location=\"office\"");
helper.Dispose();
使用telegraf来采集数据
这里先简要介绍,后续会写一篇文章专门研究telegraf。
下载对应的influxDB的telegraf
假设这里要采集计算机数据,我们先配置一下telegraf
我们现在
然后
然后看ui
这样子就是直接去监控那个电脑数据了。如果我们要监控其他的话,可以通过这里的telegraf生成配置文件,然后再去更改。
然后查询时,这里就可以根据以上的代码进行查询,这里不再赘述。