Readme-KR.md

English | 中文 | 한국어

Collector-agent 역할

pinpoint-collector의 브리지 모듈

Collector Agent 소개

Collector-Agent는 PHP/Python/C/CPP-Agent에서 전송된 Span을 수신하여 Pinpoint-Collector로 전달하는 역할을 합니다.

• 환경 변수 설정:

  export PP_COLLECTOR_AGENT_SPAN_IP=dev-pinpoint
  export PP_COLLECTOR_AGENT_SPAN_PORT=9993
  export PP_COLLECTOR_AGENT_AGENT_IP=dev-pinpoint
  export PP_COLLECTOR_AGENT_AGENT_PORT=9991
  export PP_COLLECTOR_AGENT_STAT_IP=dev-pinpoint
  export PP_COLLECTOR_AGENT_STAT_PORT=9992
  export PP_COLLECTOR_AGENT_ISDOCKER=false
  export PP_LOG_DIR=/tmp/
  export PP_Log_Level=INFO
  export PP_ADDRESS=0.0.0.0@10000
  

  1. PP_COLLECTOR_AGENT_SPAN_IP, PP_COLLECTOR_AGENT_AGENT_IP, PP_COLLECTOR_AGENT_STAT_IP: Set the IP of pinpoint-collector.
  2. PP_COLLECTOR_AGENT_SPAN_PORT, PP_COLLECTOR_AGENT_AGENT_PORT, PP_COLLECTOR_AGENT_STAT_PORT: Set the port of pinpoint-collector(grpc).
  3. PP_LOG_DIR: Set the path of collector-agent's log file.
  4. PP_Log_Level: Set the log level.
  5. PP_ADDRESS: Set the address of collector-agent, then PHP/Python-Agent will connect collector-agent through this address.

1. github release 페이지에서 바이너리 프로그램 다운로드

https://github.com/pinpoint-apm/pinpoint-c-agent/releases/tag/v0.6.6

2. docker image를 직접 사용

릴리즈 페이지: https://github.com/pinpoint-apm/pinpoint-c-agent/pkgs/container/pinpoint-c-agent%2Fcollector-agent

예시:

docker run -itd -p 9999:9999  --env-file ./env.list ghcr.io/pinpoint-apm/pinpoint-c-agent/collector-agent:v0.6.6

3. K8S에서 sidecar 모드로 실행

server.yaml sample

- image: ghcr.io/pinpoint-apm/pinpoint-c-agent/collector-agent:v0.6.6
        name: collector-agent
        args: ["-RecvBufSize=1048576"]
        securityContext:
          runAsUser: 0
        env:
          - name: "PP_COLLECTOR_AGENT_SPAN_IP"
            value: "pinpoint-collector.hostname"
          - name: "PP_COLLECTOR_AGENT_SPAN_PORT"
            value: "9993"
          - name: "PP_COLLECTOR_AGENT_AGENT_IP"
            value: "pinpoint-collector.hostname"
          - name: "PP_COLLECTOR_AGENT_AGENT_PORT"
            value: "9991"
          - name: "PP_COLLECTOR_AGENT_STAT_IP"
            value: "pinpoint-collector.hostname"
          - name: "PP_COLLECTOR_AGENT_STAT_PORT"
            value: "9992"
          - name: "PP_Log_Level"
            value: "INFO"
          - name: "PP_ADDRESS"
            value: "localhost@10000"
          - name: "PP_COLLECTOR_AGENT_ISDOCKER"
            value: "true"

4. 수동 컴파일 [require go.1.18]

• 실행: GOBIN=/usr/local/bin/ go install github.com/pinpoint-apm/pinpoint-c-agent/collector-agent@dev
  • ❗❗❗Note: collector-agent: located into /usr/local/bin/

./collector-agent