네트워크 장치¶
네트워크 장치 모니터링은 라우터, 스위치 등 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이 아직 적용되지 않았을 수도 있습니다.
표시 항목 구성¶
장치 목록은 기존 표시 항목에 선택 가능한 필드를 추가로 제공합니다. 목록 오른쪽 상단의 표시 항목을 클릭하면 필요에 따라 필드를 켜거나 끌 수 있고, 필드를 드래그하여 표시 순서를 조정할 수 있습니다. 초기화를 클릭하면 기본 구성으로 복원됩니다. 장치 이름은 고정 표시 항목입니다.
기본으로 표시되는 장치 정보 외에도 다음 표시 항목을 선택할 수 있습니다.
| 표시 항목 | 설명 |
|---|---|
| 태그 | 장치 태그 |
| Ping 상태 | 장치의 Ping 탐지 상태 |
| 인바운드 처리량, 아웃바운드 처리량 | 장치의 인바운드 및 아웃바운드 처리량 상태 |
| 제조사 | 장치 제조사 |
| SysObjectID | 장치의 시스템 객체 ID |
| 모델, 시리얼 번호 | 장치 모델 및 시리얼 번호 |
| 장치 위치 | 장치 위치 정보 |
| 버전 | 장치 버전 정보 |
| 제품 이름 | 장치의 제품 이름 |
| 운영 체제 이름, 운영 체제 버전 | 장치의 운영 체제 정보 |
표시 항목을 켜도 값이 있는지 여부는 장치가 실제로 업로드하는 데이터와 수집 구성에 따라 달라집니다.
장치 상태¶
장치 상태는 Guance이 해당 장치의 데이터를 마지막으로 수신한 시간을 기준으로 판단합니다.
- 활성(Active): 마지막 업데이트가 10분 이내이며 데이터가 정상적으로 업데이트됩니다.
- 지연(Suspect): 마지막 업데이트가 10분을 초과했지만 15분 이내이며, 수집 지연이나 장치 이상이 있을 수 있습니다.
- 오프라인(Offline): 마지막 업데이트가 15분을 초과했으며 Guance 플랫폼이 새로운 장치 데이터를 수신하지 못했습니다.
주의
"오프라인"은 Guance 플랫폼이 해당 시간 동안 장치의 새 데이터를 수신하지 못했음을 의미하며, 장치가 반드시 전원이 꺼진 것은 아닙니다. DataKit 중지, 수집 네트워크 중단, 인증 만료 또는 SNMP 서비스 종료로 인해 장치가 오프라인으로 표시될 수도 있습니다.
검색, 필터링 및 정렬¶
- 검색: 장치 이름 또는 IP를 입력하여 장치를 빠르게 찾습니다.
- 필터링: 장치 이름, IP, 유형, 가동 시간 등의 조건으로 범위를 좁힙니다.
- 활성 장치: 현재 활성 상태인 장치만 한 번에 표시합니다.
- 정렬: 목록 헤더를 클릭하여 해당 필드를 오름차순 또는 내림차순으로 정렬합니다.
장치 토폴로지 보기¶
「인프라 > 네트워크 > 장치」로 이동하여 「토폴로지」 탭으로 전환하면 LLDP 이웃 검색 데이터를 기반으로 생성된 네트워크 장치 물리적 토폴로지를 확인할 수 있습니다. 토폴로지의 노드는 네트워크 장치를 나타내고, 노드 사이의 연결선은 장치 간의 물리적 연결 관계를 나타냅니다.
사전 요구 사항
토폴로지 뷰를 사용하려면 네트워크 장치에서 LLDP를 활성화하고 DataKit의 SNMP 수집기에 대해 LLDP 토폴로지 데이터 수집 활성화를 진행해야 합니다.
노드 상태¶
모니터링 대상 장치는 장치 목록의 상태 계산 규칙을 따릅니다. LLDP로만 발견되고 snmp_object 데이터를 업로드하지 않은 이웃 장치는 미모니터링으로 표시됩니다.
| 상태 | 정의 |
|---|---|
| 활성 | 마지막 업데이트 시간 ≤ 10분 |
| 지연 | 10분 < 마지막 업데이트 시간 ≤ 15분 |
| 오프라인 | 마지막 업데이트 시간 > 15분 |
| 미모니터링 | 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 또는 장치 이름으로 데이터를 필터링할 수도 있습니다.
연결 장치¶
장치 상세 페이지에서 연결 장치 탭으로 전환하면 토폴로지 뷰로 전환하지 않고도 현재 장치의 LLDP 이웃 및 인터페이스 연결 상태를 바로 확인할 수 있습니다.
사용 전에 네트워크 장치에서 LLDP를 활성화하고 DataKit의 SNMP 수집기에 대해 LLDP 토폴로지 데이터 수집 활성화를 진행하세요.
연결 장치 목록에는 다음 정보가 표시됩니다.
| 정보 | 설명 |
|---|---|
| 이웃 장치 이름 | LLDP로 발견된 피어 장치 이름 |
| 관리 IP | 이웃 장치가 업로드한 관리 IP 주소 |
| 현재 장치 인터페이스 | 현재 장치가 이웃에 연결된 로컬 인터페이스 |
| 이웃 장치 인터페이스 | 피어 장치의 연결 인터페이스 |
| 발견 프로토콜 | 해당 이웃을 발견하는 데 사용된 프로토콜 |
연결 장치를 검색하고 연결 상세 정보를 확인할 수 있으며, 수집 대상에 연결된 장치는 클릭하여 장치 상세 페이지로 이동할 수 있습니다. 관리 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시간마다 실행합니다. 이러한 주기는 모두 조정할 수 있으며, 실제 표시되는 시점은 사용자의 수집기 구성에 따릅니다.

