프로필은 ktranslate 수집하여 New Relic 계정으로 보내는 SNMP OID를 정의합니다. 이 문서에서는 기존 프로필을 수정하거나 새 프로필을 만드는 방법을 설명합니다.
시작하다
사용자 지정 프로필을 작성하거나 오픈 소스 프로필 중 하나를 수정하기로 결정했다면 몇 가지 필수 도구가 필요합니다.
- A Git repo: 주로 GitHub이지만 모든 클라우드 또는 로컬 git 도구가 될 수 있습니다.
- 이렇게 하면 Kentik SNMP 프로필 컬렉션을 시작점으로 복제하고 필요에 따라 고유한 수정 사항과 새 프로필을 추가할 수 있습니다.
- 프로파일에서 작업하려는 네트워크 장치의 SNMP 워크. 자세한 내용은 SNMP 설정 및
snmpwalk사용 에 대한 설명서를 참조하세요.
팁
New Relic은 kentik/snmp-profiles의 콘텐츠를 직접 지원하지 않습니다. New Relic 기술 지원은 문제를 제기하기 위해 다시 리디렉션하는 것 외에 추가 지원을 제공할 수 없습니다.
사용자 정의 프로필을 비공개로 사용
새 프로필을 추가하거나 ktranslate에 포함된 프로필을 수정하는 가장 효과적인 방법 은 Kentik/snmp-profiles 저장소 의 고유한 개인 복사본을 만들고 시작 시 사용자 지정 프로필 디렉터리를 Docker 컨테이너에 로드하는 것입니다.
팁
devices.[deviceName].provider 값은 New Relic에서 엔티티 합성에 중요합니다. 자세한 내용은 장치 구성에 대한 설명서에서 찾을 수 있습니다.
이를 수행하는 방법은 Docker의 볼륨 마운트를 사용하여 맞춤 파일을 etc/ktranslate/profiles/ 디렉터리 내부의 KTranslate 컨테이너에 전달하는 것입니다. 이 작업을 수행할 수 있는 다른 방법이 있지만 이 예에서는 데이터를 로컬에서 포크하고 복제하는 GitHub를 시연합니다.
- 파일을 보관할 디렉터리에 있는지 확인한 다음 GitHub 리포지토리의 포크를 Docker 호스트에 복제합니다.
git clone https://github.com/<YourGitUser>/snmp-profiles.git- 일반적으로 SNMP 컨테이너를 시작하는 데 사용하는 명령을 가져오고
snmp-base.yaml에서 전달한 인수 뒤에 두 번째 볼륨 마운트 인수를 추가합니다.
-v `pwd`/snmp-profiles/profiles:/etc/ktranslate/profiles \mount 명령은 기본 제공 프로필 디렉터리를 사용자 지정 데이터로 바꿉니다.
최종 결과는 다음과 유사합니다.
docker run -ti --name ktranslate-discovery --rm --net=host \--user `id -u`:`id -g` \-v `pwd`/snmp-base.yaml:/snmp-base.yaml \-v `pwd`/snmp-profiles/profiles:/etc/ktranslate/profiles \kentik/ktranslate:v2 \-snmp /snmp-base.yaml \-log_level info \-snmp_discovery=true팁
검색 컨테이너 또는 SNMP 폴링 컨테이너를 시작할 때마다 프로필의 사용자 정의 버전을 전달해야 합니다. 모든 SNMP 인스턴스 세트에 대해 일관되게 사용하지 않으면 불안정한 동작이 발생할 수 있습니다.
팁
기존 SNMP 프로필이 잘못된 데이터 또는 다른 중단 동작을 반환하거나 새롭거나 수정된 SNMP 프로필을 요청하는 경우 다음 지침에 따라 snmp-profiles Github 리포지토리에서 문제를 엽니다. 제3자 프로젝트 GitHub - kentik/snmp-profiles: ktranslate용 SNMP 프로필 에서 SNMP 프로필의 수정 또는 생성을 위한 타임라인을 제공할 수 없습니다.
New Relic 계정과 연결된 서비스 수준에 따라 New Relic 글로벌 기술 지원에서 사례 지원을 받을 수 있습니다. 당사의 글로벌 기술 지원 서비스에 따라 문제가 New Relic의 제품과 관련된 것인지 아니면 당사의 통제 및 권한 밖의 원인인지 판단하기 위해 최선을 다할 것입니다. 당사가 해결할 수 없는 제3자 도구 문제의 경우 업스트림 오픈 소스 프로젝트에 개선 사항, 패치 또는 기타 기능 개발을 제공하기 위해 상업적으로 합당한 노력을 기울일 것입니다.
프로필 및 수정 사항을 공개적으로 제공
오픈 소스 리포지토리로서 새 프로필을 만들거나 기존 프로필을 개선하려는 모든 사람의 기여를 환영합니다.
- 프로필 구조에 익숙해지려면 GitHub에서 주석이 많이 달린 이 template.yml을 검토하세요.
- GitHub에 로그인하고 snmp-profiles repo 로 이동합니다.
- 귀하의 계정에서 동일한 정보의 사본을 생성하려면 상단 근처에 있는 포크 버튼을 클릭하십시오.
- 포크 내에서 필요에 따라 파일을 변경하거나 필요에 따라 새 공급업체 디렉토리 및 프로필을 만듭니다.
- pull 요청을 제출하기 전에 codebeautify 와 같은 YAML 유효성 검사기를 통해 프로필을 전달해야 합니다.
- 변경이 완료되면 upstream repo 에 pull 요청을 제출하십시오.
New Relic은 제3자 리포지토리의 프로필을 검토하는 과정에 관여하지 않으며 변경 및 업데이트에 대한 모든 요청은 Github 문제를 통해 Kentik의 관리자와 함께 해결해야 합니다.
프로필이 병합된 직후 새 SNMP 프로필은 Docker 이미지의 새 버전을 가져오고 환경에서 새 컨테이너를 시작하여 자동으로 사용할 수 있습니다. 자세한 내용은 SNMP 수동 설정에 대한 설명서를 참조하십시오.
팁
업스트림 리포지토리의 변경 사항을 최신 상태로 유지하려면 포크를 정기적으로 동기화해야 합니다 .
실제로 프로필에 어떤 종류의 OID를 포함해야 합니까?
많은 경우 SNMP는 많은 데이터를 제공하지만 해당 데이터의 대부분은 실행 가능한 정보를 제공하지 않습니다. 또는 데이터가 매우 드물고 영향이 적은 가치를 제공하므로 New Relic 계정에 가져올 가치가 없을 수도 있습니다.
장치가 수행할 것으로 기대하는 기능을 수행할 수 없도록 하는 요소가 있는지 알려주는 데이터 수집에 집중하고 싶습니다. 이를 바탕으로 해당 기능을 얼마나 잘 수행하고 있는지 알려주는 측정값을 수집해야 합니다.
예 1: VPN 집중 장치로 작동하는 장치의 경우 다음과 같은 상위 수준 시스템 메트릭을 수집합니다.
- CPU 및 메모리 사용률
- 팬 고장 등으로 인해 장치가 자동으로 종료되지 않도록 하는 하드웨어 센서 정보
- 집계된 연결 및 처리량에 대해 알려주는 OID
예 2: 사용 가능하지만 매우 낮은 값을 제공하는 데이터의 예는 네트워크 어플라이언스에서 실행 중인 모든 프로세스를 나열하는 OID 테이블입니다. 서버 관리자의 관점에서 보면 유용하게 들릴 수 있지만 이것은 어플라이언스이기 때문에 일반적으로 내부에서 실행되는 프로세스에 대해 수행할 기능이나 필요가 없습니다. 실제로 아무 것도 할 수 없는 수백 개의 항목이 있는 테이블을 폴링하고 저장하는 것은 효율적이지 않습니다.