모니터링 추적

Instana 에이전트를 설치하면 Traefik 센서가 자동으로 배포 및 설치됩니다.

Instana Traefik을 통과하는 요청에 대한 메트릭과 분산 추적 정보를 모두 수집할 수 있습니다.

지원 정보

Traefik 센서가 현재 환경과 호환되는지 확인하려면 다음 지원 정보 섹션을 참조하십시오:

지원되는 버전 및 지원 정책

다음 표는 최신 지원 버전 및 지원 정책을 보여줍니다:

기술 지원 정책 최신 기술 버전 최신 지원 버전
Traefik 온디맨드 3.4.1 3.4

지원 정책에 대한 자세한 내용은 ‘센서 지원 전략’을 참조하십시오.

메트릭 콜렉션

메트릭을 확인하려면 Instana 사용자 인터페이스의 사이드바에서 ‘인프라(Infrastructure)’를 선택하고, 모니터링 중인 특정 호스트를 클릭하면 수집된 모든 메트릭과 모니터링 중인 프로세스가 표시된 호스트 대시보드를 볼 수 있습니다.

성능 메트릭

메트릭 설명 세분성
HTTP 초당 요청 수 HTTP 초당 요청 수 1초
구성의 마지막 다시 로드 성공 마지막으로 성공한 구성 다시 로드 시간 1초
구성 다시 로드 수 초당 구성 다시 로드 수 1초
시작점 HTTP 엔트리 포인트당 초당 요청 수 1초
참고: 모니터링할 수 있는 진입 지점의 최대 수는 100개로 제한됩니다.

메트릭 콜렉션 사용

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 애플리케이션에서 추적을 사용으로 설정하는 방법을 확인하십시오.