Home

Awesome

Build Test libraries codecov

Getting Started

Requirement

DependencyVersionMore
GOgo1.13+go1.18 not support
cpu archamd64(x86_64)
*nux

Pre-requirement

Quicklystart

  1. Add pinpoint.go under the root of your project. pinpoint.go

    package main
    
    // only import libs you cared
    
    import (
        "github.com/pinpoint-apm/go-aop-agent/common"
        _ "github.com/pinpoint-apm/go-aop-agent/libs/example"
        _ "github.com/pinpoint-apm/go-aop-agent/libs/httpClient"
        _ "github.com/pinpoint-apm/go-aop-agent/libs/mongo"
        _ "github.com/pinpoint-apm/go-aop-agent/libs/redisv8"
        _ "github.com/pinpoint-apm/go-aop-agent/libs/sql"
    )
    
    func init() {
        init_pinpoint()
    }
    
    func init_pinpoint() {
        common.Pinpoint_enable_debug_report(true) //open pinpoint debug log
        common.Pinpoint_set_collect_agent_host("tcp:127.0.0.1:9999") // set the collector agent(Installed in step of `Install Collector Agent`), it should be consistent with `PP_ADDRESS`
        common.Pinpoint_set_trace_limit(10) // set the sample rate: `-1`: not limit, all requests with be sampled. `0`: not sample, no requets will be sampled. `n`: n requests will be sampled every seconed.
        common.Appname = "go-agent1" // set Appname
        common.Appid = "Go-Agent1" // set Appid
    }
    
    
  2. Import pinpoint middleware into your project(mux framework for example):

    package main
    ...
    import (
    ...
    pinpoint "github.com/pinpoint-apm/go-aop-agent/middleware/mux"
    )
    
    router := mux.NewRouter()
    // add pinpoint middleware
    router.Use(pinpoint.PinpointMuxMiddleWare) // <-- add middleware
    ...
    
  3. At last, execute go mod tidy.

Build your project in build-env

If your project deploy as docker images, use golang-build-env-1.16 as your builder image.

There are some examples in testapps and CI-action, hopes these can help your ! ✨

echo framework

mux framework

ServerMap and callstack

pinpoint,supports distributed tracking

java-go-php-py-server-map

java-go-php-py-server-map

Callstack

Callstack

Framework, library supported

LibraryVersion
[net/http]~
[mongo-driver/mongo]v1.5.3
[coreos/etcd/clientv3]v3.3.25+incompatible
[go-redis/redis/v8]v8.11.0
[database/sql]~
Framework (middleware)Version
mux~
echov3.3.10+incompatible
echov4.3.0

More libraries and frameworks is coming soon. Welcome for contribution and suggestion.

TestApps

Example of mux and echo testapp

License

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

Copyright 2021-present 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.