Erhöhen Sie die Debug-Protokollierung für Edge Encryption Proxy

Erhöhen Sie die Protokollierungsstufe, um die Protokolle zu interpretieren und Probleme mit dem Proxy zu debuggen.

Es gibt derzeit drei Optionen zum Erhöhen der Debug-Protokollierung in Edge Encryption Proxy. Erhöhen Sie die Protokollierungsstufe, um Probleme zu debuggen. Stellen Sie technischen Support mit Informationen bereit, um das Problem mit ausführlicheren Protokollanweisungen zu untersuchen.

Richten Sie die Debug-Protokollierung je nach Problem auf eine von drei Arten ein:

• Debugging-Probleme mit Ausnahme der SSL-Konnektivität
• Protokollierung von Zeitmetriken für Anforderungen über den Proxy
• Debugging von Problemen mit der SSL-Konnektivität zwischen dem Edge Encryption-Proxy und der Instanz

Für alle Debug-Fälle können Sie die Protokolle in Ihren eigenen Protokollen anzeigen und interpretieren oder einen Incident öffnen, um eine Interpretation von zu erhalten ServiceNow Technischer Support, der die Beschreibung des Problems und seine Reproduktion bereitstellt.

Debugging-Probleme mit Edge Encryption Andere Anwendung als SSL-Konnektivität

Verwenden Sie diese Methode, um Probleme mit zu debuggen Edge Encryption Anwendung, ohne den Proxy anzuhalten und neu zu starten. Diese Schritte erhöhen die Protokollierungsstufe und helfen bei der Behebung der Ursache mit ausführlicheren Protokollanweisungen.

Vorbereitungen

Erforderliche Rolle: Administrator

Hinweis:

Änderungen an vorgenommen $Proxy_Installation_location/conf/log4j2.properties Dateien werden vom Proxy innerhalb von etwa 60 Sekunden nach dem Vornehmen der Änderungen verwendet. Sie müssen die Proxys nicht neu starten.

Prozedur

1. In $Proxy_Installation_location/conf/log4j2.properties Datei Suchen Sie die folgende Zeile.

   logger.edge.level=info

2. Ändern Sie die obige Zeile wie folgt:

   logger.edge.level=debug

3. Speichern Sie die Änderung.
   Es kann bis zu 60 Sekunden dauern, bis der Change wirksam wird, dies erfordert jedoch keinen Proxy-Neustart.
4. Reproduzieren Sie Ihr Problem.
5. Überprüfen Sie auf Debug-Protokollanweisungen im Zusammenhang mit der Anwendung in $Proxy_Installation_location/logs/edgeencryption.log Datei.

Ergebnisse

Nach der Änderung der Eigenschaft können Sie zusätzliche Details in anzeigen $Proxy_Installation_location/logs/edgeencryption.log Datei. Wenn Sie das Debugging abgeschlossen haben, setzen Sie die an vorgenommene Änderung zurück $Proxy_Installation_location/conf/log4j2.properties Datei.

Protokollierung von Zeitmetriken für Anforderungen über den Proxy

Aktivieren Sie die Protokollierung der Zeitmetrik, um eine Metrikanweisung für jede Anforderung hinzuzufügen, die von bearbeitet wird Edge Encryption Proxy. Jede dieser Protokollanweisungen für Zeitmetriken enthält nützliche Informationen zur Anforderung, z. B. Verarbeitungszeiten und welche Verschlüsselungsregel verwendet wurde.

Vorbereitungen

Erforderliche Rolle: Administrator

Hinweis:

Die zusätzlichen Protokollierungseinstellungen werden dem hinzugefügt $Proxy_Installation_location/conf/log4j2.properties Datei. Vorgenommene Änderungen werden vom Proxy innerhalb von etwa einer Minute nach den Änderungen an der Datei dynamisch übernommen, sodass Sie die Proxys nicht neu starten müssen.

Prozedur

1. Ändern Sie $Proxy_Installation_location/conf/log4j2.properties Datei durch Hinzufügen der folgenden Zeilen am Ende der Datei

   appender.timinglog.type=RollingFile
   appender.timinglog.name=TimingLog
   appender.timinglog.fileName=../logs/edgenetwork.log
   appender.timinglog.filePattern=../logs/$${date:yyyy-MM}/edgenetwork-%d{yyyy-MM-dd-HH}-%i.log.gz
   appender.timinglog.layout.type=PatternLayout
   appender.timinglog.layout.pattern=%d [%t] %-5p %m%n
   appender.timinglog.policies.type=Policies
   appender.timinglog.policies.size.type=SizeBasedTriggeringPolicy
   appender.timinglog.policies.size.size=500MB
   appender.timinglog.strategy.type=DefaultRolloverStrategy
   appender.timinglog.strategy.max=4
   
   logger.timing.name=com.snc.edgeencryption.metrics.EdgeEncryptionTimingMetricCache
   logger.timing.level=debug
   logger.timing.additivity=false
   logger.timing.appenderRef.rolling.ref=TimingLog

2. Speichern Sie die Datei.

Ergebnisse

Nach log4j.properties Die Datei wird gespeichert, die folgenden Nachrichtentypen werden in angezeigt $Proxy_Installation_location/logs/edgenetwork.log Protokolldatei für Netzwerkzeiten.

2022-07-21 12:56:15,783 [qtp1971991758-7700] DEBUG com.snc.edgeencryption.metrics.EdgeEncryptionTimingMetricCache -  request_uri=/api/now/ui/presencesysparm_auto_request=true&cd=1658433375754 request_method=POST client_request_received="2022-07-21 12:56:15,015" proxy_request_processing_time=6 all_rules_processing_time=0 rule_executed="REST JSON" rule_execution_time=1 proxy_instance_round_trip=14 proxy_response_processing_time=1 total_time_from_proxy=21 reponse_code=201 glide_user=SCv3_1:BAz1ZK7ee9XoroG2nvMlixHpgTvsT4fY2bwQvnH2WdU=:y5HGsTTqo3Pjq6G0xk4LoazCwCiWRJk4/6SpbXuBzqg=:6816f79cc0a8016401c5a33be04be441 jsessionid_suffix=037A66

Die Werte in den Protokollnachrichten lauten wie folgt:

request_uri: The URI being requested

request_method: The HTTP method being used, for example, GET, POST, PUT, PATCH, DELETE

client_request_received: The timestamp noting when the HTTP client request arrived at the Edge proxy

proxy_request_processing_time: How long the Edge proxy took to process the request in milliseconds

all_rules_processing_time: Total time it took to execute all of the Edge Encryption rules for the request in milliseconds

rule_executed: The name of the encryption rule that was executed

rule_execution_time: How long it took to execute listed rule_executed in milliseconds

proxy_instance_round_trip: The time from when the Edge proxy sent the request to the instance until the instance sent the response and was received by the edge proxy in milliseconds

proxy_response_processing_time: How long the Edge proxy took to process the response in milliseconds

total_time_from_proxy: The total time from when the Edge proxy received the request from the client and returned the response to the client in milliseconds

response_code: HTTP response code 

glide_user: The glide_user cookie value

jsessionid_suffix: The JSession cookie suffix associated with the request

Debuggen von Problemen mit SSL-Konnektivität zwischen Edge Encryption Proxy und die Instanz

Verwenden Sie diese Methode, um Probleme mit der SSL-Konnektivität zwischen zu debuggen Edge Encryption Proxy und Ihre Instanz, z. B. der Zugriff auf die Instanz schlägt über den Proxy fehl. Diese Schritte erhöhen die Protokollierung und helfen bei der Suche nach ausführlichen Protokollanweisungen.

Vorbereitungen

Erforderliche Rolle: Administrator

Hinweis:

Das Debugging der SSL-Konnektivität ist nur bei der Behebung von Problemen mit dem TLS-Konnektivitätstyp relevant. In der Praxis ist dies nicht üblich und wird selten benötigt.

Prozedur

1. Den Proxy-Server stoppen.
2. Fügen Sie der Datei die folgende Zeile hinzu $Proxy_Installation_location/conf/Wrapper.conf , Was eine Java-Starteigenschaft ist:

   wrapper.java.additional.<next available number in sequence> = -Djavax.net.debug=all
   

   Zum Beispiel:

   For example: wrapper.java.additional.4 = -Djavax.net.debug=all

3. Speichern Sie die Änderung, und starten Sie den Proxy-Server neu.
4. Reproduzieren Sie Ihr Konnektivitätsproblem.

Ergebnisse

Nach der Reproduktion des Problems können Debug-Protokollanweisungen im Zusammenhang mit dem SSL-Austausch in gefunden werden $Proxy_Installation_location/logs/Wrapper_<current date>.log Datei. Wenn Sie das Debugging abgeschlossen haben. Sie können die zusätzliche Protokollierung Remote durchführen, indem Sie die in den vorherigen Schritten erstellte Zeile entfernen oder kommentieren.