UniFi - 어떤 로그파일이 존재하고, 어떻게 확인할수 있는가

download at 2017-10-27T16:52:43Z origin

Overview


이 문서는 사용자에게 로그파일의 위치와 어떻게 로그 파일의 각각을 통하여 UniFi 요소 (접근 포인트, 스위치, 보안 게이트웨이, 컨트롤러)를 확인할 수 있는지 서술합니다. 로그 파일은 트러블 슈팅을 위해 필수적이므로, 모든 장치에서 어떻게 로그 파일을 확인하는지 아는 것은 매우 중요합니다.

Table of Contents


  1. 로그파일 위치
  2. 로그파일 확인하기: UniFi AP , 스위치
  3. 로그파일 확인하기: UniFi 보안 게이트웨이
  4. 로그파일 확인하기: UniFi 컨트롤러
  5. UI에서 암호화된 로그 파일 다운로드 받기
  6. 관련 문서

로그파일 위치


맨위로 가기

Note

심볼릭 링크된 디렉토리는 아래 에서 실제 폴더의 위치를 기술하고 있습니다. 컨트롤러를 데비안이나 우분투에 직접 설치하는 것도 이와 동일하며, UniFi Video NVR 어플라이언스나 UniFi Cloud key에서도 동일합니다. 사용하는 플랫폼이나 구성하는 방식에 따라서 다른 폴더에 위치할 수는 있으나, 공식 지원하는 버전에서는 **/usr/lib/unifi/logs**에 위치합니다.

UniFi 장비나 컨트롤러에 관련된 로그 파일은 다음 3개의 위치에서 확인할 수 있습니다:

  • UniFi AP: 802.11 정보와 같이 로컬에서 UAP로 향하는 정보를 포함합니다.
/var/log/messages
  • UniFi 스위치: 포트 링크 상태 변화, 트리 스패닝 이벤트 정보 등 로컬에서 스위치로 향하는 정보를 포함합니다.
/var/log/messages
  • UniFi 보안 게이트웨이: DHCP, VPN 등과 같은 USG 로컬 로그를 포함합니다.
/var/log/messages
  • UniFi Controller:
    • 컨트롤러 소프트웨어, UAP와의 통신 내역등의 정보를 포함합니다.
  server.log

- UniFi 소프트웨어 로컬에서 PC 컨트롤러로 향하는 정보를 포함합니다.
mongod.log

로그파일 확인하기: UniFi AP , 스위치


맨위로 가기

UAP와 USW의 로그 파일을 확인하는 방법은:

  1. SSH로 UAP, USW에 연결하여
  2. 직접 타이핑 합니다.
cat /var/log/messages
  1. 그리고 결과를 확인합니다.

실시간 로그를 확인하기 위해서는, SSH세션에서 새롭게 로그에 추가되는 내용을 cat명령어 대신 다음 명령어를 사용하여 확인할 수 있습니다.

tail -f /var/log/messages

로그파일 확인하기: UniFi 보안 게이트웨이


맨위로 가기

USG의 로그 파일을 확인하기 위해서는:

  1. SSH로 USG에 접속하여
  2. EdgeOS CLI에서 다음을 수행합니다:
show log
  1. 리눅스 쉘의 cat , tail 명령어와 동일하게 출력합니다. 리눅스 CLI에 접근하기 위해서 EdgeOS CLI에서 다음 명령어를 수행합니다.
sudo su
  1. 그리고 UAP에서 사용한 방식과 동일하게 cat , tail 명령어를 수행할 수 있습니다.

로그파일 확인하기: UniFi 컨트롤러


맨위로 가기

UniFi 컨트롤러의 로그은 플랫폼마다 다르게 저장됩니다:

  • Windows: C:\Users\<username>\Ubiquiti UniFi\logs\
  • Mac OS X: /Users/<username>/Library/Application\ Support/UniFi/logs/
  • UniFi Cloud Key , Debian/Ubuntu Linux*: /usr/lib/unifi/logs/

UI에서 암호화된 로그 파일 다운로드 받기


맨위로 가기

UniFi 컨트롤러는 사용자에게 Ubiquiti support와 로그 파일을 공유할 수 있도록 할 수 있습니다. 하지만 해당 파일은 보안적 이유로 암호화가 되어 있습니다. 사용자로서는 해당 로그파일을 참조 할 수 없게 됩니다. 모든 로그파일의 내용을 확인하기 위해서는 해당 파일이 장치의 로그를 포함하지 않아야 합니다.

  1. UniFi 컨트롤러에서 Settings > Maintenance 섹션 아래의 Support Info 섹션에서 Download Support Info 버튼을 선택합니다.

관련 문서


맨위로 가기