모니터링 추적
Instana 에이전트를 설치하면 Traefik 센서가 자동으로 배포 및 설치됩니다.
Instana Traefik을 통과하는 요청에 대한 메트릭과 분산 추적 정보를 모두 수집할 수 있습니다.
지원 정보
Traefik 센서가 현재 환경과 호환되는지 확인하려면 다음 지원 정보 섹션을 참조하십시오:
지원되는 버전 및 지원 정책
다음 표는 최신 지원 버전 및 지원 정책을 보여줍니다:
| 기술 | 지원 정책 | 최신 기술 버전 | 최신 지원 버전 |
|---|---|---|---|
| Traefik | 온디맨드 | 3.4.1 | 3.4 |
지원 정책에 대한 자세한 내용은 ‘센서 지원 전략’을 참조하십시오.
에이전트 구성
에이전트 구성 파일에서 다음 필드를 설정할 수 있습니다:
com.instana.plugin.traefik:
enabled: true
poll_rate: 1 # seconds
구성
메트릭 콜렉션
메트릭을 확인하려면 Instana 사용자 인터페이스의 사이드바에서 ‘인프라(Infrastructure)’를 선택하고, 모니터링 중인 특정 호스트를 클릭하면 수집된 모든 메트릭과 모니터링 중인 프로세스가 표시된 호스트 대시보드를 볼 수 있습니다.
구성 데이터
- PID
- 버전
- 시작 시간
성능 메트릭
| 메트릭 | 설명 | 세분성 |
|---|---|---|
| HTTP 초당 요청 수 | HTTP 초당 요청 수 | 1초 |
| 구성의 마지막 다시 로드 성공 | 마지막으로 성공한 구성 다시 로드 시간 | 1초 |
| 구성 다시 로드 수 | 초당 구성 다시 로드 수 | 1초 |
| 시작점 | HTTP 엔트리 포인트당 초당 요청 수 | 1초 |
메트릭 콜렉션 사용
Traefik앱에서 메트릭 콜렉션을 사용하려면 Prometheus 메트릭을 사용하여 엔드포인트를 노출해야 합니다. 다음과 같은 여러 가지 방법으로 이를 수행할 수 있습니다.
- 구성 파일( YAML 또는 TOML 형식)을 사용하여
- 환경 변수 설정
- 명령행 인수 추가
예를 들어, 구성 파일의 다음 행은 :8888/metrics에서 메트릭을 노출합니다.
#config.yaml
entryPoints:
metrics:
address: ":8888"
metrics:
prometheus:
entryPoint: metrics
메트릭 엔드포인트는 Instana 에이전트에서 액세스할 수 있어야 합니다.
추가 예제는 Traefik 웹 사이트에서 찾을 수 있습니다.
추적 사용
Traefik앱에서 추적을 사용하려면 이를 구성해야 합니다. 다음과 같은 여러 가지 방법으로 이를 수행할 수 있습니다.
- 구성 파일( YAML 또는 TOML 형식)을 사용하여
- 환경 변수 설정
- 명령행 인수 추가
예를 들어,
#config.yaml
tracing:
instana: {}
Instana Traefik 애플리케이션에서 에이전트에 접근할 수 있어야 합니다.
추가 예제는 Traefik [웹 사이트]https://doc.traefik.io/traefik-enterprise/operations/metrics/instana/에서 찾을 수 있습니다.
Traefik Helm 차트
공식 Traefik 프록시 Helm 차트를 사용하려면, Instana 추적을 활성화하고 Traefik Prometheus 메트릭을 노출하도록 다음과 같이 구성을 명시적으로 지정해야 합니다:
helm install \
--set="additionalArguments={--tracing.instana=true}" \
--set ports.metrics.port=8080 \
--set ports.metrics.exposedPort=8080 \
traefik \
traefik/traefik
문제점 해결
모니터링 문제 유형: traefik_metrics_api_not_accessible
이 문제를 해결하려면 메트릭 콜렉션 사용 에 설명된 대로 메트릭 엔드포인트를 노출하도록 Traefik 애플리케이션을 구성하는 방법에 대한 단계를 참조하십시오.
모니터링 문제 유형: traefik_metrics_api_not_enabled
이 문제를 해결하려면 메트릭 콜렉션 사용 에 설명된 대로 메트릭 엔드포인트를 노출하도록 Traefik 애플리케이션을 구성하는 방법에 대한 단계를 참조하십시오.
모니터링 문제 유형: traefik_tracing_not_enabled
이 문제를 해결하려면 추적 사용 에 설명된 단계를 참조하여 Traefik 애플리케이션에서 추적을 사용으로 설정하는 방법을 확인하십시오.