Related pages:

ウィジェットを使用すると、カスタムダッシュボードまたはウォールームでデータをビジュアルに表現できます。 

このページでは、アプリケーション パフォーマンス モニタリングで使用可能なウィジェットについて説明します。お使いのプラットフォームが Analytics のライセンス対象である場合、Analytics 検索の結果をカスタムダッシュボードにも表示できます。詳細については、「Analyticsデータの視覚化」を参照してください。

ウィジェットのタイプ

カスタムダッシュボードやウォールームで利用可能なウィジェットタイプのほとんどは、数値グラフを扱った経験がある人ならよく知っているものです。このセクションでは、補足説明が必要と思われる特定のウィジェット機能についての情報を提供します。

時系列グラフ

標準の時系列グラフは、時間経過に対して1つ以上の値を直線図、領域図、柱状図、散布図といった様々な形式で表示します。

Java ノードのメトリックを検証するウォールームのウィジェットを構成する場合は、「仮想ウォールーム」で説明されているストリーミング グラフ ウィジェットを使うことを検討してください。ストリーミングウィジェットは標準の時系列ウィジェット（60秒ごと）より頻繁（5秒ごと）に更新されるため、共同作業によるリアルタイムのトラブルシューティングに最適です。

イベントはグラフの下部にある解決時刻によってグループ化されます。Events Overlay を有効化したり、グラフのイベントクエリを構成したりするときに表示するイベントを選択できます。

円グラフ

円グラフまたはドーナツグラフでは、複数の値の全体に対する割合を扇形で表示します。データ系列は、合計すると意味のある形で100%になります。単一のノードまたはティアのCPU Busy + CPU Idle + CPU Stolenがその一例です。

ゲージウィジェット

ゲージウィジェットは、メトリック値を最小値と最大値に対する規模で表示します。これは、ゲージがどれだけ満たされているかと、その色で表されます。

ウィジェットで表示する最小値と最大値を設定できます。最大値を最大許容値か、それに近い値に設定することで、サイトの許容値の範囲内でメトリックに合わせてゲージが構成されるようにします。設定しない場合、デフォルト値が使用されます。

次の表は、ゲージウィジェットの色の解釈についての説明です。

割合カラーステータス
0-10%グリーンOK
10-50%緑から黄色のグラデーションOK trending to WARNING
50-90%黄色から赤のグラデーションWARNING trending to CRITICAL
90-100%赤クリティカル

例えば、次のゲージは、最小値と最大値を特別に構成していない状態で1分間あたりのコール数メトリックを表示しています。現在の値は74 cpmで、この期間の最小値0と最大値148の中間にあたり、警告の範囲に収まります。


最大値を1000に設定した場合、74はOKの範囲に収まるため、ゲージの色が緑に変化します。

ストリーミンググラフウィジェット

ストリーミンググラフウィジェットは、視覚的には時系列グラフに似ていますが、時系列グラフが60秒ごとに更新されるのに対して、ストリーミンググラフウィジェットは5秒ごとに更新されます。

Java ノードに限り、ウォールームはストリーミング グラフ ウィジェットに対応します。このウィジェットには、単一の指定されたノードとJavaノードのデータのみが表示されます。この機能は、他のエージェントには対応していません。複数のノードのストリーミングデータを表示するには、複数のウィジェットを作成する必要があります。

ログテールウィジェット

ウォールームは、ログファイルまたはその一部を共有するためにJavaノード限定で使用されるログテールウィジェットに対応します。

ログテールウィジェットは、Path プロパティで指定されたファイルの内容を表示します。Path は、選択したノードが実行されているマシン上のログファイルへの絶対パスです。ウィジェットのプロパティで正規表現を指定した場合、ウィジェットには、その正規表現に一致するログファイル内の行のみが表示されます。正規表現が指定されない場合、ウィジェットにはログファイル全体が表示されます。正規表現フィルタを適用しても、フィルタを指定した後に表示される行しか調整されないことに注意してください。それより前の行は、それまでのルールに基づいてフィルタ処理されたままになります。ウィジェットでは、正規表現に Java の表記法が使用されます。

リクエスト中にログファイルがロールオーバーした場合、ログテールリクエストへの応答は未定義です。

メトリック値

選択したメトリックの名前、時間範囲、または関数の名前を追加する書式文字列に加えて、ウィジェットのタイトルを指定できます。または、独立したラベルウィジェットを使用してメトリック値を説明することができます。

メトリック値の書式を設定して、メトリック値を短縮したり、小数点以下の桁数を設定したり、末尾のゼロを削除したりできます。短縮は100万を超える数値にのみ適用されます。小数点以下の桁数を設定することで、整数部の 10 進値に加えて 1 未満の小数値を表示できます。小数点以下の桁数がゼロに設定されている場合、末尾のゼロを削除する機能はデフォルトで無効になります。

正常性ステータス

これは、アプリケーション、ビジネストランザクション、ティア、ノード、データベース、サーバー、正常性ルールなどのエンティティの正常性ステータスの正常性バー、フィルタを適用したテーブル、またはステータスライトサークルです。正常性を表示するエンティティタイプを選択した後、スコープを絞り込むか、そのまますべて表示するかを選択できます。

重要な注意点として、エンティティとしてティアを選択する場合、正常性ステータスの色はティアに設定されているすべての正常性ルールのステータスによって異なります。たとえば、ティアに4つの正常性ルールがある場合、ウィジェットの色はそれらのステータスすべてを1つにまとめたものを反映します。ウィジェットでは、正常は緑、警告は黄色、重大ステータスは赤で表示されます。警告と重大の正常性ステータスを定義するメトリックの設定方法については、「正常性ルールの構成」の「正常性ルールの条件の構成」を参照してください。

サークルのビジュアルを使用する場合、その集合タイプを比率グラフと最も重大なステータスのどちらかから選択することによって表示を操作できます。

イベントリスト

指定された時間範囲内に発生したイベントのフィルタされた表です。

IFrame

複数のオペレータがそれぞれ特定のダッシュボードを担当していて、それらのダッシュボードを管理用のマスターダッシュボードに集約したい場合、共有カスタムダッシュボードを別のカスタムダッシュボードに含めることができます。

別のダッシュボードまたは別の Web サイトからの情報をこのカスタムダッシュボード内に表示するには、URL が必要です。次をクリックして、画面の URL を取得できます。 Settings > Copy a link to this screen to the clipboard.

iframeウィジェットはサンドボックス化されます。フォームやJavaScriptなどの高度なHTML機能はiframeウィジェットでは機能しません。

ウィジェットデータ

時系列グラフなどの一部のウィジェットは、単一の値も複数の値も表示できます。ドーナツグラフなど、複数の値を表示しないと意味をなさないウィジェットもあります。さらに、ゲージやメトリック値など、単一の値しか表示しないものもあります。

単一のエンティティに対するメトリック値の関数の指定

ウィジェットに表示されるデータを指定するとき、Add Seriesウィンドウのプルダウンメニューを使用して、値のどの関数を表示するかを選択します。

  • Minimum：最小値。平均化されたメトリックにのみ使用可能
  • Maximum：最大値。平均化されたメトリックにのみ使用可能
  • Value：時間範囲内の平均または合計（どちらが含まれるかはメトリックによって異なる）
  • Sum：時間範囲内のメトリックの総計値
  • Count：時間範囲内に観測された値のカウント
  • Current：含まれているすべてのノードにわたる最新 1 分間のメトリックデータ値の合計

メトリック式を使用してメトリックを指定することもできます。動作は、正常性ルールの式を使用する場合と同様です。メトリック表現の使用方法の詳細については、正常性ルールを表す式の作成方法を参照してください。

ダッシュボードウィジェットのメトリック式は現在、1未満の分数または浮動小数点定数を正しく処理できません。これらのメトリックは0として扱われます。これらは、1より大きい分数または浮動小数点値である場合は正しく機能します。

複数のエンティティでワイルドカードを使用してメトリックを指定する

ワイルドカードを使用すると、メトリック階層内の以下のブランチのメトリックを、複数の類似エンティティをまたいで評価するメトリックを指定できます。

  • Hardware Resource
  • JVM
  • CLR
  • Custom Metrics

その実行方法については、「メトリック定義でのワイルドカードの使用」を参照してください。

空のデータ系列

特定のメトリックで、指定された時間範囲内のデータが入手できない一方、他の時間範囲については有効なデータがレポートされる可能性があります。この場合、空のデータ系列のラベルが凡例に表示されますが、データは表示されません。たとえば、時系列グラフに線がない状態や、円グラフに扇形がない状態が発生します。

単一エンティティに対するJMXインスタンス数またはノード数の制限の有効化

アカウントレベルの構成を使用して、ウィジェットデータを返す間に1つのアプリケーションでインストゥルメント化される多数のJMXインスタンスまたはノードに対するダッシュボード/ウィジェットの制限を有効化できます。これには、ビジネストランザクション、エラー、サーバー、バックエンドデータのしきい値チェックも含まれます。これはウィジェットの Type of Nodes メニューで JMX タイプのメトリックに適用されます。ノード数がしきい値を超えると All Nodes in the Application オプションが無効になります。いずれかのしきい値の数値をバックエンドで超過した場合、エラーが返されます。これは停止を防ぐために役立ちます。

ウィジェットのプロパティ

ウィジェットのプロパティは、ウィジェットのタイプによって若干異なります。

構成フォームにあるウィジェットのプロパティは、一目瞭然のわかりやすいものが大半です。次のリストでは、一部のわかりにくいプロパティについて説明します。

  • Metric Display Name:  ：ウィジェットでのメトリックの表示名を選択できます。以下の置換変数を1つ以上指定して、メトリックの表示名を決定します。
    • ${#}：ロールアップ値によるソートに基づき表示されるメトリックの数。
    • ${m}：メトリック名。
    • ${e}： エンティティ名。

例えば、${m}を指定した場合、ウィジェットには完全なメトリック名が表示されます。

  • Static Thresholds: ：グラフウィジェットに対して、特定の値を持つ静的しきい値を作成できます。  グラフウィジェットに対して、特定の値を持つ静的しきい値を作成できます。  
  • Double click action：一部のウィジェットには、ウィジェットをダブルクリックしたときの結果を定義するオプションがあります。ダブルクリックアクションを、メトリックブラウザを開いたり、Drilldown URL 値で指定された URL を開くよう構成することができます。
  • Drilldown URL：Drilldown URL では、ウィジェットをダブルクリックしたときにウィジェットで開く AppDynamics ウィンドウの URL を指定します。たとえば、リクエストの遅延が増加したときにその原因を調査する場合、ウィジェットをダブルクリックすることでダッシュボードからすべてのティアのApp Servers Listにジャンプするよう設定できます。特定の画面の URL を取得するには、Settings > Copy a link to this screen to the clipboard をクリックします。
  • Time Range：ウィジェットでは、グローバルまたはダッシュボードの時間範囲、あるいはウィジェットに固有の時間範囲を使用できます。ウィジェット固有の時間範囲を選んだ場合は、プルダウンメニューからウィジェットの時間範囲を選択します。
  • Events Overlay：グラフウィジェットでオーバーレイする特定のイベントを構成して、特定のイベントとパフォーマンスの相関性を示すことができます。Show Events チェックボックスにチェックを入れ、オーバーレイされるイベントを定義するクエリを作成します。

ウィジェットの構成

編集モードでは、ウィジェットパレットを使用してウィジェットをセットアップまたは変更します。

ウォールームのウィジェットを構成する場合、Streaming Dataウィジェット用の追加カテゴリが表示されます。ウォールームのスペースにウィジェットを追加するには、プレゼンターが編集モードである必要があります。編集モードを開始するには、常に表示されている編集トグルボタンをクリックします。プレゼンターが作業していて鉛筆アイコンが表示されてない場合、すでに編集モードになっています。1つまたは複数のウィジェットを一度に複製したり、必要に応じてウィジェットを削除したりできます。

新しいウィジェットを構成するには
  1. Edit をクリックします。
  2. Add Widget をクリックします。ウィジェットパレットが表示されます。
  3. パレットでウィジェットをクリックします。
    構成フォームが構成ウィンドウの左側に表示されます。
  4. ウィジェットデータとウィジェットプロパティの両方を構成します。
    データの構成後、ウィジェットのプレビューが表示されます。さらにプロパティを設定すると、プレビューは更新されます。
  5. Save をクリックします。
既存のウィジェットに変更を加えるには
  1. Edit をクリックします。
  2. ダッシュボードでウィジェットをクリックします。
  3. ウィジェットの右上の設定アイコンをクリックします。
  4. フォームを使用してウィジェットに変更を加えます。
  5. Save をクリックします。