When Cloud Next Generation Firewall Enterprise detects and submits a file to
Advanced malware sandbox (WildFire) for analysis, it generates
detailed logs that help you audit and analyze malware detection and prevention.
These logs provide visibility into network-based threats and sandboxing
results.

This page describes the format and structure of the Advanced malware sandbox
submission logs.

## Types of Advanced malware sandbox logs

Advanced malware sandbox introduces two main categories of logs:

- **Submission logs**: generated when an unknown file is
  evaluated by Advanced malware sandbox. These contain two subtypes:

  - **`WILDFIRE`**: indicates a file was extracted and submitted to the Advanced malware sandbox cloud for asynchronous deep sandboxing.
  - **`INLINE_WILDFIRE`**: indicates a file was evaluated in real-time by the Advanced malware sandbox inline cloud analysis engine before reaching the network.
- **Threat logs**: generated when the firewall detects and
  actively blocks a known or dynamically identified threat inline. These
  add two new subtypes of threat logs:

  - **`WILDFIRE_VIRUS`**: indicates a virus detected by the Advanced malware sandbox cloud service based on a known signature match.
  - **`ML_VIRUS`**: indicates a virus detected dynamically by the firewall's on-box Advanced malware sandbox inline machine learning (ML) engine.

## View logs

To view and analyze the Advanced malware sandbox logs, see
[View all firewall logs](https://docs.cloud.google.com/firewall/docs/manage-firewall-policy-rules-logging.md.txt#all_firewall_logs).

You can use the following queries in the
[Logs Explorer](https://docs.cloud.google.com/logging/docs/view/logs-explorer-interface.md.txt) query editor
field:

- To view submission logs, enter
  `type.googleapis.com/google.cloud.networksecurity.logging.v1.WildfireSubmissionLog`.

- To view threat logs, enter the following query:

  ```
  type.googleapis.com/google.cloud.networksecurity.logging.v1.ThreatLog
  jsonPayload.threatDetails.type="WILDFIRE_VIRUS" OR jsonPayload.threatDetails.type="ML_VIRUS"
  ```

## Advanced malware sandbox log format

Cloud Next Generation Firewall Enterprise creates a log entry in Cloud Logging for
each file submitted to Advanced malware sandbox. The log records are included in the
JSON payload field of a [LogEntry](https://docs.cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry.md.txt) object.

The following table describes the format of the Advanced malware sandbox submission
log fields:

| Field | Type | Description |
|---|---|---|
| `connection` | [`Connection`](https://docs.cloud.google.com/firewall/docs/wildfire-logs.md.txt#connection) | A 5-tuple that describes the connection parameters associated with the traffic. |
| `action` | `string` | The action performed on the connection where the file is submitted to Advanced malware sandbox. For example, `ALLOW`, `DENY`. |
| `wildfireDetails` | [`WildfireDetails`](https://docs.cloud.google.com/firewall/docs/wildfire-logs.md.txt#wildfireDetails) | The details of the Advanced malware sandbox file submission and analysis results. |
| `securityProfileGroupDetails` | [`SecurityProfileGroupDetails`](https://docs.cloud.google.com/firewall/docs/wildfire-logs.md.txt#securityProfileGroupDetails) | The details of the security profile group applied to the intercepted traffic. |
| `interceptVpc` | [`VpcDetails`](https://docs.cloud.google.com/firewall/docs/wildfire-logs.md.txt#vpcDetails) | The details of the Virtual Private Cloud (VPC) network associated with the intercepted traffic. |
| `interceptInstance` | [`InterceptInstance`](https://docs.cloud.google.com/firewall/docs/wildfire-logs.md.txt#interceptInstance) | The details of the virtual machine (VM) instance where the traffic was intercepted. |

### `Connection` field format

The following table describes the format of the `Connection` field:

| Field | Type | Description |
|---|---|---|
| `clientIp` | `string` | The client IP address. If the client is a Compute Engine VM instance, `clientIp` is either the primary internal IP address or an address in an alias IP range of the network interface for the VM. The external IP address is omitted. The logs show the IP address of the VM instance as observed on the IP header, similar to the TCP dump on the VM instance. |
| `clientPort` | `integer` | The client port number. |
| `serverIp` | `string` | The server IP address. If the server is a Compute Engine VM instance, `serverIp` is either the primary internal IP address or an address in an alias IP range of the network interface for the VM. The external IP address is omitted, even if it is used to make the connection. |
| `serverPort` | `integer` | The server port number. |
| `protocol` | `string` | The [IP protocol](https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml) of the connection. |

### `WildfireDetails` field format

The following table describes the format of the `wildfireDetails` field:

| Field | Type | Description |
|---|---|---|
| `verdict` | `string` | The Advanced malware sandbox verdict on the file. For example, `MALICIOUS`. |
| `detectionTime` | `string` | The time the malware was detected. |
| `direction` | `string` | The direction of the file transmission. For example, `CLIENT_TO_SERVER`. |
| `file` | `string` | The name of the file. |
| `fileType` | `string` | The type of the file. For example, `LINUX`, `PE`. |
| `hash` | `string` | The Secure Hash Algorithm 256-bit (SHA-256) hash of the file. |
| `severity` | `string` | The severity associated with the detected malware. For more information, see [Threat severity levels](https://cloud.google.com/firewall/docs/about-threats#threat-severity-level). |
| `repeatCount` | `integer` | The number of sessions with the same client IP address, server IP address, client port, server port, protocol, and domain seen within five seconds. |
| `reportUri` | `string` | A URL to download the Advanced malware sandbox report. This URL generally points to `networksecurity.usercontent.google.com` and contains the organization or project, location, firewall endpoint, and report information. |
| `sampleUri` | `string` | A URL to download the malware sample. This URL generally points to `networksecurity.usercontent.google.com` and contains the organization or project, location, firewall endpoint, and sample information. |
| `subtype` | `string` | The subtype of Advanced malware sandbox. For example, `WILDFIRE`, `INLINE_WILDFIRE`. |

> [!NOTE]
> **Note:** When using the `reportUri` or `sampleUri` from an Advanced malware sandbox submission log from a project-level endpoint, you must replace the project ID with the project number.

### `SecurityProfileGroupDetails` field format

The following table describes the format of the `SecurityProfileGroupDetails` field:

| Field | Type | Description |
|---|---|---|
| `securityProfileGroupId` | `string` | The ID of the security profile group applied to the traffic. |
| `organizationId` | `string` | The ID of the organization that contains the security profile group. Either `organizationId` or `projectId` is populated. |
| `projectId` | `string` | The ID of the project that contains the security profile group. Either `organizationId` or `projectId` is populated. |

### `VpcDetails` field format

The following table describes the format of the `VpcDetails` field:

| Field | Type | Description |
|---|---|---|
| `vpc` | `string` | The name of the VPC network associated with the intercepted traffic |
| `projectId` | `string` | The name of the Google Cloud project associated with the VPC network. |

### `InterceptInstance` field format

The following table describes the format of the `InterceptInstance` field:

| Field | Type | Description |
|---|---|---|
| `zone` | `string` | The name of the zone where the VM instance is located. |
| `vm` | `string` | The name of the VM instance associated with the intercepted traffic. |
| `projectId` | `string` | The ID of the Google Cloud project that contains the VM instance. |

## Advanced malware sandbox log correlation with firewall logs

When traffic is evaluated by a firewall rule,
Cloud NGFW records a
[firewall policy rules logging](https://docs.cloud.google.com/firewall/docs/firewall-policy-rules-logging-overview.md.txt)
entry. For more information, see
[Advanced malware sandbox log format](https://docs.cloud.google.com/firewall/docs/wildfire-logs.md.txt#wildfire-log-format).
To view these firewall rule logs, see
[View logs](https://docs.cloud.google.com/firewall/docs/using-firewall-rules-logging#viewing_logs).

When firewall policy rule with Layer 7 inspection has logging enabled,
Cloud NGFW first records a VPC firewall rules logging entry for
the evaluated traffic. Then, it sends the traffic to the firewall
endpoint for Layer 7 inspection. For more information, see
[Enable or disable firewall policy rules logging](https://docs.cloud.google.com/firewall/docs/manage-firewall-policy-rules-logging.md.txt#enable-and-disable-firewall-policy-rules-logging)

The firewall endpoint analyzes the traffic for files to submit to
Advanced malware sandbox, and creates a separate Advanced malware sandbox submission log for
the connection. This Advanced malware sandbox submission log
includes fields such as the filename, the file hash, the source of the traffic,
and the destination of the traffic.

To view the Advanced malware sandbox submission logs, in the
[Logs Explorer](https://docs.cloud.google.com/logging/docs/view/logs-explorer-interface.md.txt),
search for the log `networksecurity.googleapis.com%2Ffirewall_wildfire`.

You can compare the fields in the
[firewall policy rules log](https://docs.cloud.google.com/firewall/docs/firewall-policy-log-format.md.txt)
and the [Advanced malware sandbox log format](https://docs.cloud.google.com/firewall/docs/wildfire-logs.md.txt#wildfire-log-format) to identify the
connection that triggered Advanced malware sandbox file submission and take
appropriate action to resolve it.

For example, you have a firewall policy rule configured with the following
settings:

- Source IP address: `192.0.2.0`
- Source port: `47644`
- Destination IP address: `192.0.2.1`
- Destination port: `80`
- Logging: `Enabled`

To view the Advanced malware sandbox submission logs associated with this rule, navigate to
the **Logs Explorer** page. In the **Query** pane, paste the following
query into the query editor field.

<br />

```
  resource.type="networksecurity.googleapis.com/FirewallEndpoint"
  jsonPayload.connection.clientIp="192.0.2.0"
  jsonPayload.connection.clientPort="47644"
  jsonPayload.connection.serverIp="192.0.2.1"
  jsonPayload.connection.serverPort="80"
  
```

<br />

The **Query results** section displays the following Advanced malware sandbox
submission log:

<br />

```
    {
      "insertId": "akxp8uf5f0fuv",
      "jsonPayload": {
      "connection": {
      "serverPort": 80,
      "clientPort": 47644,
      "protocol": "TCP",
      "clientIp": "192.0.2.0",
      "serverIp": "192.0.2.1"
    },
      "interceptInstance": {
      "zone": "us-central1-c",
      "vm": "aied-test-dont-delete",
      "projectId": "project_001"
    },
      "interceptVpc": {
      "projectId": "project_001",
      "vpc": "default"
    },
      "@type": "type.googleapis.com/google.cloud.networksecurity.logging.v1.WildfireSubmissionLog",
      "securityProfileGroupDetails": {
      "securityProfileGroupId": "my-spg-id",
      "organizationId": "organization_001"
    },
      "action": "DENY",
      "wildfireDetails": {
        "detectionTime": "2026-04-19T21:18:50Z",
        "direction": "SERVER_TO_CLIENT",
        "file": "sheet.exe",
        "fileType": "PE",
        "hash": "02521f0bb91b4c74d1590b85254f26f0d258cd780393010593ae6daaa5993753",
        "repeatCount": 1,
        "reportUri": "https://networksecurity.usercontent.google.com/projects/12345/locations/us-west2-a/firewallEndpoints/prober-wfmixed-fwp-ep-us-w2-a/wildfireReports/C08DD6908D91EAB335FA89675E499631557B3126ADFF9C83A1856D4404D2F4A2",
        "sampleUri": "https://networksecurity.usercontent.google.com/projects/12345/locations/us-west2-a/firewallEndpoints/prober-wfmixed-fwp-ep-us-w2-a/wildfireSamples/C08DD6908D91EAB335FA89675E499631557B3126ADFF9C83A1856D4404D2F4A2",
        "severity": "INFORMATIONAL",
        "subtype": "WILDFIRE",
        "verdict": "MALICIOUS"
      },
    },
    "resource": {
    "type": "networksecurity.googleapis.com/FirewallEndpoint",
    "labels": {
      "location": "us-central1-c",
      "resource_container": "organizations/organization_001",
      "id": "pg-ni-latencyayzl8peq"
    }
  },
  "timestamp": "2025-06-02T19:09:35.452299517Z",
  "logName": "projects/project_001/logs/networksecurity.googleapis.com%2Ffirewall_wildfire",
  "receiveTimestamp": "2025-06-02T19:09:35.452299517Z"
}
   
```

<br />

Similarly, to view the firewall logs associated with this rule, navigate to
the **Logs Explorer** page. In the **Query** pane, paste the following
query into the query editor field.

<br />

```
    jsonPayload.rule_details.action="APPLY_SECURITY_PROFILE_GROUP"
    jsonPayload.connection.src_ip="192.0.2.0"
    jsonPayload.connection.src_port="47644"
    jsonPayload.connection.dest_ip="192.0.2.1"
    jsonPayload.connection.dest_port="80"
   
```

<br />

The **Query results** section displays the following firewall log:

<br />

```
    {
      insertId: "qn82vdg109q3r9"
      jsonPayload: {
      connection: {
      }
      dest_ip: "192.0.2.1"
      dest_port: 80
      protocol: 6
      src_ip: "192.0.2.0"
      src_port: 47644
      disposition: "INTERCEPTED"
      ►instance: {4}
      ▸ remote_instance: {4}
      ▸ remote_vpc: {3}
      rule_details: {
      action: "APPLY_SECURITY_PROFILE_GROUP"
      apply_security_profile_fallback_action: "UNSPECIFIED"
      direction: "INGRESS"
      ▸ ip_port_info: [1]
      ▼
      priority: 6000
      reference: "network: fwplus-vpc/firewallPolicy: fwplus-fwpolicy"
      source_range: [
      1
      0: "192.0.2.0/24"
      target_secure_tag: [
      0: "tagValues/281479199099651"
      ]
      }
      vpc: {
      project_id: "project_001"
      subnetwork_name: "fwplus-us-central1-subnet"
      vpc_name: "fwplus-vpc"
      }
      }
      logName: "projects/project_001/logs/compute.googleapis.com%2Ffirewall",
      receiveTimestamp: "2023-11-28T19:08:46.749244092Z"
      resource: {2}
      timestamp: "2023-11-28T19:08:40.207465099Z"
    }
   
```

<br />

By using both the Advanced malware sandbox submission log and firewall log queries,
you can see the correlation between them. The following table maps the firewall
log fields to the corresponding Advanced malware sandbox submission log fields:

| Firewall log field | Advanced malware sandbox submission log field | Description |
|---|---|---|
| `src_ip` | `clientIp` | The source IP address in the firewall log is correlated with the client IP address in the Advanced malware sandbox submission log to identify the origin of the evaluated traffic. |
| `src_port` | `clientPort` | The source port in the firewall log is correlated with the client port in the Advanced malware sandbox submission log to identify the source port used by the evaluated traffic. |
| `dest_ip` | `serverIp` | The destination IP address in the firewall log is correlated with the server IP address in the Advanced malware sandbox submission log to pinpoint the target of the evaluated traffic. |
| `dest_port` | `serverPort` | The destination port in the firewall log is correlated with the server port in the Advanced malware sandbox submission log to identify the destination port used by the evaluated traffic. |

## What's next

- [Advanced malware sandbox overview](https://docs.cloud.google.com/firewall/docs/about-wildfire.md.txt)