Contrail Insights SNMP 트랩
Contrail Insights 네트워크 디바이스에서 전송되는 SNMP 트랩의 모니터링을 지원합니다. 트랩은 SNMP 에이전트에서 원격 네트워크 관리 시스템 또는 트랩 수신기로 전송되는 원치 않는 메시지입니다.
SNMP 트랩을 전달하도록 디바이스 구성
Contrail Insights 디바이스에서 SNMP 트랩을 수신하려면 기본적으로 전달되지 않기 때문에 디바이스가 트랩을 전달하도록 구성해야 합니다. 이는 디바이스의 Junos OS CLI에서 수동으로 수행하거나 Contrail Insights 소프트웨어 개발 키트(SDK)를 통해 수행될 수 있습니다.
디바이스에서 SNMP 트랩 구성 확인
버전 3.1 Contrail Insights 이전:
Contrail Insights 버전 3.0에서 Contrail Insights SNMPv2 트랩만 지원합니다. 디바이스가 SNMP 트랩을 전달하도록 구성된 후, Junos OS CLI에 로그인하고 다음 명령을 실행하여 구성을 확인할 수 있습니다.
show snmp
출력은 다음 예와 유사해야 합니다.
trap-options {
source-address {device_ip};
}
trap-group snmp-trap-metallb-test {
version v2;
destination-port 42597;
categories {
link;
authentication;
}
targets {
{collector_1_ip};
{collector_2_ip};
}
}
구성에 관한 추가 세부 정보는 SNMP 트랩 구성을 참조하십시오.
Contrail Insights 버전 3.1 이후:
Contrail Insights 버전 3.1 이상이 설치된 경우, Contrail Insights 버전 3.0의 디바이스 구성이 더 이상 유효하지 않아 디바이스의 SNMP 트랩 구성을 업데이트해야 합니다. Contrail Insights 버전 3.1 이상에서 Contrail Insights SNMPv2와 SNMPv3을 모두 지원합니다. Contrail Insights SNMP 트랩을 수집할 수 있도록 다음 샘플 구성을 사용하여 디바이스를 구성해야 합니다.
디바이스가 SNMP 트랩을 전달하도록 구성된 후, Junos OS CLI에 로그인하고 다음 명령을 실행하여 구성을 확인할 수 있습니다.
show snmp v3
출력은 SNMPv2의 다음 예와 유사해야 합니다.
다음 구성의 은 security-name public (는) 디바이스에서 설정한 SNMPv2 커뮤니티 이름을 나타냅니다. 이 SNMP 트랩 구성을 추가하기 전에 SNMPv2 커뮤니티 이름을 설정합니다.
...
SNMP v2c Configuration
...
target-address appformix_snmp_v2 {
address x.x.x.x;
port 42597;
tag-list appformix_snmp_v2;
target-parameters appformix_snmp_v2;
}
target-parameters appformix_snmp_v2 {
parameters {
message-processing-model v2c;
security-model v2c;
security-level none;
security-name public; //this is the snmp v2c community name
}
notify-filter appformix_snmp_v2;
}
notify appformix_snmp_v2 {
type trap;
tag appformix_snmp_v2;
}
notify-filter appformix_snmp_v2 {
oid .1 include;
}
출력은 SNMPv3의 다음 예와 유사해야 합니다.
...
SNMP v3 Configuration
...
target-address appformix_snmp_v3 {
address x.x.x.x;
port 42597;
tag-list appformix_snmp_v3;
target-parameters appformix_snmp_v3;
}
target-parameters appformix_snmp_v3 {
parameters {
message-processing-model v3;
security-model usm;
security-level authentication;
security-name acelio;
}
notify-filter appformix_snmp_v3;
}
notify appformix_snmp_v3 {
type trap;
tag appformix_snmp_v3;
}
notify-filter appformix_snmp_v3 {
oid .1 include;
}
구성에 관한 추가 세부 정보는 Junos OS 실행하는 디바이스에서 SNMPv3 트랩 구성을 참조하십시오.
, 및 security-level변수security-model는 이 디바이스에서 설정한 SNMPv3 구성과 security-name 관련이 있습니다. SNMPv3 트랩을 활성화하기 전에 SNMPv3 자격 증명으로 디바이스를 구성합니다.
네트워크 디바이스에서 SNMP 트랩 모니터링을 활성화하기 위한 Contrail Insights 구성
- 네트워크 디바이스에 대한 SNMP 트랩 듣기 활성화
- SNMPv2c용 네트워크 디바이스 JSON 파일 생성
- SNMPv3에 대한 네트워크 디바이스 JSON 파일 생성
- Contrail Insights 네트워크 디바이스 모니터링 플러그인 구성
- SNMP 트랩을 활성화하여 Contrail Insights 대시보드에 표시
- 외부 알림에 대한 SNMP 트랩 데이터
네트워크 디바이스에 대한 SNMP 트랩 듣기 활성화
네트워크 디바이스 설정 > Contrail Insights 대시보드에서 SNMP 디바이스 구성을 추가하거나 편집하고 Contrail Insights 구성된 디바이스에 대해 SNMP 트랩을 수집하도록 할 수 있습니다. Ansible에서 플러그인을 게시 snmp_trap_network_device 한 경우, Contrail Insights Contrail Insights 구성된 모든 SNMP 네트워크 디바이스에서 SNMP 트랩 수신을 자동으로 시작합니다.
디바이스에 대한 SNMPv3 트랩을 활성화하려면 필드는 SnmpEngineId 필요합니다. 이 필드는 일반적인 SNMP 폴링에 필요하지 않습니다.
SNMPv2c용 네트워크 디바이스 JSON 파일 생성
모니터링해야 하는 네트워크 디바이스 목록은 다음 형식의 JSON 파일에 추가되어야 합니다. JSON 파일에 여러 디바이스가 있을 수 있습니다.
{
"NetworkDeviceList": [
{
"NetworkDevice": {
"MetaData": {
"SnmpConfig": {
"Version": "2c",
"OIDList": ["TCP-MIB::tcp",
"IF-MIB::ifTable",
"enterprises.2636.3.1.13.1"],
"Community": "public"}
},
"Name": "QFX0",
"NetworkDeviceId": "QFX0",
"ManagementIp": "x.x.x.x",
"ChassisType": "tor",
"Source": ["user.snmp"],
"InterfaceList": [
],
"ConnectionInfo": []
}
}
]
}
현장에 user.snmp 포함되어 Source 야 합니다. Contrail Insights Contrail Insights 구성된 모든 user.snmp 디바이스에서 전송된 트랩을 자동으로 모니터링하기 시작합니다. 다른 필드와 Ansible을 사용하여 네트워크 디바이스를 게시하는 방법에 대한 자세한 내용은 JSON 파일의 네트워크 디바이스 구성을 참조하십시오.
SNMPv3에 대한 네트워크 디바이스 JSON 파일 생성
모니터링해야 하는 네트워크 디바이스 목록은 다음 형식을 사용하여 JSON 파일에 추가해야 합니다. JSON 파일에 여러 디바이스가 있을 수 있습니다. SNMPv3 트랩의 경우 에 대한 SnmpConfig을(를SnmpEngineId) 지정해야 합니다.
{
"NetworkDeviceList": [
{
"NetworkDevice": {
"MetaData": {
"SnmpConfig": {
"Version": "3",
"Password": "pwd",
"Level": "authPriv",
"PrivKey": "privkey",
"PrivProtocol": "DES",
"Protocol": "MD5",
"SnmpEngineId": "80000a4c010a574478",
"OIDList": ["TCP-MIB::tcp",
"IF-MIB::ifTable",
"enterprises.2636.3.1.13.1"],
"Username": "user"}
},
"Name": "QFX0",
"NetworkDeviceId": "QFX0",
"ManagementIp": "x.x.x.x",
"ChassisType": "tor",
"Source": ["user.snmp"],
"InterfaceList": [
],
"ConnectionInfo": []
}
}
]
}
Contrail Insights 네트워크 디바이스 모니터링 플러그인 구성
Contrail Insights 설치 시 구성하여 SNMP 트랩 플러그인을 활성화해야 합니다. Contrail Insights Ansible 설치 디렉터리에 있는 폴더에 certified_plugins 내장된 SNMP 트랩 플러그인이 있습니다. 이는 의 변수group_vars/all에 플러그인 설명자에 appformix_plugins 포함되어야 합니다.
# network_device_file_name is optional, if you want to add devices from UI, then you don't need it
network_device_file_name: <path_to_above_json_file>
appformix_plugins:
- { plugin_info: certified_plugins/snmp_trap_network_device.json }
SNMP 트랩을 활성화하여 Contrail Insights 대시보드에 표시
Contrail Insights 대시보드 알람 페이지에서 SNMP 트랩 팝업을 사용하도록 구성된 profiles/network_device_snmp_trap_profile.json 내장형 SNMP 트랩 규칙이 있습니다. 트랩은 기본적으로 Contrail Insights 게시되며 트랩이 Contrail Insights 에이전트로 전송될 때마다 트랩은 Contrail Insights 대시보드 알람 페이지에 표시되고 Contrail Insights 수신하는 트랩에 대한 자세한 정보를 표시합니다.
외부 알림에 대한 SNMP 트랩 데이터
Contrail Insights SNMP 트랩을 수신하면, Contrail Insights 대시보드 > 알람 에 트랩을 규칙 network_device_snmp_trap 적으로 표시하고 Kafka가 Contrail Insights 구성된 경우 아파치 카프카로 보냅니다. 규칙을 network_device_snmp_trap PagerDuty, ServiceNow, Slack, Custom Notifier 등과 같은 외부 통보자와 연결할 수 있습니다.
다음은 SNMP 트랩에 대한 외부 공지 사항으로 전송되는 JSON 파일의 예입니다.
{'status': {
'description': 'NetworkDevice sample_device: SNMP Trap Received for OID=linkUp',
'timestamp': 1555549001000,
'entityType': 'network_device',
'state': 'triggered',
'entityDetails': {},
'entityId': 'sample_device',
'metaData': {
'snmpTrapOID': 'linkUp',
'Timestamp': 1555548996000,
'ifAdminStatus': '1',
'roomKey': 'sample_device',
'ifIndex': '545',
'ifName': 'irb.20',
'ifOperStatus': '1',
'sysUpTimeInstance': '1028117810'}
},
'kind': 'Alarm',
'spec': {
'aggregationFunction': 'sum',
'intervalDuration': 1,
'severity': 'none',
'module': 'alarms',
'intervalCount': 1,
'metricType': 'snmp.trap',
'name': 'network_device_snmp_trap',
'eventRuleId': 'NETWORK_DEVICE_SNMP_TRAP',
'mode': 'event',
'intervalsWithException': 1,
'threshold': 1,
'comparisonFunction': 'equal'},
'apiVersion': 'v2'}
> 필드에서 SNMP 트랩에 status 대한 간략한 설명, > description 필드에서 SNMP 트랩에 metaData status 대한 자세한 정보를 찾을 수 있으며 status , > entityId 이 트랩이 속한 네트워크 디바이스를 알려줍니다.
Contrail Insights 네트워크 에이전트에 관리 정보 베이스(MIB) 설치
Contrail Insights 디바이스로부터 트랩을 수신하면 해당 관리 정보 베이스(MIB)가 Contrail Insights 에이전트에 설치되지 않은 경우 Contrail Insights OID를 적절한 사용자 이해할 수 있는 문자열로 디코딩하지 못할 수 있습니다. 관리 정보 베이스(MIB)를 다운로드하고 모든 관리 정보 베이스(MIB) 파일을 모든 *.txt 네트워크 에이전트 /usr/share/snmp/mibs/ 에 수동으로 복사하거나 Contrail Insights Ansible을 사용하여 관리 정보 베이스(MIB) 파일을 구축해야 합니다.
Ansible에서 관리 정보 베이스(MIB)를 설치하려면 사용자 지정 SNMP 플러그인을 참조하십시오.