システム カタログ › モニタリング アプライアンス › MON： アプリケーション モニタリング アプライアンス

MON： アプリケーション モニタリング アプライアンス

最新バージョン： 3.0.3-1

機能の概要

MON は、アプリケーション内の他のアプライアンスからパフォーマンスおよびリソースの使用状況統計（つまりカウンタ）を収集するアプリケーション モニタリング アプライアンスです。 アプライアンスは、mon 端子を通じて MON にそのカウンタをレポートします。

MON は、アプライアンス カウンタにアクセスして表示できるように、Web ブラウザを使用して、視覚的なインターフェースを提供します。 視覚的なインターフェースを介して、ユーザは、1 つ以上のグラフが含まれているビューを作成します。 それぞれのグラフに、1 つ以上のアプライアンス カウンタが表示されます。 視覚的なインターフェースには、以下の方法でアクセスできます。

• CA 3Tera AppLogic GUI
  • ダッシュボードの［アプリケーション］タブの下にある［モニタ］ボタン
  • アプリケーション エディタのツールバーにあるモニタ アイコン
• MON の Web 端子に接続されたゲートウェイ（つまり、IN または INSSLR ゲートウェイ）

視覚的なインターフェースのアクセスおよび使用の詳細については、「ユーザ インターフェース リファレンス ガイド」を参照してください。

MON は、アプライアンス カウンタのバックグラウンド モニタリングもサポートします。 単一のビュー内のカウンタはすべて、alarm_view プロパティによって指定されているとおりに、MON によってバックグラウンドでモニタされます。 これらのいずれかのカウンタが指定されたしきい値を下回るか超えると、MON は、CA 3Tera AppLogic グリッド コントローラにアラームを生成します。ダッシュボードにメッセージがポストされます。 アプライアンス カウンタをバックグラウンドでモニタする場合は、MON の視覚的なインターフェースに使用するブラウザを開く必要はありません。

境界

リソース

端子

デフォルト インターフェースは有効です。 デフォルト インターフェースは、正常に起動したことを CA 3Tera AppLogic にレポートするためにアプライアンスによって使用されます。 また、主に診断およびトラブルシューティングの目的で、CA 3Tera AppLogic コントローラから、安全なシェルを通じてアプライアンスにログインするときに使用することもできます。 デフォルト インターフェースは、MON アプライアンスの視覚的なインターフェースにアクセスするために、CA 3Tera AppLogic GUI によって使用されます。

ユーザ ボリューム

プロパティ

エラー メッセージ

アプライアンスが起動に失敗すると、以下のメッセージが、アプライアンス ログ ファイルまたはグリッド コントローラのシステム ログに表示される場合があります。

• データ ボリュームをマウントできませんでした

httpd は開始されませんでした

カウンタ グループおよびカウンタ

以下のカウンタ グループがすべてのアプライアンス用に定義されます。

• CPU サマリ
• CPU n （CPU の数が 2 以上の場合のみ。それ以外の場合は、そのようなグループなし）
• スケジューラ
• メモリ統計
• ファイルシステム
• インターフェース名（各インターフェースに 1 つのグループ。端子または Raw インターフェース）
• ボリューム名（クラスとプレースホルダを含むボリュームごとの 1 グループ）

アプライアンスでカスタム カウンタを作成してモニタする方法については、「カスタム カウンタの作成」を参照してください。

典型的な使用状況

CA 3Tera AppLogic GUI によるアプリケーションのモニタリング

以下の図は、シンプルなアプリケーション用の MON の典型的な使用状況を示しています。 このアプリケーションでは、モニタは CA 3Tera AppLogic GUI のみによってアクセスできます。

使用中のアプライアンス：

• in - 入力ゲートウェイ、クラス IN
• srv - Web サーバ、クラス WEB5
• db - データベース サーバ、クラス MYSQL5
• mon - モニタリング アプライアンス、クラス MON

すべてのアプライアンスの mon 端子は、mon の mon 端子に接続されます。

ポート 80 上の CA 3Tera AppLogic GUI および IP アドレスの両方によるアプリケーションのモニタリング

以下の図は、CA 3Tera AppLogic GUI または IP アドレスによってアプリケーション モニタにアクセスするためにどのように MON を使用できるかを示しています。

使用中のアプライアンス：

• usr - 入力ゲートウェイ、クラス IN
• admin - 入力ゲートウェイ、クラス IN
• srv - Web サーバ、クラス WEB5
• db - データベース サーバ、クラス MYSQL5
• mon - モニタリング アプライアンス、クラス MON

すべてのアプライアンスの mon 端子は、mon の mon 端子に接続されます。

admin の out 端子は、mon の web 端子に接続して、ユーザが、admin 上の ip_addr プロパティによって指定された IP アドレスを使用して、モニタにアクセスできるようにします。

ポート 8080 上の CA 3Tera AppLogic GUI およびアプリケーション IP アドレスの両方によるアプリケーションのモニタリング

以下の図は、ポート 8080 上の CA 3Tera AppLogic GUI またはアプリケーション IP アドレスによってアプリケーション モニタにアクセスするためにどのように MON を使用できるかを示しています。

使用中のアプライアンス：

• INSSLR - 入力ゲートウェイ、クラス INSSLR
• WEBx8 - Web サーバ アセンブリ、クラス WEBx8
• MYSQL - データベース サーバ、クラス MYSQL5
• NAS - ストレージ アプライアンス、クラス NAS
• PS8 - ポート スイッチ、クラス PS8
• mail - メール サーバ、クラス MAIL
• NET - 出力ゲートウェイ、クラス NET
• mon - モニタリング アプライアンス、クラス MON

すべてのアプライアンスの mon 端子は、mon の mon 端子に接続されます。

INSSLR は、WEBx8 に https トラフィックを転送し、aux 端子に他のすべての TCP トラフィックを転送するように設定されます。 PS8 は、ポート 8080 上のすべてのトラフィックを、out8 を通じて mon の web 端子に転送するように設定されます。 これにより、ユーザは、ポート 8080 上の INSSLR にある ip_addr プロパティによって指定されたアプリケーション IP アドレスを使用して、アプリケーションをモニタできます。

注： MAIL アプライアンスは、CA 3Tera AppLogic では配布されていません。

バックグラウンド モニタリング

このユーザ ケースでは、MON を使用して、アプライアンス カウンタをバックグラウンドでモニタし、アプライアンス カウンタが範囲外になったときにアラートを生成する方法について説明します。

1. MON 上の alarm_view プロパティを、モニタするカウンタが含まれているビューの名前に設定します。
2. アプリケーションを再起動します。
3. アプリケーション モニタにログインします。
4. ［新規］ボタンをクリックして新しいビューを作成し、そのビューに alarm_view プロパティと同じ名前を付けます。
5. ［グラフの追加］ボタンをクリックして新しいグラフを作成し、ビューに追加します。
6. モニタするカウンタを選択して、グラフに追加します。
7. ［アラーム］の隣の 2 つのボックスに入力して、アラームしきい値を設定します。
   最小しきい値を設定するには、左のテキスト ボックス内に値を入力します。 このテキスト ボックスを空のままにした場合、最小しきい値は設定されません。
   最大しきい値を設定するには、右のテキスト ボックス内に値を入力します。 このテキスト ボックスを空のままにした場合、最大しきい値は設定されません。
8. 追加のアプライアンス カウンタをモニタするには、手順 5～7 を繰り返します。

アプライアンス カウンタが、指定されたしきい値を下回るか超えると、MON は、CA 3Tera AppLogic コントローラにアラートを生成します。 メッセージは、ダッシュボードにログ記録されて、どのアプライアンスのどのカウンタが範囲外かを示します。 アプライアンスごとに、CA 3Tera AppLogic コントローラは、最後のアラートのみをダッシュボードにログ記録しますが、複数のアラートがアプライアンスに対して受信されているかどうかをダッシュボード メッセージで指定します。 アラートはすべて、CA 3Tera AppLogic コントローラ上の /var/log/messages にログ記録されます。

注： アプリケーション モニタのブラウザは、MON がアプライアンス カウンタをバックグラウンドでモニタするときは開く必要はありません。

特定のアプライアンス カウンタのモニタリングを停止する方法

• カウンタがグラフ上の唯一のカウンタの場合は、グラフを削除します。
• カウンタが複数のカウンタがあるグラフ上のカウンタの場合は、カウンタをグラフから削除します。

バックグラウンド モニタリングを無効にするには、以下のいずれかを実行します。

• MON 上の alarm_view プロパティと異なる名前にビューを変更します。
• ビュー内のグラフをすべて削除します。
• ビューを削除します。
• アプリケーション内の MON アプライアンスを停止します（たとえば、comp stop myapp:main.mon）。

MON 上の alarm_view プロパティをクリアし、MON インスタンス（またはアプリケーション）を再起動します。

データ収集インターフェース

バージョン 1.1.3 以降、MON アプライアンスは REST サービスのようなデータ収集 API を提供しています。XML、JSON および UDL 形式でカウンタ設定および値をエクスポートします。 API の詳細については、「Mon データ収集インターフェース」を参照してください。

注

既知の制限

CA 3Tera AppLogic GUI を使用してアプリケーションをモニタするには、アプリケーション内の MON アプライアンスの名前を mon にする必要があります。

アプライアンス内で使用されるオープン ソース/サードパーティ ソフトウェア

アプライアンス カウンタ

標準アプライアンス カウンタのリスト

概要

このドキュメントでは、CCA によってエクスポートされたすべての標準カウンタのリストを定義します。 CCA は、すべての CA 3Tera AppLogic アプライアンスで実行されるカウンタ コレクション エージェントです。 CCA は MON アプライアンスによって表示されたモニタリング GUI にカウンタをレポートするために使用されます。 これらのカウンタの可用性は、サポートされたアプライアンス プラットフォームによっては制限される場合があります（以下のカウンタ テーブルで説明）。 アプライアンス OS が特定のカウンタをサポートする場合、アプライアンスの mon 出力端子が MON アプライアンスに接続されるときに MON GUI で表示できるようにする必要があります。

CPU サマリ

File System

メモリ統計

スケジューラ

CPU#X

ボリューム X

端子 X

カスタム カウンタ

概要

ccad （カウンタ コレクション エージェント）デーモンを実行するそれぞれのアプライアンスでは、カスタム カウンタを定義して、サードパーティ ユーティリティによって収集できます。 この機能は拡張インターフェースと呼ばれ、標準の MON ユーザ インターフェースによってアプライアンスに固有のカウンタ データをモニタするオプションを、アプライアンス作成者に提供します。

カスタム カウンタの作成

カスタム カウンタをモニタするには、ccad 設定にカウンタ定義を追加して、ccad に実際のカウンタ値を適用する必要があります。

カウンタ定義の追加

オプションの /etc/ccad.conf 設定ファイルでカスタム カウンタを定義する必要があります（UDL 形式）。 設定に変更を加えた場合は、必ず ccad デーモンを再起動して変更を有効にする必要があります。

単純な設定例を以下に示します。

counters Apache
   {
   pace = 1000
   pipe = /tmp/cca
   counter Total_Accesses
      {
      name        = "Total hits"
      desc        = "Total number of hits"
      units       = "#"
      type        = "MAX"
      }
   counter Total_kBytes
      {
      name        = "Total bytes"
      desc        = "Total number of bytes"
      units       = "bytes"
      type        = "MAX"
      }
   counter BusyWorkers
      {
      name        = "Active requests"
      desc        = "Number of active requests"
      units       = "#"
      type        = "MAX"
      }
   counter IdleWorkers
      {
      name        = "Idle servers"
      desc        = "Number of idle servers"
      units       = "#"
      type        = "MAX"
      }
   }

この例では 4 つのカウンタを定義します。 それぞれのカウンタ エンティティは以下の属性をサポートします。

• name - カウンタの人間可読名（デフォルトではカウンタ エンティティ名に設定）
• desc - カウンタの人間可読説明（デフォルトでは空）
• type - カウンタのタイプ（SUM、AVG、MIN、MAX。デフォルトは AVG）
• units - カウンタ値を解釈するための単位（デフォルトは空）
• range_lower - そのカウンタに使用可能な最小値（より小さい値は切り捨て）
• range_upper - そのカウンタに使用可能な最大値（より大きい値は切り捨て）
• alarm_below - そのカウンタのアラームなし最小値（より小さい値ではアラームをトリガ）
• alarm_above - そのカウンタのアラームなし最大値（より大きい値ではアラームをトリガ）

カウンタが後から MON に表示される場合は、エンティティ名にルートレベルのカウンタのエンティティ名が使用されます。 さらに、以下の属性がこのエンティティで有効になります。

• pace - カスタム カウンタ コレクションのミリ秒単位によるペース（指定されない場合は、1000）
• pipe - コレクションに使用される名前付きパイプへのパス（指定しない場合は、/tmp/cca）

上記のカウンタ定義メソッドに加えて、ccad.conf では、カウンタをグループ化できます。 これを行うには、以下の例のように、グループ エンティティ内に 1 レベル深くカウンタを配置します。

counters Plants
   {
   pace = 2000
   pipe = /my-pipe
   counter tree: desc = "Any tree" , units = "#"
   group Fruits
      {
      desc = "Delicious Fruits!!!"
      counter pears : desc = "Number of pears"   , units = "pears"
      counter apples: desc = "Number of apples"  , units = "apples"
      }
   group Vegetables
      {
      counter potato: desc = "Number of potatoes", units = "potatoes"
      counter tomato: desc = "Number of tomatoes", units = "tomatoes"
      }
   }

この設定は、MON GUI 内に 3 つのカスタム カウンタ エンティティとして、Plants、Delicious Fruits!!!、 、Vegetables が生成されて、5 つの定義済みカウンタが分散されます。 グループは、より制約されたグループ エンティティ名とは正反対の多様なグループ名を定義できる desc 属性（カウンタ エンティティに類似）をサポートします。 カウンタ名は、設定ファイル全体で一意にする必要があります。そうなっていないと重複カウンタ名の影響でカウンタ コレクションを行えなくなります。

カウンタ データの供給

適切なカウンタ定義で ccad を実行したら、実際のカウンタ値を入力する必要があります。 それを行うには、ccad によって作成された名前付きパイプ（/etc/ccad.conf で pipe 属性によって指定、デフォルトは /tmp/cca）にカウンタ値を書き込みます。
正しい形式は次のいずれかです。

counter = value （名前と値は = で区切ります）

counter : value （名前と値は : で区切ります）
カウンタ セットは、フラッシュ（MON に）する必要があります。その場合は、名前付きパイプ内の . またはフォーム フィード文字（¥f）をそれ自体の行に出力します。 カウンタ コレクション スクリプト（Bash 内）は、以下の手順を実行して ccad にカウンタを提供できます。

echo "Total_Accesses = 31" > /tmp/cca
echo "Total_kBytes = 22241" > /tmp/cca
echo "BusyWorkers = 6" > /tmp/cca
echo "IdleWorkers = 34" > /tmp/cca
echo "." > /tmp/cca

これは、/etc/ccad.conf で指定されているとおりに、ミリ秒単位のペースで行う必要があります。

必要なデータを収集して、ccad に提供する単純な bash ループの例を以下に示します。 収集されたすべてのデータを ccad に供給したほうが、ccad に供給する前に解析するよりも速いため、必要以上のデータを供給します（カウンタ値でない行は無視します）。

while true; do
   curl -s http://in/server-status?auto | sed "s/^Total¥ /Total_/g" > /tmp/cca # this parses the data so it matches out counter definitions
   sleep 1 || exit 4        
   echo "." > /tmp/cca

done

例

Windows の例

以下の Windows カスタム カウンタの例では Perl を使用しています。  管理対象 Windows アプライアンスに Perl Win32 パッケージが存在しない場合は、以下の手順でインストールします。

• Cygwin レガシー コマンド ライン インストーラをアプライアンスにコピーします。  インストーラは http://www.cygwin.com/setup-legacy.exe からダウンロードできます。
• バージョン 0.27 の Perl Win32 パッケージをアプライアンスにコピーします（例： c:¥local_cygwin_pkg）。  このパッケージは、いくつかのソースからダウンロードできます。たとえば http://cygwin.basemirror.de/release-legacy/perl/perl-libwin32/perl-libwin32-0.27-1.tar.bz2 などがあります。
• Perl Win32 パッケージをインストールします。  アプライアンスのグラフィック コンソール内のコマンド シェルで、以下を実行します：  setup-legacy.exe -q -n -N -d -R c:¥cygwin -l c:¥local_cygwin_pkg -L

コード例を以下に示します。

#!/bin/perl
use Win32::Pipe;

my $defaultPace=1000;
my $defaultPipe="¥¥¥¥.¥¥pipe¥¥cca";
my $ccadConf="/etc/ccad.conf";

sub get_value_from_config
   {
   open(F, $ccadConf) || die "can't open $ccadConf: $!¥n";
   while(<F>)
      {
      #($name, $value) = split('=');
      my $row=$_;
      $row =~ m/^¥s*(¥w+)¥s*=¥s*(.*)¥s*$/;
      if ($_[0] eq $1)
         {
         close F;
         return $2;
         }
      }
   close F;
   return "";
   }

my $cfgPace = &get_value_from_config("pace");
my $cfgPipe = &get_value_from_config("pipe");
if ($cfgPace eq "") { $cfgPace = $defaultPace; }
if ($cfgPipe eq "") { $cfgPipe = $defaultPipe; }
else { $cfgPipe = "¥¥¥¥.¥¥pipe¥¥".$cfgPipe; }

my $pipe;
$pipe = new Win32::Pipe($cfgPipe) || die "can't connect to pipe¥n";
$pipe->ResizeBuffer(4096);

# this loop feeds a counter named Test with a value which increments on each iteration
my $val = 0;
while (1)
  {
   $val ++;
   my $str = "Test = $val¥n.";
   $pipe->Write( $str );
   sleep( $cfgPace / 1000 );
   }

Linux の例

Apache

注： サーバでは、「拡張ステータス」を有効にする必要があります。

#!/bin/bash

DEFAULT_PACE=1000
DEFAULT_PIPE=/tmp/cca
CCAD_CONF=/etc/ccad.conf
STATUS_URL='http://in/server-status?auto'
CURL=/usr/bin/curl
SED=/bin/sed
SLEEP=/bin/sleep
function get_value_from_config {
   CONF_VALUE=`grep -oE "$1[[:space:]]*=[[:space:]]*[^[:space:]]+" $CCAD_CONF |cut -d"=" -f 2|tr -d " "`
}
get_value_from_config "pace"
PACE=${CONF_VALUE:-$DEFAULT_PACE}
PACE=$(( $PACE / 1000 ))
get_value_from_config "pipe"
PIPE=${CONF_VALUE:-$DEFAULT_PIPE}
test -p $PIPE || exit 3
while true; do
   $CURL -s "$STATUS_URL" | $SED "s/^Total¥ /Total_/g" > $PIPE
   sleep $PACE || exit 4
   echo "." > $PIPE
done

Mysql

#!/bin/bash

DEFAULT_PACE=1000
DEFAULT_PIPE=/tmp/cca
CCAD_CONF=/etc/ccad.conf
MYSQL='/usr/bin/mysql'
TR=/usr/bin/tr
SLEEP=/bin/sleep
function get_value_from_config {
   CONF_VALUE=`grep -oE "$1[[:space:]]*=[[:space:]]*[^[:space:]]+" $CCAD_CONF |cut -d"=" -f 2|tr -d " "`
}
get_value_from_config "pace"
PACE=${CONF_VALUE:-$DEFAULT_PACE}
PACE=$(( $PACE / 1000 ))
get_value_from_config "pipe"
PIPE=${CONF_VALUE:-$DEFAULT_PIPE}
test -p $PIPE || exit 3
while true; do
   $MYSQL -e 'show status'|$TR '[[:blank:]]' '=' > $PIPE
   $SLEEP $PACE || exit 4
   echo "." > $PIPE
done

カウンタ収集 Web サービス API

モニタリング API 概要

MON アプライアンスは、その aux 出力端子上で接続されたアプライアンスから収集されたカウンタ データおよび設定をエクスポートします。 これは、カスタムの REST ベースのプロトコルを使用して、HTTP 上で実行されます。 このプロトコルは、以下の 3 つのタイプのリソースを定義します。

• アプライアンス
• エンティティ
• カウンタ

これらの各タイプは、それまでのスコープに組み込まれます。 つまり、エンティティはアプライアンスのスコープでのみ意味を持ち、カウンタは特定のエンティティのスコープでのみ意味を持ちます。 データ収集 API を使用すると、MON に認識されるすべてのカウンタの設定および値を取得することができます。

MON では、リクエストされたデータ設定および値を、以下のいずれかの構造化テキスト形式でエクスポートします。

• XML （特定の形式が fmt 引数を通じてリクエストされない場合に主に使用される形式）
• UDL （CA 3Tera AppLogic 内部使用）

JSON （JavaScript 対応のブラウザ クライアント用）

モニタリング API プロトコル

このプロトコルは、読み取り機能のみを提供するので、GET HTTP メソッドのみが使用されます。 したがって、サポートされているすべてのタイプのプロトコルで、リクエストはその URI および出力構造によって定義できます。 文字は URI では「特殊」と認識されるため、標準的な % エンコーディングを使用してエスケープする必要があります。 その出力は XML スキーマによって定義します（主な出力形式は XML です）。 他の出力形式（UDL、JSON）への変換は、それぞれの出力形式の表現構造の方法および属性を直接使用することによって行われます（例： UDL エンティティと XML エンティティ、UDL 属性 と XML 属性、JSON オブジェクトと XML エンティティ、JSON オブジェクト プロパティと XML 属性）。

すべての出力のルート ノードには、タイム スタンプ属性が含まれており、レスポンスが作成された時点のサーバの時間が提供されます。

以下で、サポートされるすべての URL （コール）について説明します。

カウンタ設定コール

/monapi/desc[?fmt=<format>] 

すべての利用可能なアプライアンスのリストを、指定された出力形式で返します（<format> は、xml など既知の出力形式の 1 つです）。

出力：

<response timestamp="1194967464">
   <appliance name="main.web" />
   <appliance name="main.in" />
</response>

/monapi/desc/<apps>[?fmt=<format>] 

リクエストされたアプライアンス（<apps>）に含まれる利用可能なすべてのエンティティのリストを返します。 <apps> には、単一のアプライアンス名、アプライアンス名のカンマ区切りリスト、または利用可能なすべてのアプライアンスを意味するワイルドカード文字（*）を指定できます。

出力：

<response timestamp="1194967464">
   <appliance name="main.web">
      <entity name="Terminal in" />
      <entity name="Terminal out" />
      <entity name="Volume data" />
      <entity name="CPU" />
      <entity name="Memory" />
      <entity name="Network" />
   </appliance>
</response>

/monapi/desc/<apps>/<ents>[?fmt=<format>] 

リクエストされたアプライアンス エンティティ（<ents>）に含まれる利用可能なすべてのカウンタのリストを返します。 <ents> には、単一のエンティティ名、エンティティ名のカンマ区切りリスト、または利用可能なすべてのエンティティを意味するワイルドカード文字（*）を指定できます。 <apps> と同じです。

出力：

<response timestamp="1194967464">
   <appliance name="main.web">
      <entity name="Terminal in">
         <counter name="Sent bytes" />
         <counter name="Received bytes" />
      </entity>
   </appliance>
</response>

/monapi/desc/<apps>/<ents>/<cnts>[?fmt=<format>] 

リクエストされたカウンタ（<cnts>）の説明を返します。 <ents>、<ents>、および <ents> には、単一のアプライアンス/エンティティ/カウンタ、それらのカンマ区切りリスト、またはワイルドカードを指定できます。

出力：

<response timestamp="1194967464">
   <appliance name="main.web">
      <entity name="Terminal in">
         <counter name="Sent bytes" description="" units="" alarm_below="" alarm_above="" range_lower="" range_upper="" pace="" />
         <counter name="Received bytes" description="" units="" alarm_below="" alarm_above="" range_lower="" range_upper="" pace="" />
      </entity>
   </appliance>
</response>

カウンタ値コール

/monapi/val/<apps>/<ents>/<cnts>[?fmt=<format>] 

指定されたカウンタの値を返します。 app、ent、または cnt パラメータのいずれかが省略された場合、ワイルドカード値と見なされます。 したがって、たとえば、/monapi/val/main.web は、「アプライアンス main.web のすべてのエンティティ内の全カウンタの値」を意味します。

出力：

<response timestamp="1194967464">
   <appliance name="main.web">
      <entity name="Terminal in">
         <counter name="Sent bytes" value="23234" />
         <counter name="Received bytes" value="690432" />
      </entity>
   </appliance>
</response>