• docs : 공식 문서를 번역하고, 개인적으로 확인한 내용들을 추가합니다.
• images : md파일에 들어갈 이미지들을 저장합니다.
• src : 파이썬을 활용한 influxdb 사용하는 예제 코드를 작성합니다.
• requiremnets.txt : influxdb와 연동하기 위한 DB connector 오픈소스 패키지를 명시헤놨습니다.
• README.md : 기초적인 설치방법 및 간단한 파이썬 예제를 작성했습니다.
• InfluxDBClient : 인플럭스DB에서 제공하는 오픈소스를 분석하는 공간
• grafana : grafana 와의 연동테스트 기록

• UI 있는 버전

https://dl.influxdata.com/influxdb/releases/influxdb2-2.0.3_darwin_amd64.tar.gz 이 링크를 클릭해 다운로드

tar zxvf influxdb2-2.0.3_darwin_amd64.tar.gz

• 압축 해제 이후 influx와 influxd를 특정 경로로 보내주어야 한다.

• sudo cp influxdb2-2.0.3_darwin_amd64/{influx,influxd} /usr/local/bin/

• 저 경로로 보내주면 mac 터미널에서 influx, influxd 와 같은 경로를 명시하지 않고도 두 바이너리 실행 가능하다~!

• docker run --name influxdb -p 8086:8086 quay.io/influxdb/influxdb:v2.0.3
• 마지막 태그를 자신이 원하는 버전으로 사용하면 됨.
• influex 컨테이너 안으로 들어가기 위해서는
• docker exec -it influxdb /bin/bash

• 최초 진입 화면(localhost:8086)

• UI 기반으로 최초 설정을 진행 할 수 있다.

• CLI 기반으로도 설정 가능!

• 최초 설정은 다음과 같은 것들을 설정하는 것임

  • 디폴트 조직
  • 디폴트 유저
  • 디폴트 버킷
  • 관리자 인증 토큰

• 최초 설정을 하면서 만들어진 관리자 토큰 (Admin token)은 해당 인플럭스DB의 모든 조직에 대해서 모든 읽기, 쓰기 권한을 갖고있다.

• 따라서 조직간 충돌을 방지하기 위해서 각 조직마다 All Access Token을 생성하여 각 조직별 관리자 토큰을 생성하는 것을 권장함!

• 추후 작성하기로 하며 개발 단계에서는 패스

• 최초 셋업 설정

• 다음 패키지를 설치해야 함

  • pip install influxdb-client

• 클라이언트 객체를 초기화 해야 함

from datetime import datetime

from influxdb_client import InfluxDBClient, Point, WritePrecision
from influxdb_client.client.write_api import SYNCHRONOUS

# You can generate a Token from the "Tokens Tab" in the UI
token = "s7osywpu7TghUKAMs9k1HYZkHsKgUG6YkvxFdGjGSsgMLEVl0TvxqvLByAeyQiY_1tT1UdjfPf1TxZbHFs6gUg=="
org = "sehwan"
bucket = "testBucket"

client = InfluxDBClient(url="http://localhost:8086", token=token)

• 토큰은 자신의 조직에 대해서 발급 받을 수 있다. 위 코드로 client 객체를 초기화 함. (설정이라고 생각하면 됨)

• 기존에 존재하는 Line 프로토콜을 이용해서 데이터 쌓기

write_api = client.write_api(write_options=SYNCHRONOUS)

data = "mem,host=host1 used_percent=23.43234543"
write_api.write(bucket, org, data)

• 데이터 포인트를 이용해 데이터를 쌓기

point = Point("mem")\\
  .tag("host", "host1")\\
  .field("used_percent", 23.43234543)\\
  .time(datetime.utcnow(), WritePrecision.NS)

write_api.write(bucket, org, point)

• 일괄처리 시퀀스를 이용해 데이터 쌓기

sequence = ["mem,host=host1 used_percent=23.43234543",
            "mem,host=host1 available_percent=15.856523"]
write_api.write(bucket, org, sequence)

• Flux 쿼리를 실쟁하기

query = f'from(bucket: \\"{bucket}\\") |> range(start: -1h)'
tables = client.query_api().query(query, org=org)

• used_percent 에 대한 데이터를 쌓은 것에 대한 결과

• 그라파나와 influxdb 모두 도커 컨테이너로 실행하면 사용하기 편리하다.
• 원리는 그라파나 이미지와 influxdb 이미지를 docker pull하고, 그 이미지들을 특정 port를 export하여 사용하는 것인데
• 그라파나는 3000번, influxdb는 8086번으로 지정하고, host os의 포트와 컨테이너 내부 port를 맞추어서 사용하게 된다.
• 이 때 각 컨테이너를 실행하는 명령어를 입력하기 너무 귀찮으니까. 도커 컴포즈 파일을 내가 만들었다!

version: '3'
#influxdb 컨테이너와 grafana 컨테이너를 쉽게 실행하기 위한 도커 컴포즈 파이
services:
  influxdb:
    image: quay.io/influxdb/influxdb:v2.0.3
    container_name: influxdb
    ports: 
      - "8086:8086"
    #데이터가 휘발되지 않게 하기 위해서 로컬에 있는 특정 볼륨과 연동
    volumes:
      - /Users/gimsehwan/docker/influx/data:/var/lib/influxdb2
    command: influxd run --bolt-path /var/lib/influxdb2/influxd.bolt --engine-path /var/lib/influxdb2/engine --store bolt
    #influxdb v2 버전의 경우, 컨테이너 내부의 DB 경로와, 특정 command를 사용해야 데이터가 휘발되지 않습니다.
    #위 volumes와 command를 사용하면 해당 이슈 없습니다.
  grafana:
    image: grafana/grafana:7.3.7-ubuntu
    container_name: grafana
    ports:
      - "3000:3000"
    #데이터가 휘발되지 않게 하기 위해서 로컬에 있는 특정 볼륨과 연동
    #mkdir -p /Users/gimsehwan/grafana/data/data
    volumes:
      - /Users/gimsehwan/docker/grafana/data:/var/lib/grafana
    user: "0"
    links:
      - influxdb

#links를 위 같이 작성하면. influxdb라고 url를 요청하면
#자동으로 influxdb의 내부 ip address와 port를 찾아 들어감 !

• 사용법은 간단하다. docker-compose를 설치하고.

• 위 yml파일의 파일 이름을 docker-compose.yml로 지정하여 생성한다.

• volumes 에 있는 /Users/gimsehwan/docker/influx/data 경로를 본인이 원하는 경로로 mkdir를 한다.

  • 이것을 하는 이유는 도커 컨테이너가 끝나더라도, DB에 저장되는 값을 로컬 머신에 저장하여, 다음에 컨테이너를 실행할때도 저 정보를 갖고서 실행하게 되기 때문!

• 이후 docker-compose -d up 을 하면 호스트의 localhost:3000 으로 그라파나를 접근 가능하고, localhost:8086으로 인플럭스디비를 접근 가능하다!

• 그라파나에서 데이터소스를 설정할때 다음 사항을 유의하면 된다!

• 첫번째. 데이터베이스 url을 http://localhost:8086 이 아닌 http://influxdb:8086 으로 정의할것!
• 도커 컴포즈 link 옵션으로 인플럭스 디비 컨테이너를 influxdb 라는 이름으로 (일종의 DNS라고 생각하면 됨) 접근하도록 해놨다.
• 따라서 influxdb 라고 접근해야 한다

• 그라파나 설정에서 localhost:8086으로 접근하게 되면, 그라파나 서버가 떠있는 컨테이너의 localhost:8086을 찾아가게 되는 것임.
• 호스트 OS의 8086도 아니고, 인플럭스 디비의 8086번도 아님. 따라서 influxdb라고 접근해야 influxdb가 떠있는 컨테이너로 찾아가게 됨 !