Logs voor foutopsporing aanvragen configureren in beveiligd webtoestel

Inleiding

In dit document worden de stappen beschreven voor het aanvragen van foutopsporingslogboeken in Secure Web Appliance (SWA).

Voorwaarden

Vereisten

Cisco adviseert kennis van deze onderwerpen:

• Administratieve toegang tot Command Line Interface (CLI) van SWA.

Gebruikte componenten

Dit document is niet beperkt tot specifieke software- en hardware-versies.

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.

Foutopsporingslogboeken aanvragen

Request Debug Logs in SWA zijn een gespecialiseerd logtype dat is ontworpen om extreem gedetailleerde, end-to-end debug en up-to-trace informatie vast te leggen voor een enkele, specifieke HTTP- of HTTPS-transactie of een clientmachine. In tegenstelling tot standaard proxylogs die samengevatte gebeurtenissen in veel verzoeken opnemen, bundelen Request Debug Logs debug-uitvoer van alle Web Proxy-modules die betrokken zijn bij het verwerken van een bepaald verzoek (zoals authenticatie, URL-filtering, decodering, malwarescanning en reputatieservices) in één gecorreleerde logstream. Dit logtype is uitsluitend bedoeld voor diepe diagnostiek en kan alleen worden gemaakt via de CLI, niet via de GUI

Foutopsporingslogboeken aanvragen is essentieel bij het oplossen van complexe of intermitterende proxyproblemen waarbij standaardlogboeken onvoldoende details bevatten. Ze stellen beheerders en Cisco TAC in staat om precies te traceren hoe een enkel verzoek in elke verwerkingsfase werd afgehandeld, waardoor het mogelijk is om onderliggende oorzaken te identificeren, zoals onverwachte beleidsovereenkomsten, scanvertragingen, verificatiefouten of inconsistente uitspraken tussen motoren. Omdat het log zich op één transactie richt, biedt het maximale zichtbaarheid zonder de operationele overhead en de impact op de prestaties van het mogelijk maken van foutopsporingslogging voor alle proxymodules in het hele systeem. Dit maakt Request Debug Logs een nauwkeurige, efficiënte en laag risico, diagnostische tool tijdens geavanceerde onderzoeken.

De foutopsporingslogboeken voor aanvragen configureren

Stap 1. Log in op CLI, voer logconfig uit en kies nieuw.

Stap 2. Selecteer het nummer dat is gekoppeld aan Foutopsporingslogboeken aanvragen en druk op Enter.

Stap 3. Voer de naam van het log in.

Stap 4. Kies Trace als logniveau.

Stap 5. Kies modules waar gevraagd om de verbeterde logboekregistratie te verzamelen. Meerdere selecties kunnen worden gemaakt in de vorm van een komma gescheiden of bereik lijst (zoals 1,3,4 of 3-7).

Tip: Als de TAC geen specifieke module vereist, is het het beste om alle modules te selecteren (zoals 1-30).

Stap 6. Geef het aantal aanvragen op waarvoor verbeterde logboekregistratie moet worden ingeschakeld. Zodra dit aantal aanvragen is vastgelegd, stopt de logboekregistratie automatisch.

Opmerking: Het is belangrijk om een redelijke waarde te selecteren op basis van de verkeersomstandigheden tijdens het oplossen van problemen. Als er bijvoorbeeld een speciale testmachine wordt gebruikt en het achtergrondverkeer minimaal is, is een lager aantal aanvragen voldoende. In omgevingen met hogere achtergrondactiviteit (zoals updates van het besturingssysteem, achtergrondverzoeken van browsers of toepassingen zoals Webex) zorgt het kiezen van een hogere waarde er echter voor dat de relevante transactie wordt vastgelegd.

Stap 7. Definieer de criteria voor het matchen van aanvragen voor verbeterde logboekregistratie door het IP-adres van de client, het IP-adres van de bestemming of het bestemmingsdomein te selecteren. 

Opmerking: In de meeste gevallen wordt aanbevolen om het IP-adres van de client te selecteren, zelfs bij het oplossen van problemen met de toegang tot één website. Deze aanpak zorgt ervoor dat alle webverzoeken die tijdens het laden van de pagina worden gegenereerd, worden vastgelegd, inclusief achtergrondverzoeken naar extra URL's die mogelijk niet onmiddellijk zichtbaar zijn. Deze methode is echter het meest effectief bij het gebruik van een speciale testmachine met minimaal achtergrondinternetverkeer. In omgevingen waar de client aanzienlijk extra verkeer genereert (zoals updates van het besturingssysteem, browserachtergrondservices of toepassingen zoals Webex), is het beter om te filteren op bestemmingsdomein of bestemmings-IP-adres.

Tip: Als het exacte punt van de fout onbekend is, kunnen browser HAR-logs worden verzameld om de specifieke URL of het domein te identificeren dat problemen vertoont (bijvoorbeeld mislukte pagina's of hoge latentie), en dat domein kan vervolgens worden geconfigureerd in de criteria voor het debuglogboek aanvragen.

Stap 8. Kies de methode om de logs op te halen. Als u FTP Poll selecteert, worden de logbestanden op de SWA weergegeven.

Stap 9. Definieer de bestandsnaam die u wilt gebruiken voor logbestanden of druk op Enter om de huidige gegenereerde bestandsnaam te accepteren.

Stap 10. Selecteer Nee voor de op tijd gebaseerde logbestanden die worden verplaatst, omdat de logboekregistratie stopt nadat aan het gedefinieerde aantal verzoeken is voldaan.

Stap 11. Definieer de maximale bestandsgrootte in Bytes of druk op Enter om de huidige waarde te accepteren.

Tip: Door een grotere logbestandsgrootte te definiëren, kunnen logs moeilijker te downloaden en te beoordelen zijn. In plaats van de grootte van afzonderlijke logbestanden te vergroten, wordt aanbevolen het aantal logbestanden te verhogen (volgende stap). Deze aanpak verbetert de beheerbaarheid en zorgt ervoor dat alle vereiste foutopsporingsinformatie wordt vastgelegd zonder al te grote bestanden te maken.

Stap 12. Configureer het maximale aantal logbestanden op basis van het aantal proxymodules dat is geselecteerd voor het aanmelden bij stap 5 en de criteria voor het matchen van aanvragen die zijn gedefinieerd in stap 7. Het selecteren van een redelijke bestandslimiet is belangrijk om ervoor te zorgen dat alle relevante foutopsporingsinformatie wordt vastgelegd zonder de logboekregistratie voortijdig te stoppen, wat kan resulteren in onvolledige of ontbrekende logbestanden.

Stap 13. Selecteer Nee wanneer hierom wordt gevraagd Moet er een waarschuwing worden verzonden wanneer bestanden worden verwijderd vanwege het maximale aantal bestanden dat is toegestaan? Dit voorkomt onnodige waarschuwingen tijdens normale logrotaties, vooral wanneer er moedwillig foutopsporingslogs worden gegenereerd voor het oplossen van problemen.

Stap 14. Selecteer Nee wanneer u wordt gevraagd Wilt u logboeken comprimeren (ja/nee)? Hierdoor blijven de logbestanden ongecomprimeerd, waardoor ze gemakkelijker kunnen worden bekeken en geanalyseerd tijdens het oplossen van problemen.

Stap 15. Druk op Enter om de wizard af te sluiten

Stap 16. Typ commit en druk op Enter om de wijzigingen op te slaan 

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.

Gerelateerde informatie

• Gebruikershandleiding voor AsyncOS 15.2 voor Cisco Secure Web Appliance

• Best practices voor veilige webtoepassingen gebruiken

• Toegang tot logboeken voor beveiligde webtoepassingen 
• SCP-pushlogs configureren in SWA met Microsoft Server 

Revisiegeschiedenis

Revisie	Publicatiedatum	Opmerkingen
2.0	30-Jul-2026	hercertificering
1.0	24-Apr-2026	Eerste vrijgave