네트워크 장치¶
네트워크 장치 모니터링은 라우터, 스위치 등 SNMP를 지원하는 네트워크 장치의 기본 정보, 온라인 상태, 인터페이스 상태 및 성능 메트릭을 중앙에서 확인할 수 있게 하여, 네트워크 인프라의 운영 상태를 파악하고 장치 또는 인터페이스 이상 발생 시 문제를 신속하게 찾을 수 있도록 지원합니다.
데이터 소스¶
표준 연동 방식에서는 장치가 Guance 콘솔에서 수동으로 생성되지 않습니다. 장치 데이터는 주로 사용자 네트워크 환경에 배포된 DataKit이 SNMP 프로토콜을 통해 네트워크 장치에서 수집한 후 현재 워크스페이스로 전송합니다.
간소화된 데이터 흐름은 다음과 같습니다.
DataKit은 장치가 제공하는 MIB/OID에서 장치 이름, IP 주소, 유형, 제조사, 가동 시간, 인터페이스 및 CPU, 메모리, 네트워크 트래픽, 패킷 손실, 오류 패킷 등의 정보를 가져옵니다. 장치 기본 정보는 장치 목록을 생성하고 업데이트하는 데 사용되며, 시계열 메트릭은 성능 차트와 실행 상태를 표시하는 데 사용됩니다.
제조사와 모델에 따라 공개된 MIB/OID가 다르므로 실제 표시되는 필드와 메트릭은 다를 수 있습니다. 내장 Profile이 장치 모델이나 제조사 전용 메트릭을 포함하지 않는 경우, 제조사가 제공하는 MIB/OID 문서를 참고하여 사용자 정의 Profile을 추가할 수 있습니다.
자세한 구성 방법은 SNMP 수집기를 참조하세요.
주의
DataKit SNMP 수집기를 구성하지 않은 경우 이 페이지에 장치 데이터가 자동으로 생성되지 않습니다.
사전 조건¶
연동을 시작하기 전에 다음 사항을 확인하세요.
- 네트워크 장치에 접근할 수 있는 호스트 또는 Kubernetes 환경에 DataKit 설치를 완료했는지 확인합니다.
- 수집 대상 장치에서 SNMP를 활성화했는지 확인합니다. DataKit은 SNMP v1, v2c, v3를 지원하며, 보안 요구 수준이 높은 경우 v3 사용을 권장합니다.
-
해당 SNMP 인증 정보를 준비했는지 확인합니다.
- v1/v2c: 읽기 전용 커뮤니티 이름만 있으면 됩니다.
- v3: 사용자 이름, 인증 프로토콜 및 비밀번호, 암호화 프로토콜 및 비밀번호 등
-
DataKit이 설치된 호스트에서 장치의 SNMP 서비스에 접근할 수 있어야 하며, 기본 포트는 UDP 161입니다.
- 장치 ACL, 방화벽 또는 액세스 관리 정책에서 DataKit이 설치된 호스트의 SNMP 요청을 허용해야 합니다.
장치 연동¶
DataKit은 '특정 장치'와 '자동 발견' 두 가지 연동 방식을 지원하며, 두 방식을 동시에 사용할 수 있습니다. 두 방식을 함께 사용하는 경우 관련 장치에 동일한 SNMP 버전과 인증 설정을 적용해야 합니다.
특정 장치¶
장치 IP가 명확하고 수집 범위를 제어하려는 경우에 적합합니다. SNMP 수집기 구성에서 specific_devices를 통해 하나 이상의 장치 IP를 지정합니다. DataKit은 해당 IP로 직접 SNMP 요청을 보냅니다.
자동 발견¶
장치 수가 많거나 새 장치를 지속적으로 발견해야 하는 경우에 적합합니다. SNMP 수집기 구성에서 auto_discovery를 통해 하나 이상의 CIDR 대역을 지정합니다. DataKit은 구성된 대역 내 IP를 주기적으로 검색합니다. 특정 IP가 SNMP 요청에 응답하고 반환된 sysObjectID가 해당 Profile과 일치하면 해당 IP를 네트워크 장치로 식별합니다.
자동 발견이 Guance가 임의의 네트워크를 스캔한다는 의미는 아닙니다. DataKit에 명시적으로 구성한 대역만 스캔합니다.
수집 구성 완료¶
DataKit 배포 방식에 따라 SNMP 수집기에서 장치 IP 또는 자동 발견 대역, SNMP 버전 및 해당 인증 정보를 구성한 다음 DataKit 구성을 재시작하거나 업데이트합니다. 호스트 설치와 Kubernetes 설치의 구성 방식이 다르므로 SNMP 수집기의 해당 탭에 따라 작업을 완료하세요.
수집에 성공하면 장치는 인프라 > 네트워크 > 장치에 자동으로 나타나며, 콘솔에서 다시 생성할 필요가 없습니다.
주의
SNMP 인증 정보는 민감한 정보이므로 안전하게 관리하고, 실제 커뮤니티 이름, 사용자 이름 또는 비밀번호를 공개 문서, 스크린샷, 코드 저장소에 작성하지 마세요.
장치 목록 보기¶
인프라 > 네트워크 > 장치로 이동하여 DataKit SNMP 수집기를 통해 현재 워크스페이스에 연동된 네트워크 장치를 확인합니다.
장치 목록에는 다음이 표시됩니다.
- 장치 상태
- 장치 이름
- 장치 IP
- 장치 유형
- 인터페이스 수
- CPU 사용률
- 메모리 사용률
- 장치 가동 시간
- 마지막 업데이트 시간
장치가 관련 필드를 표시하는지 여부는 장치 모델, SNMP Profile 및 장치가 실제로 공개한 MIB/OID에 따라 달라집니다.
필드에 값이 없다고 해서 반드시 장치 이상을 의미하는 것은 아닙니다. 장치가 해당 메트릭을 제공하지 않거나 현재 Profile이 아직 적용되지 않았을 수도 있습니다.
장치 상태¶
장치 상태는 Guance가 해당 장치 데이터를 마지막으로 수신한 시간을 기준으로 판단합니다.
- 활성(Active): 마지막 업데이트가 5분 이내이며 데이터가 정상적으로 업데이트됩니다.
- 지연(Suspect): 마지막 업데이트가 5분을 초과하고 10분 이내입니다. 수집 지연 또는 장치 이상이 있을 수 있습니다.
- 오프라인(Offline): 마지막 업데이트가 10분을 초과했습니다. Guance가 새로운 장치 데이터를 수신하지 못했습니다.
주의
'오프라인'은 Guance가 해당 시간 동안 장치의 새 데이터를 수신하지 못했음을 의미하며, 장치가 반드시 전원이 꺼진 것은 아닙니다. DataKit 중지, 수집 네트워크 중단, 인증 실패 또는 SNMP 서비스 종료로 인해 장치가 오프라인으로 표시될 수도 있습니다.
검색, 필터링 및 정렬¶
- 검색: 장치 이름 또는 IP를 입력하여 장치를 빠르게 찾습니다.
- 필터링: 장치 이름, IP, 유형, 가동 시간 등의 조건으로 범위를 좁힙니다.
- 활성 장치: 한 번에 현재 활성 상태인 장치만 표시합니다.
- 정렬: 목록의 열 머리글을 클릭하여 해당 필드를 오름차순 또는 내림차순으로 정렬합니다.
장치 토폴로지 보기¶
「인프라 > 네트워크 > 장치」로 이동한 다음 「토폴로지」 탭으로 전환하면 LLDP 이웃 발견 데이터를 기반으로 생성된 네트워크 장치 물리 토폴로지를 확인할 수 있습니다. 토폴로지의 노드는 네트워크 장치를 나타내고, 노드 사이의 연결선은 장치 간 물리적 연결 관계를 나타냅니다.
사전 조건
토폴로지 뷰를 사용하려면 먼저 네트워크 장치 측에서 LLDP를 활성화하고 DataKit의 SNMP 수집기에서 LLDP 토폴로지 데이터 수집 활성화를 해야 합니다.
노드 상태¶
모니터링 대상 장치는 장치 목록의 상태 계산 규칙을 따릅니다. LLDP로만 발견되고 snmp_object 데이터를 전송하지 않은 이웃 장치는 미모니터링으로 표시됩니다.
| 상태 | 정의 |
|---|---|
| 활성 | 마지막 업데이트 시간 ≤ 5분 |
| 지연 | 5분 < 마지막 업데이트 시간 ≤ 10분 |
| 오프라인 | 마지막 업데이트 시간 > 10분 |
| 미모니터링 | LLDP가 이웃 장치를 발견했지만 장치 목록에 해당 snmp_object 레코드가 없음 |
토폴로지 맵은 서로 다른 노드 스타일로 장치 상태를 구분합니다. 미모니터링 이웃은 회색 노드로 표시되어 아직 모니터링에 포함되지 않은 네트워크 장치를 빠르게 식별할 수 있습니다.
노드 정보¶
모니터링 대상 장치 노드에 마우스를 올리면 장치 이름, IP 주소, 제조사, 상태, CPU 사용률, 메모리 사용률, 연결 수 등의 정보를 확인할 수 있으며 다음 작업을 수행할 수 있습니다.
- 상세 보기: 해당 장치 상세 페이지의 「장치 정보」로 이동합니다.
- 인터페이스 트래픽: 해당 장치 상세 페이지의 「인터페이스 정보」로 이동하여 인터페이스 상태와 트래픽 데이터를 확인합니다.
미모니터링 이웃 노드에 마우스를 올리면 LLDP로 발견된 장치 이름, 사용 가능한 IP 주소 및 '미모니터링' 상태를 확인할 수 있습니다.
주의
LLDP 데이터에 안정적인 피어 IP 주소가 제공되지 않으면 미모니터링 이웃의 IP 주소가 비어 있을 수 있습니다. 장치가 CPU 또는 메모리 메트릭을 전송하지 않는 경우 해당 데이터도 비어 있을 수 있습니다.
노드 표시 규칙¶
| 시나리오 | 토폴로지 맵 표시 |
|---|---|
| 모니터링 대상 장치가 이웃을 발견함 | 장치 상태에 따라 노드를 표시하고 이웃과의 연결선을 표시 |
| LLDP로 미모니터링 이웃을 발견함 | 회색 노드와 연결선을 표시하고, 마우스를 올리면 LLDP가 제공하는 장치 정보 표시 |
| 모니터링 대상 장치가 이웃을 발견하지 못함 | 연결선이 없는 독립 노드를 표시하고 연결 수는 0 |
| 장치가 모니터링되지 않고 LLDP로도 발견되지 않음 | 표시하지 않음 |
빠른 작업¶
- 검색: 장치 이름 또는 IP 주소로 노드를 검색하고 필터링합니다.
- 범례: 다양한 노드 상태와 스타일의 의미를 확인합니다.
- 캔버스 제어: 토폴로지 맵을 확대, 축소 또는 화면에 맞게 표시합니다.
장치 상세 보기¶
장치 이름을 클릭하여 상세 페이지로 이동하면 장치 정보, 인터페이스 실행 상태 및 성능 메트릭을 확인할 수 있습니다.
장치 정보¶
장치 정보 영역에는 현재 장치의 기본 속성이 표시됩니다.
- 가동 시간: 장치가 마지막으로 시작된 이후 계속 가동된 시간
- 제조사 식별자: 장치가 반환한 제조사 OID
- CPU 평균 사용률: 장치 CPU 사용 현황
- 메모리 평균 사용률: 장치 메모리 사용 현황
- 인터페이스 수: 장치에서 수집한 네트워크 인터페이스 총 개수
- 장치 설명: 장치가 반환한 제조사, 모델, 소프트웨어 버전 등 설명 정보
- 확장 속성: 장치의 태그와 메타데이터로, 필드 이름이나 값으로 검색 가능
일부 정보가 비어 있다면 장치가 SNMP를 통해 해당 OID를 반환하는지, 현재 장치 Profile에 해당 필드가 포함되어 있는지 먼저 확인하세요.
인터페이스 정보¶
인터페이스 정보 영역에는 장치 네트워크 인터페이스의 상태와 트래픽 통계가 표시됩니다.
- 인터페이스 총 개수 및 Up, Down, Admin Down 상태 분포
- 인터페이스 이름과 상태
- 인바운드 및 아웃바운드 트래픽
- 인바운드 및 아웃바운드 오류 패킷
- 인터페이스 대역폭 상한
인터페이스 상태로 필터링하여 비정상 포트를 빠르게 찾을 수 있으며, 페이지 오른쪽 상단의 설정 진입점을 통해 인터페이스 메트릭에 대한 모니터를 구성할 수도 있습니다.
인터페이스에 트래픽 또는 오류 패킷 데이터가 없으면 장치에서 IF-MIB를 공개하는지, 인터페이스 카운터를 읽을 수 있는지, Profile에 해당 OID가 포함되어 있는지 확인하면 됩니다.
성능 메트릭¶
성능 메트릭 영역에서는 장치 및 인터페이스의 시계열 데이터를 차트로 표시합니다. 주요 항목은 다음과 같습니다.
- 기본 메트릭: CPU Usage, Mem Usage, Interface IfOperStatus, TCP CurrEstab 등
- 트래픽 메트릭: Inbound Throughput, Outbound Throughput 등
- 인터페이스 네트워크: 각 인터페이스의 인바운드, 아웃바운드 네트워크 트래픽
- 인터페이스 패킷 손실 및 오류: 각 인터페이스의 드롭 패킷 및 오류 패킷 통계
상단의 시간 선택기를 사용하여 조회 범위를 전환하거나 장치 IP 또는 장치 이름으로 데이터를 필터링할 수 있습니다.
자주 묻는 질문¶
목록에 장치가 없습니다
다음을 순서대로 확인하세요.
- DataKit이 설치되어 정상적으로 실행 중인지 확인합니다.
- SNMP 수집기가 활성화되어 있고 구성 변경 후 DataKit을 재시작했는지 확인합니다.
- 올바른 장치 IP 또는 자동 발견 대역을 구성했는지 확인합니다.
- 장치에서 SNMP가 활성화되어 있는지 확인합니다.
- SNMP 버전과 인증 정보가 장치 측과 일치하는지 확인합니다.
- DataKit이 장치의 UDP 161 포트에 접근할 수 있는지 확인합니다.
- DataKit이 설치된 호스트에서
snmpwalk를 실행할 때 장치 OID를 읽을 수 있는지 확인합니다. - 자동 발견 모드에서 장치가 반환한
sysObjectID가 Profile과 일치할 수 있는지 확인합니다. - DataKit이 데이터를 현재 조회 중인 워크스페이스로 전송했는지 확인합니다.
장치는 보이지만 CPU, 메모리 또는 일부 인터페이스 메트릭이 없습니다
DataKit은 SNMP 장치에서 공통 기준 메트릭을 수집하지만, 제조사 전용 메트릭은 해당 MIB/OID와 Profile에 따라 달라집니다. 다음을 확인하세요.
- 장치가 SNMP를 통해 해당 메트릭을 제공하는지 확인합니다.
- 현재 Profile이 해당 제조사와 모델을 지원하는지 확인합니다.
- 장치 계정에 해당 MIB에 대한 읽기 권한이 있는지 확인합니다.
- 장치에 사용자 정의 Profile을 추가해야 하는지 확인합니다.
장치가 갑자기 지연 또는 오프라인으로 표시됩니다
장치 자체의 장애 외에도 다음과 같은 원인으로 발생할 수 있습니다.
- DataKit 중지 또는 재시작
- DataKit과 장치 사이의 네트워크 중단
- SNMP 서비스 종료
- SNMP 인증 정보 변경
- 장치 ACL 또는 방화벽 정책 변경
- 수집 작업 실행 시간 초과 또는 데이터 전송 링크 이상
먼저 DataKit이 설치된 호스트에서 snmpwalk를 실행하여 장치 접근 문제인지 데이터 전송 문제인지 확인하는 것이 좋습니다.
새 장치는 얼마나 지나면 목록에 표시되나요
특정 장치 모드에서는 DataKit이 구성된 수집 주기에 따라 장치를 폴링하며, 자동 발견 모드에서는 자동 발견 주기의 영향도 받습니다. 현재 SNMP 수집기의 기본 주기는 메트릭이 10초마다, 장치 정보가 5분마다, 자동 발견이 1시간마다 실행됩니다. 이 주기는 모두 조정할 수 있으며 실제 표시되는 시점은 사용자의 수집기 구성에 따릅니다.

