Visit our official web site for more information and Latest updates on Pinpoint

The current stable version is v0.1.0.

It is an agent written by C/C++ language. And we hope to support other languages by this agent. Until now, it supports PHP language.

• Download pinpoint-c-agent: git clone https://github.com/naver/pinpoint-c-agent.git

• Install Build-essential

  Ubuntu

    sudo apt-get install automake bison flex g++ git libtool make pkg-config
  

  Centos

    sudo yum install automake libtool flex bison pkgconfig gcc-c++
  

• Install third-library

  Option 1. Use agent build tools (install boost and Thirft in $PWD/../thirdlibray/var)

    $ cd pinpoint-c-agent
    $ ./Build.sh
    $ export LD_LIBRARY_PATH=$PWD/../thirdlibray/var/:$LD_LIBRARY_PATH
  

  Option 2. Install from source code

  • Install Boost 1.6.3+

    • wget https://jaist.dl.sourceforge.net/project/boost/boost/1.63.0/boost_1_63_0.tar.gz
    • tar -zxvf boost_1_63_0.tar.gz && cd boost_1_63_0
    • ./bootstrap.sh
    • ./b2 install --prefix=PREFIX

  • Install Thrift 0.11.0+

    • wget http://apache.fayea.com/thrift/0.11.0/thrift-0.11.0.tar.gz

    • tar zxvf thrift-0.11.0.tar.gz

    • cd thrift-0.11.0

    • ./configure --with-cpp --with-php=no --with-python=no --with-ruby=no --with-nodejs=no --with-qt4=no --with-java=no

    • make

    • make install

    • export environment variable

        export WITH_BOOST_PATH=/boost root path/
        export WITH_THRIFT_PATH=/thrift root path/
        export LD_LIBRARY_PATH=/boost lib/:/thrift/:$LD_LIBRARY_PATH
    

• phpize (In your php installation path)

1. Checking phpize is in your PATH. If not, install phpize and export in your system PATH.(eg:export PATH=/path to phpize/:$PATH)
2. Run cd pinpoint_php && ./Build.sh && make install
3. If 2 running successfully, agent had installed into php module.

1. Modifying below options in the "pinpoint_agent.conf" (eg:pinpoint_c_agent/quickstart/config/pinpoint_agent.conf.example)

      AgentID=uniquely identifies the application instance in which the agent is running on
      ApplicationName= groups a number of identical application instances as a single service
      Collector*= pinpoint collector information  
      LogFileRootPath=/absolute ​path where logging to/
      PluginRootDir​=/absolute path to /web/plugins/​

2. Enable pinpoint-agent-php into php.ini, and configuring extension and pinpoint_agent.config_full_name (eg:pinpoint_c_agent/quickstart/config/php.ini.example)
3. Restart php-fpm/Apache
4. After restart php-fpm/Apache, if you meet "xxx pinpoint_api.cpp:158 [INFO] common.AgentID=php_pinpoint ...." in your LogFileRootPath/pinpoint_log.txt, pinpoint-agent-php installed successfully. If not, contract us without hesitation.

1. Configure pinpoint_c_agent/quickstart/php/web/ as your web side.
2. Access http://$serverip:$port/index.php
3. Log into pinpoint-web and choose the right ApplicationList

This project is licensed under the Apache License, Version 2.0. See LICENSE for full license text.

Copyright 2018 NAVER Corp.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.