Pinpoint C Agent

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.

Getting Started

Requirement

Dependency	Version
APACHE	2.2.x 2.4.x
PHP	php 5.4.x 5.5.x 5.6.x 7x
OS	64bit only
Boost	1.5.8+
Thirft	0.11.0+
gcc	4.4.7+
pinpoint	1.8.0-RC1

Installation

Pre-install

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 openssl libssl-dev

Centos

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

Install third-library

Option 1. Use agent build tools (install boost and Thirft in $PWD/../thirdlibray/var)
```
  $ cd pinpoint-c-agent/pinpoint_php
  $ ./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 CXXFLAGS="-DFORCE_BOOST_SMART_PTR" --with-cpp --with-php=no --with-python=no --with-ruby=no --with-nodejs=no --with-qt4=no --with-java=no -with-boost=$PREFIX
  - 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)

Build php-agent

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

Startup

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/

(eg: make sure LogFileRootPath has been created.)

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)
Restart php-fpm/Apache
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.

Collect result from the Pinpoint

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

Overview

Distributed Tracking system

Call Stack

Compatibility

Pinpoint Version	PHP	GCC	Boost	Thrift
1.8.0-RC1	5.3.x 5.4.x 5.5.x 5.6.x 7.x	gcc 4.4.7+	1.5.8+	0.11.0+

License

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.

tk1990/pinpoint-c-agent