URL 모니터링 서비스 가이드

제목 : URL 모니터링 서비스 가이드
작성자 : Whatap Support
이메일 : support@whatap.io
날짜 : 2019-10-22
버전 : 1.0.0

설명 : 본 문서는 WhaTap URL 모니터링 서비스 사용법에 대해 설명합니다.

1. 시작하기

와탭은 모니터링 서비스입니다. SaaS형 모니터링 솔루션이라고도 합니다. Public 클라우드에서 와탭 모니터링이 서비스되고 있습니다.
사용자는 www.whatap.io에 가입하고 프로젝트를 만든후 에이전트를 모니터링 대상 시스템에 설치하면 모니터링 서비스를 사용할 수 있습니다.

1.1. 와탭 URL 모니터링 소개

와탭 URL 모니터링은 최종 사용자 입장에서의 웹 사이트 접속 정상 여부를 판단하기 위한 용도의 서비스를 제공합니다.
사용자 입장에서 웹 사이트의 정상 접근 여부를 브라우저 등을 통해 점검해 보는 과정을 대신하여, 와탭의 모니터링 에이전트가 해당 사이트에 대한 접속을 수행하고 접속의 정상 여부를 제공합니다.
사이트에 대한 접속 수행은 와탭의 체크 에이전트가 설치된 서버에서 접속을 시도하게 됩니다. 접속 테스트에 대한 결과는 http 호출에 대한 응답 코드와 응답 시간을 제공합니다.

접속 테스트 수행을 위한 에이전트의 위치는 AWS Seoul 리전과 AWS Tokyo 리전의 2개 위치를 제공합니다.
향후 접속 테스트를 위한 추가 리전을 제공할 수 있으며, 추가 리전에 대해서는 와탭에 문의주시기 바랍니다.
폐쇄망 사이트의 접속 테스트를 수행하고자 하는 경우, 에이전트로부터의 호출이 허용되도록 방화벽을 오픈해야 할 수 있습니다.
각 에이전트의 방화벽 오픈 대상 IP Address 는 다음과 같습니다.
AWS-Seoul-Agent - 54.180.11.176
AWS-Tokyo-Agent - 18.179.189.142

1.1.1. 와탭 URL 모니터링 시작하기

프로젝트 생성

먼저 URL 모니터링 프로젝트를 생성합니다.
화면 상단의 프로젝트 생성 버튼을 클릭한 후, 팝업 화면에서 URL 아이콘을 선택한 후, 프로젝트 명을 입력하고 데이터 서버 지역으로 WEB-Checker-Region을 선택합니다.

create project
Figure 1. create 와탭 URL 모니터링 project

프로젝트 생성이 완료되면 하기와 같이 프로젝트 목록에 신규 프로젝트가 표시됩니다.

created 와탭 URL 모니터링 project
Figure 2. created 와탭 URL 모니터링 project
URL 추가하기

생성된 프로젝트를 클릭하여 프로젝트에 진입하면 URL이 설정되지 않은 화면이 표시됩니다.
화면 우측 상단의 URL 추가하기 버튼을 클릭하면 설정이 한 줄 추가되므로 추가된 입력 필드에 URL 설정을 진행합니다.

add URL
Figure 3. add URL

URL 입력 필드의 각 항목은 다음과 같습니다.

  • 이름 - URL 설정의 고유 식별 정보로 사용됩니다. 중복 불가하며, 재설정 시에 동일한 이름으로 등록할 경우 동일한 이름의 통계 데이터를 같은 URL의 데이터로 간주합니다.

  • URL - 체크 대상 URL을 등록합니다. 호출 대상 URL의 전체 경로를 입력합니다. http/https 프로토콜을 지원합니다.

  • 확인 지역 - 와탭이 제공하는 에이전트를 선택합니다. Seoul, Tokyo 리전을 제공합니다. (위치 IP 주소가 도움말로 표시됩니다. 폐쇄망에서 서비스 중인 URL을 등록하여 모니터링하고자 하는 경우 해당 IP에 대한 방화벽 설정이 열려있어야 합니다.)

edit URL
Figure 4. edit URL

편집이 완료되면 저장하기 버튼을 통해 설정 정보를 저장한 후, 모니터링 버튼을 클릭하여 모니터링 화면으로 전환합니다.

monitor URL
Figure 5. monitor URL
모니터링 하기

모니터링 화면으로 전환 후 모니터링을 수행합니다.
화면 상단에는 등록된 URL 목록의 최종 응답 스테이터스 별 건수 정보를 표시하며, 시간 구간을 선택하여 조회할 수 있는 기능을 제공합니다.
URL의 등록 및 편집이 필요한 경우 URL 편집 버튼을 통해 편집 화면으로 전환할 수 있습니다.
화면 중앙부에는 등록된 URL 단위의 체크 결과를 표시하며, 각 표시 항목은 다음과 같습니다.

  • 상태 - 최종 체크 응답 코드 (Http Status Code)

  • 이름 - URL 등록 시에 지정한 고유 식별 정보

  • 경과시간 - 20분 간의 체크 결과 (응답 코드 및 응답 시간) 및 최종 응답 시간

  • 가용성 % - 조회된 구간의 정보를 기준으로 전체 체크 결과 건수 대비 정상 응답(응답코드 200~399) 건수의 비중을 %로 표시합니다.

monitor
Figure 6. monitor

차트 상에서 드래그 하여 시간 범위 조회 시, 하단에 해당 시간대의 응답 코드 및 응답 시간을 테이블로 표시합니다.

select range
Figure 7. select range

1.1.2. 와탭 URL Monitoring 서비스 사용 관련

URL 모니터링은 별도의 정책 변경이 있기까지 무상 서비스로 제공합니다.
무상 서비스 제공 기간 중, 사용자가 프로젝트에 등록하여 사용할 수 있는 URL 개수는 10개까지로 제한됩니다.
사용자는 별도의 에이전트를 설치할 필요가 없으며, 와탭이 제공하는 에이전트 및 서버 저장소를 활용합니다.
AWS Seoul 리전, AWS Tokyo 리전 외의 환경에서 URL 체크를 수행하고자 하는 경우 와탭에 문의 주시기 바랍니다.

2. 이벤트

이벤트 설정을 통해 문자메시지 또는 이메일 형태의 경고 알림을 제공받을 수 있습니다.

2.1. 이벤트 설정하기

등록된 URL을 대상으로 개별 이벤트 설정이 가능합니다. 이벤트 목록 화면에서 편집하고자 하는 URL(또는 수정 버튼)을 클릭하면 해당 URL에 대한 이벤트 설정 창이 확장됩니다.

event list
Figure 8. 메뉴 : 이벤트 > 이벤트 목록 화면
event setting
Figure 9. 이벤트 설정 창

2.1.1. 이벤트 규칙

이벤트 규칙은 모니터링 지표와 조건식을 조합하여 설정합니다.

  • 상태 이벤트
    선택한 상태코드 옵션에 따라 이벤트가 발생합니다.

event setting - status
Figure 10. 예시) 상태코드가 4XX 또는 5XX 발생시 이벤트 발행
  • 경과 시간 이벤트
    실시간 수집 중인 경과시간 값이 사용자가 입력한 임계치와 조건문에 해당하는 경우 이벤트가 발생합니다.

event setting - status
Figure 11. 예시) 경과시간이 5초 이하 발생하는 경우 이벤트 발행
  • 상태 & 경과시간 (복합) 이벤트
    상태코드 선택 옵션과 경과 시간 조건 모두에 해당하는 경우 이벤트가 발생합니다.

event setting - status
Figure 12. 예시) 상태코드가 2XX(정상)이고 경과시간이 10초를 초과인 경우 이벤트 발행
알림 메시지란 해당 규칙에서 이벤트가 발생하는 경우 표시할 제목을 말합니다. 개별 이벤트 규칙에 알림 메시지를 설정할 수 있습니다. 설정을 적용하지 않는 경우 기본 표시되는 알림메시지는 "[상태코드, 경과시간, URL: 상세이유]" 입니다.

2.2. 이벤트 기록

이벤트 기록을 프로젝트에서 조회하고자 하는 경우 이벤트 기록 메뉴을 이용할 수 있습니다.

event list
Figure 13. 메뉴: 이벤트 > 이벤트 기록

모니터링 중인 프로젝트 화면에서는 실시간으로 발생하는 이벤트에 대해서도 알림을 제공합니다.

notification
Figure 14. 프로젝트 화면 실시간 알림

3. 에러 유형

URL 모니터링 적용 시 발생할 수 있는 에러 유형과 그 유형에 따른 설정 방법을 제시합니다.

URL 모니터링 화면에 나타나는 차트 영역을 드래그 하시면 해당 시간대에 URL 호출 시 취득한 결과 데이터가 화면 하단에 표시됩니다.+ 데이터의 상세 원인에 표시된 메세지에 따른 조치 방법을 소개하도록 하겠습니다.

error detail
Figure 15. 상세 원인

3.1. connect timed out

URL 호출을 위한 접속 자체가 차단된 경우를 의미합니다.
1 URL을 웹 브라우저에 입력하여 접속에 문제가 없는지 먼저 점검합니다. 간혹 입력 과정에서 오류가 발생하기도 합니다.
2 방화벽 및 빈번한 호출에 대한 IP 차단 내역을 확인하여 모니터링 에이전트의 IP에 대하여 명시적으로 접근을 허용합니다. 서울 에이전트의 외부 아이피는 54.180.11.176 입니다.

3.2. no route to host

목적지에 도달하기 위한 경로가 존재하지 않음을 의미합니다.
1 port 지정이 잘못되지 않았는지 확인합니다.
2 입력 URL의 프로토콜을 잘못 입력하지 않았는지 확인합니다.
https:// 와 http:// 를 잘못 입력한 경우 등

3.3. https

URL 입력에 protocol이 중복되어 입력된 경우 등에 발생합니다.
1 URL이 https://https://…​; 과 같은 형식으로 입력되지 않았는지 확인합니다.

3.4. handshake alert: unrecognized_name

에이전트가 호출한 서버명이 서버측에서 식별되지 않을 경우 발생합니다.
1 http protocol을 사용하는 URL이 https://…​; 으로 지정되지 않았는지 확인합니다.

3.5. sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

에이전트가 호출 대상 사이트의 SSL 인증서에 접근하지 못할 경우 발생합니다.
1 에이전트의 문제로 와탭에 문의해 주시기 바랍니다. 현재까지는 SSL 인증서의 알고리즘에 대응이 안 된 몇 가지 사례가 식별되었습니다.
2 자체적으로 Java HttpClient 기반으로 HTTPS 프로토콜 기반의 호출이 가능한 샘플 모듈을 공유 가능하시면, 유사한 에이전트를 추가 개발하여 탑재하여 드리도록 하겠습니다.