AppendixWhaTap Support

Version 1.0.0

Table of Contents1. Java Application Monitoring Quickstart. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22. Javaアプリケーションモニタリングクイックスタート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

2.1. インストール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32.2. エージェント構成ファイル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32.3. エージェントのインストール方法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

3. Server Monitoring Quickstart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104. サーバーモニタリングクイックスタート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

4.1. インストール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114.2. エージェントのインストール方法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

5. Open API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166. Open API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

6.1. Open API Token 확인 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176.2. Open API Spec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186.3. Open API 호출 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

7. Liberty 엔진 DB Connection Pool 모니터링 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328. Liberty 엔진 DB Connection Pool 모니터링 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

8.1. monitor feature 적용 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338.2. 와탭 에이전트 설정 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338.3. 와탭 Plug-in 설정 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338.4. 적용 확인 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

9. Install On PaaS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3610. PaaS 환경 설치. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

10.1. IBM BlueMix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3711. 수집서버 설치 가이드 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3812. 수집서버 설치 가이드 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

12.1. 안내사항 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3912.2. 수집 서버 준비 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4012.3. 설치 작업 절차 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4112.4. 최소형 설치 예제 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4912.5. 확장형 설치 예제 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5112.6. 알람연동 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5812.7. FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

13. 에이전트 설치 안내서 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7014. 설치 사전 안내서 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

14.1. 방화벽 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7114.2. 지원환경 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7214.3. 회원가입 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7214.4. 설치 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

제목 : Appendix작성자 : WhaTap Support이메일 : support@whatap.io날짜 : 2021-01-20버전 : 1.0.0

설명 : 본 문서는 WhaTap 모니터링 활용에 관한 가이드 입니다.

Preface

Copyright 2019 WhaTap Labs Inc. All rights reserved. 1

Chapter 1. Java Application Monitoring Quickstart

Chapter 1. Java Application Monitoring Quickstart

Copyright 2019 WhaTap Labs Inc. All rights reserved. 2

Chapter 2. Javaアプリケーションモニタリングクイックスタート題名 : Appendix作成者 : Whatap Supportメール : support@whatap.io日付 : 2021-01-20バージョン : 1.0.0

概略 : Javaアプリケーションモニタリングクイックスタートガイド

本ガイドは使用者がWhaTapアプリケーションモニタリングサービスをTomcatのアプリケーションサーバーへインストールし確認する手順を紹介します。更に詳細な設定を要する機能に関しては利用者ガイドをご参考ください。

本ガイドはWhaTapアプリケーションモニタリングのインストール方法の中で「javaagent」方式を対象とします。「javaagent」方式はアプリケーションサーバーの実行時にエージェントを適用する場合の方式です。

2.1. インストール環境• OS: Linux

• アプリケーションサーバー: Tomcat

• エージェントのインストール方式: “javaagent”

Windowsへインストールする場合は 5章の Javaアプリケーションモニタリングをご参照ください。

Tomcat以外の WASへJVMオプションを追加する方法はWhaTapウェブでプロジェクト内の管理 >エージェントのインストールページでご確認できます。

2.2. エージェント構成ファイルモニタリング情報を収集しサーバーへ転送するための Tracerとエージェントデバッグするためのシェルスクリプトで構成されています。エージェントを構成する各ファイルの説明は以下の通りです。

Table 1. エージェント構成ファイル

ファイル名 説明

whatap.agent.tracer-#.#.#.jar (Tracerプログラム)ウェブアプリケーションサーバープロセスへ合体され性能情報を集め、サーバーへ転送するプログラム

whatap.conf アプリケーションサーバー情報、データの収集対象のプロジェクトを特定するためのライセンスキー、そしてエージェントの各種オプションを含む設定ファイル

javaproc.sh(bat) 実行中JAVAプロセスのPIDとJVMオプション確認のためのシェルスクリプト

resmon.sh(bat) CPU/Memory/Disk情報抽出確認のためのシェルスクリプト

2.3. エージェントのインストール方法アプリケーションモニタリングを利用するためにはモニタリング対象アプリケーションへエージェントをインストールする必要があります。エージェントはWhaTapウェブサイトのプロジェクト内の画面からダウンロードできます。そしてダウンロードしたエージェントファイルをサーバーへ解凍後JVMオプションを追加し、アプリケーションを再起動することでインストールが完了します。

2.3.1. プロジェクトの生成

2.1. インストール環境

Copyright 2019 WhaTap Labs Inc. All rights reserved. 3

Figure 1. プロジェクトの生成

サーバーの登録の前にまずはプロジェクトを生成します。プロジェクトの生成ボタンをクリックすると次のようにプロジェクト生成画面が表示されます。Javaアイコンを選択し、ご希望のプロジェクト名とデータが保存されるサーバーの地域とプロジェクトが属するグループを選択し,保存ボタンをクリックします。

2.3. エージェントのインストール方法

Copyright 2019 WhaTap Labs Inc. All rights reserved. 4

Figure 2. プロジェクト生成時データサーバー地域を選択

2.3. エージェントのインストール方法

Copyright 2019 WhaTap Labs Inc. All rights reserved. 5

以降生成されたプロジェクトをクリックしエージェントのインストール画面に進みます。

2.3.2. ライセンスの発行WhaTap画面のインストールページで「Get a License Key」ボタンをクリックしプロジェクトライセンスを発行します。ライセンスは各プロジェクト毎に生成されるため、同じプロジェクトにデータを集める場合のみ、同じキーを使うことになります。

Figure 3. ラインセンスの発行前

ライセンスの発行が完了しますと発行したライセンス情報が表示されます。

Figure 4. ラインセンスの発行後

2.3.3. エージェントのダウンロード

2.3. エージェントのインストール方法

Copyright 2019 WhaTap Labs Inc. All rights reserved. 6

Figure 5. エージェントのダウンロード

ライセンス発行後「Agent Download」ボタンが活性化された後、クリックをしエージェントファイルをダウンロードします。

ダウンロードが完了すると圧縮ファイルの中にある「whatap.conf」ファイルの設定を確認し、ライセンスキーとデータ収集サーバーのIPアドレスが正常に定義されているかをご確認します。

license=ライセンスキー whatap.server.host=データ収集サーバーのIPアドレス

wgetなどで直接ダウンロードする場合、「whatap.conf」ファイルにライセンスキーとデータ収集サーバーのIPアドレスが設定されないため、アップロード後ライセンスキーとデータ収集サーバーのIPアドレスを自ら設定する必要があります。

2.3.4. エージェントのアップロードアプリケーションサーバーがあるサーバーへ接続し、ダウンロードしたエージェントファイルをアップロード後、圧縮ファイルを解凍します。

• $WHATAP_HOMEはエージェントのインストールパスを表します。

• エージェントは収集サーバーへアプリケーションの性能情報を転送するため、ファイアウォールへ収集サーバー向けの「TCPアウトバウンドの6600ポート」が開放されていなければいけません。

2.3.5. エージェントのインストールアプリケーションサーバーのJVMオプションへ次のような「-javaagent」設定を追加します。

-javaagent:[エージェントのインストールパス]/whatap.agent.tracer-#.#.#.jar

常に$WHATAP_HOME配下の最上位バージョンのエージェントを使いたい場合は、次のスクリプトを参考しエージェントを適用します。

########## WHATAP ############WHATAP_HOME=/whatapWHATAP_JAR=`ls $WHATAP_HOME/whatap.agent.tracer-*.jar | sort | tail -1`JAVA_OPTS=" -javaagent:$WHATAP_JAR "########## WHATAP ############

2.3.6. アプリケーションの再起動アプリケーションサーバーを起動又は再起動後、アプリケーションサーバーのログ及びエージェントログを確認し、エージェントの正常起動を確認します。

2.3. エージェントのインストール方法

Copyright 2019 WhaTap Labs Inc. All rights reserved. 7

Oct 16, 2019 3:06:40 AM org.apache.catalina.startup.HostConfig deployDirectoryINFO: Deployment of web application directory /var/lib/tomcat7/webapps/ROOT has finished in 577 msOct 16, 2019 3:06:40 AM org.apache.coyote.AbstractProtocol startINFO: Starting ProtocolHandler ["http-bio-8080"]Oct 16, 2019 3:06:40 AM org.apache.catalina.startup.Catalina startINFO: Server startup in 3984 ms

_ ____ ______| | /| / / / ___ /_ __/__ ____| |/ |/ / _ \/ _ `// / / _ `/ _ \|__/|__/_//_/\_,_//_/ \_,_/ .__/ /_/Just Tap, Always MonitoringWhaTap Agent version 1.8.1 20191001

2.3.7. モニタリングの確認エージェントが正常に起動しましたら、WhaTapウェブサイトのプロジェクト内の画面により、モニタリング状況を確認します。

Figure 6. モニタリング状況確認

サーバーページではサーバーとの通信が確認できたアプリケーションのリストが確認できます。

2.3. エージェントのインストール方法

Copyright 2019 WhaTap Labs Inc. All rights reserved. 8

Figure 7. 登録されたモニタリング対象のアプリケーションリスト

2.3. エージェントのインストール方法

Copyright 2019 WhaTap Labs Inc. All rights reserved. 9

Chapter 3. Server Monitoring Quickstart

Chapter 3. Server Monitoring Quickstart

Copyright 2019 WhaTap Labs Inc. All rights reserved. 10

Chapter 4. サーバーモニタリングクイックスタート題名 : Appendix作成者 : Whatap Supportメール : support@whatap.io日付 : 2021-01-20バージョン : 1.0.0

概略 : サーバーモニタリングクイックスタートガイド

本ガイドは使用者がWhaTapサーバーモニタリングサービス（以降サーバーモニタリングとする）をUbuntu 16.04サーバーへインストールし確認する手順を紹介します。更に詳細な設定を要する機能に関しては利用者ガイドをご参考にしてください。

4.1. インストール環境• OS: Linux Ubuntu 16.04

4.2. エージェントのインストール方法サーバーモニタリングを利用するためにはモニタリング対象のサーバーにエージェントをインストールする必要があります。サーバーモニタリングエージェントはLinuxの場合「WhaTapRepository」からWindowsの場合はWhaTapウェブサイトのプロジェクト内の画面からダウンロードできます。そしてインストール案内ページで発行するライセンスキーを入力しエージェントを登録します。

4.2.1. プロジェクトの生成

Figure 8. プロジェクトの生成

サーバーの登録の前にまずはプロジェクトを生成します。プロジェクトの生成ボタンをクリックしますと次のようにプロジェクト生成画面が表示されます。Serverアイコンを選択し、ご希望のプロジェクト名とデータを保存するサーバーの地域とプロジェクトが属するグループを選択し、保存ボタンをクリックします。

4.1. インストール環境

Copyright 2019 WhaTap Labs Inc. All rights reserved. 11

Figure 9. プロジェクト生成時データサーバー地域を選択

4.2. エージェントのインストール方法

Copyright 2019 WhaTap Labs Inc. All rights reserved. 12

以降、生成されたプロジェクトをクリックしエージェントのインストール画面に進みます。

4.2.2. WhaTapパッケージリポジトリの登録サーバーモニタリングをインストールするサーバーでパッケージ管理ツールによりエージェントを入手するためのリポジトリを登録します。そして画面に表示されたようにモニタリングデータの収集のため「TCPアウトバウンド6600ポート」が開放できるようファイアウォールをご確認ください。

Figure 10. パッケージリポジトリの登録

以下の内容をコピーしコマンドを実行してください。

wget http://repo.whatap.io/debian/release.gpg -O -|sudo apt-key add -wget http://repo.whatap.io/debian/whatap-repo_1.0_all.debsudo dpkg -i whatap-repo_1.0_all.debsudo apt-get update

正常に登録できた場合、次のような内容が表示されます。確認後「sudo apt-getupdate」を実行しパッケージリストをアップデートします

(中略)- 100%[===================>] 1.69K --.-KB/s in 0s

2017-11-07 11:13:43 (517 MB/s) - written to stdout [1735/1735]

OKroot@ubuntu:~# wget http://repo.whatap.io/debian/whatap-repo_1.0_all.deb--2017-11-07 11:13:44-- http://repo.whatap.io/debian/whatap-repo_1.0_all.debResolving repo.whatap.io (repo.whatap.io)... 210.122.7.70Connecting to repo.whatap.io (repo.whatap.io)|210.122.7.70|:80... connected.HTTP request sent, awaiting response... 200 OKLength: 1988 (1.9K) [application/x-debian-package]Saving to: ‘whatap-repo_1.0_all.deb’

whatap-repo_1.0_all 100%[===================>] 1.94K --.-KB/s in 0s

2017-11-07 11:13:44 (526 MB/s) - ‘whatap-repo_1.0_all.deb’ saved [1988/1988]

root@ubuntu:~# sudo dpkg -i whatap-repo_1.0_all.deb(Reading database … 102988 filees and directories currently installed.)Preparing to unpack whatap-repo_1.0_all.deb ...Unpacking whatap-repo (1.0) over (1.0) ...Setting up whatap-repo (1.0) ...root@ubuntu:~# sudo apt-get update

4.2. エージェントのインストール方法

Copyright 2019 WhaTap Labs Inc. All rights reserved. 13

正常にリポジトリが設定された場合、aptリストに「http://repo.whatap.io」が追加されたことをご確認できます。正常に表示されなかった場合は、インストールコマンドとネットワークの設定をご確認ください。

4.2.3. エージェントのインストールサーバーモニタリングエージェントをインストールします。

Figure 11. エージェントのインストール

以下の内容をコピーしコマンドを実行してください。

sudo apt-get install whatap-infra

4.2.4. ライセンスの発行WhaTap画面のインストールページで「Issue a License Key」ボタンをクリックしプロジェクトライセンスを発行します。ライセンスは各プロジェクト毎に生成されるため、同じプロジェクトにデータを集める場合のみ、同じキーを使うことになります。

Figure 12. ラインセンスの発行

ライセンスの発行が完了しますと発行したライセンス情報が表示されます。

Figure 13. 設定スクリプトの実行

4.2.5. エージェントへライセンスキーを登録インストール画面で発行したライセンスキー及びデータ転送対象のサーバーアドレスを登録し、エージェントを再起動します。以下のコマンドのようにライセンス発行後、画面に表示されたコマンドを実行します。

4.2. エージェントのインストール方法

Copyright 2019 WhaTap Labs Inc. All rights reserved. 14

echo "license=[発行されたライセンスキー] " |sudo tee /usr/whatap/infra/conf/whatap.confecho "whatap.server.host=[画面に表示されたIPアドレス]" |sudo tee -a /usr/whatap/infra/conf/whatap.confecho "createdtime=`date +%s%N`" |sudo tee -a /usr/whatap/infra/conf/whatap.confsudo service whatap-infra restart

エージェントが正常に起動出来なかった場合、又は正常にインストール出来たがサーバーのモニタリングができない場合はファイアウォールの設定をご確認ください。

4.2.6. モニタリング内容の確認

Figure 14. サーバーリスト

エージェントが正常に登録されるとサーバーリストメニューで登録されたエージェントをご確認できます。

システムモニタリングのメトリック (CPU, Memory, Disk, Network)は5秒、プロセスモニタリングメトリックは20秒単位で収集されます。

4.2. エージェントのインストール方法

Copyright 2019 WhaTap Labs Inc. All rights reserved. 15

Chapter 5. Open API

Chapter 5. Open API

Copyright 2019 WhaTap Labs Inc. All rights reserved. 16

Chapter 6. Open API제목 : Open API작성자 : WhaTap Support이메일 : support@whatap.io날짜 : 2021-01-20버전 : 1.0.0

설명 : 본 문서는 WhaTap 모니터링에서 제공하는 Open API 가이드 입니다.

수집중인 모니터링 정보를 추출하여 별도로 활용하고자 하는 경우 Open API 를 통해 해당 정보를 추출할 수 있는 기능을 제공합니다. 계정 API토큰 및프로젝트 API토큰 및 프로젝트 코드를 파라메타로 전달하여 수집된 정보를 획득할 수 있습니다.

6.1. Open API Token 확인토큰은 계정 API토큰과 프로젝트 API토큰으로 구분됩니다. 계정 API 토큰은 프로젝트의 목록 정보를 취득하기 위한 용도로, 프로젝트 API 토큰은프로젝트의 모니터링 정보를 취득하기 위한 용도로 활용됩니다.

프로젝트 코드는 프로젝트 진입 시, 화면 상단의 윈도우 또는 탭 제목에 "[프로젝트 코드] Cloud Application Monitoring"와 같이 표시되는 정보를통해 확인하실 수 있습니다. API토큰을 변경하고자 하는 경우, 각 화면의 재발급 또는 토큰 재발급 버튼을 통하여 토큰을 갱신 합니다.

계정 토큰은 화면 우측 상단의 계정 이메일을 클릭하여 표시되는 계정 수정 버튼을 클릭한 후 API토큰에서 확인합니다.

Figure 15. 이메일 | 계정 수정

Figure 16. API 토큰

프로젝트 토큰은 프로젝트 진입 후 관리 | 프로젝트 관리 메뉴를 통해 확인할 수 있습니다.

6.1. Open API Token 확인

Copyright 2019 WhaTap Labs Inc. All rights reserved. 17

Figure 17. 관리 | 프로젝트 관리 - 프로젝트 API 토큰

6.2. Open API Spec

6.2.1. 계정 API프로젝트 목록 조회 등, 프로젝트의 권한 범위를 넘는 Open API의 경우 계정 API토큰을 사용하여 호출합니다.

Open API 호출 시 헤더에 포함될 내용은 다음과 같습니다.

구분 키 설정 값 비고

헤더 x-whatap-token API토큰 계정 API토큰: 계정 수정 메뉴

프로젝트 API토큰: 관리 > 프로젝트 관리메뉴

메타성 정보 조회용 Open API 호출 URL 입니다.

URL 설명

https://service.whatap.io/open/api/json/projects 프로젝트 목록 조회

6.2.2. 프로젝트 API프로젝트 권한 범위 내의 Open API의 경우 프로젝트 코드와 함께 프로젝트 API토큰을 사용하여 호출합니다.

Open API 호출 시 헤더에 포함될 내용은 다음과 같습니다.

구분 키 설정 값 비고

헤더 x-whatap-token API토큰 계정 API토큰: 계정 수정 메뉴

프로젝트 API토큰: 관리 > 프로젝트 관리메뉴

x-whatap-pcode 프로젝트 코드 화면 윈도우 또는 탭 타이틀에서 확인

"[프로젝트 코드] Cloud ApplicationMonitoring"

메타 정보 조회 URL메타성 정보 조회용 Open API 호출 URL 입니다.

6.2. Open API Spec

Copyright 2019 WhaTap Labs Inc. All rights reserved. 18

구분 URL

프로젝트 정보 조회 https://service.whatap.io/open/api/json/project

Spot 정보 조회 URLSpot 정보 조회용 Open API 호출 URL 입니다.

구분 URL

활성화 상태의 에이전트 수 https://service.whatap.io/open/api/act_agent

비활성화 상태의 에이전트 수 https://service.whatap.io/open/api/inact_agent

호스트 수 https://service.whatap.io/open/api/host

호스트의 CPU 코어 합 https://service.whatap.io/open/api/cpucore

트랜잭션 수 https://service.whatap.io/open/api/txcount

초당 트랜잭션 수 https://service.whatap.io/open/api/tps

5분간 집계된 고유 사용자 수 https://service.whatap.io/open/api/user

액티브 트랜잭션 수 https://service.whatap.io/open/api/actx

평균 응답 시간 https://service.whatap.io/open/api/rtime

CPU 사용률 https://service.whatap.io/open/api/cpu

쓰레드풀 활성 쓰레드 수 https://service.whatap.io/open/api/threadpool_active

쓰레드풀 큐잉 쓰레드 수 https://service.whatap.io/open/api/threadpool_queue

전체 DB Connection 수 https://service.whatap.io/open/api/dbc_count

활성(Active) DB Connection 수 https://service.whatap.io/open/api/dbc_active

비활성(Idle) DB Connection 수 https://service.whatap.io/open/api/dbc_idle

통계 정보 조회 URL통계 정보 조회용 Open API는 시간 범위를 지정하여 호출하며, URL에 다음 항목이 포함된 경우 각 항목의 동작 방식은 다음과 같습니다.

• 시간 범위 미지정 시 최근 5분간의 정보를 조회

• stime: 조회 시작 시간 (UNIX epoch time, millisecond)

• etime: 조회 종료 시간 (UNIX epoch time, millisecond)

etime은 stime을 기준으로 1일을 초과할 수 없음

• oids: agent 식별 ID (콤마 구분자로 복수 지정 가능)

• URL에 "/avg"가 포함된 경우 에이전트 단위의 평균치 도출을 의미함

통계 정보 조회용 Open API 호출 URL 입니다.

구분 내역

Exception 발생 https://service.whatap.io/open/api/json/exception/stime/etime

HTTP 외부 호출 https://service.whatap.io/open/api/json/httpc/stime/etimehttps://service.whatap.io/open/api/json/httpc/stime/etime/filter/filterkey/filterval/port/port

filterkey: 조회 조건 키 (host, url)filterval: 조회 조건 (filterkey가 url 인 경우 base64로 인코딩)

Client IP https://service.whatap.io/open/api/json/remote/stime/etime

SQL 발행 https://service.whatap.io/open/api/json/sql/stime/etime

6.2. Open API Spec

Copyright 2019 WhaTap Labs Inc. All rights reserved. 19

구분 내역

트랜잭션 https://service.whatap.io/open/api/json/transaction/stime/etime

Thread 수 https://service.whatap.io/open/api/json/thread_count/stime/etimehttps://service.whatap.io/open/api/json/thread_count/stime/etime/oids https://service.whatap.io/open/api/json/thread_count/stime/etime/avg https://service.whatap.io/open/api/json/thread_count/stime/etime/avg/oids

Thread Daemon 수 https://service.whatap.io/open/api/json/thread_daemon/stime/etimehttps://service.whatap.io/open/api/json/thread_daemon/stime/etime/oids https://service.whatap.io/open/api/json/thread_daemon/stime/etime/avg https://service.whatap.io/open/api/json/thread_daemon/stime/etime/avg/oids

Thread Peak 수 https://service.whatap.io/open/api/json/thread_peak_count/stime/etime https://service.whatap.io/open/api/json/thread_peak_count/stime/etime/oids https://service.whatap.io/open/api/json/thread_peak_count/stime/etime/avg https://service.whatap.io/open/api/json/thread_peak_count/stime/etime/avg/oids

Thread Pool 수 https://service.whatap.io/open/api/json/threadpool_active/stime/etime https://service.whatap.io/open/api/json/threadpool_active/stime/etime/oids https://service.whatap.io/open/api/json/threadpool_active/stime/etime/avg https://service.whatap.io/open/api/json/threadpool_active/stime/etime/avg/oids

Thread Pool Queue 수 https://service.whatap.io/open/api/json/threadpool_queue/stime/etime https://service.whatap.io/open/api/json/threadpool_queue/stime/etime/oids https://service.whatap.io/open/api/json/threadpool_queue/stime/etime/avg https://service.whatap.io/open/api/json/threadpool_queue/stime/etime/avg/oids

프로젝트간 트랜잭션 호출 통계 https://service.whatap.io/open/api/json/tx_caller/stime/etimehttps://service.whatap.io/open/api/json/tx_caller/stime/etime/oidshttps://service.whatap.io/open/api/json/tx_caller/stime/etime/filter/filterkey/filterval https://service.whatap.io/open/api/json/tx_caller/stime/etime/oids/filter/filterkey/filterval

filterkey: 조회 조건 키 (caller_pcode, caller_spec (버전), caller_url, spec (버전),url)filterval: 조회 조건 (filterkey가 caller_url 또는 url인 경우 base64로 인코딩)

도메인 호출 통계 https://service.whatap.io/open/api/json/tx_domain/stime/etimehttps://service.whatap.io/open/api/json/tx_domain/stime/etime/oids https://service.whatap.io/open/api/json/tx_domain/stime/etime/filter/filterkey/filterval https://service.whatap.io/open/api/json/tx_domain/stime/etime/oids/filter/filterkey/filterval

filterkey: 조회 조건 키 (domain, url)filterval: 조회 조건 (filterkey가 url인 경우 base64로 인코딩)

액티브 사용자 (5분 단위) https://service.whatap.io/open/api/json/visitor_5m/stime/etime

5분간 집계된 고유 사용자

액티브 사용자 (1시간 단위) https://service.whatap.io/open/api/json/visitor_h/stime/etime

1시간 동안 집계된 고유 사용자 통계

장기 통계 조회 URL장기 통계 조회용 Open API의 경우 유형에 따른 시간 지정 범위를 가집니다. 시간 범위를 지정하여 호출하며, URL에 다음 항목이 포함된 경우 각 항목의동작 방식은 다음과 같습니다.

• stime: 조회 시작 시간 (UNIX epoch time, millisecond)

• etime: 조회 종료 시간 (UNIX epoch time, millisecond)

구분 내역

액티브 사용자 (1일 단위) https://service.whatap.io/open/api/json/visitor_d/stime/etime

1일간 집계된 고유 사용자 통계, etime은 stime을 기준으로 31일을 초과할 수 없음

액티브 사용자 (1개월 단위) https://service.whatap.io/open/api/json/visitor_m/stime/etime

1개월간 집계된 고유 사용자 통계, etime은 stime을 기준으로 365일을 초과할 수 없음

6.2. Open API Spec

Copyright 2019 WhaTap Labs Inc. All rights reserved. 20

로그 조회 URL로그 조회용 Open API를 제공합니다. 시간 범위를 지정하여 호출하며, URL에 다음 항목이 포함된 경우 각 항목의 동작 방식은 다음과 같습니다.

• 시간 범위 미지정 시 최근 5분간의 정보를 조회

• stime: 조회 시작 시간 (UNIX epoch time, millisecond)

• etime: 조회 종료 시간 (UNIX epoch time, millisecond)

etime은 stime을 기준으로 1일을 초과할 수 없음

구분 URL

Full GC 로그 https://service.whatap.io/open/api/json/fullgclog/stime/etime

6.3. Open API 호출Open API 호출 시에는 계정 API토큰 또는 프로젝트 코드와 프로젝트 API토큰을 헤더로 전송합니다. 본 문서에서는 curl을 통한 호출 예시를 제시합니다.

6.3.1. 프로젝트 목록 조회command

$ curl -L -w "\n" -H "x-whatap-token: J************************A" "https://service.whatap.io/open/api/json/projects"

response

"data": [ "groupName": "", "projectCode": 35, "projectName": "APM_TEST2", "createTime": "2018-10-19 07:17:03.774", "lastUpdatedTime": "2018-10-19 07:46:05.167", "status": "subscribe", "productType": "APM", "platform": "JAVA", "gatewayName": "LOCAL", "apiToken": "5**********************R", , (중략) ], "accountEmail": "xxx@whatap.io", "total": 6

6.3.2. 프로젝트 정보 조회command

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1" "https://service.whatap.io/open/api/json/project"

response

"platform": "JAVA","createTime": "Tue Sep 18 08:34:27 GMT 2018", "gatewayName": "Office-OTE","projectCode": 1**1,"status": "Subscribe","lastUpdatedTime": "Tue Sep 18 08:34:34 GMT 2018", "name": "SEO_APM","productType": "APM"

6.3. Open API 호출

Copyright 2019 WhaTap Labs Inc. All rights reserved. 21

6.3.3. Spot 정보 조회

Active Agentcommand

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1" "https://service.whatap.io/open/api/act_agent"

response

5

Inactive Agentcommand

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1" "https://service.whatap.io/open/api/inact_agent"

response

1

Hostcommand

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1" "https://service.whatap.io/open/api/host"

response

2

CPU Corecommand

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1" "https://service.whatap.io/open/api/cpucore"

response

16

트랜잭션 수command

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1" "https://service.whatap.io/open/api/txcount"

response

469

TPScommand

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1" "https://service.whatap.io/open/api/tps"

6.3. Open API 호출

Copyright 2019 WhaTap Labs Inc. All rights reserved. 22

response

92.03

액티브 사용자(5분)command

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1" "https://service.whatap.io/open/api/user"

response

1007

액티브 트랜잭션command

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1" "https://service.whatap.io/open/api/actx"

response

171

평균 응답시간command

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1" "https://service.whatap.io/open/api/rtime"

response

1644

평균 CPU 사용률command

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1" "https://service.whatap.io/open/api/cpu"

response

9.62

6.3.4. 통계 데이터 조회

Exceptioncommand

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1""https://service.whatap.io/open/api/json/exception/1535554800000/1535641200000"

response

6.3. Open API 호출

Copyright 2019 WhaTap Labs Inc. All rights reserved. 23

"records": [ "oids": "[-1459620666]", "time": 1535557500000, "classHash": -1811136020, "count": 14, "service": "/account/delete/dept/daegu", "class": "java.sql.SQLException(0)", "serviceHash": 1900616259, "snapSeq": "6068699991557528332", "msg": "Sql Exception" , (중략) ], "total": 2063

HTTP 외부 호출command

curl -w -L "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1""https://service.whatap.io/open/api/json/httpc/1535554800000/1535641200000"

response

"records": [ "Sum": 22628, "Port": 10002, "Url": "/remote/account/save/employee/kwangju", "Host": "127.0.0.1", "Max": 1815, "Stdev": "247.95", "Actived": 0, "Avg": 1131, "HostHash": -675813464, "Min": 1002, "Error": 0, "Total": 20, "UrlHash": -243814510 , (중략) ], "total": 4923

command

curl -w -L "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1""https://service.whatap.io/open/api/json/httpc/1543219200000/1543478400000/filter/host/127.0.0.1/port/10007"

response

6.3. Open API 호출

Copyright 2019 WhaTap Labs Inc. All rights reserved. 24

"records": [ "Service": "/sales/remove/unit/kwangju", "Host": "127.0.0.1", "HostHash": -675813464, "Avg": 1080, "Error": 0, "Sum": 2411644, "Port": 10007, "Service_hash": -1003301916, "Url": "/remote/account/save/employee/seoul", "Max": 2442, "Stdev": "159.01", "UrlHash": 180997672, "Total": 2233, "Min": 1001 , "Service": "/product/delete/employee/daejun", "Host": "127.0.0.1", "HostHash": -675813464, "Avg": 1085, "Error": 0, "Sum": 2075036, "Port": 10007, "Service_hash": 2100205994, "Url": "/remote/account/save/employee/pusan", "Max": 2462, "Stdev": "173.06", "UrlHash": -924053750, "Total": 1911, "Min": 1001 , (중략) ], "total": 1080

SQLcommand

curl -w -L "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1""https://service.whatap.io/open/api/json/sql/1535554800000/1535641200000"

response

"records": [ "time_max": 4164, "dbcHash": 450678784, "db": "jdbc:mysql://localhost:3306,localhost:3310/fake", "time_min": 0, "fetch_count": 0, "hash": 796628118, "fetch_time": 0, "sql_crud": 0, "count_total": 5224, "count_error": 0, "sql": "update table set x=# where key=#", "time_sum": 581391, "time_avg": 111, "time_std": "240.79", "count_actived": 0 , (중략) ], "total": 130

6.3. Open API 호출

Copyright 2019 WhaTap Labs Inc. All rights reserved. 25

Client IPcommand

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1""https://service.whatap.io/open/api/json/remote/1535554800000/1535641200000"

response

"records": [ "count": 86, "city": "Winnipeg", "country": "CA (CANADA)", "ip": "140.193.83.68" , (중략) ], "total": 1000

트랜잭션command

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1""https://service.whatap.io/open/api/json/transaction/1535554800000/1535641200000"

response

"records": [ "time_max": 44735, "sql_fetch_time": 363, "sql_time": 2628663, "count": 10743, "error": 29, "sql_count": 22635, "hash": -1485863373, "sql_fetch": 6741607, "httpc_avg": 1084, "cpu_avg": 0, "time_sum": 19911778, "time_avg": 1853, "httpc_count": 7072, "service": "/account/save/employee/seoul", "mem_avg": 0 , (중략) ], "total": 1080

Thread Count / Thread Daemon Count / Thread Peak Count / Thread Pool Count / Thread Pool QueueCount에이전트 개별 데이터 조회 예시

command

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1""https://service.whatap.io/open/api/json/thread_count/1536050100000/1536050700000"

response

6.3. Open API 호출

Copyright 2019 WhaTap Labs Inc. All rights reserved. 26

"pcode": 1234570141, "type": "thread_count", "stime": 1536050100000, "etime": 1536050700000, "interval": 300, <= data point 간격 " data": [ "oname": "8080", "oid": -1234257485, "data": [ [ 1536050100000, <= 시계열 timestamp 95.2 ], [ 1536050400000, 85.3 ], [ 1536050700000, 91.43 ] ] , (중략) "oname": "TC-29-96-8082", "oid": 1482741919, "data": [ [ 1536050100000, 98.11 ], [ 1536050400000, 81.44 ], [ 1536050700000, 90.05 ] ] ]

에이전트 평균 데이터 조회 예시

command

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1""https://service.whatap.io/open/api/json/thread_count/1536050100000/1536050700000/avg"

response

6.3. Open API 호출

Copyright 2019 WhaTap Labs Inc. All rights reserved. 27

"pcode": 1234570141, "type": "thread_count", "stime": 1536050100000, "etime": 1536050700000, "interval": 300, <= data point 간격 "op": "avg", "data": [ [ 1536050100000, <= 시계열 timestamp 122.86 <= 전체 에이전트의 평균 데이터 ], [ 1536050400000, 99.26 ], [ 1536050700000, 109.68 ] ]

에이전트 지정 데이터 조회 예시

command

$ curl -L -w "\n" -H "x-whatap-token: HN8ZCGB72CK1RQOI8PQBHKIC" -H "x-whatap-pcode: 1234570141""http://apmote.whatap.io:8080/open/api/json/thread_count/1536050100000/1536050700000/-1050048219,- 1459620666"

response

"pcode": 1234570141, "type": "thread_count", "stime": 1536050100000, "etime": 1536050700000, "interval": 300, "data": [ "oname": "8081", "oid": -1050048219, <= 지정한 에이전트의 정보가 조회됨 "data": [ [ 1536050100000, 97.75 ], [ 1536050400000, 98 ] ] , "oname": "8073", "oid": -1459620666, <= 지정한 에이전트의 정보가 조회됨 "data": [ [ 1536050100000, 137.23 ], [ 1536050400000 102.53 ], [ 1536050700000, 120.2 ] ] ]

에이전트 지정 평균 데이터 조회 예시

6.3. Open API 호출

Copyright 2019 WhaTap Labs Inc. All rights reserved. 28

command

$ curl -L -w "\n" -H "x-whatap-token: HN8ZCGB72CK1RQOI8PQBHKIC" -H "x-whatap-pcode: 1234570141""http://apmote.whatap.io:8080/open/api/json/thread_count/1536050100000/1536050700000/avg/- 1050048219,-1459620666"

response

"pcode": 1234570141, "type": "thread_count", "stime": 1536050100000, "etime": 1536050700000, "interval": 300, "op": "avg", "data": [ [ 1536050100000, 117.49 <= 지정한 에이전트들의 평균 지표가 조회됨 ], [ 1536050400000, 100.26 ], [ 1536050700000, 120.2 ] ]

액티브 사용자 (5분 단위)command

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1""https://service.whatap.io/open/api/json/visitor_5m/1554444000000/1554076800000"

response

"data": [ [ 1554444005000, <== 1시간 단위 (5*60*1000) 12 ], [ 1554444010000, 12 ], (중략) ], "pcode": 3000000079, "stime": 1554444000000, "etime": 1554444300000, "total": 59

액티브 사용자 (1시간 딘위)command

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1""https://service.whatap.io/open/api/json/visitor_h/1554444000000/1554454800000"

response

6.3. Open API 호출

Copyright 2019 WhaTap Labs Inc. All rights reserved. 29

"data": [ [ 1554444000000, <== 1시간 단위 (60*60*1000) 18 ], [ 1554447600000, 16 ], (중략) ], "pcode": 3000000079, "stime": 1554444000000, "etime": 1554454800000, "total": 3

6.3.5. 장기 통계 조회

액티브 사용자 (1일 단위)command

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1""https://service.whatap.io/open/api/json/visitor_d/1554163200000/1554422400000"

response

"data": [ [ 1554163200000, <== 1일 단위 (24*60*60*1000) 1007 ], [ 1554249600000, 1007 ], [ 1554336000000, 1007 ] ], "pcode": 3000000079, "stime": 1554163200000, "etime": 1554422400000, "total": 3

액티브 사용자 (1개월 단위)command

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1""https://service.whatap.io/open/api/json/visitor_m/1551398400000/1554076800000"

response

6.3. Open API 호출

Copyright 2019 WhaTap Labs Inc. All rights reserved. 30

"data": [ "stime": 1535760000000, <== 월 1일 시각 (24*60*60*1000) "etime": 1538352000000, "sdate": "Sat Sep 01 00:00:00 GMT 2018", "edate": "Mon Oct 01 00:00:00 GMT 2018", "mau": 1007 , "stime": 1538352000000, "etime": 1541030400000, "sdate": "Mon Oct 01 00:00:00 GMT 2018", "edate": "Thu Nov 01 00:00:00 GMT 2018", "mau": 1007 ], "pcode": 1234570141, "stime": 1535760000000, "etime": 1541030400000, "sdate": "Sat Sep 01 00:00:00 GMT 2018", "edate": "Thu Nov 01 00:00:00 GMT 2018", "total": 2

6.3.6. 로그 데이터 조회

Full GC Logcommand

$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1""https://service.whatap.io/open/api/json/fullgclog/1538983800000/1539104400000"

response

"pcode": 1, "stime": 1538983800000, "etime": 1539070200000, "data": [ "oid": 832254513, "oname": "SEO2", "count": [ [ 1538983800000, 1 ]], "logs": ["2018-10-08T16:33:09.001-0900: 79.812: [Full GC (System.gc()) 47269K->14801K(448000K), 0.0537298 secs]"] , "oid": -1453518268, "oname": "0-1-9780-seo", "count": [ [ 1538983800000, 2 ] ], "logs": [ "2018-10-08T16:32:57.009-0900: 32.382: [Full GC (System.gc()) 26874K->14816K(94720K), 0.0463841 secs]", "2018-10-08T16:33:02.435-0900: 37.807: [Full GC (System.gc()) 15040K->13556K(94720K), 0.0557387 secs]" ] ]

6.3. Open API 호출

Copyright 2019 WhaTap Labs Inc. All rights reserved. 31

Chapter 7. Liberty 엔진 DB Connection Pool 모니터링

Chapter 7. Liberty 엔진 DB Connection Pool 모니터링

Copyright 2019 WhaTap Labs Inc. All rights reserved. 32

Chapter 8. Liberty 엔진 DB Connection Pool 모니터링제목 : Prepare guidelines작성자 : WhaTap Support이메일 : support@whatap.io날짜 : 2021-01-20버전 : 1.0.2

설명 : DB ConnectionPool 모니터링을 위한 Plug-in 적용을 설명합니다. 문서에 관한 문의는 support@whatap.io 로 연락 주시기 바랍니다.

Liberty 는 IBM BlueMix PaaS 환경의 컨테이너로 사용 되며, osgi 기반으로 동적 구성이 가능한 WAS 입니다. Liberty 엔진 사용시 와탭을 통한DBConnectionPool을 모니터링 하기 위해 추가 설정이 필요합니다.

8.1. monitor feature 적용server.xml 파일을 수정하여 monitor-1.0 feature를 추가 합니다.

server.xml 추가 예

<!-- Enable features --><featureManager> <feature>javaee-8.0</feature> <feature>localConnector-1.0</feature> <feature>jndi-1.0</feature> <feature>jdbc-4.2</feature> <feature>jsp-2.3</feature> <feature>monitor-1.0</feature> ①</featureManager>

① xml 을 편집하여 monitor-1.0 feature 를 추가 합니다.

IBM BlueMix 환경은 JBP_CONFIG_LIBERTY 변수에 추가 합니다.

ibmcloud Command

$ ibmcloud cf set-env myapp JBP_CONFIG_LIBERTY "app_archive: features: [monitor-1.0]" ①

① ibmcloud 명령을 사용하여 추가 합니다.

8.2. 와탭 에이전트 설정whatap.conf 내에 custom_pool_classes 설정을 추가 합니다.

$ cat whatap.confcustom_pool_classes=liberty@com.ibm.ws.connectionpool.monitor.ConnectionPoolStats ①license=xxxxxxxxxxxxxx-xxxxxxxxxxxxxx-xxxxxxxxxxxxxxwhatap.server.host=52.78.209.94/52.78.224.235

① ConnectionPool 모니터링 정보를 가지고 있는 클래스를 설정 합니다.

8.3. 와탭 Plug-in 설정custom_pool_classes 로 부터 Active, Idle Pool 정보를 수집해 와탭 서버로 송신할 Plug-in을 설정 합니다.

whatap.conf 가 위치한 경로를 기준으로 plugin 디렉토리를 생성, 디렉토리 내에 CustomPool.x 파일 생성 후 아래 내용으로 두 줄 추가 합니다.

$WHATAP_HOME/plugin/CustomPool.x

$result.active(method($pool,"getConnectionHandleCount")); ①$result.idle(method($pool,"getFreeConnectionCount")); ②

① getConnectionHandleCount : Active Connection Pool 을 얻을 수 있는 메소드 입니다.

8.1. monitor feature 적용

Copyright 2019 WhaTap Labs Inc. All rights reserved. 33

② getFreeConnectionCount : Idle Connection Pool 을 얻을 수 있는 메소드 입니다.

8.4. 적용 확인에이전트 설정이 정상 적용 된 경우 [서버] [더보기] [DB상태] 메뉴를 통해 다음과 같이 확인 가능합니다.

과거 추이는 [분석] 실시간, 일간, 주간, 월간 카운터 메뉴에서 [자원] DB Connection Active, DB Connection Idle 차트를 통해 확인 할 수 있습니다.

8.4. 적용 확인

Copyright 2019 WhaTap Labs Inc. All rights reserved. 34

8.4. 적용 확인

Copyright 2019 WhaTap Labs Inc. All rights reserved. 35

Chapter 9. Install On PaaS

Chapter 9. Install On PaaS

Copyright 2019 WhaTap Labs Inc. All rights reserved. 36

Chapter 10. PaaS 환경 설치제목 : Install On PaaS작성자 : WhaTap Support이메일 : support@whatap.io날짜 : 2021-01-20버전 : 1.0.0

설명 : 본 문서는 PaaS 환경 에이전트 설치 가이드 입니다.

PaaS 환경은 배포 대상 어플리케이션에 WhaTap Agent 와 설정을 포함하여 배포합니다.

10.1. IBM BlueMixIBM BlueMix 는 컨테이너로 WebSphere Liberty 환경을 제공합니다. Liberty는 WebSphere Application Server 와 다른 경량화 환경으로 SpringBoot 가 동작하는 방식과 유사합니다.

설정 환경 예제 입니다. 가이드에 따른 환경 구성시 로컬 개발환경에서 생성되는 파일들은 아래와 같습니다.

whatap@vmwas01:/apps/bluemix/java-helloworld$ ls -alrt합계 64drwxrwxr-x 3 whatap whatap 4096 10월 29 13:13 ..-rw-rw-r-- 1 whatap whatap 1079 10월 29 13:13 .classpath-rw-rw-r-- 1 whatap whatap 1184 10월 29 13:13 .project-rw-rw-r-- 1 whatap whatap 39 10월 29 13:13 .gitignore-rw-rw-r-- 1 whatap whatap 151 10월 29 13:13 CONTRIBUTING.mddrwxrwxr-x 2 whatap whatap 4096 10월 29 13:13 .settings-rw-rw-r-- 1 whatap whatap 2823 10월 29 13:13 pom.xml-rw-rw-r-- 1 whatap whatap 122 10월 29 13:13 manifest.yml-rw-rw-r-- 1 whatap whatap 3522 10월 29 13:13 README.md-rw-rw-r-- 1 whatap whatap 11323 10월 29 13:13 LICENSEdrwxrwxr-x 3 whatap whatap 4096 10월 29 13:13 srcdrwxrwxr-x 2 whatap whatap 4096 10월 29 13:13 targetdrwxrwxr-x 8 whatap whatap 4096 10월 29 13:13 .gitdrwxrwxr-x 6 whatap whatap 4096 10월 29 15:26 .

$APP_HOME에서 src/main/resources/whatap-agent/ 디렉토리를 생성하고 jar 파일, conf 파일을 복사 합니다.

$ mkdir -p src/main/resources/whatap-agent/$ cp /apps/whatap/whatap.agent.tracer-1.5.4.jar src/main/resources/whatap-agent/$ cp /apps/whatap/whatap.conf src/main/resources/whatap-agent/

whatap.conf 설정은 PaaS 가 아닌 환경과 동일하게 적용합니다. 단, 적용 후 에이전트명 식별에 어려움이 있을 수 있으므로 상황에 맞는 에이전트명명 [1:에이전트 네이밍에 관한 세부 사항은 설치가이드의 에이전트 네이밍 부분을 참고합니다.] 정책을 적용 합니다.

$APP_HOME/manifest.yml 파일에 옵션을 추가 합니다. yml 파일이므로 공백, 들여쓰기 기준을 잘 맞춰야 합니다.

manifest.yml

---applications:- name: sample-java-helloworld random-route: true memory: 256M path: target/JavaHelloWorldApp.war #여기서부터 추가됩니다. env: JAVA_OPTS: "-javaagent:/APPLICATION_DIR/WEB-INF/classes/whatap-agent/whatap.agent.tracer-1.5.4.jar -Dorg.osgi.framework.bootdelegation=whatap.* "

10.1. IBM BlueMix

Copyright 2019 WhaTap Labs Inc. All rights reserved. 37

Chapter 11. 수집서버 설치 가이드

Chapter 11. 수집서버 설치 가이드

Copyright 2019 WhaTap Labs Inc. All rights reserved. 38

Chapter 12. 수집서버 설치 가이드제목 : On-premise Installation Guide작성자 : WhaTap Support이메일 : support@whatap.io날짜 : 2021-01-20버전 : 1.0.2

설명 : 본 문서는 WhaTap 설치형 수집서버 설치에 대해 설명합니다. 문서에 관한 문의는 support@whatap.io 로 연락 주시기 바랍니다.

12.1. 안내사항

SaaS형 서비스 사용시 와탭의 수집서버를 사용하므로 별도 수집서버 설치는 불필요 합니다.

12.1.1. 와탭 수집서버 모듈와탭 수집서버 모듈은 역할별로 나누어져 있습니다. 하나의 모듈은 JVM Process 하나와 대응합니다.

Table 2. 수집서버 모듈

모듈명 역할 비고

front UI 프론트

account 계정 관리 최소형의 경우 front 와 통합

yard 수집데이터 저장, 가공 및 제공

keeper 데몬의 정보를 관리

proxy 에이전트에서 수집한 데이터를 송신하는 Proxy

gateway 확장형에서 front 와 yard 간 gateway 역할 최소형의 경우 불필요

eureka 각 데몬의 서비스 정보를 찾는 DNS 역할 최소형의 경우 불필요

notihub stmp, sms 등과 연계하여 알람발송 알람 연계시 구성

12.1.2. 최소형과 확장형와탭 수집서버는 최소형과 확장형 중 선택해 설치 가능 합니다.1000TPS 이상 부하 환경이거나 향후 대규모 확장 요건이 있는 경우라면 확장형, 그 이하라면 최소형 설치로도 충분합니다.

최소형 설치

• 1대의 수집서버 내에서 모든 서비스 모듈이 구동됨

• 단순한 설치와 구성

확장형 설치

• 2대 이상 수집서버가 역할을 분담하는 구성으로 확장이 손쉬움

• 다량의 에이전트, 프로젝트, 리전을 수용 할 수 있음

12.1.3. 라이센스설치형 서버는 별도의 라이센스를 필요로 하며 발급은 license@whatap.io 에 다음 사항을 기술하여 요청합니다.

12.1. 안내사항

Copyright 2019 WhaTap Labs Inc. All rights reserved. 39

설치 환경 정보: 고객사 + 사업명고객사 담당자: 이름, 전화번호, 이메일라이센스 시작/종료일: 종료일 0시에 제한되므로 종료일 + 1로 요청인프라 모니터링 대상 코어 수/에이전트 수 (정식 라이센스는 에이전트 수 기준)어플리케이션 모니터링 대상 코어 수/에이전트 수 (정식 라이센스는 코어 수 기준)DB 모니터링 대상 코어 수/에이전트 수 (정식 라이센스는 코어 수 기준)

이벤트 알림을 위한 SMS/MMS, SMTP 연동 설정은 별도 절차로 진행합니다. 본 문서에서 이를 위한 notihub 관련 사항도 기술합니다.

12.1.4. 라이센스 만기수집서버는 매 시 정각 라이센스 사용기간과 사용량을 체크합니다.기간 만료나 수량을 초과한 경우 에이전트 데이터 수집은 정상적으로 이루어지나 모니터링 UI로 접속이 제한됩니다.라이센스 연장 요청은 최초 발급 과정과 동일하며, 연장 임을 명시하여 요청합니다.

12.2. 수집 서버 준비

12.2.1. 공통 항목• OS : 안정화 버전 Linux 배포판 (Windows 설치 가능하나 비권장)

• JDK : JDK 1.8 이상 (최소 1.7)

• 높은 File I/O로 인한 운영체제 file descriptor 설정 조정

• 방화벽 사전 오픈

• 서버 NTP 동기화 적용

12.2.2. 최소형 수집 서버 사양• 서버(VM) : 1 대

• CPU : 4Core 이상 (최소 2Core)

• Memory : 16G 이상 (최소 8G)

• Disk : 수집서버 Disk 산정 기준에 따름 (OS 영역 별도, SSD 또는 고성능 스토리지 필요)

12.2.3. 확장형 수집 서버 사양• 서버(VM) : 2 대 이상

• CPU

Front : 2Core 이상

Yard : 4Core 이상 (최소 2Core)

• Memory

Front : 8G 이상 (최소 4G)

Yard : 16G 이상 (최소 8G)

• Disk

Front : 2G 이상 (OS 영역 별도)

Yard : 수집서버 Disk 산정 기준에 따름 (OS 영역 별도, SSD 또는 고성능 스토리지 필요)

12.2.4. 수집서버 Disk 산정Table 3. Disk 사용량 산출 상세

12.2. 수집 서버 준비

Copyright 2019 WhaTap Labs Inc. All rights reserved. 40

구분 데이터 보존기간 Disk 용량 산출 근거

Infra Monitoring 1 년 8.2G / 연 (1EA * Raw Data 100M * 30일)(Summary Data 14M * 365일)1 Agent 기준

Application Monitoring 30 일 30G / 월 (1Gb * 30일)100 TPS 기준

12.2.5. 방화벽 오픈• 에이전트 → 수집 서버 (TCP 6600 포트)

• 모니터링 PC → 수집 서버 (TCP 8080 포트)

12.2.6. 파일 디스크립터 설정의 상향 조정시스템의 파일 디스크립터 설정을 상향 조정합니다.

/etc/sysctl.conf

$ sudo vi /etc/sysctl.conf fs.file-max = 999999 ①$ sysctl -p ②$ sysctl -a | grep fs.file-max = 999999 ③

① sysctl.conf 파일 내용에 fs.file-max = 999999 설정을 추가합니다.

② 추가한 설정을 적용합니다.

③ 추가한 설정을 확인 합니다.

설치형 서버를 실행할 사용자에 대해 파일 디스크립터 설정을 상향 합니다.

/etc/security/limits.conf

$ sudo vi /etc/security/limits.conf ① 사용자 계정 또는 @그룹명 soft nofile 999999 사용자 계정 또는 @그룹명 hard nofile 999999

① /etc/security/limits.conf 파일에 사용자 또는 그룹 이름으로 soft, hard 설정을 상향 합니다. 사용자 계정은 그대로 사용하고, 그룹은 앞에 @를 붙여서 설정합니다.

12.2.7. 수집서버 시간 동기화수집서버의 시간을 동기화 합니다.

ntpq 또는 rdate

$ntpq -p #또는$rdate -s time.bora.net

확장형 구성에서 수집서버간 시간이 다른 경우 데이터 누락, 통계 왜곡이 발생하므로 반드시 NTP등을 통해 올바른 시간이 설정되어있어야 합니다.

12.3. 설치 작업 절차

12.3.1. 설치 파일 및 라이센스 업로드단일 서버에 구성하는 경우, 최소형 패키지를 활용하며 향후 확장성을 고려할 때 확장형 패키지를 활용하여 설치를 진행합니다. JDK 및 와탭 모니터링패키지를 설치 대상 서버에 업로드 하고 압축을 해제합니다.

12.3. 설치 작업 절차

Copyright 2019 WhaTap Labs Inc. All rights reserved. 41

• 최소형 패키지: whatap_single-*.*.*.****.tar

• 확장형 패키지: whatap_multi-*.*.*.****.tar

• JDK 1.8 이상

• 라이센스 파일: 텍스트 파일로 별도 준비

와탭 모니터링 패키지를 압축 해제하면 whatap_package 라는 디렉토리로 압축이 해제됩니다.본 문서에서 이후 해당 경로를 $WHATAP_PACKAGE로 기술합니다.

12.3.2. JDK 설치대상 서버에 JDK가 사전 설치되어 있는 경우 이를 활용합니다.설치되어 있지 않은 경우, JDK를 설치합니다. 본 문서에서 이후 JDK 설치 경로를 $JDK로 기술합니다.

12.3.3. 실행 파일 편집$WHATAP_PACKAGE/bin 하위에는 쉘 스크립트가 존재합니다. 스크립트에 실행 권한을 부여합니다.

$WHATAP_PACKAGE/bin

$ cd $WHATAP_PACKAGE/bin$ chmod +x *.sh

이후 쉘 스크립트를 편집하여 JAVA_HOME 경로를 지정합니다.

예) front.sh

#!/usr/bin/env bashSERVICE_NAME=front.apmJAVA_HOME=$JDKSERVER_HOME=cd ..;pwd LIB_HOME=$SERVER_HOME/lib CONF_PATH=$SERVER_HOME/confEXE_JAR=ls $LIB_HOME/*.$SERVICE_NAME.boot* | sort | tail -1 $JAVA_HOME/bin/java -Djava.security.egd=/dev/./urandom -Dwhatap.log.path=. -Xmx512m -jar $EXE_JAR

최소형 설치의 경우 front.sh, keeper.sh, yard.sh, proxy.sh 가 사용되고,확장형 설치의 경우 eureka.sh, account.sh, front.sh / keeper.sh, yard.sh, proxy.sh, gateway.sh 가 사용됩니다.부가적으로 이벤트 알림 설정을 추가할 경우 notihub.sh 가 사용됩니다.

12.3.4. 설정편집$WHATAP_PACKAGE/lib 하위에는 어플리케이션 라이브러리(jar), $WHATAP_PACKAGE/conf 하위에는 설정 파일(conf)이 존재합니다.

실행 파일 편집시 개행코드로 인한 문제 발생 시에는 vi에디터에서 :set ff=unix 로 지정하고 편집합니다.

각 설정 파일에서 필수로 설정해야 하는 정보를 수정합니다.

Table 4. 설치 유형별 수정 대상 설정

구분 파일명 항목명 설정

최소형 account.conf owner ifconfig/ipconfig로 식별 가능한 IP

license 발급받은 서버 라이센스

front.conf region.proxy.address 에이전트가 데이터를 전송하게 될 수집서버의 IP

admin.password 사이트 관리자 계정 패스워드 (초기값 :admin)

notihub.conf mail.host SMTP 연계를 통한 초대 메일 및 알람발송등 적용 시

mail.port

mail.username

12.3. 설치 작업 절차

Copyright 2019 WhaTap Labs Inc. All rights reserved. 42

구분 파일명 항목명 설정

mail.password

mail.sender

mail.smtp.auth

mail.smtp.ssl.enable

mail.smtp.starttls.enable

mail.smtp.starttls.required

smsformat

smssender 이벤트 알림 중 문자 발송 시 고객사커스터마이징 설정을 지정

smsformat

확장형 account.conf owner ifconfig/ipconfig로 확인 가능한account 서버 IP

license 발급받은 서버 라이센스

eureka.addr eureka 서버 접근 정보

eureka.hostname eureka에 등록할 명칭(복수의 서버가동일 명칭을 가질 수 있음)

eureka_client_ip_address gateway에서 접근 가능한 account 서버IP

region.id 첫 번째 리전의 ID

region.name

region.proxy.address 첫 번째 리전의 proxy IP(복수 지정 가능)

mail.host SMTP 연계를 통한 초대 메일 적용 시

mail.port

mail.username

mail.password

mail.sender

mail.smtp.auth

mail.smtp.ssl.enable

mail.smtp.starttls.enable

mail.smtp.starttls.required

front.conf eureka.addr eureka 서버 접근 정보

eureka.hostname eureka에 등록할 명칭(복수의 서버가동일 명칭을 가질 수 있음)

eureka_client_ip_address front 서버 IP

admin.password 사이트 관리자 계정 패스워드 (초기값 :admin)

yard.conf keeper yard에서 접근 가능한 keeper 서버IP:Port

server.name keeper에 등록할 이름(서버 단위)

net_noti_ip yard에서 접근 가능한 noti 서버 IP

proxy.conf keeper proxy에서 접근 가능한 keeper 서버IP:Port

server.name keeper에 등록할 이름(서버 단위)

gateway.conf eureka.addr eureka 서버 접근 정보

eureka.hostname eureka에 등록할 명칭(복수의 서버가동일 명칭을 가질 수 있음)

12.3. 설치 작업 절차

Copyright 2019 WhaTap Labs Inc. All rights reserved. 43

구분 파일명 항목명 설정

eureka_client_ip_address account/front 에서 접근 가능한gateway 서버 IP

keeper gateway에서 접근 가능한 keeper 서버IP:Port

region.name region 명 첫 번째 region명은account.conf에서 지정한region.name과 일치해야 함두 번째 이후 region명은 사이트 관리자페이지에서 지정한 region명과 일치해야함

notihub.conf eureka.addr eureka 서버 접근 정보

eureka.hostname eureka에 등록할 명칭(복수의 서버가동일 명칭을 가질 수 있음)

eureka_client_ip_address noti 서버 IP

keeper noti에서 접근 가능한 keeper 서버IP:Port

mail.host 이벤트 알람 중 SMTP 통한 메일발송 기적용 시

mail.port

mail.username

mail.password

mail.sender

mail.smtp.auth

mail.smtp.ssl.enable

mail.smtp.starttls.enable

mail.smtp.starttls.required

smsformat

smssender 이벤트 알림 중 문자 발송 시 고객사커스터마이징 설정을 지정

smsformat

12.3.5. 로그 경로 변경실행 시 로그는 $WHATAP_PACKAGE /logs/server명.log 로 출력됩니다. 로그를 외부 경로에 출력할 경우 다음과 같이 지정합니다.

로그 경로 변경

$ cd $WHATAP_PACKAGE$ rmdir logs$ ln -s 외부경로 logs$ cd javam/server$ ln -s 외부경로 logs

12.3.6. 실행서버 실행은 $WHATAP_PACKAGE /bin/control.sh를 통해 실행하게 됩니다. 최소형 설치본의 경우 $WHATAP_PACKAGE /bin/start.sh,$WHATAP_PACKAGE /bin/stop.sh 파일을 통해서도 실행/정지가 가능합니다.

control.sh 를 통한 실행최소형 서버 실행 시에는 front를 구성한 서버에서 다음의 명령을 실행합니다.

12.3. 설치 작업 절차

Copyright 2019 WhaTap Labs Inc. All rights reserved. 44

control.sh - 최소형

./control.sh keeper start

./control.sh front start

./control.sh yard start

./control.sh proxy start

./control.sh notihub start (이벤트 알림 설정 시)

확장형 서버 실행 시에는 front를 구성한 서버에서 다음의 명령을 실행합니다.

control.sh - 확장형 Front

./control.sh eureka start

./control.sh account start

./control.sh front start

./control.sh notihub start

yard 구성 서버에서 다음의 명령을 실행합니다.

control.sh - 확장형 Yard

./control.sh keeper start

./control.sh yard start

./control.sh proxy start

./control.sh gateway start

control.sh 실행 시 다음과 같이 메뉴를 선택하여 작업을 수행할 수도 있습니다.

control.sh - Usage

$ cd $WHATAP_PACKAGE/bin$ ./control.sh-------------------------------------------------------------------------[ Usage ] ./control.sh [ service_name [ command ]]./control.sh menu./control.sh all (stop/status)./control.sh single (status/start/stop/restart)./control.sh (multi-front/mf) (status/start/stop/restart)./control.sh (multi-yard/my) (status/start/stop/restart)./control.sh front (status/start/stop/restart)./control.sh proxy (status/start/stop/restart)./control.sh yard (status/start/stop/restart)./control.sh keeper (status/start/stop/restart)./control.sh notihub (status/start/stop/restart)./control.sh eureka (status/start/stop/restart)./control.sh gateway (status/start/stop/restart)./control.sh account (status/start/stop/restart)/apps/whatap/bin/admin_console.sh-------------------------------------------------------------------------

12.3. 설치 작업 절차

Copyright 2019 WhaTap Labs Inc. All rights reserved. 45

control.sh - 메뉴

./control.sh menu===========================#Select type===========================#1. service start/stop2. start-single3. restart-single4. start-multi5. restart-multi6. status-all7. stop-all

99. Exit===========================#number> 원하는 메뉴 번호를 입력함

===========================#Select command===========================#1. front start2. front stop3. front restart

4. proxy start5. proxy stop6. proxy restart

7. yard start8. yard stop9. yard restart

10. keeper start11. keeper stop12. keeper restart

13. notihub start14. notihub stop15. notihub restart

16. billing start17. billing stop18. billing restart

19. eureka start20. eureka stop21. eureka restart

22. gateway start23. gateway stop24. gateway restart

25. account start26. account stop27. acdount restart

0. menu99. Exit===========================#number> 원하는 메뉴 번호를 입력함

12.3.7. 실행 확인기동 완료 여부는 서버의 포트 리스닝 여부와 로그를 확인합니다.

포트 리스닝 확인구성 환경에 따른 서버의 포트 리스닝 여부를 체크합니다.

$ netstat -na | grep 체크 대상 포트 | grep LISTEN

12.3. 설치 작업 절차

Copyright 2019 WhaTap Labs Inc. All rights reserved. 46

최소형

어플리케이션 서버 포트 프로토콜 용도

front (+account) 8080 HTTP 모니터링 사이트

keeper 6789 TCP/UDP 서버 정보 수신

yard 7710 TCP 모니터링 데이터 조회

6610 TCP 모니터링 데이터 저장

proxy 6600 TCP 에이전트 데이터 수신

notihub 6500 TCP/UDP 이벤트 알림

확장형

12.3. 설치 작업 절차

Copyright 2019 WhaTap Labs Inc. All rights reserved. 47

어플리이션 서버 포트 프로토콜 용도

eureka 6761 TCP 서버 위치 관리

account 18080 HTTP 계정 관리

front 8080 HTTP 모니터링 사이트

gateway 8800 TCP 리전 요청 수신

keeper 6789 TCP/UDP 서버 정보 수신

yard 7710 TCP 모니터링 데이터 조회

6610 TCP 모니터링 데이터 저장

proxy 6600 TCP 에이전트 데이터 수신

notihub 6500 TCP/UDP 이벤트 알림

로그 확인실행 시 로그는 $WHATAP_PACKAGE /logs 하위에 출력되므로, 본 경로의 로그를 확인하여 이상 로그 출력 여부를 점검합니다. 서버 초기 기동 시의 상호접속 실패로 인한 로그는 이상 로그로 간주하지 않습니다.

설치 형태 구분 어플리케이션 로그

최소형/확장형 front.log

keeper.log

yard.log

proxy.log

notihub.log

확장형 eureka.log

gateway.log

실행 화면 확인front 서버의 기동이 정상 완료되면, admin@whatap.io / admin 계정으로 로그인 합니다. 본 계정은 와탭 수집 서버 관리용으로 사용되는 계정으로,

12.3. 설치 작업 절차

Copyright 2019 WhaTap Labs Inc. All rights reserved. 48

수집 서버 관리용으로만 사용합니다. 본 계정으로는 프로젝트를 생성하지 않습니다.

화면 우상단의 계정메뉴(이메일 클릭시 노출)에서 사이트 관리를 선택하여 각 화면에 표시되는 내용을 확인합니다. 하기의 메뉴가 노출됩니다.

• SERVERS: 서버 관리 현황

• ACCOUNTS: 계정 관리

• PROJECTS: 프로젝트 생성 현황

• NOTICE: 공지사항 등록 관리 (설치형에서는 사용불가)

• REGIONS: 수집 서버 관리 리전 정보

• MAIL: 최소형 설치 시 메일 설정 변경

• SITELOGO: 설치형 제품의 로고 변경 옵션

12.3.8. 점검이후 점검은 신규 계정을 생성하여 진행합니다. 최소 점검 사항은 다음과 같습니다.

• 서버 라이센스 점검 : admin@whatap.io 계정으로 접속 후 http://수집서버주소/v2/admin/check URL로 접속하여 라이센스 정상 등록 여부를확인 합니다.

• 계정 생성 : 로그인 페이지 하단의 계정 생성 링크 또는 사이트 관리자 메뉴의 ACCOUNTS를 통해 계정을 생성합니다. 사이트 관리자 메뉴를 통해계정을 생성하는 경우, 패스워드에 대한 제약이 존재하지 않습니다.

• 프로젝트 생성 : 새로 생성한 계정으로 프로젝트를 생성하여 프로젝트 생성 시 이상 현상이 발생하지 않는지 확인합니다.

• 프로젝트 라이센스 발급 : 프로젝트 카드 클릭 시의 설치 안내 페이지에서 라이센스 발급 버튼을 클릭하고, 이상 현상 발생 여부를 확인합니다.

• 에이전트를 적용하고 기능 체크를 수행합니다.

12.4. 최소형 설치 예제최소형 서버를 실제 운영환경에 구성해야 하는 경우 구성에 앞서 예제를 통해 연습 해 볼 수 있습니다.

12.4.1. 환경예제에 사용 되는 환경은 다음과 같습니다.

호스트명 항목 내용 비고

vmsvr03 용도 front 서버

vmsvr03 OS X86 Linux

vmsvr03 IP 192.168.122.23

vmsvr03 구동 서비스 KeeperProxyYardFrontNotihub

12.4.2. 서버 설치예제 환경의 설치 절차는 다음과 같습니다. 방화벽, JDK 와 같은 제반 환경은 사전 구성되어 있어야 합니다.

파일 업로드 및 환경 구성

12.4. 최소형 설치 예제

Copyright 2019 WhaTap Labs Inc. All rights reserved. 49

whatap@vmsvr03:/apps$ ls -alrt ①합계 519544drwxr-xr-x 24 root root 4096 7월 6 11:48 ..-rw-rw-r-- 1 whatap whatap 531998720 12월 17 12:09 whatap_single-1.2.6.2240.tardrwxrwxr-x 2 whatap whatap 4096 12월 17 12:32whatap@vmsvr03:/apps$ tar -xvf whatap_single-1.2.6.2240.tar ②whatap@vmsvr03:/apps$ cd whatap/binwhatap@vmsvr03:/apps/whatap/bin$ chmod +x *sh ③whatap@vmsvr03:/apps/whatap/bin$ rm -f *.bat *.exe *solaris.sh ④

① 최소형 서버의 설치 파일명은 whatap_single 로 시작합니다.

② 설치 파일 압축을 해제 합니다.

③ 실행 파일 권한 추가 합니다.

④ Linux 환경에서 불필요 파일 제거 합니다. - (선택사항)

Account 설정 변경

/apps/whatap/conf/account.conf 파일을 편집하여 내 항목을 아래 값으로 변경합니다.

/apps/whatap/conf/account.conf

# Relative path from Home or Absolute pathh2.file.path=./dbdb_driver=org.h2.Driverh2_auto_server=trueh2_bind_address=127.0.0.1jpa_ddl_auto=updatedb_name=accountdb_name_project=accountadmin.email=admin@whatap.io#owner=ip address can be showed by ifconfig/ipconfig#license=server licenseowner=192.168.122.21 ①license=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ②

① ip address can be showed by ifconfig/ipconfig → 192.168.122.23

② server license → 발급된 라이센스

Front 설정 변경

/apps/whatap/conf/front.conf 파일을 편집하여 내 항목을 아래 값으로 변경합니다.

/apps/whatap/conf/front.conf

standalone=truedomain=service.whatap.iokeeper=127.0.0.1:6789

region.name=LOCALregion.id=LOCAL#region.proxy.address=IP_ADDRESS_accessable_from_AGENTregion.proxy.address=192.168.122.23 ①

admin.email=admin@whatap.ioadmin.password=admin

sessionTimeoutSecs=-1

login_footer_visible=false

# NotiHubnotihub.enable=truenotihub=127.0.0.1:6500

① IP_ADDRESS_accessable_from_AGENT → 192.168.122.23

12.4. 최소형 설치 예제

Copyright 2019 WhaTap Labs Inc. All rights reserved. 50

12.4.3. 기동Keeper, Proxy, Yard, front 기동

①whatap@vmsvr03:/apps/whatap/bin$ ./control.sh keeper startwhatap@vmsvr03:/apps/whatap/bin$ ./control.sh proxy startwhatap@vmsvr03:/apps/whatap/bin$ ./control.sh yard startwhatap@vmsvr03:/apps/whatap/bin$ ./control.sh front start

# 또는②whatap@vmsvr03:/apps/whatap/bin$ ./start.sh

① control 명령을 사용하여 각각의 데몬을 기동 할 수 있습니다.

② start 명령을 사용하여 일괄 기동 할 수 있습니다.

12.5. 확장형 설치 예제확장형 서버를 실제 운영환경에 구성해야 하는 경우 구성에 앞서 예제를 통해 연습 해 볼 수 있습니다.

12.5.1. 환경예제에 사용 되는 환경은 UI용도의 서버 1기, 수집데이터 저장 용도의 서버 1기 이며 세부 정부는 다음과 같습니다.

UI 용도 Front #1

호스트명 항목 내용 비고

vmsvr01 용도 front 서버

vmsvr01 OS X86 Linux

vmsvr01 IP 192.168.122.21

vmsvr01 구동 서비스 EurekaFrontAccountNotihub

수집데이터 저장용도 Yard #1

호스트명 항목 내용 비고

vmsvr02 용도 yard 서버

vmsvr02 OS X86 Linux

vmsvr02 IP 192.168.122.22

vmsvr02 구동 서비스 KeeperGatewayProxyYard

12.5.2. 설치 절차예제 환경의 설치 절차는 다음과 같습니다. 방화벽, JDK 와 같은 제반 환경은 사전 구성되어 있어야 합니다.

Front 서버 설치설치 파일을 업로드 하고 실행 환경을 구성 합니다.

12.5. 확장형 설치 예제

Copyright 2019 WhaTap Labs Inc. All rights reserved. 51

whatap@vmsvr01:/apps$ ls -alrt ①합계 769828drwxr-xr-x 25 root root 4096 8월 14 17:15 ..drwxr-xr-x 2 whatap whatap 4096 9월 27 12:08 .-rw-r--r-- 1 whatap whatap 788295680 9월 27 12:08 whatap_multi-1.1.4.2092.tarwhatap@vmsvr01:/apps$ tar -xvf whatap_multi-1.1.4.2092.tar ②whatap@vmsvr01:/apps$ cd whatap/binwhatap@vmsvr01:/apps/whatap/bin$ chmod +x *sh ③whatap@vmsvr01:/apps/whatap/bin$ rm -f *.bat *.exe *solaris.sh ④whatap@vmsvr01:/apps/whatap/bin$ rm -f gateway.sh keeper.sh *yard* proxy.sh billing.sh billing.sh adaptor.sh start.sh stop.sh noti.sh ⑤

① 확장형 서버의 설치 파일명은 whatap_multi 로 시작합니다.

② 설치 파일 압축을 해제 합니다.

③ 실행 파일 권한 추가 합니다.

④ Linux 환경에서 불필요 파일 제거 합니다. - (선택사항)

⑤ Yard 관련 모듈 제거 - (선택사항)운영 과정에서 발생 할 수 있는 혼란 방지를 위해 Front 에서 사용 되지 않는 실행 파일을 삭제합니다.

Account 설정 변경

/apps/whatap/conf/account.conf 파일을 편집하여 내 항목을 아래 값으로 변경합니다.

/apps/whatap/conf/account.conf

# Eureka# eureka.addr=http://whatap:1qaz$RFV@EUREKA_IP_accessable_from_ACCOUNT:6761/eureka/# eureka.hostname=ACCOUNT# eureka_client_ip_address=ACCOUNT_IP_accessable_from_GATEWAYeureka.addr=http://whatap:1qaz$RFV@192.168.122.21:6761/eureka/ ①eureka.hostname=ACCOUNT ②eureka_client_ip_address=192.168.122.21 ③ribbon_protocol=httpprefer_ip_address=true

# Region Proxy#region.id=FIRST_REGION_ID/NAME#region.name=FIRST_REGION_DISPLAY_NAME#region.proxy.address=PROXY_IPs_accessable_from_AGENTSregion.id=REGION-01 ④region.name=REGION-01 ⑤region.proxy.address=192.168.122.22 ⑥prefer_ip_address=true

# DB# Relative path from Home or Absolute pathh2.file.path=./dbdb_driver=org.h2.Driverh2_auto_server=trueh2_bind_address=127.0.0.1jpa_ddl_auto=updatedb_name=accountdb_name_project=account

# Admin Accountdomain=service.whatap.iodatabase.init=trueadmin.email=admin@whatap.ioadmin.password=admin

# Licenseowner=192.168.122.21 ⑦license=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ⑧

① EUREKA_IP_accessable_from_ACCOUNT → 192.168.122.21

② ACCOUNT → ACCOUNT

③ ACCOUNT_IP_accessable_from_GATEWAY → 192.168.122.21

④ FIRST_REGION_ID/NAME → REGION-01

⑤ FIRST_REGION_DISPLAY_NAME → REGION-01

12.5. 확장형 설치 예제

Copyright 2019 WhaTap Labs Inc. All rights reserved. 52

⑥ PROXY_IPs_accessable_from_AGENTS → 192.168.122.22

⑦ ip address can be showed by ifconfig/ipconfig → 192.168.122.21

⑧ server license → 발급된 라이센스

Front 설정 변경

/apps/whatap/conf/front.conf 파일을 편집하여 내 항목을 아래 값으로 변경합니다.

/apps/whatap/conf/front.conf

# Eureka#eureka.addr=http://whatap:1qaz$RFV@EUREKA_IP_accessable_from_FRONT:6761/eureka/#eureka.hostname=FRONT#eureka_client_ip_address=FRONT_IPeureka.addr=http://whatap:1qaz$RFV@192.168.122.21:6761/eureka/ ①eureka.hostname=FRONT ②eureka_client_ip_address=192.168.122.21 ③ribbon_protocol=httpprefer_ip_address=true

# Front Controlstandalone=falsedomain=service.whatap.iowhatap.admin=admin@whatap.iologinable=truesessionTimeoutSecs=-1login_footer_visible=false

# NotiHubnotihub.enable=true

① EUREKA_IP_accessable_from_FRONT → 192.168.122.21

② FRONT → FRONT

③ FRONT_IP → 192.168.122.21

Notihub 설정

/apps/whatap/conf/notihub.conf 파일을 편집하여 내 항목을 아래 값으로 변경합니다.

12.5. 확장형 설치 예제

Copyright 2019 WhaTap Labs Inc. All rights reserved. 53

/apps/whatap/conf/notihub.conf

# Eurekaeureka.enable=true#eureka.addr=http://whatap:1qaz$RFV@EUREKA_IP_accessable_from_NOTI:6761/eureka/#eureka.hostname=NOTIHUB#eureka_client_ip_address=NOTIHUB_ADDRESSeureka.addr=http://whatap:1qaz$RFV@192.168.122.21:6761/eureka/ ①eureka.hostname=NOTIHUB ②eureka_client_ip_address=192.168.122.21 ③ribbon_protocol=httpprefer_ip_address=true

# H2 DB# Relative path from Home or Absolute pathh2.file.path=./dbh2_auto_server=truedb_driver_event=org.h2.Driverh2_bind_address=0.0.0.0

jpa_show_sql=falsejpa_generate_ddl=truejpa_ddl_auto=update

# Mailmail.sender=no-reply@whatap.iomail.smtp.debug=falsemail.host=mail.username=mail.password=mail.smtp.protocol=smtpmail.port=25mail.smtp.auth=truemail.smtp.ssl.enable=falsemail.smtp.starttls.enable=truemail.smtp.starttls.required=true

① EUREKA_IP_accessable_from_FRONT → 192.168.122.21

② NOTIHUB → NOTIHUB

③ NOTIHUB_IP → 192.168.122.21

Yard 서버 설치설치 파일을 업로드 하고 실행 환경을 구성 합니다.

whatap@vmsvr02:/apps$ ls -alrt ①합계 769828drwxr-xr-x 25 root root 4096 8월 14 17:15 ..drwxr-xr-x 2 whatap whatap 4096 9월 27 12:08 .-rw-r--r-- 1 whatap whatap 788295680 9월 27 12:08 whatap_multi-1.1.4.2092.tarwhatap@vmsvr02:/apps$ tar -xvf whatap_multi-1.1.4.2092.tar ②whatap@vmsvr02:/apps$ cd whatap/binwhatap@vmsvr02:/apps/whatap/bin$ chmod +x *sh ③whatap@vmsvr02:/apps/whatap/bin$ rm -rf *.bat *.exe *solaris.sh ④whatap@vmsvr02:/apps/whatap/bin$ rm -f account.sh eureka.sh adaptor.sh billing.sh noti* start.sh *front.sh ⑤

① 확장형 서버의 설치 파일명은 whatap_multi 로 시작합니다.

② 설치 파일 압축을 해제 합니다.

③ 실행 파일 권한 추가 합니다.

④ Linux 환경에서 불필요 파일 제거 합니다. - (선택사항)

⑤ Front 관련 항목 제거 - (선택사항)운영 과정에서 발생 할 수 있는 혼란 방지를 위해 Yard 에서 사용 되지 않는 실행 파일을 삭제합니다.

Gateway 설정

/apps/whatap/conf/gateway.conf 파일을 편집하여 내 항목을 아래 값으로 변경합니다.

12.5. 확장형 설치 예제

Copyright 2019 WhaTap Labs Inc. All rights reserved. 54

/apps/whatap/conf/gateway.conf

# Eureka#eureka.addr=http://whatap:1qaz$RFV@EUREKA_IP_accessable_from_GATEWAY:6761/eureka/#eureka.hostname=GATEWAY#eureka_client_ip_address=GATEWAY_IP_accessable_from_ACCOUNTeureka.addr=http://whatap:1qaz$RFV@192.168.122.21:6761/eureka/ ①eureka.hostname=GATEWAY ②eureka_client_ip_address=192.168.122.22 ③prefer_ip_address=true

# Keeper#keeper=KEEPER_IP_accessable_from_GATEWAY:6789keeper=192.168.122.22:6789 ④

# Account 의 Region Value#region.name=REGION_NAME_displayed_by_SiteAdminPageregion.name=REGION-01 ⑤

① EUREKA_IP_accessable_from_GATEWAY → 192.168.122.21

② GATEWAY → GATEWAY

③ GATEWAY_IP_accessable_from_ACCOUNT → 192.168.122.22

④ KEEPER_IP_accessable_from_GATEWAY → 192.168.122.22

⑤ REGION_NAME_displayed_by_SiteAdminPage → REGION-01

Proxy 설정

/apps/whatap/conf/proxy.conf 파일을 편집하여 내 항목을 아래 값으로 변경합니다.

/apps/whatap/conf/proxy.conf

# Keeper#keeper=KEEPER_IP_accessable_from_PROXY:6789#server.name=PROXY-01keeper=192.168.122.22:6789 ①server.name=PROXY-01 ②secure_file_name=secure.conf

# Self Monitoringselfmon.enabled=false

① KEEPER_IP_accessable_from_PROXY → 192.168.122.22

② PROXY-01 → PROXY-01

Yard 설정

/apps/whatap/conf/yard.conf 파일을 편집하여 내 항목을 아래 값으로 변경합니다.

12.5. 확장형 설치 예제

Copyright 2019 WhaTap Labs Inc. All rights reserved. 55

/apps/whatap/conf/yard.conf

# Keeper#keeper=KEEPER_IP_accessable_from_YARD:6789#server.name=YARD-01keeper=192.168.122.22:6789 ①server.name=YARD-01 ②

# Portweb.port=7710data.port=6610

# Self Monitoringselfmon.enabled=false

# Noti#net_noti_ip=NOTI_IP_accessable_from_YARD#net_noti_port=6500

# NotiHubnotihub_enabled=true#notihub=127.0.0.1:6500notihub=192.168.122.21:6500 ③

① KEEPER_IP_accessable_from_YARD → 192.168.122.22

② YARD-01 → YARD-01

③ notihub=127.0.0.1:6500 → notihub=192.168.122.21:6500

12.5.3. 기동

Front 서버 기동Eureka, Front, Account 기동

①whatap@vmsvr01:/apps/whatap/bin$ ./control.sh eureka startwhatap@vmsvr01:/apps/whatap/bin$ ./control.sh front startwhatap@vmsvr01:/apps/whatap/bin$ ./control.sh account start

# 또는②whatap@vmsvr01:/apps/whatap/bin$ ./start_front.sh

① control 명령을 사용하여 각각의 데몬을 기동 할 수 있습니다.

② start_front 명령을 사용하여 일괄 기동 할 수 있습니다.

Notihub 기동

whatap@vmsvr01:/apps/whatap/bin$ ./control.sh notihub start

Yard 서버 기동Keeper, Gateway, Proxy, Yard 기동

①whatap@vmsvr02:/apps/whatap/bin$ ./control.sh keeper startwhatap@vmsvr02:/apps/whatap/bin$ ./control.sh gateway startwhatap@vmsvr02:/apps/whatap/bin$ ./control.sh proxy startwhatap@vmsvr02:/apps/whatap/bin$ ./control.sh yard start

# 또는②whatap@vmsvr02:/apps/whatap/bin$ ./start_yard.sh

① control 명령을 사용하여 각각의 데몬을 기동 할 수 있습니다.

12.5. 확장형 설치 예제

Copyright 2019 WhaTap Labs Inc. All rights reserved. 56

② start_yard 명령을 사용하여 일괄 기동 할 수 있습니다.

12.5.4. 설치 확인브라우저에서 http://192.168.122.21:8080 에 admin@whatap.io 로 접속 후 확인합니다.

1.우측 상단의 계정명 클릭해 "사이트 관리" 메뉴로 이동

1. 등록항목 확인 및 REGION-01 정보 확인

NOTIHUB, REGION-01, FRONT, ACCOUNT 항목이 보여지는지 확인 후 REGION-01의 화살표 버튼을 클릭해 이동

1. REGION-01 세부 정보 확인

KEEPER, PROXY, YARD 정보가 확인되면 정상 입니다

12.5. 확장형 설치 예제

Copyright 2019 WhaTap Labs Inc. All rights reserved. 57

1. 라이센스 정보 확인

http://서버접속정보/v2/admin/check URL로 접속하여 등록한 라이센스 정보가 올바른지 확인 합니다.

12.6. 알람연동

12.6.1. SMTP 연동SaaS 환경에서는 별도 설정 없이 이메일 계정을통해 알람 및 초대 발송이 가능하나 설치형 환경에서 이메일 발송을 위해 대상 환경의 SMTP 정보를 등록 해주어야 합니다.

SMTP 연동 설정은 $WHATAP_HOME/conf/notihub.conf 에서 MAIL 항목을 다음과 같이 변경합니다.

/apps/whatap/conf/notihub.conf

...

# Mailmail.smtp.debug=false ①mail.host= ②mail.username= ③mail.password= ④mail.smtp.protocol=smtpmail.port=25 ⑤mail.smtp.auth=true ⑥mail.smtp.ssl.enable=false ⑦mail.smtp.starttls.enable=true ⑧mail.smtp.starttls.required=true ⑧

...

12.6. 알람연동

Copyright 2019 WhaTap Labs Inc. All rights reserved. 58

① 상세 로그를 $WHATAP_HOME/logs/notihub.log 에 출력할 지 여부를 설정합니다.

② SMTP 서버 호스트 정보를 입력합니다.

③ SMTP 계정 정보를 입력합니다.

④ SMTP 계정에 대한 비밀번호를 입력합니다.

⑤ SMTP 포트 정보를 입력합니다.

⑥ SMTP 인증 여부를 설정합니다. 계정으로 인증하지 않는 경우 false 로 설정합니다.

⑦ SSL을 사용하는 경우 ture 로 설정합니다.

⑧ TLS를 사용하는 경우 ture 로 설정합니다.

notihub를 재기동 합니다.

$ ./control.sh notihub restart

12.6.2. 텔레그램 연동와탭의 알람은 텔레그램 메신저를 통해서도 수신 할 수 있습니다.

SaaS 서비스와 달리 설치형 서비스에서는 텔레그램 연동을 위해서는 토큰정보가 등록하고 봇을 생성하는 과정이 필요합니다.

텔레그램 클라이언트에서 @botfather 사용자를 채팅 목록에 추가합니다.

텔레그램 클라이언트에서 @BotFather를 검색하거나 웹 브라우저에서 https://telegram.me/botfather 주소로 접속해 @BotFather 사용자를 추가할 수 있습니다.

12.6. 알람연동

Copyright 2019 WhaTap Labs Inc. All rights reserved. 59

Figure 18. botfather 를 추가한 화면

새로운 봇을 생성하고 토큰을 발급 받습니다.

12.6. 알람연동

Copyright 2019 WhaTap Labs Inc. All rights reserved. 60

Figure 19. 봇 생성

① /newbot 을 입력합니다.

② 이름을 입력 합니다. 예) 와탭알람테스트

③ 계정정보를 입력합니다. 계정은 영문이며 bot으로 끝나야 합니다. 예) whatap_alarm_bot

④ 봇 생성이 완료되면 토큰이 발행됩니다.

생성한 계정으로 봇을 검색하고 대화방에 생성한 봇을 초대 합니다.

Figure 20. 생성한 계정으로 검색 후 추가

발급받은 텔레그램 토큰은 $WHATAP_HOME/conf/notihub.conf 에 추가 합니다.

12.6. 알람연동

Copyright 2019 WhaTap Labs Inc. All rights reserved. 61

/apps/whatap/conf/notihub.conf

telegram.token= ①

① telegram.token 속성으로 토큰을 등록 합니다.

notihub를 재기동 합니다.

$ ./control.sh notihub restart

관리 - 이벤트 설정 메뉴로 이동해 텔레그램 박스를 선택합니다.

생성된 봇과의 대화창에서 /help 를 입력하면 사용법이 안내됩니다.

알람을 받고자 하는 프로젝트의 라이센스를 봇에 등록하면 알람을 수신 할 수 있습니다.프로젝트의 라이센스는 에이전트 설정(whatap.conf)에 사용된 것과 동일하며 에이전트 설치 메뉴에서 확인 가능합니다.

/license <프로젝트 라이센스> ①

12.6. 알람연동

Copyright 2019 WhaTap Labs Inc. All rights reserved. 62

① 봇과의 대화창에 대상 프로젝트 라이센스를 등록합니다.

12.6.3. Slack 연동설치형 서비스에서 Slack 을 연동하기 위해서는 Custom App을 생성하고 해당 인증을 사용합니다.

Slack 에 로그인 후 https://api.slack.com/apps 로 이동합니다.

Figure 21. 만들기 버튼

Create an App 버튼을 클릭해 적당한 이름의 앱을 생성합니다.

12.6. 알람연동

Copyright 2019 WhaTap Labs Inc. All rights reserved. 63

Figure 22. App 생성메뉴

App Credentials 에서 인증 정보를 확인합니다.

12.6. 알람연동

Copyright 2019 WhaTap Labs Inc. All rights reserved. 64

Figure 23. 인증정보

OAuth & Permissions 메뉴를 선택해 Redirect URLs에 수집서버 URL을 등록합니다.

수집서버_URL/slack/auth 주소를 추가 합니다.

12.6. 알람연동

Copyright 2019 WhaTap Labs Inc. All rights reserved. 65

수접서버 WHATAP_HOME/conf/front.conf 에 확인한 인증정보를 추가 합니다.

slack.clientId=508472741975.529883672800slack.clientSecret=32634xxxxxxxxxxxxxxxxxxxxxxxxb1f

이벤트 알림을 수신하고자 하는 프로젝트의 관리 - 이벤트 설정 메뉴로 이동해 Add to Slack 버튼을 클릭합니다.

12.6. 알람연동

Copyright 2019 WhaTap Labs Inc. All rights reserved. 66

12.7. FAQ

12.7.1. 재설치설정 오류 혹은 설정 변경을 통해 문제를 해결할 수 없는 경우, 재설치 하는 과정을 안내합니다. 재설치 시, 기존 모니터링 정보는 폐기합니다.

로그 삭제

$ cd $WHATAP_PACKAGE $ rm -rf logs/*

모니터링 데이터 삭제

$ cd $WHATAP_PACKAGE $ rm -rf yardbase/*

DB 삭제

$ cd $WHATAP_PACKAGE $ rm -rf db/*.db

이후 재설치 과정은 신규 설치 과정과 동일합니다.

12.7.2. 사이트 관리자 패스워드사이트 관리자 계정(admin@whatap.io) 은 변경 불가합니다. 사이트 관리자 계정의 패스워드는 front.conf의 admin.password 를 통해 설정가능합니다.

12.7.3. 포트 변경어플리케이션 서버는 디폴트로 지정된 포트가 사전 점유되어 있는 경우, 포트 번호를 +1씩 증가시켜 가용한 포트를 활용합니다. 임의로 포트를 지정하여사용해야 할 경우 다음의 옵션을 적용합니다.

파일 설정 용도 디폴트

front.conf web.port 사이트 접근 8080

proxy.conf data.port 모니터링 데이터 수신 (서버측) 6600

whatap.conf whatap.server.port 모니터링 데이터 전송(에이전트) 6600

12.7.4. 설치 파일 다운로드문의처로 요청시 Google Drive 및 AWS S3를 통해 제공 (라이센스 요청 시 별도 제공)

12.7.5. MySQL DB 사용수집된 모니터링 데이터는 RDB 를 사용하지 않고 와탭 만의 독자적인 저장구조를 가지지만 이외 계정 정보, 구성 정보, 알림 발송 이력은 내장 DB인 H2를사용합니다. 이를 MySQL DB로 변경하는 방법 입니다.

계정 정보 및 구성 정보 DB로 MySQL 사용은 $WHATAP_HOME/conf/account.conf 을 변경합니다.

MySQL에서 account 명의 DB와 CRUD 권한이 있는 whatap_dbuser 가 존재 해야 합니다.

12.7. FAQ

Copyright 2019 WhaTap Labs Inc. All rights reserved. 67

/apps/whatap/conf/account.conf

...

# DB# Relative path from Home or Absolute path#h2.file.path=./db ①#db_driver=org.h2.Driver ①#h2_auto_server=true ①#h2_bind_address=127.0.0.1 ①#jpa_ddl_auto=update ①#db_name=account ①#db_name_project=account ①

# DB for MySQLdb_driver=com.mysql.jdbc.Driver ②jdbc_url=jdbc:mysql://127.0.0.1:3306 ②db_username=whatap_dbuser ②db_password=whatap_dbpassword ②db_name=account ②db_name_project=account ②

...

① 기존 설정은 주석처리 하거나 삭제 합니다.

② 사용 할 Mysql DB 정보를 입력 합니다.

알림 이력의 MySQL 사용은 $WHATAP_HOME/conf/notihub.conf 에서 DB 항목을 다음과 같이 변경합니다.

/apps/whatap/conf/notihub.conf

...

# H2 DB# Relative path from Home or Absolute path#h2.file.path=./db ①#h2_auto_server=true ①#db_driver_event=org.h2.Driver ①#h2_bind_address=0.0.0.0 ①

db_driver_event=com.mysql.jdbc.Driver ②jdbc_url_event=jdbc:mysql://127.0.0.1:3306 ②db_username_event=whatap_dbuser ②db_password_event=whatap_dbpassword ②db_name_event=account ②

...

① 기존 설정은 주석처리 하거나 삭제 합니다.

② 사용 할 Mysql DB 정보를 입력 합니다.

관련 서비스를 재기동 합니다.

$ ./control.sh account restart$ ./control.sh notihub restart

자동생성되는 DDL 문제로 MySQL 사용시 컬럼정보 수정이 필요합니다.

ALTER TABLE EventPolicy MODIFY Rules TEXT;

12.7.6. Windows 환경 수집서버의 응답지연Windows 2012 이상에서 ECN Capability 로 인해 수집서버의 반응 지연이 발생할 수 있습니다. 이 경우 ECN Capability 기능을 Disable 합니다.

CMD 관리자권한

netsh int tcp set global ecncapability=disabled

12.7. FAQ

Copyright 2019 WhaTap Labs Inc. All rights reserved. 68

네트워크가 느린 시절 과도한 데이터 트래픽으로 인한 네트워크 붕괴 현상이 문제가 되었고 이를 막기 위해 TCP 혼잡 제어(TCPCongestion Control) 알고리즘이 제안/적용되었습니다. 기본적으로 TCP 혼잡 제어는 TCP 데이터 송신자 측에서 패킷 유실발생(혹은 그에 준하는 상태)을 감지한 이후 송신자의 데이터 전송률을 낮추는 방식으로 동작합니다.

12.7.7. 문의처송재진 (jjsong@whatap.io, 010.7288.3384) 박명규 (mkpark@whatap.io, 010.8972.4012)

12.7. FAQ

Copyright 2019 WhaTap Labs Inc. All rights reserved. 69

Chapter 13. 에이전트 설치 안내서

Chapter 13. 에이전트 설치 안내서

Copyright 2019 WhaTap Labs Inc. All rights reserved. 70

Chapter 14. 설치 사전 안내서제목 : Prepare guidelines작성자 : WhaTap Support이메일 : support@whatap.io날짜 : 2021-01-20버전 : 1.0.3

설명 : 본 문서는 SaaS 환경의 WhaTap 에이전트 설치를 검토하기 위한 가이드 입니다. 문서에 관한 문의는 support@whatap.io 로 연락 주시기바랍니다.

14.1. 방화벽와탭 에이전트는 수집서버 TCP 6600 포트로 접속 가능해야 합니다.

Table 5. APM - 수집서버

출발지 목적지 목적지 IP 포트

와탭 APM 에이전트 와탭 수집서버 52.78.209.94 / 52.78.224.235 TCP 6600

Table 6. Infra - 수집서버

출발지 목적지 목적지 IP 포트

와탭 Infra 에이전트 와탭 수집서버 13.124.11.223 / 13.209.172.35 TCP 6600

Table 7. DB - 수집서버

출발지 목적지 목적지 IP 포트

와탭 DB 에이전트 와탭 수집서버 210.122.38.128 / 210.122.38.170 TCP 6600

에이전트에서 수집서버로 직접 접속이 어려운 경우 제공하는 Proxy 모듈을 사용해 경유 할 수 있습니다.

Figure 24. Proxy

14.1. 방화벽

Copyright 2019 WhaTap Labs Inc. All rights reserved. 71

14.2. 지원환경APM / Infra / DB Agent별 지원 환경은 다음과 같습니다.지원 환경에 포함되지 않는경우 support@whatap.io 로 별도 문의 주시기를 부탁 드립니다.

Table 8. 제품 지원 환경

제품 환경 지원 환경

APM Agent Java Java6 이상Java10 이하

NodeJS NodeJS 0.1.12 이상

PHP PHP 5.2 이상

Python Python 2.7, 3.3 이상

Infra Agent Windows Windows 2008R2 이상

Linux Debian 7.0 이상Ubuntu 12.04 이상Centos, Readhat 6.0 이상Amazon Linux 1.0 이상SUSE 12.1 이상

FreeBSD FreeBSD 10 이상

DB Agent Oracle Oracle 10G 이상

PgSQL PostgreSQL, EDBPAS 9.2 이상

MySQL MySQL, MariaDB 5.2 이상

MSSQL SQLServer 2005 이상

Tibero Tibero 5 이상

DB Agent 적용시 DB Repository(Dictionary, performance_schema) 조회 권한이 있는 모니터링용 계정이 필요합니다.

14.3. 회원가입와탭 모니터링 UI는 웹브라우저와 모바일 앱을 통해 사용합니다.

1. http://www.whatap.io 로 접속 하여 무료로시작하기 버튼을 클릭합니다.

2. 회사명, 이름, 이메일계정, 비밀번호, SMS 인증 정보를 입력하여 회원가입을 진행합니다.

3. 회원가입 완료 후 등록한 이메일로 가입 승인 안내 메일이 전송됩니다.

4. 이메일을 확인하여 가입승인을 완료하면 와탭 계정이 생성 됩니다.

지원하는 브라우저 범위는 다음과 같습니다.

Table 9. 지원 브라우저

브라우저 권장여부 지원버전

Google Chrome O 58 이상

Mozilla FireFox O 52 이상

Edge O 38.14393 이상

Safari X Untested

Internet Explorer X 11 이상

브라우저 호환성과 성능을 이유로 Chrome, Firefox 최신버전 사용을 권장 합니다.

모바일 앱은 앱스토어에서 다운로드 받을 수 있습니다.

14.2. 지원환경

Copyright 2019 WhaTap Labs Inc. All rights reserved. 72

• : https://play.google.com/store/apps/details?id=io.whatap.app.WhaTap

• : https://itunes.apple.com/kr/app/whatap/id1252504621?mt=8

14.4. 설치안내 사항을 확인했다면 회원가입한 계정으로 로그인 하고 Agent별 설치화면 안내에 따라 설치를 진행 합니다. 더 자세한 사항은 와탭 가이드 내 Agent Guide에서 확인 할 수 있습니다.

궁금한 사항은 support@whatap.io 로 문의 주시면 됩니다.

14.4. 설치

Copyright 2019 WhaTap Labs Inc. All rights reserved. 73