Skip to content

Latest commit

 

History

History
128 lines (89 loc) · 4.61 KB

Readme.md

File metadata and controls

128 lines (89 loc) · 4.61 KB

Support Plan

What we have supported and what will support: support plan

Getting Started

Requirement

Dependency Version More
PHP php 7+
GCC GCC 4.7+ C++11
*inux windows is on the way
pinpoint 2.0+
composer class can be automatic pinpoint-cut
collector-agent installed ?

Installation

Steps

  1. git clone https://github.com/pinpoint-apm/pinpoint-c-agent.git

  2. Build pinpoint_php module, goto the root directory of pinpoint-c-agent installation package, and do following steps:

    1. phpize

    2. ./configure

    3. make

    4. make test ps: We recommend you to test whether the module is RIGHT. For PHP5: make test TESTS=tests5/

    5. make install

    6. Activate pinpoint-php-module, please add the following configuration into your 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

  3. Use Pinpoint PHP-Agent in your project, and follow the steps below:

    We assume that you have installed composer and known how to use it. How to Use Composer?

    1. Use composer require

      composer require pinpoint-apm/pinpoint-php-aop:v2.1.0

    2. Add the following constants in the index file of your project:

      define('APPLICATION_NAME','APP-2');
define('APPLICATION_ID','app-2');
define('AOP_CACHE_DIR',__DIR__.'./Cache/');
## if yii2
define('PP_REQ_PLUGINS',\Pinpoint\Plugins\Yii2PerRequestPlugins::class);      
require_once __DIR__. path to 'vendor/pinpoint-apm/pinpoint-php-aop/auto_pinpointed.php';
# require_once __DIR__. '/vendor/pinpoint-apm/pinpoint-php-aop/auto_pinpointed.php';
      1. APPLICATION_NAME: Application name.
      2. APPLICATION_ID: Agent ID.
      3. AOP_CACHE_DIR: Where to generate Cache.
      4. require_once __DIR__. path to 'vendor/pinpoint-apm/pinpoint-php-aop/auto_pinpointed.php';: Require pinpoint's auto_pinpointed.php.Please add after require_once __DIR__."/../vendor/autoload.php";, this is very important!

We have prepared some examples for you, try playground.

Changes

  • Fully support ZTS
  • More stability
  • Higher performance
  • Easily use and maintain
  • Support GRPC

F & Q

1. How to regenerate all AOP files?

Delete __class_index_table in Cache/

2. Why not support automatically update AOP files?

We can DO but prefer not to DO! Because we have not yet found an efficient way to implement this and monitoring these files status every time is a bad idea.

3. How much performance does it lose when using?

After full test, the AOP code could spend at least 1ms in our env(E5-2660 v4 @ 2.00GHz). While, the more function/method you monitor, the more you take.

Performance Test Result

3.1 Test Result ☚
3.2 Flarum Test Result ☚

For the developer

Plugins Tutorial ☚

PHP user manual ☚

Known Issues

1. Exception or error message with a wrong file path.

pinpoint-apm#99

2. If I do not use composer/autoloader, can I use this version?

Sorry, pinpoint-php-aop does not support to wrap the user class (or internal class) without composer/autoloader. By the way, Composer is GOOD. O(∩_∩)O

pinpoint-apm#103

3. Why not support PHP5.x. Already done!

https://www.php.net/supported-versions.php

4. Generator function is not supported. Already done!

pinpoint-apm#100

5. Some built-in functions can't AOP Already done!

pinpoint-apm#102