Geckoboard でダッシュボードを作成し、リアルタイムの PingOne のデータ をビジュアライズ
Geckoboard は、主要業績評価指標(KPI)のビジュアライゼーションを簡素化するビジネスインテリジェンスツールで、ライブダッシュボードを作成できます。Salesforce、Snowflake、Google Analytics、スプレッドシートなど、さまざまなソースからデータを統合し、視覚的に魅力的で理解しやすい形式で表示できます。シンプルさと明瞭さを重視して設計された Geckoboard は、企業がパフォーマンスをモニタリングし、目標を追跡し、データドリブンな意思決定を行うのに役立ちます。
CData Connect AI と組み合わせると、Geckoboard からダッシュボード、モニタリング、ビジュアライゼーションなどのためにPingOne のデータへ即座にクラウド間でアクセスできます。この記事では、PingOne に接続し、Geckoboard でPingOne のデータを使用してビジュアライゼーションを作成する方法を説明します。
CData Connect AI は、PingOne 向けのシームレスな SQL Server クラウド間インターフェースを提供し、Geckoboard でリアルタイムのPingOne のデータを使用したダッシュボードとビジュアライゼーションを簡単に作成できます。ビジュアライゼーションを構築する際、Geckoboard は必要なデータを取得するために SQL クエリを必要とします。最適化されたデータ処理を標準で備えており、サポートされているすべての SQL 操作(フィルターや JOIN など)を PingOne に直接プッシュし、サーバーサイド処理を活用してPingOne のデータを高速かつ効率的に取得します。
Geckoboard 用の PingOne 接続を設定
Geckoboard から PingOne への接続は、CData Connect AI によって実現されます。Geckoboard からPingOne のデータを扱うには、まず PingOne 接続を作成・設定します。
- Connect AI にログインし、Sources をクリック、次に Add Connection をクリック
- Add Connection パネルから「PingOne」を選択
-
PingOne に接続するために必要な認証プロパティを入力します。
PingOne に接続するには以下のプロパティを設定します。
- Region:自身のPingOne 組織のデータがホスティングされている地域。
- AuthScheme:PingOne に接続する際に使用する認証の種類。
- WorkerAppEnvironmentId (デフォルトのPingOne ドメインを使用する場合に必要)、またはAuthorizationServerURL のいずれかで、下で説明するように設定します。
WorkerAppEnvironmentId の設定
WorkerAppEnvironmentId は、Worker アプリケーションが存在するPingOne 環境のID です。 このパラメータは、環境がデフォルトのPingOne ドメイン(auth.pingone)を利用している場合のみ使用されます。 これは、ヘルプドキュメントのカスタムOAuth アプリケーションの作成で説明するように、PingOne への認証に使用するカスタムOAuth アプリケーションを作成した後に設定します。
はじめに、このプロパティの値を見つけます。
- 自身のPingOne 組織のホームページからナビゲーションサイドバーに移動し、Environments をクリックします。
- OAuth / Worker のカスタムアプリケーションを作成した環境(通常はAdministrators)を見つけ、Manage Environment をクリックします。 環境のホームページが表示されます。
- 環境のホームページのナビゲーションサイドバーで、Applications をクリックします。
- リストから、OAuth またはWorker アプリケーションの詳細を見つけます。
-
Environment ID フィールドの値をコピーします。
以下の例に似たものになるはずです:
WorkerAppEnvironmentId='11e96fc7-aa4d-4a60-8196-9acf91424eca'
次に、WorkerAppEnvironmentId をEnvironment ID フィールドの値に設定します。
AuthorizationServerURL の設定
AuthorizationServerURL は、お使いのアプリケーションが配置されている環境のPingOne 認可サーバーのベースURL です。 このプロパティは、PingOne プラットフォームAPI ドキュメントで説明されているように、環境にカスタムドメインを設定した場合にのみ使用されます。 Custom Domains を参照してください。
OAuth でのPingOne への認証
PingOne はOAuth とOAuthClient 認証の両方をサポートしています。 上述の設定手順に加え、OAuth またはOAuthCliet 認証をサポートするために、さらに2つの手順を完了する必要があります。
- ヘルプドキュメントのカスタムOAuth アプリケーションの作成で説明するように、カスタムOAuth アプリケーションを作成して設定します。
- ドライバーがデータモデル内のエンティティにアクセスできるようにするには、ヘルプドキュメントのAdministrator Roles での説明のとおり、使用するアドミンユーザー / ワーカーアプリケーションに対して正しいロールを設定していることを確認してください。
- 以下のサブセクションで説明されているように、選択した認証スキームと認証フローに適切なプロパティを設定します。
OAuth(認可コードグラント)
AuthScheme をOAuth に設定します。
デスクトップアプリケーション
OAuth アクセストークンの取得およびリフレッシュ
以下を設定して、接続してください。
- InitiateOAuth:GETANDREFRESH。繰り返しOAuth の交換を行ったり、手動でOAuthAccessToken を設定する必要をなくすには、InitiateOAuth を使用します。
- OAuthClientId:カスタムOAuth アプリケーションを作成した際に取得したClient ID。
- OAuthClientSecret:カスタムOAuth アプリケーションを作成した際に取得したClient Secret。
- CallbackURL:カスタムOAuth アプリケーションの登録時に定義したリダイレクトURI。例:https://localhost:3333
接続すると、CData 製品 はデフォルトブラウザでPingOne のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。 ドライバーはこれでOAuth プロセスを完了します。
- ドライバーはPingOne からアクセストークンを取得し、それを使ってデータをリクエストします。
- OAuth 値はOAuthSettingsLocation で指定された場所に保存され、接続間で永続化されるようにします。
ドライバーはアクセストークンの期限が切れると自動的にリフレッシュします。
Web アプリケーションやヘッドレスマシン、クライアントクレデンシャルグラントを含むその他のOAuth メソッドについては、ヘルプドキュメントを参照してください。
- Save & Test をクリック
-
Add PingOne 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 からPingOne のデータに接続する準備が整いました。
Geckoboard でリアルタイムの PingOne データに接続
以下の手順に従って、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 を入力(例:PingOne1)
- Username:CData Connect AI のユーザー名を入力。CData Connect AI インターフェースの右上に表示されています(例:[email protected])
- Password:Settings ページで生成した PAT を入力
- Connect をクリック
接続の設定が完了したら、PingOne のデータ をクエリ・ビジュアライズできます。
Geckoboard でリアルタイムのPingOne のデータをビジュアライズ
Geckoboard でリアルタイムのPingOne のデータをビジュアライズするには、以下の手順に従ってください:
- Paste your SQL query コンパイラ画面で、ビジュアライゼーションに必要な特定のPingOne のデータを選択する SQL クエリを記述
- ビジネス要件に最適なビジュアライゼーションタイプ(折れ線グラフ、棒グラフ、または縦棒グラフ)を選択
- 選択したチャートが Geckoboard に表示されます
- グラフの右上にあるメニュー(3 つのドット)をクリックし、Edit を選択して SQL クエリを変更したり、チャートの更新間隔を設定したりできます
ユースケースに応じて、CData Connect AI の AI Generator または Query Builder 機能を使用して、必要な SQL クエリを生成することもできます
クラウドアプリケーションから PingOne データへのリアルタイムアクセス
これで、Geckoboard からリアルタイムのPingOne のデータへの直接のクラウド間接続が確立されました。ダッシュボードを作成して、データをシームレスにモニタリング・ビジュアライズできます。
Geckoboard などのクラウドアプリケーションから 100 以上の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスの詳細については、Connect AI ページをご覧ください。