Soracom

Users

ドキュメント
Home ドキュメント SORACOM Lagoon 2 はじめに

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 は以下のようなコンポーネントで構成されます。

コンポーネント説明
ユーザーコンソールの SORACOM Lagoon 画面

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

Lagoon コンソール

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

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

コンポーネント説明
FolderDashboard を分類して入れておくために利用します。
DashboardPanel を配置するベースになるコンポーネントです。1 つの Dashboard に複数の Panel を配置できます。また、プランによっては、Lagoon コンソールに複数の Dashboard を作成できます。
Panel可視化の最小単位です。様々な可視化の種類 (Bar Gauge、Gauge、Graph など) が用意されています。
AlertAlert 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]) が表示されます。

サイドバー

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

メニューサブメニュー提供する操作
Search dashboardsDashboard を検索します。
Starredお気に入り設定された Dashboard を利用します。
DashboardsBrowseDashboard を一覧表示したり、フォルダを作成したりできます。詳しくは、Dashboard を管理する を参照してください。
PlaylistsPlaylist を管理します。Playlist は、複数の Dashboard をスライドショーのように順番に表示する機能です。
Snapshots (*1)Snapshot を管理します。
Library panelsLibrary panel を管理します。
+New dashboardDashboard を作成します。
+New folderFolder を作成します。
+ImportDashboard をインポートします。詳しくは、以下のページを参照してください。
Exploreデータソース の任意のデータを選択して、一時的に簡単な可視化をする機能です。
Alerting (legacy)Alert RulesAlert を利用します。
Notification channelsNotification Channel を利用します。
---
(アバターアイコン)Sign outLagoon コンソールからのログアウト
Change passwordパスワードを変更します。
Notification historyこれまでに Lagoon コンソールに表示されたエラーや警告を確認します。
PreferencesSORACOM Lagoon コンソールの環境設定を行う (Preferences)
HelpKeyboard shortcutsLagoon コンソールで使用できるショートカットキーが表示されます。
DocumentationSORACOM 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 をまとめたり、非表示にしたりするために利用します。
PanelPanel は Dashboard の構成要素です。グラフ、テーブル、リスト、地図など、データをさまざまな方法で可視化できます。

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

ヘッダー

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

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

Dashboard のお気に入り設定のオン / オフを変更できます。お気に入り設定をオンにした 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 の詳細設定 を参照してください。
(Time range)

Dashboard で表示する時間範囲を設定 できます。

[ (Time range)] が表示されない場合は、[Hide time picker] がオンになっています。詳しくは、Dashboard の詳細設定 を参照してください。

(Time range zoom out)Dashboard で表示する時間範囲を 2 倍に拡大できます。たとえば、10 分間のデータを表示しているときは、中心を変更せずに 20 分間のデータを表示するように時間範囲が拡大されます。
(Refresh dashboard)

Dashboard を更新できます。また、 をクリックすると、自動更新の間隔を選択できます。

更新するたびに Harvest Data のデータエクスポートが発生します

Harvest Data のデータ保持期間延長オプション を有効化している場合は、データエクスポート料金が発生します。自動更新間隔や読み取り量によってはデータエクスポート料金が高額になる可能性があります。詳しくは SORACOM Harvest Data の料金プラン を参照してください。

自動更新の間隔について
  • 自動更新の選択肢 (30s1m5m、...) は、Dashboard の詳細設定 で変更できます。
  • Dashboard を 1 秒ごとに更新することはできません。Dashboard の最短更新間隔は、SORACOM Lagoon のプラン によって異なります。
(Cycle view mode)

View Mode を変更して、サイドバー やヘッダーの表示 / 非表示を切り替えられます。Esc キーを押すと、通常モードに戻ります。

View Modeサイドバーヘッダー
通常モード表示表示
kiosk-tv非表示表示
kiosk非表示非表示

Row

Dashboard の Row は、複数の Panel をまとめたり、表示 / 非表示を切り替えたりするために利用します。 詳しくは、Row を作成する を参照してください。

Panel

Panel は Dashboard の構成要素です。以下の Dashboard の例では、5 つの Panel が配置されています。また、Panel には、グラフ、テーブル、リスト、地図など、様々な 可視化の種類 が用意されています。詳しくは、Panel を作成する を参照してください。