• 로그인지금 시작하기

사용자의 편의를 위해 제공되는 기계 번역입니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

'ktranslate' Docker 컨테이너 관리

이 페이지에서는 New Relic의 네트워크 모니터링에서 사용하는 ktranslate 컨테이너 관리 옵션에 대해 설명합니다.

컨테이너 요구 사항

ktranslate 컨테이너 이미지에 대해 다음 리소스를 권장합니다.

디스크

  • 100MB의 사용 가능한 디스크 공간

CPU

  • SNMP 폴링/트랩 수집: ~1,000개 장치마다 전용 CPU 코어 1개
  • 장치 흐름 수집: 초당 ~2,000 흐름(fps)마다 전용 CPU 코어 1개
  • Syslog 메시지 수집: 초당 ~2,000개 메시지마다 전용 CPU 코어 1개

메모리

  • ktranslate 는 일반적으로 메모리 리소스의 제약을 받지 않습니다. 호스트의 메모리 양은 실행하려는 애플리케이션/컨테이너 유형에 따라 결정되어야 합니다. 일반적으로 1개의 vCPU와 1.0GB의 사용 가능한 RAM이 있는 AWS t2.micro 만큼 작은 이미지 크기에서 성공을 거둔 경우가 많습니다.

KTranslate 컨테이너 이미지는 한 번에 하나의 "작업 유형"을 실행합니다. 예를 들어 SNMP 폴링 및 트랩 수집을 위해 배포된 컨테이너는 흐름 수집에 사용되지 않습니다. 또한 흐름 수집을 위해 배포된 컨테이너는 컨테이너당 단일 -nf.source 유형으로 제한됩니다. 즉, 주어진 시간에 단일 Docker 호스트에 여러 컨테이너를 배포하는 것이 일반적입니다. 공통 구성 파일을 공유할 수도 있지만 반드시 그럴 필요는 없습니다.

컨테이너 업데이트

ktranslate 컨테이너 이미지를 최신 상태로 유지하는 것은 최신 업데이트를 수신하고 개발 수명 주기 동안 적용된 다양한 버그 수정을 통해 일반적인 문제를 해결하는 좋은 방법입니다. 컨테이너를 재배포할 때 항상 사용 가능한 최신 이미지를 가져오는 것이 좋습니다.

  1. 다음 중 하나를 실행하여 사용 가능한 최신 컨테이너 이미지를 가져옵니다.

    • 도커 허브

      bash
      $
      docker pull kentik/ktranslate:v2
    • 키아이오

      bash
      $
      docker pull quay.io/kentik/ktranslate:v2
  2. 기존 컨테이너의 ID와 이름을 수집합니다.

    bash
    $
    docker ps -a --filter ancestor=kentik/ktranslate:v2 --format "{{.ID}} - {{.Names}}"

    출력 예:

    3297b134a352 - ktranslate-snmp
    4962a854b386 - ktranslate-sflow
  3. 기존 컨테이너 제거

    bash
    $
    docker rm -f $CONTAINER_ID
  4. SNMP ,흐름 데이터 또는 syslog 수집 에서 배포한 원래 설정을 사용하여 ktranslate 컨테이너를 다시 배포합니다.

중요

ktranslate 에서 사용하는 구성 파일은 런타임에 컨테이너에 적용됩니다. 이 파일을 변경하려면 통합 검색 작업 사용을 제외하고 편집 내용을 적용하려면 실행 중인 컨테이너를 제거하고 다시 시작해야 합니다.

컨테이너 런타임 옵션

다음은 ktranslate 컨테이너 이미지에 대해 Docker 런타임 동안 사용할 수 있는 다양한 옵션입니다.

옵션 이름

유형

필수의

설명

-snmp

깃발

런타임 중에 옵션으로 전달된 Docker 호스트의 볼륨 마운트를 기반으로 Docker 컨테이너의 snmp-base.yaml 파일 경로를 설정합니다.

-nr_account_id

깃발

ktranslate 가 데이터를 배송할 New Relic 계정 ID입니다.

-log_level

깃발

ktranslate 에 대한 기본 정보 로그 수준을 재정의합니다. 사용 가능한 옵션은 debug , info , warn 또는 error 입니다.

-snmp_discovery

깃발

SNMP 검색 모드에서 컨테이너를 설정하여 단일 검색 작업을 실행하고 제공된 YAML 구성 파일을 업데이트하고 종료하는 데 사용됩니다.

-snmp_discovery_min

깃발

고정된 간격으로 실행되도록 예약된 SNMP 폴링 컨테이너 내에서 통합 검색 작업 을 설정하는 데 사용됩니다. 이 설정은 검색 작업을 실행하고 제공된 YAML 구성 파일을 업데이트한 다음 SNMP 폴링 컨테이너에서 SNMP 수집 스레드를 다시 시작하여 검색된 장치에 대한 전체 컨테이너를 파괴/재시작할 필요를 제거합니다.

-snmp_discovery_on_start

깃발

설정된 -snmp_discovery_min 플래그와 결합되면 KTranslate는 -snmp_discovery_min 에 정의된 대로 매 X분 외에도 컨테이너 시작 시 검색 작업을 즉시 실행합니다. -snmp_discovery_min 가 설정되지 않은 경우 이 플래그는 적용되지 않습니다.

-snmp_poll_now

깃발

요청 시 대상 장치를 폴링하도록 컨테이너를 설정하는 데 사용됩니다.

-tee_logs

깃발

ktranslate 의 Docker 로그를 New Relic Logs로 전달합니다.

-metrics=jchf

깃발

ktranslate 에서 New Relic으로 상태 메트릭을 전달합니다.

-service_name

깃발

New Relic Logs의 다양한 컨테이너에서 로그를 분리하는 데 도움이 되도록 Docker 로그의 컨테이너 이름에 추가되었습니다.

-nr_region

깃발

원격 분석을 New Relic으로 전달하도록 ktranslate 의 리전 API 엔드포인트를 설정합니다. 옵션은 US , EUGOV (FedRAMP)입니다.

-max_threads

깃발

더 많은 양의 데이터를 처리할 수 있습니다. 전송된 네트워크 흐름 데이터의 초당 흐름(fps) 2,000개마다 또는 모니터링되는 SNMP 장치 1,000개마다 또는 컨테이너에서 수집하는 초당 syslog 메시지 2,000개마다 사용 가능한 CPU 코어 하나를 권장합니다. 기본값은 1 입니다.

-sample_rate

깃발

흐름이 New Relic 이벤트로 전달되는 기본 샘플 속도 값을 변경합니다. 이렇게 하면 장치에서 흐름 샘플 속도의 로컬 구성 속도가 빨라지지는 않지만 속도가 느려질 수 있습니다. 이것을 1 으로 설정하면 컨테이너로 전송된 모든 흐름을 캡처할 수 있습니다. 기본값은 1000 입니다.

-nf.workers

깃발

네트워크 패킷 처리에 사용되는 작업자 수를 재정의합니다. 전송된 네트워크 흐름 데이터의 초당 흐름(fps) 4,000마다 작업자 한 명을 사용합니다. 기본값은 1 입니다.

-nf.port

깃발

들어오는 흐름 패킷에 대한 수신 포트를 재정의합니다. 기본값은 9995 입니다.

-nf.source

깃발

✓ (흐름 컨테이너의 경우)

이 컨테이너가 처리할 흐름 유형을 설정합니다. 옵션은 ipfix , netflow5 , netflow9sflow 입니다.

-application_map

깃발

런타임 동안 옵션으로 전달된 Docker 호스트의 볼륨 마운트를 기반으로 Docker 컨테이너의 애플리케이션 맵 파일에 대한 경로를 설정합니다.

-dns

깃발

IP 주소의 DNS 확인 중에 사용할 ktranslateIP:Port 을 설정합니다. 이를 설정하면 dst_hostsrc_host 필드의 결과에 영향을 줍니다.

nr1.flow

논쟁

✓ (흐름 컨테이너의 경우)

이 인수는 compression: gzip , sink: new_relic , format: new_relic , max_before_sample: 100 , flow_only:true 플래그를 정적으로 설정합니다.

nr1.snmp

논쟁

✓ (SNMP 컨테이너의 경우)

이 인수는 compression: gzip , sink: new_relic , format: new_relic_metric , max_flows_per_message: 100 옵션을 정적으로 설정합니다.

nr1.syslog

논쟁

✓ (syslog 컨테이너의 경우)

이 인수는 compression: gzip , sink: new_relic , format: new_relic_metric , syslog:"0.0.0.0:5143" 플래그를 정적으로 설정합니다.

NEW_RELIC_API_KEY

환경 변수

ktranslate 가 데이터를 New Relic API로 보내기 위해 New Relic 라이센스 키를 보유하기 위해 Docker 런타임 중에 사용해야 하는 환경 변수입니다. 예: -e NEW_RELIC_API_KEY=$LICENSE_KEY .

HTTPS_PROXY

환경 변수

Docker 런타임 동안 프록시를 통해 New Relic에 데이터를 전달하도록 ktranslate 를 설정하는 데 사용할 수 있는 환경 변수입니다. 예: -e HTTPS_PROXY=https://user:password@hostname:port .

AWS_ACCESS_KEY_ID

환경 변수

Docker 런타임 중에 AWS Secrets Manager를 사용하도록 ktranslate의 SNMPv3 구성을 설정하는 데 사용할 수 있는 환경 변수입니다. 사용자를 인증하기 위한 자격 증명의 일부로 사용되는 AWS 액세스 키를 지정합니다.

AWS_SECRET_ACCESS_KEY

환경 변수

Docker 런타임 중에 AWS Secrets Manager를 사용하도록 ktranslate의 SNMPv3 구성을 설정하는 데 사용할 수 있는 환경 변수입니다. 사용자를 인증하기 위한 자격 증명의 일부로 사용되는 AWS 보안 키를 지정합니다.

AWS_DEFAULT_REGION

환경 변수

Docker 런타임 중에 AWS Secrets Manager를 사용하도록 ktranslate의 SNMPv3 구성을 설정하는 데 사용할 수 있는 환경 변수입니다. 이 프로필을 사용하여 요청된 명령에 대한 요청을 보낼 AWS 리전을 지정합니다.

KENTIK_PING_PRIV

환경 변수

Docker 런타임 중에 ktranslate의 response_time 를 설정하는 데 사용할 수 있는 환경 변수 | ping_only 권한이 없는 모드에서 사용되는 기본 UDP 패킷 대신 ICMP 패킷에 대해 권한 있는 모드를 사용하도록 구성합니다.

Copyright © 2022 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.