SORACOM Lagoon を構成するコンポーネント

バージョンに関する注意

ここでは、Lagoon 2 (旧バージョンの Lagoon) について説明しています。最新バージョンの Lagoon 3 については、Lagoon 3 のドキュメントを参照してください。
Lagoon 2 は 2024 年 5 月 31 日に終了します。Lagoon 2 が終了するまでに Lagoon 3 へ移行してください。Lagoon 3 への移行方法は、Lagoon 2 から Lagoon 3 に移行するを参照してください。Lagoon 2 終了後は、Dashboard が閲覧できません。また、Alert も停止します。
各バージョンに関する情報は、SORACOM Lagoon 2 と SORACOM Lagoon 3 の違いを参照してください。
Lagoon 2 の新規契約はできません。
Lagoon Classic の提供は終了しました。

SORACOM Lagoon は以下のようなコンポーネントで構成されます。

コンポーネント

説明

Lagoon ユーザーを管理したり、プランやライセンスパックを管理したりできます。

Dashboard やアラートを設定するサービスを、Lagoon コンソールと呼びます。Lagoon コンソールには、Lagoon ユーザーのメールアドレス / パスワードでログインします。詳しくは、SORACOM Lagoon コンソールにログイン / ログアウトするを参照してください。

Lagoon コンソールの主なコンポーネントは以下のとおりです。

コンポーネント	説明
Folder	Dashboard を分類して入れておくために利用します。
Dashboard	Panel を配置するベースになるコンポーネントです。1 つの Dashboard に複数の Panel を配置できます。また、プランによっては、Lagoon コンソールに複数の Dashboard を作成できます。
Panel	可視化の最小単位です。様々な可視化の種類 (Bar Gauge、Gauge、Graph など) が用意されています。
Alert	Alert Rule (ルール) にもとづいて Notification Channel (通知先) へ通知する機能です。

Lagoon コンソールは、OSS の Grafana 9 をベースとしています。

Lagoon ユーザー

Lagoon ユーザーは、Lagoon コンソールへログインし、Dashboard を編集 / 閲覧できるユーザーです。詳しくは、Lagoon ユーザーを参照してください。

Lagoon ユーザーは、ユーザーコンソールにログインできるルートユーザーや SAM ユーザーとは異なります。
編集可能な Lagoon ユーザーと、読み取り専用の Lagoon ユーザーを作成できます。
Pro プランでは、Dashboard ごとにユーザーの権限を設定できます。詳しくは、Pro プランで Dashboard の権限を管理するを参照してください。

作成できる Dashboard / Alert / Lagoon ユーザーの数はプランによって異なります。詳しくは SORACOM Lagoon のプランを参照してください。

ユーザーコンソールの SORACOM Lagoon 画面

Lagoon ユーザーを管理したり、プランやライセンスパックを管理したりできます。

ユーザーコンソールにログインして、[メニュー] → [データ収集・蓄積・可視化] → [SORACOM Lagoon] の順にタップすると、SORACOM Lagoon 画面が表示されます。

Lagoon コンソール

Lagoon では、(SORACOM ユーザーコンソールとは別の) Lagoon コンソールにログインして、Dashboard を作成してデータを確認します。ここでは、Lagoon コンソールの概要を説明します。

ホーム画面 (Home Dashboard)

Lagoon コンソールにログインすると、ホーム画面が表示されます。デフォルトのホーム画面 (Default) では、お気に入り設定された Dashboard ([Starred dashboards]) や最近表示した Dashboard ([Recently viewed dashboards]) が表示されます。

ホーム画面は、任意の Dashboard に変更できます。詳しくは、SORACOM Lagoon コンソールの環境設定を行う (Preferences) を参照してください。
デフォルトのホーム画面 (Default) を編集して、上書き保存することはできません。

サイドバー

サイドバーからは以下のような操作ができます。

メニュー	サブメニュー	提供する操作
Search dashboards		Dashboard を検索します。
Starred		お気に入り設定された Dashboard を利用します。
Dashboards	Browse	Dashboard を一覧表示したり、フォルダを作成したりできます。詳しくは、Dashboard を管理するを参照してください。
	Playlists	Playlist を管理します。Playlist は、複数の Dashboard をスライドショーのように順番に表示する機能です。
	Snapshots (*1)	Snapshot を管理します。
	Library panels	Library panel を管理します。
	＋New dashboard	Dashboard を作成します。
	＋New folder	Folder を作成します。
	＋Import	Dashboard をインポートします。詳しくは、以下のページを参照してください。 JSON 形式で他のユーザーと共有するテンプレートを使用して Dashboard を作成する
Explore		データソースの任意のデータを選択して、一時的に簡単な可視化をする機能です。
Alerting (legacy)	Alert Rules	Alert を利用します。
	Notification channels	Notification Channel を利用します。
-	-	-
(アバターアイコン)	Sign out	Lagoon コンソールからのログアウト
	Change password	パスワードを変更します。
	Notification history	これまでに Lagoon コンソールに表示されたエラーや警告を確認します。
	Preferences	SORACOM Lagoon コンソールの環境設定を行う (Preferences)
Help	Keyboard shortcuts	Lagoon コンソールで使用できるショートカットキーが表示されます。
	Documentation	SORACOM Developers (English) の SORACOM Lagoon ドキュメントが表示されます。
	User Console	ユーザーコンソールが表示されます。

(*1) Pro プランでのみ利用できます。

Folder

Folder は、Dashboard を分類して入れておくために利用します。詳しくは、Dashboard を管理するを参照してください。

ホーム画面で、[ Dashboards] → [Browse] の順にクリックすると、Folder と Dashboard を確認できます。

Dashboard

Dashboard は、Panel を配置するベースになるコンポーネントです。1 つの Dashboard に複数の Panel を配置できます。また、ほかの Lagoon ユーザーや任意の第三者と共有できます。Pro プランでは、Dashboard ごとに権限を設定できます。

ホーム画面で、[ Dashboards] → [Browse] → Dashboard の順にクリックすると、Dashboard を確認できます。

構成要素	役割
ヘッダー	Dashboard を操作するためのアイコンが表示されます。
Row	複数の Panel をまとめたり、非表示にしたりするために利用します。
Panel	Panel は Dashboard の構成要素です。グラフ、テーブル、リスト、地図など、データをさまざまな方法で可視化できます。

サイドバーについては、サイドバーを参照してください。

ヘッダー

Dashboard のヘッダーでは以下の操作ができます。

項目説明

フォルダ / Dashboard 名現在の Dashboard が保存されているフォルダと、Dashboard の名前が表示されます。クリックすると、ほかのフォルダに保存されている Dashboard を選択できます。

(Make as favorite)

Dashboard のお気に入り設定のオン / オフを変更できます。お気に入り設定をオンにした Dashboard は、以下の場所に表示されます。

Dashboard list の [Starred dashboards]
Lagoon コンソールの環境設定 (Preferences) の [Home Dashboard]

(Share dashboard or panel)

Dashboard を共有できます。クリックすると、Share 画面が表示されます。

タブ	操作
[Link]	Dashboard の URL を共有できます。詳しくは、Lagoon ユーザーに Dashboard の URL を共有するを参照してください。
[Snapshot]	Snapshot を共有できます。
[Export]	Dashboard をエクスポートして、ほかの SORACOM アカウント (オペレーター) の Lagoon ユーザーと共有できます。詳しくは、JSON 形式で他のユーザーと共有するを参照してください。

(Add panel) Panel または Row を作成できます。

(Save dashboard) Dashboard を保存できます。

(Dashboard settings) Dashboard の名前を変更したり、Tag を設定したりできます。詳しくは、Dashboard の詳細設定を参照してください。