Pinpoint
Search…
Quick-start guide
Pinpoint QuickStart provides a sample TestApp for the Agent.

Docker

Installing Pinpoint with these docker files will take approximately 10min.
Visit Official Pinpoint-Docker repository for more information.

Installation

To set up your very own Pinpoint instance you can either download the build results from our latest release.

HBase

Download, Configure, and Start HBase - 1. Hbase.
1
$ tar xzvf hbase-x.x.x-bin.tar.gz
2
$ cd hbase-x.x.x/
3
$ ./bin/start-hbase.sh
Copied!
See scripts and Run.
1
$ ./bin/hbase shell hbase-create.hbase
Copied!

Pinpoint Collector

Download, and Start Collector - 3. Pinpoint Collector
1
$ java -jar -Dpinpoint.zookeeper.address=localhost pinpoint-collector-boot-2.2.1.jar
Copied!

Pinpoint Web

Download, and Start Web - 4. Pinpoint Web
1
$ java -jar -Dpinpoint.zookeeper.address=localhost pinpoint-web-boot-2.2.1.jar
Copied!

Java Agent

Requirements

In order to build Pinpoint, the following requirements must be met:
  • JDK 8 installed
Download Pinpoint from Latest Release.
Extract the downloaded file.
1
$ tar xvzf pinpoint-agent-2.2.1.tar.gz
Copied!
Run the JAR file, as follows:
1
$ java -jar -javaagent:pinpoint-agent-2.2.1/pinpoint-bootstrap.jar -Dpinpoint.agentId=test-agent -Dpinpoint.applicationName=TESTAPP pinpoint-quickstart-testapp-2.2.1.jar
Copied!

When Building Manually

Download Pinpoint with git clone https://github.com/pinpoint-apm/pinpoint.git or download the project as a zip file and unzip.
Change to the pinpoint directory, and build.
1
$ cd pinpoint
2
$ ./mvnw install -DskipTests=true
Copied!
Change to the quickstart testapp directory, and build. Let's build and run.
1
$ cd quickstart/testapp
2
$ ./mvnw clean package
Copied!
Change to the pinpoint directory, and run.
1
$ cd ../../
2
$ java -jar -javaagent:agent/target/pinpoint-agent-2.2.1/pinpoint-bootstrap.jar -Dpinpoint.agentId=test-agent -Dpinpoint.applicationName=TESTAPP quickstart/testapp/target/pinpoint-quickstart-testapp-2.2.1.jar
Copied!

Get Started

You should see some output that looks very similar to this:
1
. ____ _ __ _ _
2
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
3
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
4
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
5
' |____| .__|_| |_|_| |_\__, | / / / /
6
=========|_|==============|___/=/_/_/_/
7
:: Spring Boot :: (v2.3.2.RELEASE)
8
9
2020-08-06 17:24:59.519 INFO 19236 --- [ main] com.navercorp.pinpoint.testapp.TestApp : Starting TestApp on AD01160256 with PID 19236 (C:\repository\github\pinpoint\quickstart\testapp\target\classes started by Naver in C:\repository\github\pinpoint)
10
2020-08-06 17:24:59.520 INFO 19236 --- [ main] com.navercorp.pinpoint.testapp.TestApp : No active profile set, falling back to default profiles: default
11
2020-08-06 17:24:59.520 DEBUG 19236 --- [ main] o.s.boot.SpringApplication : Loading source class com.navercorp.pinpoint.testapp.TestApp
12
2020-08-06 17:24:59.558 DEBUG 19236 --- [ main] o.s.b.c.c.ConfigFileApplicationListener : Loaded config file 'file:/C:/repository/github/pinpoint/quickstart/testapp/target/classes/application.yml' (classpath:/application.yml)
13
2020-08-06 17:24:59.558 DEBUG 19236 --- [ main] ConfigServletWebServerApplicationContext : Refreshing org.springframework.boot.web.ser[email protected]46185a1b
14
08-06 17:24:59.059 [ main] INFO .n.p.p.DefaultDynamicTransformerRegistry:67 -- added dynamic transformer classLoader: [email protected], className: com.navercorp.pinpoint.testapp.controller.ApisController, registry size: 1
15
08-06 17:24:59.059 [ main] INFO .n.p.p.DefaultDynamicTransformerRegistry:67 -- added dynamic transformer classLoader: [email protected], className: com.navercorp.pinpoint.testapp.controller.CallSelfController, registry size: 2
16
08-06 17:24:59.059 [ main] INFO .n.p.p.DefaultDynamicTransformerRegistry:67 -- added dynamic transformer classLoader: [email protected], className: com.navercorp.pinpoint.testapp.controller.HttpClient4Controller, registry size: 3
17
08-06 17:24:59.059 [ main] INFO .n.p.p.DefaultDynamicTransformerRegistry:67 -- added dynamic transformer classLoader: [email protected], className: com.navercorp.pinpoint.testapp.controller.SimpleController, registry size: 4
18
08-06 17:24:59.059 [ main] INFO .n.p.p.DefaultDynamicTransformerRegistry:67 -- added dynamic transformer classLoader: [email protected], className: com.navercorp.pinpoint.testapp.controller.StressController, registry size: 5
19
2020-08-06 17:25:00.313 DEBUG 19236 --- [ main] .s.b.w.e.t.TomcatServletWebServerFactory : Code archive: C:\Users\Naver\.m2\repository\org\springframework\boot\spring-boot\2.3.2.RELEASE\spring-boot-2.3.2.RELEASE.jar
20
2020-08-06 17:25:00.313 DEBUG 19236 --- [ main] .s.b.w.e.t.TomcatServletWebServerFactory : Code archive: C:\Users\Naver\.m2\repository\org\springframework\boot\spring-boot\2.3.2.RELEASE\spring-boot-2.3.2.RELEASE.jar
21
2020-08-06 17:25:00.314 DEBUG 19236 --- [ main] .s.b.w.e.t.TomcatServletWebServerFactory : None of the document roots [src/main/webapp, public, static] point to a directory and will be ignored.
22
2020-08-06 17:25:00.347 INFO 19236 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat initialized with port(s): 8082 (http)
23
2020-08-06 17:25:00.355 INFO 19236 --- [ main] o.apache.catalina.core.StandardService : Starting service [Tomcat]
24
2020-08-06 17:25:00.356 INFO 19236 --- [ main] org.apache.catalina.core.StandardEngine : Starting Servlet engine: [Apache Tomcat/9.0.37]
Copied!
The last couple of lines here tell us that Spring has started. Spring Boot’s embedded Apache Tomcat server is acting as a webserver and is listening for requests on localhost port 8082. Open your browser and in the address bar at the top enter http://localhost:8082
Last modified 26d ago