GeckoboardでLinear のデータをダッシュボードに可視化
Geckoboard は、主要業績評価指標（KPI）のビジュアライゼーションを簡素化するビジネスインテリジェンスツールで、ライブダッシュボードを作成できます。Salesforce、Snowflake、Google Analytics、スプレッドシートなど、さまざまなソースからデータを統合し、視覚的に魅力的で理解しやすい形式で表示できます。シンプルさと明瞭さを重視して設計された Geckoboard は、企業がパフォーマンスをモニタリングし、目標を追跡し、データドリブンな意思決定を行うのに役立ちます。
CData Connect AI と組み合わせると、Geckoboard からダッシュボード、モニタリング、ビジュアライゼーションなどのためにLinear のデータへ即座にクラウド間でアクセスできます。この記事では、Linear に接続し、Geckoboard でLinear のデータを使用してビジュアライゼーションを作成する方法を説明します。
CData Connect AI は、Linear 向けのシームレスな SQL Server クラウド間インターフェースを提供し、Geckoboard でリアルタイムのLinear のデータを使用したダッシュボードとビジュアライゼーションを簡単に作成できます。ビジュアライゼーションを構築する際、Geckoboard は必要なデータを取得するために SQL クエリを必要とします。最適化されたデータ処理を標準で備えており、サポートされているすべての SQL 操作（フィルターや JOIN など）を Linear に直接プッシュし、サーバーサイド処理を活用してLinear のデータを高速かつ効率的に取得します。
Geckoboard 用の Linear 接続を設定
Geckoboard から Linear への接続は、CData Connect AI によって実現されます。Geckoboard からLinear のデータを扱うには、まず Linear 接続を作成・設定します。
- Connect AI にログインし、Sources をクリック、次に Add Connection をクリック
- Add Connection パネルから「Linear」を選択
-
Linear に接続するために必要な認証プロパティを入力します。
Linear への認証には、個人用 API キーまたは OAuth 2.0 を使用できます。ご自身の Linear アカウントで接続する場合は、API キーを使うのが最も手軽です。
API キーによる認証
以下の接続プロパティを設定します。
- AuthScheme：APIKey に設定します。
- APIKey：Linear の個人用 API キー。
個人用 API キーを作成するには、Linear にログインして Settings > Security & access > Personal API keys を開き、New API key を選択して作成します。キーは一度しか表示されないため、すぐにコピーしておきましょう。
OAuth による認証
OAuth を使用するには、Linear にカスタム OAuth アプリケーションを登録する必要があります（Settings > API > OAuth applications）。登録すると OAuthClientId と OAuthClientSecret が発行されます。対応しているフローは以下の 2 つです。
- Authorization code：AuthScheme を OAuth、InitiateOAuth を GETANDREFRESH に設定し、OAuthClientId、OAuthClientSecret、およびアプリケーションで定義した CallbackURL（例：http://localhost:33333）を指定します。ドライバーがブラウザで Linear を開くので、アクセスを許可してください。
- Client credentials：AuthScheme を OAuthClient に設定し、OAuthClientId と OAuthClientSecret を指定します。アプリケーション自体を認証するためブラウザ操作は不要で、マシン間（M2M）連携に適しています。
デフォルトでは、ドライバーは read,write スコープをリクエストします。アクセストークンは有効期限が切れると自動で更新されます。
- Save & Test をクリック
-
Add Linear Connection ページで Permissions タブに移動し、ユーザーベースの権限を更新します。
Personal Access Token を追加
REST API、OData API、または仮想 SQL Server 経由で Connect AI に接続する場合、Personal Access Token（PAT）が Connect AI への接続認証に使用されます。アクセスの粒度を維持するため、サービスごとに個別の PAT を作成することをお勧めします。
- Connect AI アプリの右上にある歯車アイコン（）をクリックして Settings ページを開きます。
- Settings ページで Access Tokens セクションに移動し、 Create PAT をクリック。
-
PAT に名前を付けて Create をクリック。
- Personal Access Token は作成時にのみ表示されるので、必ずコピーして安全な場所に保存してください。
接続の設定と PAT の生成が完了したら、Geckoboard からLinear のデータに接続する準備が整いました。
Geckoboard でリアルタイムの Linear データに接続
以下の手順に従って、Geckoboard から CData Connect AI 仮想 SQL Server API への接続を確立します。
- Geckoboard にログイン
- カスタムダッシュボード名を追加し、Add widget をクリック
- Connect your data 検索バーで「Databases」を検索
- Database type として SQL Server を選択
- 接続情報を入力：
- Connection name：CData Connect AI への接続名を入力
- Host：仮想 SQL Server エンドポイントを入力：tds.cdata.com
- Port：14333 を入力
- Database name：接続したい CData Connect AI データソースの Connection Name を入力（例：Linear1）
- Username：CData Connect AI のユーザー名を入力。CData Connect AI インターフェースの右上に表示されています（例：[email protected]）
- Password：Settings ページで生成した PAT を入力
- Connect をクリック
接続の設定が完了したら、Linear のデータ をクエリ・ビジュアライズできます。
Geckoboard でリアルタイムのLinear のデータをビジュアライズ
Geckoboard でリアルタイムのLinear のデータをビジュアライズするには、以下の手順に従ってください：
- Paste your SQL query コンパイラ画面で、ビジュアライゼーションに必要な特定のLinear のデータを選択する SQL クエリを記述
- ビジネス要件に最適なビジュアライゼーションタイプ（折れ線グラフ、棒グラフ、または縦棒グラフ）を選択
- 選択したチャートが Geckoboard に表示されます
- グラフの右上にあるメニュー（3 つのドット）をクリックし、Edit を選択して SQL クエリを変更したり、チャートの更新間隔を設定したりできます
ユースケースに応じて、CData Connect AI の Playground または Query Builder 機能を使用して、必要な SQL クエリを生成することもできます
クラウドアプリケーションから Linear データへのリアルタイムアクセス
これで、Geckoboard からリアルタイムのLinear のデータへの直接のクラウド間接続が確立されました。ダッシュボードを作成して、データをシームレスにモニタリング・ビジュアライズできます。
Geckoboard などのクラウドアプリケーションから 100 以上の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスの詳細については、Connect AI ページをご覧ください。