alibaba/loongsuite-go

어떤 프로젝트인가요?

핵심 기능

• 01소스 코드를 수정하지 않고 `otel go build` 명령으로 컴파일 타임에 계측 코드를 추가합니다.
• 02HTTP 프레임워크, ORM, Redis 클라이언트, gRPC, 메시지 큐 등 다양한 Go 라이브러리를 지원합니다.
• 03openai-go 및 langchaingo 같은 여러 LLM SDK용 계측 기능을 포함합니다.
• 04공식 지원 대상이 아닌 라이브러리에 사용자 지정 코드를 삽입할 수 있습니다.
• 05Linux, macOS, Windows용 사전 빌드 바이너리를 제공합니다.

활용 사례

• 기존 Go 서비스의 코드를 건드리지 않고 분산 트레이싱을 추가합니다.
• Go 마이크로서비스의 HTTP, 데이터베이스, Redis 호출을 모니터링합니다.
• Go 애플리케이션에서 발생하는 LLM API 호출을 관측합니다.
• 배포 전에 계측으로 인한 오버헤드를 측정합니다.

빠른 시작

1. 1

   사용 중인 플랫폼에 맞는 사전 빌드된 otel 바이너리를 릴리스 페이지에서 다운로드합니다

2. 2

   또는 소스에서 도구를 빌드하고 설치합니다

   make install
3. 3

   도구가 설치되었는지 확인합니다

   otel version
4. 4

   otel을 접두사로 사용해 프로젝트를 빌드합니다

   otel go build

사용 전 알아둘 점

• !도구와 계측 대상 애플리케이션 모두 Go 1.25 이상이 필요합니다.
• !go build는 성공하지만 otel go build가 실패하면 README에서는 버그일 가능성이 높다고 설명합니다.

포함된 컬렉션

토픽

자주 묻는 질문

loongsuite-go은(는) 무엇인가요?

애플리케이션 코드를 수정하지 않고 `otel go build` 접두 명령으로 트레이싱과 메트릭을 추가하는 Go용 컴파일 타임 OpenTelemetry 계측 도구입니다. LoongSuite Go Agent는 컴파일 타임에 Go 애플리케이션에 OpenTelemetry 관측 기능을 추가하는 도구입니다. 소스 코드를 수정하는 대신 `otel` 접두 명령(예: `otel go build`)으로 프로젝트를 빌드하면, 컴파일 과정에서 지원 라이브러리에 계측 코드를 삽입합니다.

loongsuite-go은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

loongsuite-go은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

loongsuite-go은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. loongsuite-go의 마지막 커밋은 2026년 10월 19일입니다.

loongsuite-go은(는) 어디에 사용할 수 있나요?

기존 Go 서비스의 코드를 건드리지 않고 분산 트레이싱을 추가합니다. Go 마이크로서비스의 HTTP, 데이터베이스, Redis 호출을 모니터링합니다. Go 애플리케이션에서 발생하는 LLM API 호출을 관측합니다. 배포 전에 계측으로 인한 오버헤드를 측정합니다.

loongsuite-go는 어떻게 설치하나요?

사용 중인 플랫폼에 맞는 사전 빌드된 otel 바이너리를 릴리스 페이지에서 다운로드합니다 또는 소스에서 도구를 빌드하고 설치합니다: make install 도구가 설치되었는지 확인합니다: otel version otel을 접두사로 사용해 프로젝트를 빌드합니다: otel go build

loongsuite-go은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/alibaba/loongsuite-go