이 페이지에서는 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 컨테이너 이미지를 최신 상태로 유지하는 것은 최신 업데이트를 수신하고 개발 수명 주기 동안 적용된 다양한 버그 수정을 통해 일반적인 문제를 해결하는 좋은 방법입니다. 컨테이너를 재배포할 때 항상 사용 가능한 최신 이미지를 가져오는 것이 좋습니다.
다음 중 하나를 실행하여 사용 가능한 최신 컨테이너 이미지를 가져옵니다.
기존 컨테이너의 ID와 이름을 수집합니다.
bash$docker ps -a --filter ancestor=kentik/ktranslate:v2 --format "{{.ID}} - {{.Names}}"출력 예:
3297b134a352 - ktranslate-snmp4962a854b386 - ktranslate-sflow기존 컨테이너 제거
bash$docker rm -f $CONTAINER_IDSNMP ,흐름 데이터 또는 syslog 수집 에서 배포한 원래 설정을 사용하여 ktranslate 컨테이너를 다시 배포합니다.
중요
ktranslate 에서 사용하는 구성 파일은 런타임에 컨테이너에 적용됩니다. 이 파일을 변경하려면 통합 검색 작업 사용을 제외하고 편집 내용을 적용하려면 실행 중인 컨테이너를 제거하고 다시 시작해야 합니다.
컨테이너 런타임 옵션
다음은 ktranslate 컨테이너 이미지에 대해 Docker 런타임 동안 사용할 수 있는 다양한 옵션입니다.
옵션 이름 | 유형 | 필수의 | 설명 |
|---|---|---|---|
| 깃발 | ✓ | 런타임 중에 옵션으로 전달된 Docker 호스트의 볼륨 마운트를 기반으로 Docker 컨테이너의 |
| 깃발 | ✓ | ktranslate 가 데이터를 배송할 New Relic 계정 ID입니다. |
| 깃발 | ktranslate 에 대한 기본 정보 로그 수준을 재정의합니다. 사용 가능한 옵션은 | |
| 깃발 | SNMP 검색 모드에서 컨테이너를 설정하여 단일 검색 작업을 실행하고 제공된 YAML 구성 파일을 업데이트하고 종료하는 데 사용됩니다. | |
| 깃발 | 고정된 간격으로 실행되도록 예약된 SNMP 폴링 컨테이너 내에서 통합 검색 작업 을 설정하는 데 사용됩니다. 이 설정은 검색 작업을 실행하고 제공된 YAML 구성 파일을 업데이트한 다음 SNMP 폴링 컨테이너에서 SNMP 수집 스레드를 다시 시작하여 검색된 장치에 대한 전체 컨테이너를 파괴/재시작할 필요를 제거합니다. | |
| 깃발 | 설정된 | |
| 깃발 | 요청 시 대상 장치를 폴링하도록 컨테이너를 설정하는 데 사용됩니다. | |
| 깃발 | ktranslate 의 Docker 로그를 New Relic Logs로 전달합니다. | |
| 깃발 | ktranslate 에서 New Relic으로 상태 메트릭을 전달합니다. | |
| 깃발 | New Relic Logs의 다양한 컨테이너에서 로그를 분리하는 데 도움이 되도록 Docker 로그의 컨테이너 이름에 추가되었습니다. | |
| 깃발 | 원격 분석을 New Relic으로 전달하도록 ktranslate 의 리전 API 엔드포인트를 설정합니다. 옵션은 | |
| 깃발 | 더 많은 양의 데이터를 처리할 수 있습니다. 전송된 네트워크 흐름 데이터의 초당 흐름(fps) 2,000개마다 또는 모니터링되는 SNMP 장치 1,000개마다 또는 컨테이너에서 수집하는 초당 syslog 메시지 2,000개마다 사용 가능한 CPU 코어 하나를 권장합니다. 기본값은 | |
| 깃발 | 흐름이 New Relic 이벤트로 전달되는 기본 샘플 속도 값을 변경합니다. 이렇게 하면 장치에서 흐름 샘플 속도의 로컬 구성 속도가 빨라지지는 않지만 속도가 느려질 수 있습니다. 이것을 | |
| 깃발 | 네트워크 패킷 처리에 사용되는 작업자 수를 재정의합니다. 전송된 네트워크 흐름 데이터의 초당 흐름(fps) 4,000마다 작업자 한 명을 사용합니다. 기본값은 | |
| 깃발 | 들어오는 흐름 패킷에 대한 수신 포트를 재정의합니다. 기본값은 | |
| 깃발 | 이 컨테이너가 처리할 흐름 유형을 설정합니다. 옵션은 | |
| 깃발 | 런타임 동안 옵션으로 전달된 Docker 호스트의 볼륨 마운트를 기반으로 Docker 컨테이너의 애플리케이션 맵 파일에 대한 경로를 설정합니다. | |
| 깃발 | IP 주소의 DNS 확인 중에 사용할 ktranslate 의 | |
| 논쟁 | ✓ (흐름 컨테이너의 경우) | 이 인수는 |
| 논쟁 | ✓ (SNMP 컨테이너의 경우) | 이 인수는 |
| 논쟁 | ✓ (syslog 컨테이너의 경우) | 이 인수는 |
| 환경 변수 | ✓ | New Relic을 보유하기 위해 Docker 런타임 중에 사용해야 하는 환경 변수 ktranslate이 New Relic API로 데이터를 전송하도록 합니다. 예: |
| 환경 변수 | Docker 런타임 동안 프록시를 통해 New Relic에 데이터를 전달하도록 ktranslate 를 설정하는 데 사용할 수 있는 환경 변수입니다. 예: | |
| 환경 변수 | Docker 런타임 중에 AWS Secrets Manager를 사용하도록 ktranslate의 SNMPv3 구성을 설정하는 데 사용할 수 있는 환경 변수입니다. 사용자를 인증하기 위한 자격 증명의 일부로 사용되는 AWS 액세스 키를 지정합니다. | |
| 환경 변수 | Docker 런타임 중에 AWS Secrets Manager를 사용하도록 ktranslate의 SNMPv3 구성을 설정하는 데 사용할 수 있는 환경 변수입니다. 사용자를 인증하기 위한 자격 증명의 일부로 사용되는 AWS 보안 키를 지정합니다. | |
| 환경 변수 | Docker 런타임 중에 AWS Secrets Manager를 사용하도록 ktranslate의 SNMPv3 구성을 설정하는 데 사용할 수 있는 환경 변수입니다. 이 프로필을 사용하여 요청된 명령에 대한 요청을 보낼 AWS 리전을 지정합니다. | |
| 환경 변수 | Docker 런타임 중에 ktranslate의 | |
| 환경 변수 | Meraki Dashboard API 키를 ktranslate 에 전달하기 위해 Docker 런타임 중에 사용할 수 있는 환경 변수입니다. 예: |