目次 개정이력 버전 비고 WhaTap PHP モニタリングインストールガイドドラフト PHP 拡張モジュール及びサービスの選択インストール追加 PHP 拡張モジュール及びサービスのマニアルインストール設定追

(1)

에이전트 네트워크 통신에 관한 설정

この文書は WhaTap アプリケーションモニタリングサービスユーザーのエージェントインストールをお手伝いするために作成された文書です。この文書は WhaTap の固有資産であり、再配布及び利用のためには WhaTap([email protected])にてお問い合わせください。

PHP Application

Monitoring

(2)

개정 이력

버전 비고 1.0 2017.07.19 WhaTap PHP モニタリングインストールガイドドラフト 1.1 2017.07.26 PHP 拡張モジュール及びサービスの選択インストール追加 1.2 2017.08.29 PHP 拡張モジュール及びサービスのマニアルインストール設定追加、問題解決の内容追加.

(3)

1 WHATAP PHP アプリケーションモニタリングの概要 ... 7 2 インストール環境 ... 9 2.1 オペレーティングシステム ... 9 2.2 PHP ... 9 2.3 ファイアワール（ネットワーク） ... 9 3 インストール ... 11 3.1 CENTOS ... 11 3.1.1 WhaTap リポジトリ ... 11 3.1.2 パッケージ ... 11 3.1.3 PHP 拡張モジュール及びサービス ... 11 3.1.4 PHP 拡張モジュール及びサービス選択インストール ... 11 3.1.5 サービスの再起動... 12 3.2 DEBIAN/UBUNTU ... 12 3.2.1 WhaTap リポジトリ ... 12 3.2.2 パッケージ ... 13 3.2.3 PHP 拡張モジュール及びサービス ... 13 3.2.4 PHP 拡張モジュール及びサービスの選択 ... 13 3.2.5 サービスの再起動... 14 4 PHP 拡張モジュール及びサービスのマニアル設定 ... 15 4.1 WHATAP.INIファイルの生成 ... 15 4.1.1 whatap.license ... 15 4.1.2 whatap.server.host ... 15 4.1.3 whatap.app_name ... 15 4.1.4 whatap.app_process_name ... 16 4.2 PHP コマンドの絶対パス確認 ... 16

(4)

4.4.1 Apache ... 17 4.4.2 PHP-FPM ... 17 4.5 PHP 拡張モジュールの絶対パス確認及び設定 ... 17 4.5.1 PHP 拡張モジュールの絶対パス確認 ... 17 4.5.2 PHP 拡張モジュールの設定 ... 18 4.5.3 whatap-php サービスの環境変数設定 ... 18 4.6 WHATAP.INI 설정 ... 19 4.6.1 PHP の ini ファイル追加ディレクトリ確認 ... 19 4.6.2 PHP の ini ファイル追加ディレクトリの確認不可... 19 4.6.3 WHATAP-PHP 서비스 환경 변수 설정 ... 20 4.7 サービスの再起動 ... 20 5 インストールの確認 ... 22 5.1 PHP 拡張モジュール ... 22 5.1.1 PHP の INI ファイル追加ディレクトリに whatap.ini が生成されていることを確認 22 5.1.2 PHP 拡張モジュールディレクトリに whatap.so ファイルが生成されていることを確認 ... 22 5.1.3 PHP 拡張モジュールがロードされていることを確認 ... 22 5.2 WHATAP-PHPサービス状態 ... 23 6 構成フアィル ... 24 6.1 PHP 拡張モジュール INI ... 24 6.2 PHP 拡張モジュール ... 24 6.3 WHATAP PHP モニラリングデフォルトディレクトリ ... 24 6.4 WHATAP-PHPサービス ... 24 6.5 WHATAP PHP モニタリングインストールスクリプト ... 24 6.6 ログファイル ... 24 7 削除 ... 26 7.1 PHP 拡張モジュール及びサービス ... 26

(5)

Whatap PHPアプリケーションモニタリングの概要

1 Whatap PHP アプリケーションモニタリングの概

要

 WhaTap はモニタリングサーバーを SaaS 型で提供しますのでユーザーはモニタリングサーバーのインストールなしで、モニタリング対象アプリケーションへエージェントをインストールするだけで、PHP 基盤アプリケーションサーバーの性能モニタリングができます。  モニタリング情報の収集及びユーザーの必要となる情報の抽出は WhaTap サーバーで行われますのでユーザーはブラウザーを通じアプリケーションの性能情報を活用できます。  WhaTap アプリケーションモニラリングサービスはプロジェクト単位でサーバーを管理できる機能を提供するためプロジェクトに纏まった性能情報を単一画面でご確認できます。

(8)

(9)

インストール環境

2 インストール環境

2.1 オペレーティングシステム

 CentOS 64bit 6.x 以上  Ubuntu 64bit 14.x 以上

2.2 PHP

 5.4, 5.5, 5.6, 7.0, 7.1

 非スレッドセーフ（None Tread Safe）方式対応  スレッドセーフ（Tread Safe）方式対応

2.3 ファイアワール（ネットワーク）

 WhaTap サーバーへのデータ送信のために 6600 アウトバウンドポートをオプンす

る必要があります。

(10)

(11)

インストール

3 インストール

3.1 CentOS

3.1.1 WhaTap リポジトリ

sudo rpm -Uvh http: //repo.whatap.io/centos/5/noarch/whatap-repo-1.0-1.noarch.rpm

3.1.2 パッケージ

sudo yum install whatap-php

3.1.3 PHP 拡張モジュール及びサービス

sudo /usr/whatap/php/install.sh

Input license key

xxxxxxxxxxxxxxxx <= [プロジェクトで発行したライセンスkey 入力]

Input whatap.server.host

192.x.x.x <= [プロジェクト設定で確認したServer Ip 入力]

(12)

インストール

 いくつかの php がインストールされている場合、

 CLI(コマンドラインインタフェース)で php5、php70、php-zts、zts-php を利用する場合、

sudo /usr/whatap/php/install.sh manual

Input license key

xxxxxxxxxxxxxxxx <= [プロジェクトで発行したライセンスkey 入力]

192.x.x.x <= [プロジェクトで確認した Server Ip を入力]

Input : which apache or php-fpm ex)/usr/sbin/httpd, /usr/sbin/apache2,

/usr/sbin/php-fpm ...

/usr/sbin/httpd <= [apache 及び php-fpm コマンドの絶対パス入力]

Input : which php ex) /usr/bin/php, /usr/bin/php5, /usr/bin/php70 ...

/usr/bin/php5 <= [php コマンドの絶対パス]

3.1.5 サービスの再起動

 Apache 及び PHP-FPM を再起動します。

3.2 Debian/Ubuntu

3.2.1 WhaTap リポジトリ

wget http://repo.whatap.io/debian/release.gpg O |sudo aptkey add

-wget http://repo.whatap.io/debian/whatap-repo_1.0_all.deb

(13)

インストール

3.2.2 パッケージ

sudo apt-get install whatap-php

3.2.3 PHP 拡張モジュール及びサービス

sudo /usr/whatap/php/install.sh

Input license key

xxxxxxxxxxxxxxxx <= [プロジェクトで発行したライセンスkey を入力]

192.x.x.x <= [プロジェクトで確認したServer Ip を入力]

3.2.4 PHP 拡張モジュール及びサービスの選択

 いくつかの php が共にインストールされている場合、

 CLI コマンドで php5、php70、php-zts、zts-php を利用する場合、

sudo /usr/whatap/php/install.sh manual

Input license key

xxxxxxxxxxxxxxxx <= [プロジェクトで発行したライセンスkey を入力]

(14)

インストール

Input : which apache or php-fpm ex)/usr/sbin/httpd, /usr/sbin/apache2,

/usr/sbin/php-fpm ...

/usr/sbin/httpd <= [apache 及び php-fpm コマンドの絶対パスを入力]

Input : which php ex) /usr/bin/php, /usr/bin/php5, /usr/bin/php70 ...

/usr/bin/php5 <= [php コマンドの絶対パスを入力]

3.2.5 サービスの再起動

(15)

PHP拡張モジュール及びサービスのマニアル設定

4 PHP 拡張モジュール及びサービスのマニアル設定

- PHP拡張モジュール、サービスのインストール及び選択インストール(install.sh)が失敗した場合、マニアルで設定する方法を説明します。 - PHPコンパイルインストール等の理由で環境情報の確認ができない場合利用します。コンパイルインストールなどで環境情報が確認できない場合利用します。

4.1 whatap.ini ファイルの生成

cp /usr/whatap/php/template.ini /usr/whatap/php/whatap.ini vi /usr/whatap/php/whatap.ini

=> 上段へ内容追加

; Enable whatap extension module

extension=whatap.so

whatap.license=[プロジェクトで発行したライセンスキー] whatap.server.host=[プロジェクトで確認したServer Ip]

whatap.app_name=[ウェブサーバーの種類 APHP, FPHP (apache : APHP, php-fpm :

FPHP)]

whatap.app_process_name=[apache, php-fpmのプロセス名(httpd,php-fpm)]

4.1.1 whatap.license

 プロジェクト > 管理 > エージェントインストール画面で発行したライセンスキーを確認します。

4.1.2 whatap.server.host

 プロジェクト > 管理 > エージェントインストール画面でサーバーIPを確認します。

4.1.3 whatap.app_name

(16)

PHP拡張モジュール及びサービスのマニアル設定

 apacheサーバーはAPHP、php-fpmはFPHPを利用します。

4.1.4 whatap.app_process_name

 apache又はphp-fpmの実行中プロセス名を正確に入力すると該当プロセスが使用するメモリが収集されます。例) httpd、apach2、php-fpm、php-fpmなど

4.2 PHP コマンドの絶対パス確認

which php => 結果 /usr/bin/php

4.2.1 whatap-php サービスの環境変数設定

sudo vi /etc/init.d/whatap-php

=> 設定

export WHATAP_PHP_BIN=[PHP 명령어 위치(/usr/bin/php)]

 WHATAP_PHP_BIN環境変数へPHP CLIコマンドの絶対パスを設定します。

4.3 PHP API のバージョン確認

sudo php -i | grep 'PHP API'

(17)

PHP拡張モジュール及びサービスのマニアル設定

4.4 PHP ZTS(Zend Thread Safe)対応可否確認

4.4.1 Apache

sudo apachectl -V | grep MPM

=> 結果

Server MPM: Prefork <= ZTS 利用不可

Server MPM: Worker <= ZTS 利用可能

4.4.2 PHP-FPM

sudo php-fpm -i | grep Thread

=> 結果

Thread Safety => disabled <= ZTS 利用不可

Thread Safety => enabled <= ZTS 利用可能

4.5 PHP 拡張モジュールの絶対パス確認及び設定

4.5.1 PHP 拡張モジュールの絶対パス確認

(18)

PHP拡張モジュール及びサービスのマニアル設定

=> 結果

extension_dir => /usr/lib64/php/modules => /usr/lib64/php/modules

4.5.2 PHP 拡張モジュールの設定

 PHP APIのバージョン、PHP ZTSの利用可否を確認し、環境に適切なライブラリーを選択し、PHP Extensionディレクトリへ「whatap.so」のファイル名でコピーします。  PHP ZTSが利用可能な場合 - whatap_zts_[PHP APIのバージョン].so  PHP ZTSが利用不可の場合 - whatap_[PHP APIのバージョン].so

sudo cp /usr/whatap/php/modules/x64/whatap_20100412.so

/usr/lib64/php/modules/whatap.so

4.5.3 whatap-php サービスの環境変数設定

=> 設定

export WHATAP_PHP_EXT_HOME=[PHP Extension

ディレックトリ(/usr/lib64/php/modules)]

export WHATAP_PHP_EXT_SRC=[WhaTap ライブラリーディレクトリ及びファイル名 (/usr/whatap/php/modules/x64/whatap_20100412.so)]

 「WHATAP_PHP_EXT_HOME」環境変数へPHP拡張モジュールのディレクトリを設定します。

(19)

PHP拡張モジュール及びサービスのマニアル設定

4.6 whatap.ini 설정

4.6.1 PHP の ini ファイル追加ディレクトリ確認

sudo php -i | grep '.ini files'

=> 結果

Scan this dir for additional .ini files => /etc/php.d  whatap.iniを該当ディレクトリへコピーします。

sudo cp /usr/whatap/php/whatap.ini /etc/php.d/whtap/ini

4.6.2 PHP の ini ファイル追加ディレクトリの確認不可

sudo php -i | grep '.ini files'

=> 結果

Scan this dir for additional .ini files => (none)

 PHPコンパイルインストールの際「--with-config-file-scan-dir=PATH」オプションの設定されてない場合、

 whatap.iniファイルの内容をphp.iniファイルの末尾に追加します。

php -i | grep 'php.ini'

(20)

PHP拡張モジュール及びサービスのマニアル設定

Loaded Configuration File => /etc/php.ini sudo vi php.ini

=> 追加 [whatap]

Enable whatap extension module

extension=whatap.so

whatap.ext.error_enabled=true

whatap.ext.exception_enabled=true

whatap.trace_user_enabled=true

whatap.trace_user_using_ip=false

 その他のオプションは「/usr/whatap/php/whatap.ini」を利用します。

4.6.3 whatap-php 서비스 환경 변수 설정

=> 設定

export WHATAP_CONFIG_HOME=[whatap.ini の絶対パス(/etc/php.d)]

 「WHATAP_CONFIG_HOME」環境変数へwhatap.iniの絶対パス設定します。  PHPのiniファイル追加ディレクトリを確認できない場合、whatap.iniを生成した「/usr/whatap/php」を設定します。

4.7 サービスの再起動

 Apache及びPHP-FPMの再起動します。  whatap-phpサービスの再起動します。

(21)

(22)

インストールの確認

5 インストールの確認

5.1 PHP 拡張モジュール

5.1.1 PHP の INI ファイル追加ディレクトリに whatap.ini が生成され

ていることを確認

find / | grep whatap.ini

5.1.2 PHP 拡張モジュールディレクトリに whatap.so ファイルが生

成されていることを確認

find / | grep whatap.so

5.1.3 PHP 拡張モジュールがロードされていることを確認

sudo php -m

=> 結果

[PHP Modules]

(23)

インストールの確認

Core ctype curl date … whatap <= WhaTap モジュールロードを確認 … [Zend Modules]

5.2 whatap-php サービス状態

(24)

構成ファイル

6 構成フアィル

6.1 PHP 拡張モジュール INI

 サーバーPHP 拡張モジュール INI ディレクトリの whatap.ini

6.2 PHP 拡張モジュール

 サーバーPHP 拡張モジュールディレクトリの whatap.so

6.3 WhaTap PHP モニラリングデフォルトディレクトリ

 /usr/whatap/php/

6.4 whatap-php サービス

 /etc/init.d/whatap-php  /usr/whatap/php/whatap_php

6.5 WhaTap PHP モニタリングインストールスクリプト

 /usr/whatap/php/install.sh

6.6 ログファイル

 PHP Extension ログはウェブサーバーのデフォルトログ設定が適用されます。  whatap-php ログは「/usr/whatap/php/logs/」ディレクトリへ生成されます。

(25)

(26)

削除

7 削除

7.1 PHP 拡張モジュール及びサービス

 whatap.ini、whatap.so、whatap-php service の自動停止

/usr/whatap/php/install.sh remove

7.2 パッケージ

7.2.1 CentOS

sudo yum remove whatap-php

7.2.2 Debian/Ubuntu

sudo apt-get purge whatap-php

(27)

(28)

一時停止

8 一時停止

8.1 PHP Extension の停止

 whatap.ini ファイルの「extension=」設定をコメントアウトします。  マニアル設定により php.ini へ直接設定を行った場合も同様に「extension=」設定をコメントアウトします。

sudo vi whatap.ini extension=whatap.so

;コメント

;extension=whatap.so

8.2 Whatap-php サービスの中止

(29)

(30)

問題解決

9 問題解決

9.1 PHP 拡張モジュール及びサービス(install.sh)

9.1.1 Error: Not found PHP API

 PHP CLIコマンドを見つけられない場合に発生します。

 PHP CLIコマンドのパスを正確に見つけ出し、「3.1.4. PHP拡張モジュール及びサービスの選択インストール」節の内容を参考し設定を行います。  PHP APIのバージョン情報を確認します。

sudo php -i | grep 'PHP API'

=> 결과

PHP API => 20100412

9.1.2 Error: Error: Not found PHP ini directory

 PHP環境で「Scan this dir for additional .ini files」のようにINIファイルの追加ディレクトリが確認できない場合に発生します。

 PHPコンパイルインストールの際に「--with-config-file-scan-dir=PATH」のオプション設定がない場合に発生します。

 PHP CLIコマンドの絶対パスを確認し、「4. PHP拡張モジュール及びサービスのマニアル設定」章の内容を参考し設定を行います。

(31)

問題解決

Scan this dir for additional .ini files => (none)

9.2 サービス

9.2.1 ダッシュボード > ヒットマップにトランザクションが

表示されない場合

 CPU、メモリチャートは正常に現れてヒットマップだけが現れない現象はエージェントと収集サーバーの通信は正常でPHP Extenionの適用が失敗した場合に発生します。  PHP Extensionのロード状態を確認します。 sudo php -m => 結果 [PHP Modules] bz2 calendar Core ctype curl date … whatap <= whatap モジュールのロード状態を確認 … [Zend Modules] => 追加  PHP Extensionがロードされている場合はサービス(Apache、PHP-FPM)の再起動を行います。

(32)

問題解決

 PHP Extensionロード状態が確認できなかった場合は正常にインストールされてないからであるため、「whatap.so」又は「whatap.ini」ファイルのパスがPHP 環境と一致するのかを確認します。(4.2 PHPコマンドの絶対パス確認、4.5.1 PHP Extensionの絶対パス確認、4.6.1 PHPの追加iniファイル設定ディレクトリの確認)

(33)

[email protected] (주)와탭랩스 www. whatap.io 서울특별시 강남구 테헤란로 69길 5 유기타워 11F (06160) Tel. 02.565. 1803