teraWeb/demo-guide/04-alerts-logs.md

# 4. 알림 설정·실제 수신·시스템 로그·삭제

[목차](README.md)

**알림은 두 곳을 설정합니다:** 메일/Trap/Syslog의 **수신 목적지 설정**과, 시스템/시리얼 이벤트의 **발생 조건 및 전달 스위치**입니다. 목적지 테스트가 성공해도 이벤트 전달이 꺼져 있으면 실제 이벤트 알림은 오지 않습니다.

## A01. 메일

| UI: 기타 설정 → 알림 설정 → 메일 | 입력 |
|---|---|
| 메일 알림 사용 | 켬 |
| SMTP 서버 / SMTP 포트 | 실제 서버와 포트. STARTTLS 서버가 587을 사용하는 경우 587 |
| STARTTLS 사용 | 서버 요구에 맞춤. STARTTLS와 암시적 TLS 포트를 혼동하지 않음 |
| SMTP 인증 사용 | 서버가 요구하면 켬 |
| SMTP 사용자 / 비밀번호 | 서버에서 허용한 발송 계정과 자격 증명 |
| 발신자 | 해당 계정이 발송 권한을 가진 주소 |
| 수신자 / 참조(CC) | 실제 확인 가능한 시험 수신함 |
| 제목 / 본문 | `TERA DEMO MAIL` / 시험 시각을 포함한 문구 |

1. **적용** 후 **테스트 발송**을 누릅니다.
2. 수신함을 열어 새 메일의 발신자·수신자·제목·본문·시각을 확인합니다. 스팸함도 확인합니다.
3. 테스트 발송 결과와 실제 수신 메일을 함께 캡처합니다.

**통과:** 실제 시험 수신함에 도착. **실패:** 발송 오류는 DNS·SMTP 포트·TLS 방식·계정·발신자 권한, 성공 안내 후 미수신은 서버 전달 로그·스팸·수신 주소 확인. **원복:** 원래 SMTP·수신자·사용 여부 복구. 실제 이벤트 발송은 A04를 수행합니다.

## A02. SNMP Trap

**준비:** PC/서버에 Trap 수신기를 실행하고 UDP 162 수신을 허용합니다. 이미 다른 프로그램이 162를 사용하면 그 프로그램을 수신기로 쓰거나 테스트 포트를 별도로 맞춥니다.

1. 수신기에서 v2c Community를 시험용 값으로 등록합니다. Net-SNMP 수신기 예시: `trap-demo.conf`에 `authCommunity log DEMO_TRAP` 한 줄을 저장하고 아래처럼 실행합니다. 도구 설치와 포트 수신 권한은 별도 준비입니다.

```text
snmptrapd -f -Lo -C -c trap-demo.conf udp:162
```

2. **기타 설정 → 알림 설정 → SNMP Trap**에 다음을 입력합니다.

| UI 항목 | 값 |
|---|---|
| Trap 전송 사용 | 켬 |
| 대상 ID | 고정값 유지 |
| 대상 주소 | 수신 PC의 실제 유선 IP, 예: `192.168.0.100` |
| 대상 포트 / 버전 | `162` / `v2c` |
| Community / 인증 키 | 수신기와 동일한 시험값. 위 예시는 `DEMO_TRAP` |

3. **적용 → 테스트 전송**. 수신기에서 장비 출발 IP, 도착 시각, OID/변수 값을 확인합니다.
4. 이어서 A04의 키워드 이벤트에서 **SNMP Trap으로 전달**을 켜고 실제 문자열을 보내 별도의 이벤트가 들어오는지 확인합니다.

**통과:** 테스트 패킷과 실제 이벤트를 수신기에서 각각 확인. UDP 전송 성공 안내만으로 수신 성공을 판정하지 않습니다. **실패:** 대상이 장비 IP가 아닌 수신 PC IP인지, UDP 162 방화벽·Community·수신기 바인딩 확인.

**v1/v3 추가 시험:** 수신기가 해당 버전을 처리하도록 먼저 설정하고 UI 버전을 일치시킵니다. v3는 사용자·인증·암호화·키·Engine ID를 수신기 등록값과 맞춘 뒤 테스트 전송과 실제 이벤트를 반복합니다. v2c 수신 성공을 v3 성공으로 기록하지 않습니다. **원복:** 원래 대상·자격 증명·전송 여부, 시험 수신기 종료.

## A03. Syslog 수신과 기록 범위

1. PC/서버의 Syslog 수신기를 UDP 514로 실행합니다. Windows에서 간단한 **UDP 내용 확인**만 할 경우, 사용하지 않는 포트임을 확인하고 아래 PowerShell을 별도 창에서 실행할 수 있습니다. 이 창은 Ctrl+C로 종료합니다. Windows 방화벽에서 시험망의 UDP 514 수신도 허용돼야 합니다.

```powershell
$demoSyslog = [System.Net.Sockets.UdpClient]::new(514)
$demoSender = [System.Net.IPEndPoint]::new([System.Net.IPAddress]::Any, 0)
try {
    while ($true) {
        $demoBytes = $demoSyslog.Receive([ref]$demoSender)
        Write-Host ((Get-Date -Format o) + ' ' + $demoSender.ToString() + ' ' + [Text.Encoding]::UTF8.GetString($demoBytes))
    }
} finally {
    $demoSyslog.Close()
}
```

2. **기타 설정 → 시스템 로그 → 로그 서버**에서 **원격 로그 전송 사용 켬**, 로그 서버 `192.168.0.100:514`(실제 수신 PC), 전송 프로토콜 **UDP** → **적용**.
3. **로그 이벤트** 탭에서 **설정 변경 이벤트 - 로컬 저장**, **설정 변경 이벤트 - 원격 전송**을 켜고 적용합니다. 시스템 이벤트·운영 모드 이벤트도 시험하려면 각각 로컬/원격 스위치를 켭니다.
4. **네트워크 설정 → 호스트 설정**에서 기존 이름을 기록하고 `tera-demo-log`로 변경·적용합니다.
5. **로그 → 시스템 로그**에서 시험 시각의 설정 변경 기록을 찾습니다. 동시에 수신 PC에 도착한 장비 출발 IP·설정 변경 메시지를 확인합니다.
6. 원격 전달만 끄고 이름을 다른 시험값으로 바꿉니다. 로컬에는 새 이벤트가 있지만 원격에는 같은 새 이벤트가 오지 않는지 비교합니다. 원격을 다시 켜고 다음 변경이 수신되는지 확인합니다.

**통과:** 같은 시험 이벤트의 로컬 저장/원격 수신이 스위치와 일치. **실패:** 서버 주소·UDP/TCP 일치·수신기·이벤트 종류 스위치 확인. **TCP 시험:** TCP 지원 수신기를 별도로 준비하고 수신기와 UI를 모두 TCP로 변경해 4~5번을 반복합니다. 위 PowerShell UDP 수신기로 TCP를 시험할 수 없습니다. **원복:** 호스트 이름·서버·전달 범위·방화벽 시험 규칙 복구.

## A04. 시리얼 감지 키워드와 포트 고급 설정 연동

**준비:** [CH01 양방향 통신](02-ports.md)과 A01/A02/A03 중 사용할 수신 경로 하나를 먼저 통과합니다. 아래는 메일을 예로 합니다.

| UI: 기타 설정 → 알림 설정 → 시리얼 이벤트 | 값 |
|---|---|
| 대상 포트 | CH01 |
| 수신 키워드 감지 | 켬 |
| 감지 키워드 | `DEMO_ALARM_01` |
| 메일로 전달 | 켬 |
| SNMP Trap / Syslog로 전달 | 각각 수신 시험을 할 때 켬 |
| DCD / DSR 상태 변경 | 우선 끔 — 키워드 시험과 분리 |

1. **적용** 후 다른 포트를 선택했다 CH01로 돌아와 키워드를 확인합니다.
2. **포트 설정 → CH01 → 고급 설정 → Alarm 키워드**에서 같은 값이 보이는지 확인합니다.
3. **상대 시리얼 장비/PC에서 TERA가 수신하는 방향으로** `DEMO_ALARM_01`을 한 번 보냅니다. 웹에서 상대에게 송신하는 것만으로 수신 키워드 시험을 대신하지 않습니다.
4. CH01 포트 로그에서 수신 데이터, 선택한 수신함/Trap/Syslog에서 해당 채널의 키워드 이벤트를 확인합니다. 시각으로 같은 시험임을 대조합니다.
5. 고급 설정에서 키워드를 `DEMO_ALARM_02`로 바꿔 적용합니다. 시리얼 이벤트 화면을 다시 열어 동일하게 바뀌었는지 확인합니다.
6. 상대에서 일반 문자열 `NORMAL_ONLY`와 이전 키워드 `DEMO_ALARM_01`을 각각 보내고 새 키워드 이벤트가 발생하지 않는지 관찰합니다. 이어 `DEMO_ALARM_02`를 보내 발생을 확인합니다. 각 문자열은 구분해 보내고 중복 억제/발송 지연이 있다면 처리 후 다음 시험을 합니다.
7. 수신 키워드 감지를 끄고 적용한 뒤 새 키워드를 다시 보내 알림이 발생하지 않는지 확인합니다. 포트 데이터 자체는 계속 수신돼야 합니다.

**통과:** 두 UI의 값이 양방향으로 연동되고 현재 키워드 수신 때만 선택한 목적지로 이벤트가 도착. 단순 저장 성공만으로 통과하지 않습니다. **실패:** 대상 포트·수신 방향·문자열·이벤트 감지 스위치·전달 스위치·목적지 설정 순서 확인. **원복:** 원래 키워드와 감지/전달 상태 복구.

## A05. DCD/DSR 및 시스템 이벤트

| UI와 이벤트 | 설정·발생 방법 | 확인 위치·통과 기준 |
|---|---|---|
| 시리얼 이벤트: DCD 상태 변경 | 대상 CH01, DCD 켬, 목적지 전달 켬 → 적용. 핸드셰이크 신호 제어가 가능한 시험 장치로 실제 DCD 신호 변화 | 수신 목적지에서 CH01의 DCD 변화 확인 |
| 시리얼 이벤트: DSR 상태 변경 | 위와 같이 DSR만 켜고 실제 신호 변화 | CH01의 DSR 변화 확인. 문자열 송신만으로 DSR 시험을 대신하지 않음 |
| 시스템 이벤트: 시리얼 링크 DOWN | 시스템 이벤트 탭의 해당 항목과 전달 켬 → 적용. 시험 포트를 정상 응답 상태로 만든 뒤 상대 분리 | 포트 상태 DOWN 전환·상태 이벤트·알림 시각 일치 |
| 이더넷 링크 DOWN | 해당 항목과 전달 켬. 관리 연결을 유지할 수 있는 보조 시험 링크만 분리 | 해당 인터페이스 DOWN 알림과 실제 연결 변화 일치 |
| OOB 경로 전환 | 해당 항목과 전달 켬. 준비된 OOB 시험망에서 주 경로 장애 발생 | 예비 경로 실제 통신 + 전환 알림 |
| Warm start | 해당 항목과 전달 켬. 백업 후 상단 저장 후 재시작 | 복구 후 Warm start 로그·수신 알림 확인 |
| Cold start | 해당 항목과 전달 켬. 시험 장비 정상 종료/전원 재인가 절차에 따라 수행 | 복구 후 Cold start 로그·알림 확인 |
| 로그인 실패 임계값 | 해당 항목과 전달 켬. 별도 시험 계정으로 설정된 임계값만큼 올바른 CAPTCHA/잘못된 암호 시험 | 서버/장비 실패 기록과 임계 이벤트·수신 알림 일치 |
| 저장 공간 경고 | 해당 항목과 전달 켬. 승인된 시험용 저장소/시뮬레이션에서 경고 조건 발생 | 실제 경고 조건·로그·알림 일치 |

시스템 이벤트의 UI에는 로그인 실패 횟수나 저장 공간 임계값을 직접 입력하는 칸이 없습니다. 시험 전 적용된 임계값을 담당자가 확인하지 못했다면 해당 항목은 ‘조건 미확인/미실시’로 둡니다. 경고 시연을 위해 운영 저장소를 임의로 가득 채우지 않습니다. DCD/DSR 배선·신호 발생 장치가 없을 때도 미실시입니다.

**원복:** 신호·배선·전원·계정 잠금 여부를 정상화하고 원래 이벤트/전달 설정 복구. 이벤트 발생 순간 전송 경로가 끊겼다면 미수신을 즉시 이벤트 감지 실패로 결론내리지 말고 장비 로컬 기록과 수신 경로를 함께 확인합니다.

## L01. 로그 조회와 다운로드

1. **기타 설정 → 시스템 로그 → 로그 이벤트**에서 시험할 종류의 **로컬 저장**을 켭니다.
2. 설정 변경, 포트 세션 연결/해제, P01 송수신, P05 상태 전환을 한 번씩 발생시키고 시각·채널을 기록합니다.
3. **로그 → 시스템 로그 / 포트 로그 / 포트 상태 이벤트**를 각각 엽니다. 시스템은 등급·검색어·시작/종료 시간, 포트는 채널과 검색 조건을 지정하고 **조회**합니다.
4. 보이지 않으면 **검색 초기화**, 시간 범위와 장비 시간 확인 후 다시 조회합니다. 자동 갱신을 켰다면 새 시험 이벤트가 들어오는지 확인합니다.
5. 다운로드 형식과 최대 다운로드 건수를 선택하고 **로그 다운로드**합니다. 내려받은 파일을 열어 UI에서 확인한 시험 시각·문자열·채널이 들어 있는지 확인합니다.

**통과:** 발생시킨 이벤트를 올바른 로그에서 찾고 파일에서도 확인. 다운로드에는 검색 조건·최대 건수 제한이 적용됩니다. 화면 내보내기를 무제한 전체 백업으로 가정하지 않습니다. **원복:** 원래 저장 범위·검색 설정 복구.

## L02. 단일 포트·전체 포트·상태 이벤트·시스템 로그 삭제

**준비:** 필요한 기록을 먼저 다운로드합니다. 설정 백업에는 로그 원문이 없습니다. 삭제 전 CH01/CH02에 서로 다른 시험 문자열을 남기고, 시스템·상태 이벤트도 하나씩 확보합니다. 삭제 범위는 검색된 몇 줄이 아니라 해당 저장 범위 전체입니다.

| 시험 | UI 조작 / 확인 입력 | 삭제 후 확인 | 보존 확인 |
|---|---|---|---|
| CH01만 삭제 | 로그 → 포트 로그 → CH01 선택 → 로그 클리어 (삭제) → `CH01` | 검색 초기화 후 CH01의 삭제 전 문자열 없음 | CH02와 시스템·상태 이벤트 존재 |
| 전체 포트 삭제 | 포트 로그 → 전체 포트 선택 → 로그 클리어 (삭제) → `ALL` | CH01·CH02 각각 조회해 삭제 전 문자열 없음 | 시스템·상태 이벤트 존재 |
| 포트 상태 이벤트 전체 삭제 | 로그 → 포트 상태 이벤트 → 로그 클리어 (삭제) → `LINKS` | 삭제 전 상태 전환 기록 없음 | 현재 링크 상태 및 시스템·포트 통신 로그 유지 |
| 시스템 로그 전체 삭제 | 로그 → 시스템 로그 → 로그 클리어 (삭제) → `SYSTEM` | 삭제 전 시스템 이벤트와 감사 기록 없음 | 포트 통신·상태 이벤트 유지 |

1. 먼저 잘못된 확인 문자열을 입력하거나 취소해 삭제되지 않는지 확인합니다.
2. 표의 시험을 한 개씩 수행합니다. 앞 시험에서 기록을 지웠다면 다음 시험의 보존 대조용 데이터를 새로 만듭니다.
3. 각 삭제 후 페이지를 새로 열고 검색 조건을 해제해 과거 문자열/시각이 사라졌는지 확인합니다.
4. 새 데이터를 발생시켜 다시 기록되는지 확인합니다. 새 수집과 삭제 작업 관련 기록 때문에 ‘영원히 0건’이 합격 기준은 아닙니다.
5. 마지막 유지 시험에서 **저장 후 재시작** 후에도 삭제 전 시험 기록이 되살아나지 않는지 확인합니다.

**통과:** 지정 범위의 과거 기록 삭제 + 다른 범위 보존 + 신규 수집 지속. **원복:** 삭제한 원문은 UI 복원할 수 없습니다. 필요한 증빙은 삭제 전에 다운로드해 보관합니다.