Diagnostics and agent logs

This section provides advanced users and IT administrators with tools and information to troubleshoot issues or test configurations within ​Akamai​ Guardicore Platform Agent.

Enable debug logging

Debug logging generates comprehensive debug information about Guardicore Platform Agent and connectivity to applications. This option may impact performance due to extensive log output. Primarily intended for support and engineering troubleshooting.

  1. Click the Guardicore Platform Agent icon in the Windows tray bar or the macOS menu bar.
  2. In the Guardicore Platform Agent window, Click Settings.
  3. In the Settings pane, toggle Debug Log.
  4. If you are enabling debug logging, a confirmation dialog opens. Click Apply.
    Debug logging is now enabled. Remember to disable this feature once you complete troubleshooting.

Run agent diagnostics

The Diagnostics menu provides two primary diagnostic tools: Quick Test and Full Diagnostics.

Quick Test

Quick Test examines the status of Access and Threat Protection, their connectivity, and configuration status. Results are indicated with icons: green (✓) for success, red (✗) for failure, and orange (!) for disabled components or interrupted tests. To run a test, do the following:

  1. Click the Guardicore Platform Agent icon in the Windows tray bar or the macOS menu bar.
  2. In the Guardicore Platform Agent window, click Diagnostics > Quick Test.
  3. In the Quick Test tab, click Run Quick Test to start diagnosing the agent.

If all checks pass, green icons appear next to each item. If any tests fail (red icons), consider these steps:

  • For configuration failures only, perform a sync operation.
  • If all checks fail or for connectivity failures, contact your Guardicore Platform Agent administrator to verify that agent services are allowed in your organization's firewall.
  • Take screenshots of failed diagnostics, along with device ID, Guardicore Platform Agent version, and logs, and share them with your Guardicore Platform Agent administrator or ​Akamai​ support.

Full Diagnostic

Full Diagnostic performs a comprehensive analysis of the agent and generates detailed logs for further troubleshooting. These logs are useful when working with IT administrators or seeking assistance from ​Akamai​ support. To run the diagnostics, do the following:

  1. Click the Guardicore Platform Agent icon in the Windows desktop tray bar or the macOS menu bar.
  2. In the Guardicore Platform Agent window, click Diagnostics > Full Diagnostics.
  3. In the Full Diagnostics tab, click Run Full Diagnostic to start diagnosing the agent.
  4. Wait for the process to complete.
    1. Click Send to Admin to share the logs with your administrator. Guardicore Platform Agentuploads the log archive to Enterprise Center where an administrator can review them.
    2. Click Download to create a zip file on your drive containing all generated log files.
      1. Select a directory for the zip file.
        The Notifications pane opens.
      2. In the Notifications pane, you can see the filename and location of the saved logs. Click Open containing folder to open the log archive's location. You can access these logs using a text editor or share them with your IT administrator for troubleshooting purposes.

(Limited availability) Capture network packets

When inspecting network packets on protected devices using tools like Wireshark, all network traffic is shown to go to the local proxy. With Packet Capture, you can capture network packets and see the actual destination IPs of your traffic to help you troubleshoot connectivity and performance issues. You need to install Wireshark to capture packets in Guardicore Platform Agent.

📘

Limited availability

This feature requires Guardicore Platform Agent 7.2.1 or later and is available only on Windows and macOS.

Before you begin

  • Packet Capture is disabled if Wireshark isn’t installed on your device. To use this feature, install Wireshark.

Use Packet Capture

  1. In Guardicore Platform Agent, go to Diagnostics > Packet Capture.
  2. Use one of the following options to customize the capture session:
    1. Duration. Sets a time limit for the capture. The capture stops automatically once this duration is reached.
    2. File Size Limit. Sets a maximum file size for the capture file. The capture stops automatically when the file reaches this size.

      👍

      These options are mutually exclusive. Only one option can be active at a time.

  3. Click Start Packet Capture.
  4. Wait for the capturing session to complete or click Stop Packet Capture to stop the capture at any time before a limit is reached.
  5. Once the capture is complete, a summary appears confirming its completion and the reason it stopped (for example, Time limit reached or Stopped by user).
  6. To save the capture file, click Save Capture File.
  7. In the location dialog, select where you want to save the capture file and click Save Capture File.
    This creates a pcapng file in the selected location, which you can open in Wireshark for detailed analysis.