지원 버전 또한 향후 확장 지원 계획 상세: 지원 계획
| 디펜던시 | 버전 | 부가 |
|---|---|---|
| PHP | php 7+ |
|
| GO | ||
| GCC | GCC 4.7+ |
C++11 |
| cmake | cmake 3.2+ |
|
| *inux | windows is on the way |
|
| pinpoint | 2.0+ |
|
| composer | class can be automatic pinpoint-cut | |
| collector-agent | installed ? |
-
명령 실행：git clone https://github.com/pinpoint-apm/pinpoint-c-agent.git
-
pinpoint-php-module 설치하여 pinpoint-c-agent 페키지 루트 디렉토리에서 이하 명령 실행：
-
phpize
-
./configure
-
make
-
make test TESTS=src/PHP/tests/ （해당 모듈의 정확성을 테스트하기 위하여 이 명령의 실행을 권장 드립니다. PHP5의 경우
make test TESTS=src/PHP/tests5/실행하시기 바랍니다.） -
make install
-
pinpoint module 활성화시켜 아래 내용을
php.ini컨피그 파일에 추가해 주십시오.php.ini
extension=pinpoint_php.so ; Collector-agent's TCP address, ip,port:Collector-Agent's ip,port, please ensure it consistent with the `PP_ADDRESS` of `Collector-Agent` in step2(Build Collector-Agent). pinpoint_php.CollectorHost=Tcp:ip:port pinpoint_php.SendSpanTimeOutMs=0 # 0 is recommanded ; request should be captured duing 1 second. < 0 means no limited pinpoint_php.TraceLimit=-1 ; DEBUG the agent, PHP's log_error should turn on too. ;pinpoint_php.DebugReport=true ;error_reporting = E_ALL ;log_errors = On ;error_log = /tmp/php_fpm_error.log
-
-
프로젝트에서 Pinpoint PHP-Agent를 이용하여 아래 스탭을 진행하십시오.
이미 composer를 설치하신 것을 가정하여 어떻게 composer를 사용하여야 하는지에 대해 알아봅시다. Composer 어떻게 사용하여야 하는가?
-
pinpoint-apm/pinpoint-php-aop설치하여composer.josn의require에"pinpoint-apm/pinpoint-php-aop": "v2.0.1"추가:"require": { ... "pinpoint-apm/pinpoint-php-aop": "v2.0.1" } -
프로젝트의 엔트리 파일에 아래 상수 추가：
################################################# define('APPLICATION_NAME','APP-2'); define('APPLICATION_ID','app-2'); define('AOP_CACHE_DIR',__DIR__.'./Cache/'); define('PLUGINS_DIR',__DIR__.'./Plugins/'); define('PINPOINT_USE_CACHE','YES'); define('PP_REQ_PLUGINS', '\Plugins\PerRequestPlugins'); #define('USER_DEFINED_CLASS_MAP_IMPLEMENT',"\Plugins\Framework\app\ClassMapInFile"); require_once __DIR__. path to 'vendor/pinpoint-apm/pinpoint-php-aop/auto_pinpointed.php'; #################################################APPLICATION_NAME: 애플리케이션 이름.APPLICATION_ID: Agent ID.AOP_CACHE_DIR:Cache폴더 위치 저장.PLUGINS_DIR:Plugins폴더 경로.PINPOINT_USE_CACHE: 'YES'-요청이 있을 때 자동 업데이트 하지 않음Cache; 'No'-요청이 있을 때 자동 업데이트 진행Cache(Cache수동 업데이트도 가능하여Cache직접 삭제하시면 됨). 성능을 고려하시면 'YES'로 설정하는 것을 권장 드립니다. Plugins를 수정하시는 경우Cache를 업데이트하셔야 반영이 될 수 있습니다.PP_REQ_PLUGINS:PerRequestPlugins의 경로(PerRequestPlugins는 기본적인 요청 차단기입니다. 다른 PHP 프레임워크에 따라 차단기가 다를 수가 있습니다. 일부 프레임워크의PerRequestPlugins는 이미 준비해 놓았으니 여기에 들어가서 받으십시오（예제 :swoole's PerRequestPlugins）. 물론 다른 프레임워크에 관한 PR도 환영합니다~require_once __DIR__. path to 'vendor/pinpoint-apm/pinpoint-php-aop/auto_pinpointed.php';: pinpoint의 auto_pinpointed.php를 임포트합니다.**require_once __DIR__."/../vendor/autoload.php";뒤에 추가하는 것은 유의하시기 바랍니다. **
-
Plugins를 프로젝트 루트 경로에 복제하여
composer.josn에서Plugins를 자동 적재합니다. Frameworks: ThinkPHP5 Yii2 laravel이 외에, 다른 예제도 제공되어 있으니 필요하시면 참고하시기 바랍니다：testapps。
-
- ZTS 지원
- 안정성 향상
- 성능 향상
- 사용성과 운영성 강화
- GRPC 지원
Cache/에서 __class_index_table를 삭제하면 됩니다.
저희가 지원할 수 있으나 권장 드리지 않는 것입니다. 왜냐하면 아직 구현하기에 유효한 방법을 찾아내지 못했기 때문입니다. 관련 파일의 상태를 모니터링할 때마다 좋은 결과로 나오지 않았습니다.
테스트를 거쳐 AOP 코드는 저희의 환경(E5-2660 v4 @ 2.00GHz)에서 최소 1ms를 소모하는 것으로 확인되었습니다. 그러나 모니터링의 기능 또한 방법이 많을 수록 소모된 성능도 역시 많아지게 될 것입니다.
너무 죄송한데 pinpoint-php-aop 는 composer/autoloader가 없는 커스텀 클래스 또는 내부 클래스를 패키징하는 것을 지원하지 않습니다. 한마디 덧붙이면, composer를 사용해 보시는 것은 추천 드립니다~ O(∩_∩)O