Traefik

Supported OS Linux Windows Mac OS

통합 버전1.1.0

개요

Traefik 메트릭, 로그, 트레이스를 Datadog으로 보내 Traefik 서비스를 모니터링하세요.

설정

Traefik 점검은 Datadog Agent 패키지에 포함되어 있지 않으므로 설치해야 합니다.

설치

Agent v7.21 이상 / v6.21 이상의 경우, 아래 지침에 따라 호스트에 Traefik 점검을 설치하세요. Docker Agent 또는 이전 버전의 Agent를 사용하여 설치하려면 커뮤니티 통합 사용을 참조하세요.

  1. 다음 명령어를 실행해 Agent 통합을 설치하세요.

    datadog-agent integration install -t datadog-traefik==<INTEGRATION_VERSION>
    
  2. 통합을 코어 통합과 유사하게 설정하세요.

설정

v2인 경우

v1에서 v2로의 변경 사항에 관한 자세한 내용은 Traefik 마이그레이션 가이드를, 최신 버전에 관한 자세한 내용은 Traefik 설명서를 참조하세요.

메트릭 수집

Traefik 설명서를 참고해 Traefik 메트릭을 Datadog으로 전송합니다.

로그 수집

Agent >6.0에서 사용 가능

기본적으로 Traefik 로그는 stdout으로 전송됩니다. Datadog Agent가 컨테이너 stdout/stderr에서 직접 로그를 수집할 수 있으므로 컨테이너화된 버전에서는 이 설정을 변경할 필요가 없습니다.

  1. Traefik이 파일에 로깅하도록 설정하려면 Traefik 설정 파일에 다음을 추가하세요.

    [traefikLog]
      filePath = "/path/to/traefik.log"
      format   = "json"
    

    일반 Apache Access 형식은 기본적으로 사용되며 이 통합에서 지원됩니다.

  2. Datadog Agent에서 로그 수집은 기본적으로 사용하지 않도록 설정되어 있습니다. datadog.yaml 파일에서 사용하도록 설정합니다.

    logs_enabled: true
    
  3. Traefik 로그 수집을 시작하려면 Agent 설정 디렉터리의 루트에 있는 traefik.d/conf.yaml 파일에 이 설정 블록을 추가하세요.

    logs:
      - type: file
        path: /path/to/traefik.log
        source: traefik
        service: traefik
    

    pathservice 파라미터 값을 환경에 맞도록 변경합니다.

  4. 에이전트를 재시작합니다.

트레이스 수집

  1. 필요한 경우 Datadog에 APM을 활성화합니다.
  2. Traefik 설명서를 참고해 트레이스를 Datadog으로 전송합니다.

v1인 경우

v1에 관한 자세한 내용은 Traefik 설명서를 참조하세요. v1에서 v2로의 변경 사항에 관한 자세한 내용은 Traefik 마이그레이션 가이드를 참조하세요.

메트릭 수집

  1. Traefik 메트릭을 수집하려면 Agent 설정 디렉터리의 루트에 있는 conf.d/ 폴더에서 traefik.d/conf.yaml 파일을 엽니다.

  2. 메트릭 수집을 시작하려면 이 구성 설정을 traefik.d/conf.yaml 파일에 추가하세요.

    init_config:
    
    instances:
      - host: 10.1.2.3
        port: "8080"
        path: "/health"
        scheme: "http"
    

    설정 옵션:

    • host: 쿼리할 Traefik 엔드포인트. 필수
    • port: Traefik 엔드포인트의 API 리스너. 기본값은 8080. 선택 사항
    • path: Traefik 상태 점검 엔드포인트 경로. 기본값은 /health. 선택 사항
    • scheme: Traefik 상태 점검 엔드포인트의 스키마. 기본값은 http. 선택 사항
  3. Agent를 다시 시작하여 Traefik 메트릭을 Datadog으로 전송합니다.

사용 가능한 모든 설정 옵션은 샘플 traefik.d/conf.yaml을 참조하세요.

로그 수집

Agent >6.0에서 사용 가능

기본적으로 Traefik 로그는 stdout으로 전송됩니다. Datadog Agent가 컨테이너 stdout/stderr에서 직접 로그를 수집할 수 있으므로 컨테이너화된 버전에서는 이 설정을 변경할 필요가 없습니다.

  1. Traefik이 파일에 로깅하도록 설정하려면 Traefik 설정 파일에 다음을 추가하세요.

    [traefikLog]
      filePath = "/path/to/traefik.log"
      format   = "json"
    

    일반 Apache Access 형식은 기본적으로 사용되며 이 통합에서 지원됩니다.

  2. Datadog Agent에서 로그 수집은 기본적으로 사용하지 않도록 설정되어 있습니다. datadog.yaml 파일에서 사용하도록 설정합니다.

    logs_enabled: true
    
  3. Traefik 로그 수집을 시작하려면 Agent 설정 디렉터리의 루트에 있는 traefik.d/conf.yaml 파일에 이 설정 블록을 추가하세요.

    logs:
      - type: file
        path: /path/to/traefik.log
        source: traefik
        service: traefik
    

    pathservice 파라미터 값을 환경에 맞도록 변경합니다.

  4. Agent를 재시작합니다.

트레이스 수집

Traefik v1.7+에서 사용 가능

  1. 필요한 경우 Datadog에 APM을 활성화합니다.
  2. Traefik 설명서를 참고해 트레이스를 Datadog으로 전송합니다.

검증

Agent의 status 하위 명령을 실행하고 Checks 섹션에서 traefik을 찾습니다.

호환성

이 점검은 다른 주요 플랫폼과 모두 호환됩니다.

메트릭

v2인 경우 Datadog에 전송된 Traefik 메트릭 목록을 확인하세요.

v1인 경우 통합에서 제공하는 메트릭 목록을 참조하세요.

수집한 데이터

메트릭

이벤트

Traefik 점검은 이벤트를 포함하지 않습니다.

서비스 점검

트러블슈팅

도움이 필요하신가요? Datadog 지원팀에 문의하세요.