• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

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

문제 신고

'ktranslate' Docker 컨테이너 관리

이 페이지에서는 뉴렐릭의 네트워크 모니터링에서 사용되는 ktranslate 컨테이너 관리 옵션을 간략하게 설명합니다.

컨테이너 요구 사항

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

Disk

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

CPU

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

Memory

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, flow data 또는 syslog collection 에서 구현하거나 배포하는 원래 설정을 사용하여 ktranslate 컨테이너를 재배포합니다.

중요

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

컨테이너 런타임 옵션

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

옵션 이름

유형

필수의

설명

-snmp

깃발

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

-nr_account_id

깃발

ktranslate 이(가) 데이터를 전송할 뉴렐릭 계정 ID입니다.

-log_level

깃발

ktranslate 에 대한 기본 info 계정 레벨을 재정의합니다. 사용 가능한 옵션은 debug, info, warn 또는 error 입니다.

-snmp_discovery

깃발

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

-snmp_discovery_min

깃발

고정된 간격으로 실행되도록 예약된 SNMP 폴링 컨테이너 내에서 integrated discovery jobs 설정하는 데 사용됩니다. 이 설정은 검색 작업을 실행하고, 제공된 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 로그를 뉴렐릭 로그로 전달합니다.

-metrics=jchf

깃발

ktranslate 의 상태 지표를 뉴렐릭으로 전달합니다.

-service_name

깃발

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

-nr_region

깃발

델메트리를 뉴렐릭으로 전달하도록 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마다 작업자 한 명을 사용합니다. 기본값은 2 입니다.

-nf.port

깃발

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

-nf.source

깃발

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

-application_map

깃발

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

-dns

깃발

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

nr1.flow

논쟁

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

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

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" 플래그를 정적으로 설정합니다.

-syslog.format

깃발

syslog 메시지를 구문 분석하는 형식입니다. 옵션은 Automatic|RFC3164|RFC5424|RFC6587|NoFormat 입니다. 기본값: Automatic.

NoFormat RFC 표준을 따르지 않는 메시지를 처리하려면 명시적으로 설정해야 합니다.

-syslog.source

깃발

IP: Syslog 서버를 실행할 포트 튜플입니다. 기본: 0.0.0.0:5143

NEW_RELIC_API_KEY

환경 변수

이(가) Docker 뉴렐릭 에 ktranslate 데이터를 보내기 위해 뉴렐릭 을(를) 보관하기 위해 런타임 중에 사용해야 하는 환경 변수입니다.API 예: -e NEW_RELIC_API_KEY=$LICENSE_KEY.

HTTPS_PROXY

환경 변수

프록시를 통해 뉴렐릭에 데이터를 전송하도록 ktranslate 을 설정하기 위해 Docker 런타임 중에 사용할 수 있는 환경 변수입니다. 예: -e HTTPS_PROXY=https://user:password@hostname:port.

KENTIK_PING_PRIV

환경 변수

Docker 런타임 중에 ktranslate's response_time 설정을 위해 사용할 수 있는 환경 변수 | 비특권 모드에서 사용되는 기본 UDP 패킷 대신 ICMP 패킷에 대해 특권 모드를 사용하도록 ping_only 설정합니다.

KENTIK_MERAKI_API_KEY

환경 변수

Docker Meraki 대시보드 API 키를 에 전달하기 위해 런타임 중에 사용할 수 있는 환경 ktranslate변수입니다. 예: -e KENTIK_MERAKI_API_KEY=$DASHBOARD_API_KEY.

다양한 클라우드 제공업체 환경 변수

환경 변수

docker 런타임 중에 AWS, Azure 또는 GCP에서 비밀을 검색하는 데 사용할 수 있는 환경 변수입니다.

Copyright © 2024 New Relic Inc.

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