Support Plan

What we have supported and what will support: support plan

Getting Started

Requirement

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 TESTS=src/PHP/tests/

      ps: We recommend you to test whether the module is RIGHT. For PHP5: make test TESTS=src/PHP/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. Add pinpoint-apm/pinpoint-php-aop into composer.json and update.

      "require": {
          ...
          "pinpoint-apm/pinpoint-php-aop": "dev-master"
      }

      or

      composer require pinpoint-apm/pinpoint-php-aop

   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/');
      define('PLUGINS_DIR',__DIR__.'./Plugins/');
      define('PINPOINT_USE_CACHE','YES');
      require_once __DIR__. path to '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. PLUGINS_DIR: Path to Plugins.
      5. PINPOINT_USE_CACHE: 'YES' will not update Cache when request coming; 'No' will update Cache when every request coming.(You can also update Cache by just deleting it.) Considering the performance, we recommend 'YES'. Further more, if you modify the plugins, you should update the Cache to take effect.
      6. 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!

   3. Choose you framework and copy the directory as Plugins to the root of your application, autoload Plugins in composer.json.
      Details for frameworks:

      1. ThinkPHP5
      2. Yii2
      3. laravel

We have prepared some examples for you, please goto testapps.

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 deal.

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.

https://github.com/pinpoint-apm/pinpoint-c-agent/issues/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

https://github.com/pinpoint-apm/pinpoint-c-agent/issues/103

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

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

4. ~Generator function is not supported.~ Already done!

https://github.com/pinpoint-apm/pinpoint-c-agent/issues/100

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

https://github.com/pinpoint-apm/pinpoint-c-agent/issues/102