IIJ Machinist ことはじめ

6745 ワード

Python IoT dashboard tech テキストリンク

IIJ Machinist とはなにか

IIJ が提供している、データを可視化するダッシュボードサービスです。

10メトリック、１ヶ月だけ保存する条件ならフリーで、もっとメトリックを増やしたり、保存期間を伸ばしたいなら費用を支払うという仕組みのようです。
メトリックというのは、あるセンサーなどで計測した数値の集合（キッチンにある温度計の温度、とか）です。
メトリックの送信は HTTPS リクエストを送るだけなのでとても楽そう。ということで試してみました。

基本的にはここの. Getting Started のままで、これを Python コードにしたものです

Python でデータを送ってみる

アカウント作成と API キーの作成

IIJ Machinist のページにログインして、 https://machinist.iij.jp/ アカウントを作成します。

ログインした後、画面右上の「アカウント設定」を表示すると、 API キーが表示されます。
（この API キーは秘密情報なので 他の人と共有しないでください ）

送信プログラムの作成

こういうクラスを定義すると、api_key とエージェント名を設定して、 send で送信できるようになります。

class Machinist:
    def __init__(self, api_key, agent:str):
        self.api_key = api_key
        self.agent = agent
        
        self.url = "https://gw.machinist.iij.jp/endpoint"
        self.headers = {
            "Content-Type": "application/json",
            "Authorization": f"Bearer {api_key}",
        }
    def send(self, metrics: list):
        ret = requests.post(url, 
            json={
              "agent": self.agent,
              "metrics": metrics
            },
            headers=self.headers
        )
        assert ret.status_code == 200, ret.text

こんなふうにデータを送れます。
この場合、グループ名 Environment Sensor、メトリック名 temperature という計測データに対して、 27.6 + ランダムな値を送信しているということになります。

import random
machinist = Machinist("YOUR_API_KEY", "Home")
machinist.send([
    {
        "name": "temperature",
        "namespace": "Environment Sensor",
        "data_point": {"value": 27.6 + random.uniform(-5, 5)}
    }
])