1 Oracle Stream Analytics Visualizer
Oracle Stream Analytics Visualizerは、Oracle Stream Analyticsアプリケーションの様々な状況において、表示、開発、構成および監視を行うことができるブラウザベースのツールです。Oracle Stream Analyticsサーバーおよびドメインを管理することもできます。
この章の内容は次のとおりです。
1.1 ビジュアライザを使用したタスクの実行
ビジュアライザを使用して様々なタスクを実行できます。
-
Oracle Stream Analyticsドメインの構造の表示
-
セキュリティの管理
-
Oracle Stream Analyticsサーバー・インスタンスの構成
-
アプリケーションのインストール、アンインストール、停止、再開および更新
-
Oracle CQLルールの表示、更新、作成および削除
-
アプリケーションに関連付けられたEPNの表示
-
アプリケーション・パラメータの調整とアプリケーション・ステータスのモニター
-
EPNの中を流れるイベントの記録および再生
-
診断プロファイルの作成によるアプリケーション・ステージの待機時間およびスループットの監視
-
問合せ計画を使用したCQLプロセッサに対する診断の監視および実行
-
HTTPパブリッシュ/サブスクライブ・チャネルおよびデータ・ソースなどのサーバー・ワイド・リソースの管理および作成
-
サーバーおよびアプリケーション・ロギングの動的オン/オフ
-
Oracle Coherenceクラスタおよびサーバー・インスタンスの管理
1.2 ビジュアライザのユーザー・インタフェース
ビジュアライザには多数のメイン・ペインがあります。
図1-1は、NonClusteredServer
という単一サーバー・インスタンスを含むドメインを示します。サーバーには、com.bea.wlevs.dataservices
、cql
、fx
、およびsignalgeneration
という4つのデプロイされたアプリケーションが含まれます。ここで、cql
は、現在開かれているアプリケーションです。右ペインには、ダッシュボードがあります。com.bea.wlevs.dataservices
と呼ばれるアプリケーションは、Oracle Stream Analytics Visualizer自体と関連付けられており、Oracle Stream Analyticsサーバー・インスタンスに常にデプロイされます。詳細は、「アプリケーションの管理」を参照してください。
1.2.1 最上位ペイン
このペインには、最も使用頻度の高いボタンが含まれます。
-
「ホーム」ボタンをクリックすると、メインOracle Stream Analytics Visualizerページに移動します。
-
「セキュリティ」ボタンをクリックすると、セキュリティ・ページに移動します。このページでは、ユーザーおよびユーザー・グループを追加または構成し、ユーザーをアプリケーション・ロールおよびタスク・ロールにマップできます。詳細は、「セキュリティ・タスク」を参照してください。
-
「ダッシュボード」ボタンをクリックすると、実行中のアプリケーションとそのステージのスループットおよび待機時間を監視するパフォーマンス管理画面に移動します。詳細は、「ビジュアライザ・ダッシュボード」を参照してください。
-
「ViewStream」ボタンをクリックすると、構成されたHTTPパブリッシュ/サブスクライブ・チャネル経由でストリーミングされるメッセージを監視できる画面が起動します。詳細は、「ストリーム・ビジュアライザ(ViewStream)パネル」を参照してください。
-
「全画面」ボタンをクリックすると、コンピュータ画面全体にOracle Stream Analytics Visualizerツールが表示され、[Esc]キーを押すと、標準画面に戻ります。
-
「プリファレンス」ボタンをクリックすると、言語や開いているペインの最大数などのユーザー・プリファレンスおよび、開いているペインの最大数を1に制限したり、全画面モードを無効にしたりするアクセシビリティ設定を設定できるページへ移動します。
-
「ヘルプ」ボタンをクリックすると、Oracle Stream Analyticsサーバーによってホストされるタスク指向のオンライン・ヘルプが表示されます。
1.2.2 左ペイン
このペインには、ドメインのドメイン・ツリーが表示され、これには、Oracle Stream Analyticsサーバー・インスタンス、各サーバー・インスタンス内のデプロイされたアプリケーションやサービス、およびドメイン・レベルのセキュリティ構成など、ドメインに含まれるすべてのオブジェクトが含まれます。
ドメイン名は、Oracle Stream Analyticsサーバーのconfig.xml
ファイルのドメイン要素によって決定されます。たとえば、config.xml
ファイルが次のような場合、ドメイン・ツリーはmydomain
という名前になります。
<domain> <name>mydomain</name> </domain>
左ペインの下半分にある「アイテムを開く」ボックスには、現在開いているアイテムが一覧表示されるので、簡単に操作から離れたウィンドウに戻ったり、ウィンドウを閉じたりできます。リフレッシュが必要な開いているパネルは、オープン・アイテムリストで赤い「x」でマークされます。詳細は、「リフレッシュが必要なパネル」を参照してください。
1.2.3 右ペイン
このペインには複数のドキュメント・コンテナが含まれます。複数のドキュメントを開くと、それらは他のドキュメントの上に重なって表示されます。
このペインには、左ペインでクリックしたオブジェクトに関する情報が表示されます。情報の形式はオブジェクトに依存します。たとえば、左ペインのドメイン・ツリーでデプロイされたアプリケーションをクリックすると、右ペインにはアプリケーションに関する一般情報(「全般」タブ)およびアプリケーションのイベント処理ネットワークの各種ビジュアル表示(「イベント処理ネットワーク」タブ)が表示されます。ストリームやプロセッサなどのネットワークの特定のステージをクリックすると、右ペインにはそれらの全般情報と、プロセッサのルールなどステージ固有の情報が表示されます。詳細は、「イベント処理ネットワーク」を参照してください。
リフレッシュが必要な開いているパネルは、パネルのタイトルで赤い「x」でマークされます。詳細は、リフレッシュが必要なパネルを参照してください。
表1-1は、右ペインの右上隅にあるボタンについて説明しています。これらのボタンは、パネルの管理に使用できます。ただし、「開いているパネルの最大数」プリファレンスを1に設定した場合、これらのボタンは表示されません(「ユーザー・プリファレンスの管理」を参照してください)。
表1-1 パネル・コントロール
ボタン | 説明 |
---|---|
![]() |
パネルを最小化します。 |
![]() |
パネルをウィンドウ・サイズに最大化します。 |
![]() |
パネルを最大化します。 |
![]() |
すべてのパネルを閉じます。 |
![]() |
パネルを閉じます。 |
1.2.4 ビジュアライザ・ダッシュボード
図1-2は、Oracle Stream Analytics Visualizerダッシュボードを示し、これは「パフォーマンス管理」画面で、実行中のアプリケーションおよびそのステージのスループットと待機時間、または2つのステージ間のパスを監視するために使用できます。最上位ペインで「ダッシュボード」ボタンをクリックすると、ダッシュボードに移動します。
ダッシュボードには次の2つのメイン・セクションが含まれます。
-
「管理イベント」: ダッシュボードの上部にあるセクションで、受信監視イベントに関する情報および警告メッセージを表示します。「警告」バーをクリックすると、警告メッセージのリストが表示されます。「情報」バーをクリックすると、情報メッセージのリストが表示されます。
-
パフォーマンスの監視: 待機時間およびスループットのグラフで、1つのイベントが指定されたステージまたはEPNのパスを通過するのにかかる時間、または通過するイベント数をそれぞれ表示します。ステージまたはパスは診断プロファイルで定義されます。下部の表には、使用可能な診断プロファイルが一覧表示されます。特定のプロファイルをクリックすると、対応する待機時間およびスループット情報がグラフに表示されます。詳細は、「EPNステージまたはパスのスループットおよび待機時間の監視」を参照してください。
この監視機能の使用方法に関する詳細は、「EPNステージまたはパスのスループットおよび待機時間の監視」を参照してください。
1.2.5 ストリーム・ビジュアライザ(ViewStream)パネル
ViewStreamパネルの主な目的は、ユーザーが所定のHTTPパブリッシュ/サブスクライブ・チャネルへパブリッシュされているイベントを追加作業なしに監視できるようにすることです。これは、アプリケーションのデバッグやEPNに流れ込むイベントの単なる監視に役立ちます。
Oracle Stream Analytics Visualizerの最上位パネルにあるViewStreamボタンをクリックすると、図1-3で示すような「ストリーム・ビジュアライザ」パネルが表示されます。
図1-3 Oracle Stream Analytics Visualizer「ストリーム・ビジュアライザ」(ViewStream)
![図1-3の説明が続きます 図1-3の説明が続きます](img/strvis-sub.png)
「図1-3 Oracle Stream Analytics Visualizer「ストリーム・ビジュアライザ」(ViewStream)」の説明
「パブリッシュ/サブスクライブ・サーバーURL」テキスト・ボックスには、Oracle Stream Analyticsに含まれるHTTPパブリッシュ/サブスクライブ・サーバーURLが表示されます。「クライアントの初期化」ボタンをクリックすると、プロセスが開始されます。このパネルで説明されたオプションを使用して、チャネルへのメッセージのサブスクライブまたはパブリッシュのいずれかを実行できます。
ユーザー/内部チャネルをサブスクライブし、チャネル上にイベントを表示したり、ユーザー/内部チャネルへパブリッシュできます。
詳細は、次を参照してください。
1.2.6 イベント処理ネットワーク
「イベント処理ネットワーク」(EPN)パネルの主な目的は、ユーザーがOracle Stream Analyticsアプリケーション内のステージおよび生成/消費する各種イベント・タイプの全体を表示できるようにすることです。
左ペインでは、「アプリケーション」ノードに移動し、ノードを展開します。アプリケーションを選択し、右ペインでは、「イベント処理ネットワーク」タブをクリックすると、図1-4で示すようにEPNを表示できます。
1.2.7 イベント処理ネットワーク・コンテキスト・メニュー
イベント処理ネットワークの任意のステージを右クリックして、表1-2で説明されているイベント処理ネットワーク・コンテキスト・メニューからオプションを選択できます。
表1-2 イベント処理ネットワーク・コンテキスト・メニュー
オプション | 説明 |
---|---|
|
選択したステージの「全般」タブを開きます。 「ステージの構成の表示および編集」を参照してください。 |
|
選択したステージの「記録」タブを開きます。 「イベントの記録方法」を参照してください。 |
|
選択したステージの「再生」タブを開きます。 「イベントの再生」を参照してください。 |
|
選択したステージのイベントのトレースタブを開きます。 「動的チャネルにおけるイベントのトレース」を参照してください。 |
|
選択したステージの「イベントのインジェクト」タブを開きます。 関連項目: |
1.2.8 リフレッシュが必要なパネル
アプリケーションのアンインストールや再デプロイなどの一部の操作では、開いているパネルをリフレッシュする必要があります。
Oracle Stream Analytics Visualizerがアプリケーションの再デプロイメント通知を受信すると、開いているすべての影響を受けるパネルに伝達し、パネルのタイトルを赤い「x」でマークしてこのパネルが廃止されていることを示します。そのようなパネルをリフレッシュするには、パネルを閉じて、もう一度開きます。
たとえば、図1-5は、再デプロイされたアプリケーションの「イベント処理ネットワーク」タブを示します。
1.3 管理タスク
Oracle Stream Analytics Visualizerを使用して実行できる主な管理タスクを説明します。
内容は次のとおりです。
1.3.1 アプリケーションの管理
Oracle Stream Analytics Visualizerを使用すると、開発しデプロイしたアプリケーション、およびcom.bea.wlevs.dataservices
アプリケーションなど、Oracle Stream Analyticsサーバーによってデプロイされるアプリケーションを監視および構成できます。イベント処理ネットワーク(EPN)、アプリケーション・ライフサイクル、およびOracle CQLルールを監視して構成できます。
詳細は、次を参照してください。
com.bea.wlevs.dataservices
アプリケーション(省略してdataservicesと呼ばれます)は、Oracle Stream Analytics Visualizerの内部にあり、Oracle Stream Analyticsサーバー・インスタンスを起動するたびに自動的にデプロイされます。データサービス・アプリケーションはアンインストールできません。
このアプリケーションの目的は診断モニター・メトリック用のフィルタを提供することです。アプリケーション自身はアダプタ、ストリーム、およびプロセッサで構成されたOracle Stream Analyticsアプリケーションです。
1.3.2 サーバーの管理
Oracle Stream Analytics Visualizerを使用すると、Oracle Stream Analyticsサーバー・インスタンスおよびその提供するサービス(JMXなど)、データ・ソース、Jetty Webサーバー、ワーク・マネージャ、永続イベント・ストア、イベント・タイプ・リポジトリ、HTTPパブリッシュ/サブスクライブ・サーバーおよびログを管理できます。
詳細は、「サーバーおよびドメインのタスク」を参照してください。
1.3.3 セキュリティの管理
Oracle Stream Analytics Visualizerを使用すると、Oracle Stream Analyticsサーバーとアプリケーションのセキュリティ(ユーザー、グループ、ロール、SSLおよびHTTPパブリッシュ/サブスクライブ・サーバーへのアクセスなど)を管理できます。
詳細は、「セキュリティ・タスク」を参照してください。
1.3.4 構成データの更新
Oracle Stream Analyticsサーバー・インスタンスおよびそのデプロイ済アプリケーションの構成の大半は更新できますが、更新できない一部のフィールドがあります。次のルールは、更新できるフィールドを決定します。
-
EPNアセンブリ・ファイルの情報は静的であるため読取り専用です。この種の情報の例としては、EPNのステージやそれらの接続のしくみなどがあります。
-
コンポーネントの構成ファイルの情報は変更可能ですが、一般に追加や削除は行いません。次の項目は、2つの例外を示します。この種の情報の例としては、最大サイズやストリームのスレッドなどがあります。
Oracle Stream Analytics Visualizerウィンドウでフィールドの更新が許可されるとき、「編集」、「保存」、「取消」という3つのボタンが表示されます。「編集」ボタンをクリックすると、フィールドを変更できます。「保存」をクリックすると、サーバーへの変更を確定し、「取消」をクリックするとキャンセルします。
-
プロセッサと関連付けられたOracle CQLルールと、HTTPパブリッシュ/サブスクライブ・サーバーと関連付けられたチャネルは変更可能です。
-
Oracle Stream Analyticsサーバーの構成ファイル(
config.xml
)の大半は読取り専用ですが、一部の情報は変更できます。この種の情報の例には、ワーク・マネージャ、ロギング・サービス、およびHTTPパブリッシュ/サブスクライブ・サーバーのユーザー定義チャネルの構成が含まれます。注意:
HTTPパブリッシュ/サブスクライブ・サーバーの内部チャネルは変更も削除もしないでください。これらの内部チャネルを変更または削除した場合、Oracle Stream Analytics Visualizerは正しく動作しません
サーバー構成は、「編集」、「保存」、および「取消」の3つのボタンも更新します。
注意:
前述のルールは、対象の更新タスクを実行するために必要な認証資格証明を使用してOracle Stream Analytics Visualizerにログインしたと想定しています。
1.4 Oracle Stream Analytics Visualizerの対象ユーザー
Oracle Stream Analytics Visualizerは、重要なサービスを様々なOracle Stream Analyticsユーザーに提供します。
1.4.1 管理者
Oracle Stream Analytics Visualizerを使用してOracle Stream Analyticsサーバー・インスタンスに接続する管理者は、ロール・ベースの認可を使用してアクセス権を取得します。Oracle Stream Analytics Visualizerの使用時に認証が成功したユーザーには、グループ・メンバーシップに基づいてロールが割り当てられ、ユーザーが保持するロールに応じてそれ以降の管理機能へのアクセスが制限されます。匿名ユーザー(認証されていないユーザー)は、Oracle Stream Analytics Visualizerへのアクセス権を持ちません。
管理者が構成ウィザードを使用して新しいドメインを作成する際には、wlevsAdministrators
グループの一部となる管理者ユーザーを入力します。デフォルトでは、この情報はファイルベースのプロバイダ・のファイルストア内に格納されます。パスワードは、SHA-256アルゴリズムを使用してハッシュされます。ドメインが作成されると、管理者はOracle Stream Analytics Visualizerを使用して新規グループを作成し、ロールをグループに割り当てた後、新規ユーザーを作成してユーザーをグループに割り当てます。
詳細は、「ユーザー、グループ、およびロールの管理」を参照してください。
注意:
Oracle Stream Analytics Visualizerのセキュリティ機能は、Oracle Stream Analyticsサーバーに対してセキュリティを有効化している場合のみ機能します。Oracle Stream Analyticsサーバーのセキュリティを無効化する場合は、次のように機能します。
-
Oracle Stream Analytics Visualizerは、デフォルトのユーザー、グループ、およびロールを提供しません。
-
新規ユーザー、グループ、およびロールは作成できません。
-
最初にOracle Stream Analytics Visualizerにアクセスするときのログイン・ページはありますが、ユーザーおよびパスワードに何でも入力できます。
-
匿名のユーザーはOracle Stream Analytics Visualizerにアクセスできます。
1.4.2 開発者
開発者は、Oracle Stream Analytics Visualizerを使用し、サーバー・リソース(データ・ソースなど)を表示したり、イベントの記録および再生を実行したり、待機時間およびスループット統計を有効にすることによって、パフォーマンス問題のトラブルシューティングを実行したりできます。
1.5 各国語サポート
Oracle Stream Analytics Visualizerは、Javaローカリゼーションを監視し、すべての構成ファイルとOracle Stream Analytics Visualizerテキスト・エントリ・フィールドでダブルバイト文字の使用をサポートします。
この項では、ダブルバイト・ロケールでOracle Stream Analytics Visualizerを使用するときの注意事項を説明し、これには「構成ファイルのエンコーディング: UTF-8」が含まれます。
注意:
デフォルトでOracle Stream Analytics Visualizerは英語のリソース・バンドルで出荷されますが、Oracle Stream Analytics Visualizerユーザー・インタフェースで表示されるすべてのテキストが提供されます。
1.6 構成ファイルのエンコーディング: UTF-8
Oracle Stream Analyticsサーバーは、すべての構成XMLファイルをUTF-8エンコーディング方式でエンコードします。このエンコーディングは、すべてのOracle Stream Analytics構成XMLファイルのヘッダーで指定されます。
次の例では、config.xml
ファイルに指定されたエンコーディングを示します。
<?xml version="1.0" encoding="UTF-8"?> <n1:config xsi:schemaLocation="http://www.bea.com/ns/wlevs/config/server wlevs_server_config.xsd" xmlns:n1="http://www.bea.com/ns/wlevs/config/server" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <domain> <name>WLEventServerDomain</name> </domain> <netio> <name>NetIO</name> <port>9002</port> </netio> ... </config>
手動でOracle Stream Analytics構成XMLファイルを編集するとき、必ずファイルをUTF-8エンコーディング方式で保存します。一部のエディタは、構成XMLファイルをencoding
属性に基づいて自動的に正しいエンコーディング方式で保存します。ただし、エディタの中には、正しいエンコーディング方式で自動的に構成XMLファイルを保存しないものもあります。この場合、Oracle Stream Analytics構成XMLファイルを保存するとき、UTF-8エンコーディング方式を選択していることを確認する必要があります。
Oracle Stream Analytics Visualizerテキスト・フィールドにはいずれも、ダブルバイト文字を入力できます。Oracle Stream Analytics VisualizerおよびOracle Stream Analyticsサーバーは、常に適切なUTF-8エンコーディング方式で構成XMLファイルに書き込みを行います。