InfluxDBを始めよう

ntopngをInfluxDBに切り替えました。

そんな筆者ですが、InfluxDBについて何も知りません。

よって、本日はInfluxDBについての基礎を勉強したいと思います。

InfluxDBの現行バージョンは1.8です。

アップデートしていない方は、アップデートしましょう。

InfluxDBを最初に勉強するのに最適なコンテンツは、Get started with InfluxDB OSSでしょう。

この解説にそって、勉強していきたいと思います。

コマンドライン接続

以下のコマンドで、接続します。

demo@apu4:~$ sudo influx -precision rfc3339
[sudo] password for demo:
Connected to http://localhost:8086 version 1.8.0
InfluxDB shell version: 1.8.0
>

postgresqlのpsqlとは違って、httpで接続しているみたいです。

rfc3339は、 RFC3339 format (YYYY-MM-DDTHH:MM:SS.nnnnnnnnnZ)を明示しています。

リファレンスの通り、DBを作ってみます。

> CREATE DATABASE mieruka
> SHOW DATABASES
name: databases
name
----
_internal
mieruka
>

_internalですが、

Note: The _internal database is created and used by InfluxDB to store internal runtime metrics. Check it out later to get an interesting look at how InfluxDB is performing under the hood.

の通り、内部の動作メトリックを配置するためにInfluxDB自身が利用するデーターベースです。

InfluxDBに最も重要な概念が以下の文章です。

First, a short primer on the datastore. Data in InfluxDB is organized by “time series”, which contain a measured value, like “cpu_load” or “temperature”. Time series have zero to many points, one for each discrete sample of the metric. Points consist of time (a timestamp), a measurement (“cpu_load”, for example), at least one key-value field (the measured value itself, e.g. “value=0.64”, or “temperature=21.2”), and zero to many key-value tags containing any metadata about the value (e.g. “host=server01”, “region=EMEA”, “dc=Frankfurt”).

InfluxDBは時系列データーベースで、時間、メジャメント(例:”cpu_load”)、それとキー値: フィールド(value=0.64)を持っています。また、メタデータであるタグ(例: “host=server01″,”regieon=JP”)があります。

言葉と意味を抑えておくのが重要かと思いました。

作成したmierukaデーターベースに接続し、INSERT文でメジャメント=cpu_load, フィールド(value=99.9), タグ(host=server01,region=jp)を入力してみましょう。

> use mieruka
Using database mieruka
> INSERT cpu_load,host=server01,region=jp value=99.9
>

次におなじみのSELECT文実行です。

> SELECT "host", "region", "value" FROM "cpu_load"
name: cpu_load
time                           host     region value
----                           ----     ------ -----
2020-06-09T12:44:51.435560559Z server01 jp     99.9
>

最低、本ブログで紹介したコマンドがあれば善戦できるかと思います。