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

Size: px

Start display at page:

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

ああすちゃわんや
5 years ago
Views:

アプリケーションモニタリングサービスユーザーのエージェントインストールをお手伝いするために作成された文書です

1 에이전트네트워크통신에관한설정 PHP Application Monitoring Agent Install Guide この文書は WhaTap アプリケーションモニタリングサービスユーザーのエージェントインストールをお手伝いするために作成された文書ですこの文書は WhaTap の固有資産であり再配布及び利用のためにはにてお問い合わせください Copyright 2017 WhaTap Developed by WhaTap Labs Inc.

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

3 目次目次 1 WHATAP PHP アプリケーションモニタリングの概要インストール環境オペレーティングシステム PHP ファイアワール ( ネットワーク ) インストール CENTOS WhaTap リポジトリパッケージ PHP 拡張モジュール及びサービス PHP 拡張モジュール及びサービス選択インストールサービスの再起動 DEBIAN/UBUNTU WhaTap リポジトリパッケージ PHP 拡張モジュール及びサービス PHP 拡張モジュール及びサービスの選択サービスの再起動 PHP 拡張モジュール及びサービスのマニアル設定 WHATAP.INI ファイルの生成 whatap.license whatap.server.host whatap.app_name whatap.app_process_name PHP コマンドの絶対パス確認 WHATAP-PHP サービスの環境変数設定

4 目次 4.3 PHP API のバージョン確認 PHP ZTS(ZEND THREAD SAFE) 対応可否確認 Apache PHP-FPM PHP 拡張モジュールの絶対パス確認及び設定 PHP 拡張モジュールの絶対パス確認 PHP 拡張モジュールの設定 whatap-php サービスの環境変数設定 WHATAP.INI 설정 PHP の ini ファイル追加ディレクトリ確認 PHP の ini ファイル追加ディレクトリの確認不可 WHATAP-PHP 서비스환경변수설정 サービスの再起動インストールの確認 PHP 拡張モジュール PHP の INI ファイル追加ディレクトリに whatap.ini が生成されていることを確認 PHP 拡張モジュールディレクトリに whatap.so ファイルが生成されていることを確認 PHP 拡張モジュールがロードされていることを確認 WHATAP-PHP サービス状態構成フアィル PHP 拡張モジュール INI PHP 拡張モジュール WHATAP PHP モニラリングデフォルトディレクトリ WHATAP-PHP サービス WHATAP PHP モニタリングインストールスクリプトログファイル削除 PHP 拡張モジュール及びサービスパッケージ

5 目次 CentOS Debian/Ubuntu /usr/whatap/php ディレクトリ削除一時停止 PHP EXTENSION の停止 WHATAP-PHP サービスの中止問題解決 PHP 拡張モジュール及びサービス (INSTALL.SH) ERROR: NOT FOUND PHP API ERROR: ERROR: NOT FOUND PHP INI DIRECTORY サービスダッシュボード > ヒットマップにトランザクションが表示されない場合 31 5

6 目次 6

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

8 Whatap PHP アプリケーションモニタリングの概要 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 アウトバウンドポートをオプンする必要がありますサーバー内部の UDP 通信のために 6600 ポートが使われます 9

10 インストール環境 10

11 インストール 3 インストール 3.1 CentOS WhaTap リポジトリ sudo rpm -Uvh パッケージ sudo yum install whatap-php PHP 拡張モジュール及びサービス sudo /usr/whatap/php/install.sh Input license key xxxxxxxxxxxxxxxx <= [ プロジェクトで発行したライセンス key 入力 ] Input whatap.server.host 192.x.x.x <= [ プロジェクト設定で確認した Server Ip 入力 ] PHP 拡張モジュール及びサービス選択インストール 11

12 インストールいくつかの php がインストールされている場合 CLI( コマンドラインインタフェース ) で php5 php70 php-zts zts-php を利用する場合 sudo /usr/whatap/php/install.sh manual Input license key xxxxxxxxxxxxxxxx <= [ プロジェクトで発行したライセンス key 入力 ] Input whatap.server.host 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 コマンドの絶対パス ] サービスの再起動 Apache 及び PHP-FPM を再起動します 3.2 Debian/Ubuntu WhaTap リポジトリ wget -O - sudo apt-key add - wget sudo dpkg -i whatap-repo_1.0_all.deb sudo apt-get update 12

13 インストールパッケージ sudo apt-get install whatap-php PHP 拡張モジュール及びサービス sudo /usr/whatap/php/install.sh Input license key xxxxxxxxxxxxxxxx <= [ プロジェクトで発行したライセンス key を入力 ] Input whatap.server.host 192.x.x.x <= [ プロジェクトで確認した Server Ip を入力 ] PHP 拡張モジュール及びサービスの選択いくつかの php が共にインストールされている場合 CLI コマンドで php5 php70 php-zts zts-php を利用する場合 sudo /usr/whatap/php/install.sh manual Input license key xxxxxxxxxxxxxxxx <= [ プロジェクトで発行したライセンス key を入力 ] Input whatap.server.host 192.x.x.x <= [ プロジェクトで確認した Server Ip を入力 ] 13

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 コマンドの絶対パスを入力 ] サービスの再起動 Apache 及び PHP-FPM を再起動します 14

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)] whatap.license プロジェクト > 管理 > エージェントインストール画面で発行したライセンスキーを確認します whatap.server.host プロジェクト > 管理 > エージェントインストール画面でサーバー IP を確認します whatap.app_name 15

16 PHP 拡張モジュール及びサービスのマニアル設定 apache サーバーは APHP php-fpm は FPHP を利用します whatap.app_process_name apache 又はphp-fpmの実行中プロセス名を正確に入力すると該当プロセスが使用するメモリが収集されます例 ) httpd apach2 php-fpm php-fpmなど 4.2 PHP コマンドの絶対パス確認 which php => 結果 /usr/bin/php 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' => 結果 PHP API =>

17 PHP 拡張モジュール及びサービスのマニアル設定 4.4 PHP ZTS(Zend Thread Safe) 対応可否確認 Apache sudo apachectl -V grep MPM => 結果 Server MPM: Prefork Server MPM: Worker <= ZTS 利用不可 <= ZTS 利用可能 PHP-FPM sudo php-fpm -i grep Thread => 結果 Thread Safety => disabled Thread Safety => enabled <= ZTS 利用不可 <= ZTS 利用可能 4.5 PHP 拡張モジュールの絶対パス確認及び設定 PHP 拡張モジュールの絶対パス確認 sudo php -i grep extension_dir 17

18 PHP 拡張モジュール及びサービスのマニアル設定 => 結果 extension_dir => /usr/lib64/php/modules => /usr/lib64/php/modules 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_ so /usr/lib64/php/modules/whatap.so whatap-php サービスの環境変数設定 sudo vi /etc/init.d/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_ so)] WHATAP_PHP_EXT_HOME 環境変数へPHP 拡張モジュールのディレクトリを設定します WHATAP_PHP_EXT_SRC 環境変数へWhaTapライブラリーディレクトリ及びファイル名を設定します 18

19 PHP 拡張モジュール及びサービスのマニアル設定 4.6 whatap.ini 설정 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 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' => 結果 19

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 を利用します whatap-php 서비스환경변수설정 sudo vi /etc/init.d/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 サービスの再起動します 20

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

22 インストールの確認 5 インストールの確認 5.1 PHP 拡張モジュール PHP の INI ファイル追加ディレクトリに whatap.ini が生成されていることを確認 find / grep whatap.ini PHP 拡張モジュールディレクトリに whatap.so ファイルが生成されていることを確認 find / grep whatap.so PHP 拡張モジュールがロードされていることを確認 sudo php -m => 結果 [PHP Modules] bz2 calendar 22

23 インストールの確認 Core ctype curl date whatap [Zend Modules] <= WhaTap モジュールロードを確認 5.2 whatap-php サービス状態 service whatap-php status 23

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/ ディレクトリへ生成されます 24

25 構成ファイル 25

26 削除 7 削除 7.1 PHP 拡張モジュール及びサービス whatap.ini whatap.so whatap-php service の自動停止 /usr/whatap/php/install.sh remove 7.2 パッケージ CentOS sudo yum remove whatap-php Debian/Ubuntu sudo apt-get purge whatap-php /usr/whatap/php ディレクトリ削除 26

27 削除 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 サービスの中止 sudo service whatap-php stop 28

29 一時停止 29

30 問題解決 9 問題解決 9.1 PHP 拡張モジュール及びサービス (install.sh) Error: Not found PHP API PHP CLIコマンドを見つけられない場合に発生します PHP CLIコマンドのパスを正確に見つけ出し PHP 拡張モジュール及びサービスの選択インストール節の内容を参考し設定を行います PHP APIのバージョン情報を確認します sudo php -i grep 'PHP API' => 결과 PHP API => 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 拡張モジュール及びサービスのマニアル設定章の内容を参考し設定を行います sudo php -i grep '.ini files' => 結果 30

31 問題解決 Scan this dir for additional.ini files => (none) 9.2 サービスダッシュボード > ヒットマップにトランザクションが表示されない場合 CPU メモリチャートは正常に現れてヒットマップだけが現れない現象はエージェントと収集サーバーの通信は正常でPHP Extenionの適用が失敗した場合に発生します PHP Extensionのロード状態を確認します sudo php -m => 結果 [PHP Modules] bz2 calendar Core ctype curl date whatap [Zend Modules] => 追加 <= whatap モジュールのロード状態を確認 PHP Extension がロードされている場合はサービス (Apache PHP-FPM) の再起動を行います 31

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

33 Thank you ( 주 ) 와탭랩스 www. whatap.io 서울특별시강남구테헤란로 69 길 5 유기타워 11F (06160) Tel Fax

Helix Swarm2018.1インストール手順

Helix Swarm2018.1インストール手順 2018 Helix Swarm2018.1 インストール手順パッケージインストール編目次はじめに... 2 インストールの流れ... 2 1. インストール準備... 3 1.1 リポジトリ設定の追加... 3 1.2 GPG キー ( 公開鍵 ) インストール... 4 1.3 EPEL パッケージのインストール... 4 2. Helix Swarm/ オプショナルパッケージのインストール...