目次 表示
次のステップはサンプルのカスタムレポート(ホストテーブルレポートと対応する Host Service Statistics の円グラフ)を一通り作成する手順を示します。 このステップの必要条件は、 ステップ 1 - 開始 を参照してください。
Eclipse Report Designer で、File、New、Report を選択します。
選択されていなかった場合は、親フォルダとして GWCustomReports を選択します。
次に、File name(例:gw_sample_report)を入力し、Finish をクリックします。
次に、Host Reportのパラメータの追加します。Report Design の画面で、Outline タブをクリックしてReport Parameters, New Parameter の上で右クリックをします。
パラメータ Name to Host を変更します。
Prompt Text (例: Enter Host)を入力します。
Default value に、localhost を設定します(あるいは、動作中の GroundWork Monitor インストレーション)。
その他の設定はそのままにして、OK ボタンをクリックします。
図: レポートパラメータ
Show/Hide レポートデータは色々な異なった情報システムから来ています。レポートを作成する際に重要なステップは、データを提供するシステムに接続できることを確実にすることです。ここではGroundWork Foundation データベースからのデータのアクセス方法を示します。注意: GroundWork ODA Eclipse Plugin のインストールを扱った ステップ1 - 開始 を終了している必要があります。
Report Design の画面で、Outlineタブをクリックし、Data Sources、New Data Source の上で右クリックをします。
GroundWork Data Source を選択して名前 (例:GWFoundationDS)を付け、Next を選択します。
以下の、 GroundWork サーバの URL を入力します(例: http://localhost:8080、あるいは使用している GroundWork Monitor の URL)。Test Connection を選択することによってサーバ接続をテストすることが可能です。
Finish(終了)を選択します。
一般的にデータソースは、有効なレポートに必要とされるものより多くのデータを持っています。このセクションではレポートに必要とされるデータのみを収集するようデータを設定する方法を説明します。
特に、このセクションではレポートに含まれるべきデータであるGroundWork Data Set のセットアップ方法と、Foundation データソースからどのようなデータが問い合わせられるべきかを定義付けるクエリフィルタの作成方法を述べています。まず、新しい Data Set 名(GWHosts)を作成し、続いて GroundWork Foundation Data Source から何のデータが問い合わせられるのかを示すクエリフィルタを作成し、それからそのクエリフィルタ(ホスト)をレポートパラメータに添付します。
最後のステップとしてこのセクションでは、全てのイベントのコンソールレポートを作成するためのレポートキャンバス内に定義されたデータセット(ホストテーブル)を表示させます。
Report Design の画面で、Outline タブをクリックして、Data Sets、New Data Set を右クリックします。
Data Set Name 欄に入力します (例: GWHosts)。
Data Souce 名が以前に作成したものと同じであること(例:GWFoundationDS)を確認して、Next をクリックします。
Report Design の画面で、Outline タブをクリックして、Data Sets、New Data Set を右クリックします。
Data Set Name 欄に入力します (例: GWHosts)。
Data Souce 名が以前に作成したものと同じであること(例:GWFoundationDS)を確認して、Next をクリックします。
アプリケーションタイプとして、デフォルトの System を使用します。Sytem、Nagios、SNMPTrap、Syslog といった
GroundWork Monitor 4つのアプリケーションタイプがあります。
Entity Type のドロップダウンリストから、Host を選択します。
Add をクリックします。
ホストプロパティによって戻ってきたホスト名前をフィルタするために、Property 欄に Host と入力します。
valueの欄を?に変更します。これをレポートパラメータに関連付けます。
Finish をクリックすると、Edit Data Set ダイアログが表示されます。
図: クエリ
下図で示しているように、左側のParameters を選択します。
Host のパラメータを変更すためにEdit をクリックします。
Linked to Report Parameter のドロップダウンボックスをクリックし、先ほど作成した Host レポートパラメータにデータセットパラメータをリンクするためにHost を選択して、
OK ボタンを押下します。
以下のようにクエリが正常に動作していることを確認するために、Preview Resultsをクリックします。
OK ボタンを押下して、Edit Data Set ダイアログを終了します。
図: クエリフィルタをレポートパラメータに添付
ホストレポートを作成するために、アウトラインからGWHosts のデータセットをレポートキャンバスにドラッグします。
定義されたデータセットの全てのカラムを表示するテーブルが自動的に作成されます。
同じサンプルレポートで、標準ページの幅にフィットするようにいくつかのカラムの削除やサイズを調整します。
このレポートに円グラフを追加する際に以下を実行します。
Report Design スクリーンの Outline タブ内で Data Sets、New Data Set で右クリックをします。
Data Set名(例:GWServiceStatistics)を入力します。
Data Soucre が以前作成したもの(例:GWFoundationDS)と同じであることを確認し、Next をクリックします。
このデータセットは、特定のホストのサービス統計情報を得ます。
Entity Type のドロップダウンからSERVICE_STATISTICS を選択します。
Add をクリックします。
HostName プロパティで、Statistics をフィルタするためにProperty をHostName に変更します。
Report Parameter を関連付けるため、Value の欄を?に変更します。
Finishボタンをクリックすると、Edit Data Set ダイアログが表示されます。
注意: これは統計クエリなので、Operator の欄は常に EQ とします。名づけられたパラメータの値を通過させるだけです。
図: クエリフィルタの定義
以下の図のように、左側のParameters を選択します。
HostName のパラメータを変更するために、Edit をクリックします。
Linked to Report Parameter のドロップダウンボックスをクリックし、データセットパラメータを以前に作成した Host のレポートパラメータとリンクするようHost を選択し、
OK ボタンを押下します。
以下で示しているように、 Preview Results をクリックして、クエリが正常に動作していることを確認します。
OK ボタンを押して Edit Data Set ダイアログを終了します。
図: Host Name Parameter
図を作成するために、図を挿入したいレポートキャンバスの中の場所で右クリックをします。Insert オプションが見えない場合は、一度キャンバスの他のエリア(キャンバスの外)にカーソルを持っていき、再度右クリックをします。
Insert Chart を選択すると、New Chart エディタが表示されます。
Pie(円)グラフを選んで、Next ボタンを押下します。
Select Data セクション下で、Use Data Set のラジオボタンをクリックし、以前に作成したGwServiceStatistics データセットを選択します。
Count カラムのタイトルをSlice Size Definition ボックスまでドラッグします。小さなマークが見えたら、マウスを放します。
Name カラムのタイトルをCategory Definition ボックスまでドラッグします。マークが見えたらマウスを放します。
Finish をクリックします。
図: ホスト名の 円グラフ
Report Design のウィンドウから View Report アイコンを選択し、アウトプットを選択します。クエリを元として、Foundation 内の Host 情報の結果を得ることができます。
注意: いくつかの構成設定は、Ecliple/Firefox 表示のレポートエラーを発生させることがあります。以下はこれを防ぐことができます:
/$user/home/.bashrc で以下を設定します。:
MOZILLA_FIVE_HOME=/yourfirefoxinstalltionlocation
export MOZILLA_FIVE_HOME
その次に
Source .bashrc