Secure Web Appliance에서 요청 디버그 로그 구성
소개
이 문서에서는 SWA(Secure Web Appliance)에서 디버그 로그를 요청하는 단계에 대해 설명합니다.
사전 요구 사항
요구 사항
Cisco에서는 다음 항목에 대한 지식을 권장합니다.
- SWA의 CLI(Command Line Interface)에 대한 관리 액세스.
사용되는 구성 요소
이 문서는 특정 소프트웨어 및 하드웨어 버전으로 한정되지 않습니다.
이 문서의 정보는 특정 랩 환경의 디바이스를 토대로 작성되었습니다. 이 문서에 사용된 모든 디바이스는 초기화된(기본) 컨피그레이션으로 시작되었습니다. 현재 네트워크가 작동 중인 경우 모든 명령의 잠재적인 영향을 미리 숙지하시기 바랍니다.
디버그 로그 요청
SWA의 요청 디버그 로그는 단일 특정 HTTP 또는 HTTPS 트랜잭션 또는 클라이언트 머신에 대한 매우 자세한 엔드 투 엔드 디버그 및 추적 레벨 정보를 캡처하도록 설계된 특수 로그 유형입니다. 여러 요청 전반에 걸쳐 요약된 이벤트를 기록하는 표준 프록시 로그와 달리, 요청 디버그 로그는 특정 요청(예: 인증, URL 필터링, 암호 해독, 악성코드 검사 및 평판 서비스) 처리와 관련된 모든 웹 프록시 모듈의 디버그 출력을 하나의 상관관계가 있는 로그 스트림으로 집계합니다. 이 로그 유형은 심층 진단을 위한 것이며 GUI가 아닌 CLI를 통해서만 생성할 수 있습니다
요청 디버그 로그는 표준 로그에 충분한 세부사항이 없는 복잡한 또는 간헐적인 프록시 문제를 해결할 때 필수적입니다. 관리자와 Cisco TAC는 모든 처리 단계에서 단일 요청이 처리된 방식을 정확하게 추적할 수 있으므로 예기치 않은 정책 일치, 검사 지연, 인증 실패 또는 엔진 간 판정 불일치와 같은 근본 원인을 정확하게 찾아낼 수 있습니다. 로그는 하나의 트랜잭션에 초점을 맞추므로 시스템 전체에 걸쳐 모든 프록시 모듈에서 디버그 로깅을 활성화하여 운영 오버헤드와 성능에 영향을 미치지 않고 최대 가시성을 제공합니다. 그러면 고급 조사 중에 디버그 로그 요청이 정확하고 효율적이며 위험이 낮은 진단 툴이 됩니다.
요청 디버그 로그 구성
1단계. CLI에 로그인하고 logconfig를 실행한 후 new(새로 만들기)를 선택합니다.
2단계. 요청 디버그 로그와 관련된 번호를 선택하고 Enter 키를 누릅니다.
3단계. 로그 이름을 입력합니다.
4단계. 로깅 레벨로 Trace(추적)를 선택합니다.
5단계. 향상된 로깅을 수집하도록 요청한 모듈을 선택합니다. 쉼표로 구분된 목록 또는 범위 목록(예: 1,3,4 또는 3-7)으로 여러 개의 항목을 선택할 수 있습니다.
6단계. 고급 로깅을 활성화할 요청 수를 지정합니다. 이 수의 요청이 캡처되면 로깅이 자동으로 중지됩니다.
7단계. 클라이언트 IP 주소, 대상 IP 주소 또는 대상 도메인을 선택하여 향상된 로깅을 위한 요청 일치 기준을 정의합니다.
8단계. 로그를 검색할 방법을 선택합니다. FTP Poll을 선택하면 로그가 SWA에 저장됩니다.
9단계. 로그 파일에 사용할 파일 이름을 정의하거나 Enter 키를 눌러 현재 생성된 파일 이름을 적용합니다.
10단계. 정의된 요청 수가 충족된 후 로깅이 중지되므로 시간 기반 로그 파일 롤오버에 대해 No를 선택합니다.
11단계. 최대 파일 크기(바이트)를 정의하거나 Enter 키를 눌러 현재 값을 적용합니다.
12단계. 5단계에서 로깅하기 위해 선택한 프록시 모듈의 수 및 7단계에서 정의한 요청 일치 기준에 따라 최대 로그 파일 수를 구성합니다. 적절한 파일 제한을 선택하는 것은 모든 관련 디버그 정보가 로깅을 섣불리 중지하지 않고 캡처되어 로그가 불완전하거나 누락될 수 있음을 보장하기 위해 중요합니다.
13단계. 허용되는 최대 파일 수로 인해 파일이 제거될 때 경고를 보내야 합니까?라는 메시지가 표시되면 No(아니요)를 선택합니다. 이렇게 하면 정상적인 로그 회전 중에 불필요한 경고가 표시되지 않습니다. 특히 문제 해결을 위해 디버그 로그 요청을 의도적으로 생성할 때 이러한 경고가 표시되지 않습니다.
14단계. Do you want to compress logs (yes/no)?(로그를 압축하시겠습니까(예/아니요)?) 메시지가 표시되면 No(아니요)를 선택합니다. 이렇게 하면 로그 파일의 압축이 해제되어 문제 해결 중에 더 쉽게 검토하고 분석할 수 있습니다.
15단계. Enter를 눌러 마법사를 종료합니다
16단계. commit을 입력하고 Enter를 눌러 변경 사항을 저장합니다
SWA_CLI> logconfig
Currently configured logs:
1. "accesslogs" Type: "Access Logs" Retrieval: FTP Poll
2. "adc_logs" Type: "ADC Engine Logs" Retrieval: FTP Poll
...
[Output removed to simplify readability]
...
55. "welcomeack_logs" Type: "Welcome Page Acknowledgement Logs" Retrieval: FTP Poll
Choose the operation you want to perform:
- NEW - Create a new log.
- EDIT - Modify a log subscription.
- DELETE - Remove a log subscription.
- HOSTKEYCONFIG - Configure SSH host keys.
- AUDITLOGCONFIG - Adjust settings for audit logging.
[]> new
Choose the log file type for this subscription:
1. ADC Engine Framework Logs
2. ADC Engine Logs
...
[Output removed to simplify readability]
...
53. Request Debug Logs
...
[Output removed to simplify readability]
...
[1]> 53
Please enter the name for the log:
[]> Request_Debug_Logs
Log level:
1. Critical
2. Warning
3. Information
4. Debug
5. Trace
[3]> 5
Choose modules where enhanced request logging is to be performed.
Multiple selections can be made in the form of a comma separated or range list (e.g. 1,3,4 or 3-7)
Choosing the Default Proxy will enable enhanced logging across modules:
1. Default Proxy
2. Access Control Engine
3. Proxy Configuration
4. Disk Manager
5. Memory Manager
6. McAfee Integration Framework
7. Sophos Integration Framework
8. Webroot Integration Framework
9. Webcat Integration Framework
10. Connection Management
11. Authentication Framework
12. HTTPS
13. FTP proxy
14. WCCP Module
15. License Module
16. SNMP Module
17. WBRS Integration Framework
18. Logging Framework
19. Data Security Module
20. Miscellaneous Proxy Modules
21. DCA Engine Framework
22. AVC Engine Framework
23. Cloud Connector
24. SOCKS Proxy
25. Advanced Malware Protection
26. ArchiveScan module in proxy
27. Web Traffic Tap module in proxy
28. Bandwidth Control
29. Http2 proxy
30. ADC Engine Framework
[1]> 1-30
Please enter the number of requests for which to perform enhanced logging:
[1]> 100
Choose the request criteria for logging:
1. Client IP Address
2. Destination Domain
3. Destination IP Address
[1]> 1
Specify source IP address
[]> 10.20.3.15
Choose the method to retrieve the logs:
1. FTP Poll
2. FTP Push
3. SCP Push
[1]> 1
Filename to use for log files:
[Request_Debug_Logs.text]>
Do you want to configure time-based log files rollover? [N]>
Please enter the maximum file size:
[10485760]>
Please enter the maximum number of files:
[10]> 50
Should an alert be sent when files are removed due to the maximum number of files allowed? [N]>
Do you want to compress logs (yes/no)
[n]>
Currently configured logs:
1. "Request_Debug_Logs" Type: "Request Debug Logs" Retrieval: FTP Poll
2. "accesslogs" Type: "Access Logs" Retrieval: FTP Poll
3. "adc_logs" Type: "ADC Engine Logs" Retrieval: FTP Poll
...
[Output removed to simplify readability]
...
56. "welcomeack_logs" Type: "Welcome Page Acknowledgement Logs" Retrieval: FTP Poll
SWA_LIC> commit
Warning: In order to process these changes, the proxy
process will restart after Commit. This will cause a brief
interruption in service. Additionally, the authentication
cache will be cleared, which might require some users to
authenticate again.
관련 정보
개정 이력
| 개정 | 게시 날짜 | 의견 |
|---|---|---|
1.0 |
24-Apr-2026
|
최초 릴리스 |
피드백