ウィジェット

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

お使いのプラットフォームが分析のライセンス対象である場合、分析検索の結果をカスタムダッシュボードにも表示できます。詳細については、「Analyticsデータの視覚化」を参照してください。

ウィジェットのタイプ

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

時系列グラフ

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

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

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

円グラフ

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

ゲージウィジェット

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

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

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

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

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

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

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

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

ログテールウィジェット

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

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

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

問題の追跡ウィジェット

問題の追跡ウィジェットには、問題または選択した問題のリストに関する情報が表示されます。表示する詳細、ユーザ、および日付のフィールドを選択できます。追跡対象の問題に対して行われた更新は、ウィジェットに反映されます。

このウィジェットは、AppDynamics を Atlassian JIRA と統合している場合にのみ使用できます。

メトリック値

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

メトリック値の書式を設定して、メトリック値を短縮したり、末尾のゼロを削除したりできます。短縮は100万を超える数値にのみ適用されます。メトリック値は、メトリックが 1 つのダッシュボードでは常に整数であるため、10 進形式は適用されません。 

メトリック式

小数点以下の桁数を設定することで、整数部の 10 進値に加えて 1 未満の小数値を表示できます。小数点以下の桁数がゼロに設定されている場合、末尾のゼロを削除する機能はデフォルトで無効になります。

正常性ステータス

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

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

サークルのビジュアルを使用する場合、その集約タイプを [Ratio Graph] と [Most Severe Status] のどちらかから選択することによって表示を操作できます。

イベントリスト

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

IFrame

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

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

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：一部のウィジェットには、ウィジェットをダブルクリックしたときの結果を定義するオプションがあります。ダブルクリックアクションを、Metric Browserや、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ウィジェット用の追加カテゴリが表示されます。ウォールームのスペースにウィジェットを追加するには、プレゼンターが編集モードである必要があります。編集モードに入るには、[Edit] をクリックします。プレゼンターが作業していて鉛筆アイコンが表示されてない場合、すでに編集モードになっています。1つまたは複数のウィジェットを一度に複製したり、必要に応じてウィジェットを削除したりできます。

新しいウィジェットを構成するには

1. Edit をクリックします。
2. Add Widget をクリックします。ウィジェットパレットが表示されます。
3. パレットでウィジェットをクリックします。構成フォームが構成パネルの左側に表示されます。
4. ウィジェットデータとウィジェットプロパティの両方を構成します。データの構成後、ウィジェットのプレビューが表示されます。さらにプロパティを設定すると、プレビューは更新されます。
5. Save をクリックします。

既存のウィジェットに変更を加えるには

1. Edit をクリックします。
2. ダッシュボードでウィジェットをクリックします。
3. ウィジェットの右上の設定アイコンをクリックします。
4. フォームを使用してウィジェットに変更を加えます。
5. Save をクリックします。