本文へスキップ

設定

WhaTapプロジェクトから任意の収集データをアップロードできます。Focusは、プロジェクトの基本エージェントがインストールされていなくても使用できます。

プロジェクトアクセスキーと収集サーバーのIP確認

選択したプロジェクトの管理 > エージェントインストール メニューからプロジェクトコード収集サーバーIPプロジェクトアクセスキーを確認します。

SH
export WHATAP_LICENSE=xxxx-xxxxxx-xxxxxx
export WHATAP_HOST=xxxx.xxxx.xxxx
export WHATAP_PCODE=xxx

フィルターに特定のタグを追加

ユーザーは、フィルターで利用する特定の文字列をタグとして設定できます。設定により、WhaTapモニタリングサービス画面で収集されたデータをそのタグの名前と値でフィルタリングできます。

SH
# -tag.[ユーザータグのキー名][空白][ユーザータグの値]

./focus -license $WHATAP_LICENSE \
-pcode $WHATAP_PCODE -server.host $WHATAP_HOST \
-tag.CustomTagName CustomTagValue \
-tag.MyServer1 server_01 \
...

通知を送信する

ユーザーのカスタム通知を直ぐに送信できます。通知を送信すると、Focusは終了します。

SH
#通知の重大度を選択します。
level={info|warn|fatal}
#通知のタイトル
title=必要な通知のタイトル
#通知の本文
message=目的の通知の本文
./focus -license $WHATAP_LICENSE \
-pcode $WHATAP_PCODE -server.host $WHATAP_HOST \
-alert -level $level -title $title -message $message

SQL Query結果の収集

ユーザー定義SQL Queryの実行結果を時系列で無期限に収集します。

SH
#メトリクスカテゴリ
category=my_category
#データベースドライバー
driver={mysql|postgres}
#データベース接続情報
dburl="ID:パスワード@tcp(IP:ポート番号)/データベース"
#Sql Query
sqlquery="select some, columns from sometable"
./focus -license $WHATAP_LICENSE \
-category $category \
-pcode $WHATAP_PCODE -server.host $WHATAP_HOST \
-rdb $driver -rdb.connect $dburl \
-rdb.sql $sqlquery

ログファイルキーワードマッチングログの収集

指定したテキストログファイルでログが発生する場合、キーワードを含めると、対応するログラインが収集されます。

SH
#メトリクスカテゴリ
category=my_category
#ログファイル
LOG_FILE=ログファイルパス
#2つ以上のログキーワードを入力する際にキーワード間で使用する区切り文字
LOG_KEYWORDS_SEPERATOR=,
#ログキーワードを「,」でつないで入力
LOG_KEYWORDS=keyword1,keyword2
./focus -license $WHATAP_LICENSE \
-category $category \
-pcode $WHATAP_PCODE -server.host $WHATAP_HOST \
-tail $LOG_FILE \
-tail.keys $LOG_KEYWORDS \
-tail.seperator $LOG_KEYWORDS_SEPERATOR

WhaTapログ分析サービス

指定したテキストログファイルでログが発生した場合、WhaTapログ分析サービスにリアルタイムでアップロードします。

SH
#カテゴリ
category=my_category
#ログファイルwildcard(*)、日付パターン(http://strftime.org)を含む
LOG_FILE=ログファイルパス
./focus -license $WHATAP_LICENSE \
-category $category \
-pcode $WHATAP_PCODE -server.host $WHATAP_HOST \
-logsink $LOG_FILE

OSリソースの使用量の収集

Focusが実行しているサーバーのリソース使用量を収集します。

Linux Shell
#メトリクスカテゴリ
category=my_category
#ディスクモニタリングが有効かどうか
diskenabled=true|false
#モニタリングするディスクマウント
diskmount=/mypartition
#NICモニタリングが有効かどうか
nicenabled=true|false
#モニタリングするNIC
nic=eth0

./focus -license $WHATAP_LICENSE \
-category $category \
-pcode $WHATAP_PCODE -server.host $WHATAP_HOST \
-sys \
-sys.disk.enabled $diskenabled \
-sys.disk $diskmount \
-sys.net.enabled $nicenabled \
-sys.net $nic

ランダムなプログラムとスクリプトの実行結果の収集

任意のプログラムおよびスクリプトを実行し、stdoutで出力される結果を継続的に収集します。WhaTap Focusはjson dictionary形式で、stdinとして入力されると、dictionaryのkey、valueを収集します。入力手段としてパイプを使用するので、バッファリングを無効にする必要があります。

ノート
  • 継続的に収集するのではなく、1回限り収集する場合は、次のオプションを適用できます。-onetime
  • 収集時間を指定する場合は、次のオプションで指定できます。-now {unix epoch time(second)}
Linux Shell
#メトリクスカテゴリ
CATEGORY="my_category"


プログラムまたはスクリプト | \
json dictionary形に再処理 | \
./focus -license $WHATAP_LICENSE \
-category $category \
-pcode $WHATAP_PCODE -server.host $WHATAP_HOST

次の例は、topコマンドを実行して、特定のプロセスのCPUとメモリ使用量を継続的に収集します。

Linux Shell
#メトリクスカテゴリー
CATEGORY="my_category"

export PID=収集するプロセスのPID
top -b -p $PID | awk '/'$PID'/{ printf "{\"pid\": %s, \"cpuPercent\": %s, \"memoryPercent\": %s, \"cmd\": \"%s\"}\n",$1, $9, $10, $12}; system("")' | \
./focus -license $WHATAP_LICENSE \
-pcode $WHATAP_PCODE -server.host $WHATAP_HOST \
-category $CATEGORY