작동 방식
- 애플리케이션은 ClickStack SDK(예: Node.js, Python, Go)를 사용합니다. 이러한 SDK는 OpenTelemetry SDK를 기반으로 하며, 추가 기능과 사용성 개선이 적용되어 있습니다.
- SDK는 OTLP(HTTP 또는 gRPC)를 통해 트레이스와 로그를 수집하고 내보냅니다.
- OpenTelemetry Collector는 텔레메트리를 수신하고, 구성된 exporter를 통해 ClickHouse에 기록합니다.
지원 언어
OpenTelemetry 호환성ClickStack에서는 향상된 텔레메트리와 기능을 제공하는 자체 language SDKs를 지원하지만, 기존 OpenTelemetry SDKs도 문제없이 사용할 수 있습니다.
| 언어 | 설명 | 링크 |
|---|---|---|
| AWS Lambda | AWS Lambda 함수 계측 | 문서 |
| Browser | 브라우저 기반 애플리케이션용 JavaScript SDK | 문서 |
| Elixir | Elixir 애플리케이션 | 문서 |
| Go | Go 애플리케이션 및 마이크로서비스 | 문서 |
| Java | Java 애플리케이션 | 문서 |
| NestJS | NestJS 애플리케이션 | 문서 |
| Next.js | Next.js 애플리케이션 | 문서 |
| Node.js | 서버 측 애플리케이션용 JavaScript 런타임 | 문서 |
| Deno | Deno 애플리케이션 | 문서 |
| Python | Python 애플리케이션 및 웹 서비스 | 문서 |
| React Native | React Native 모바일 애플리케이션 | 문서 |
| Ruby | Ruby on Rails 애플리케이션 및 웹 서비스 | 문서 |
API Key로 보안 설정
init 함수 또는 OTEL_EXPORTER_OTLP_HEADERS 환경 변수를 사용해 설정할 수 있습니다:
Team Settings → API Keys에서 확인할 수 있습니다.
OpenTelemetry를 지원하는 대부분의 language SDKs 및 텔레메트리 라이브러리에서는 애플리케이션에서 OTEL_EXPORTER_OTLP_ENDPOINT 환경 변수를 설정하거나 SDK를 초기화할 때 이를 지정하면 됩니다:
Kubernetes 통합
- 서비스와 연관된 파드 및 노드의 Kubernetes 메트릭 확인
- 애플리케이션 로그와 트레이스를 인프라 메트릭과 연관시키기
- Kubernetes 클러스터 전반에서 리소스 사용량과 성능 추적