この記事は、Zabbix - Qiita Advent Calendar 2025 - Qiita 11日目の記事です。

概要

本日は皆さんのご家庭にも1台はあるであろう、みんな大好きUniFiのお話です。

我が家では、以下のUniFi機器を利用しています。

  • Unifi Express 7
  • Unifi Flex 2.5G 5Port
  • Unifi U7 Lite

今回は、この青枠の情報をZabbixで取得してみた、という内容を書かせていただきます。

これを読むとわかること

  • Unifiというのは、Ubiquiti(ユビキティ)社の製品名であること
  • UniFiのメトリクスを取る方法が、APIとSNMPの2種類あること、すべてのデバイスがSNMP対応ではないこと
  • UniFiのAPIには、Site ManagerのAPIとローカルゲートウェイ用APIの2種類あることと、その取得方法
  • UniFiの画面に表示されていても、取れない情報があること

なお、テンプレートが入ったままでZabbixをすっとばしてしまったので、テンプレートの共有は後日になる見込みです。予めご了承ください。バックアップ大事。

Unifiのメーカー「Ubiquiti」社について

こちらは、過去にTwitterで読み方がわからん！とツイートしたところ、公式から「ユビキティでーす」とご回答をいただきました。大変フレンドリーで親切です。

最初はストアの展開状況から中国の会社なのかな？と思っていましたが、実はアメリカのカリフォルニアの会社さんなんだそうです。

詳細についてはWikipediaの記事や公式HPをご参照ください！！

UniFiのメトリクス取得について

頭出しもしましたが、UniFiのメトリクス取得方法は大きく分けて以下の２種類があります。

  • 通常のネットワーク機器と同様に、SNMPでデータを取得する方法
  • APIを利用し、Site Manager とローカルゲートウェイからデータを取得する方法

SNMPについて

はじめに注意点として、SNMPはすべての機器でサポートをされているわけではありません。

例えば、私の保有しているUniFi Flex 2.5G 5Portは、SNMP非対応です。

SNMPの有効化は、管理画面から、「歯車マーク」→「CyberSecure」→「トラフィックロギング」タブ→「SNMPモニタリング」の箇所から設定が可能です。

非対応のデバイスもこちらで表示されていますね。大変親切です。

SNMP用のテンプレートとしては、Zabbix公式のテンプレートが活用できますので、こちらを利用されるとよいと思います。

UniFi APIについて

概要

UniFiのAPIは、Site ManagerのAPIとローカルゲートウェイのAPIの2種類ある、と記載しました。

各々で取得できる情報や、取得のためのパラメータを以下表にまとめます。

API名取得できる情報取得に必要なパラメーター
SiteManager API各ローカルサイトのID情報、サイト内にあるデバイスID、ISP遅延など(1)UniFiパブリックAPIのURL、(2)SiteManagerで発行したTOKEN情報
ローカルゲートウェイAPIローカルサイト内デバイスのメトリクス情報、サイト内クライアントの情報(1)ローカルゲートウェイAPIのURL、(2)ローカルゲートウェイで発行したTOKEN情報、(3)ローカルゲートウェイのサイトID情報、(4)各デバイスのID情報

最初に戸惑ったのはこの棲み分けでした。これだけみれば、なるほど、となる方もいらっしゃるかもしれません。

SiteManager APIについて

公式ドキュメント: Getting Started | UniFi API

API TOKEN取得方法:

SiteManagerの画面上から「Integration」→「Create New API Key」で発行できます。

パーミッションは標準ではView Onlyが選択されています。POSTなどをしたい方はFull Accessを選択されるとよいでしょう。

ローカルゲートウェイAPIについて

公式ドキュメント:

おそらく、各サイトのクラウドゲートウェイにマッピングされている？ような気がしていますので、URL自体は共有はやめておきます。

「Integration」のメニューを開くと、右側に「API Request Format」のリンクがありますので、そちらをご参照ください。

API TOKEN取得方法:

ローカルゲートウェイ側の管理画面から、「Integration」→「Create New API Key」を選択します。

こちらでは権限などの定義はありませんでした。ここで発行されたAPIキーは、あとから参照はできませんので、手元にのこしておきます。

Zabbix上でのAPI側のメトリクス取得について

やっとZabbixが出てきました。ここまでお付き合いいただきありがとうございます。

Zabbixでは、基本的に上記APIのすべてをHTTPエージェントで処理できます。

注意点としては以下の点です。

  • APIが2種類あるため、各々でエンドポイントが異なる
  • SiteManager上で取得した対象サイトのデバイスID情報は、ローカルゲートウェイのデバイスIDと同一
  • SiteManager上で取得した対象サイトID情報は、ローカルゲートウェイのAPIを利用する際に必要となるサイトID情報とは異なる

特に、ローカルゲートウェイのリファレンスを読むとわかりますが、ローカルゲートウェイ側のエンドポイントの形式が、SiteManager側と異なるため注意が必要です。

取得できるものとできないもの

実際に触ってみた結果、以下の通りの結果でした。

  • 通信機器系…CPU/Memory Usageや、Uplinkのトラフィックのメトリクスは取得可能だが、各ポートまでは難しそう
  • クライアント系…ホスト名などは取得できるが、トラフィックメトリクスなどは難しそう

上述したように、WebUIで確認可能な項目の中でも、取得できるものとできないものがあることがわかりました。

このあたりについては、必要に応じてSNMPで取得可能なメトリクスと組み合わせてモニタリングをするのがよさそうだな、という印象です。

テンプレートの共有

冒頭にも記載しましたが、2025/12/1 8:46時点では、ふっとばしたテンプレートデータを再構築できていないため、現時点では共有できる情報はありません。

早く使いたい！という方は、GitHubなどにAPI用のテンプレートが公開されているようですので、そちらをご参照ください。

気長にお待ちいただける方は、今週末までにはなんとか復旧させますので、それまでお待ちください。

終わりに

長々とUniFiのAPI仕様について記載してきました。いかがだったでしょうか。

私はネットワークエンジニアを20年以上続けていますが、これほど高機能な機器がこの値段で買えるとは…と驚きを隠せませんでした。

ぜひ皆さんも、自宅ネットワークの再構築の際にはUniFiを導入することを検討してみてください。

ちょうどホリデー割引も来ています（ニッコリ）

そして、Zabbixでメトリクス情報を取得してみてください。

UniFiはいいぞおじさん「UniFiはいいぞ」

Zabbixはいいぞおじさん「Zabbixはいいぞ」

https://tenko.hatenablog.jp/entry/2025/12/11/085302

バックアップ日時: 2026年11月11日