Questa pagina descrive la struttura di logging delle regole firewall VPC in Cloud Logging. Quando una regola Virtual Private Cloud (VPC) con la registrazione abilitata si applica al traffico da o verso un'istanza di macchina virtuale (VM), Cloud Logging crea una voce di log. I record di log vengono visualizzati nel campo payload JSON di una LogEntry di Logging.
I record di log del firewall sono costituiti da campi di base, che sono i campi principali di ogni record di log, e da campi di metadati facoltativi. Per ridurre i costi di archiviazione, puoi escludere i campi dei metadati.
Alcuni campi dei log possono contenere altri campi come valori. Ad esempio, il campo
connection utilizza il formato IpConnection, che include l'indirizzo IP e la porta di origine e di destinazione, nonché il protocollo, in un unico campo.
La tabella seguente descrive i campi dei log supportati per le regole firewall VPC.
| Nome campo | Tipo di campo: metadati di base o facoltativi | Descrizione |
|---|---|---|
connection |
Livelli | IpConnection 5 tuple che descrivono l'indirizzo IP di origine e di destinazione, la porta di origine e di destinazione e il protocollo IP di questa connessione. |
disposition |
Livelli | Indica se la connessione è stata ALLOWED o
DENIED. |
rule_details |
Livelli | RuleDetails Dettagli della regola firewall VPC. Per le regole firewall VPC, il formato è network:{network name}/firewall:{firewall_name}. |
instance |
Metadati | InstanceDetails Dettagli dell'istanza VM. In una configurazione del VPC condiviso, project_id corrisponde a quello del progetto di servizio. |
load_balancer_details |
Metadati | LoadBalancingDetails Dettagli del bilanciatore del carico delle applicazioni interno o del bilanciatore del carico di rete proxy interno a cui si applica la regola firewall. Quando la destinazione di una regola firewall è uno di questi bilanciatori del carico, il campo instance viene omesso. |
vpc |
Metadati | VpcDetails Dettagli rete VPC. In una configurazione del VPC condiviso, project_id corrisponde a quello del progetto host. |
remote_instance |
Metadati | InstanceDetails Se l'endpoint remoto della connessione era una VM situata in Compute Engine, questo campo viene compilato con i dettagli dell'istanza VM. |
remote_vpc |
Metadati | VpcDetails Se l'endpoint remoto della connessione era una VM che si trova in una rete VPC, questo campo viene compilato con i dettagli della rete. |
remote_location |
Metadati | GeographicDetails Se l'endpoint remoto della connessione era esterno alla rete VPC, questo campo viene compilato con i metadati sulla posizione disponibili. |
IpConnection
| Campo | Tipo | Descrizione |
|---|---|---|
src_ip |
string | L'indirizzo IP di origine. Se l'origine è una VM di Compute Engine,
src_ip è l'indirizzo IP interno primario o un indirizzo
in un intervallo IP alias dell'interfaccia di rete della VM. L'indirizzo IP esterno
non viene mostrato. La registrazione mostra l'indirizzo IP della VM
come viene visualizzato nell'intestazione del pacchetto, come se avessi eseguito
tcpdump sulla VM. |
src_port |
integer | La porta di origine. |
dest_ip |
string | L'indirizzo IP di destinazione. Se la destinazione è una VM, Google Cloud dest_ip è l'indirizzo IP interno primario o un indirizzo in un intervallo IP alias dell'interfaccia di rete della VM. L'indirizzo IP esterno non viene mostrato anche se è stato utilizzato per stabilire la connessione. |
dest_port |
integer | La porta di destinazione. |
protocol |
integer | Protocollo IP della connessione. |
RuleDetails
| Campo | Tipo | Descrizione |
|---|---|---|
reference |
string | Una stringa identificatore univoca che fa riferimento a una regola firewall denominata risorsa
associata a una singola rete VPC. Il formato per
la regola firewall VPC è:network:{network name}/firewall:{VPC firewall rule name}. |
priority |
integer | La priorità della regola firewall VPC. |
action |
string | Azione applicata alla connessione. I valori supportati sono ALLOW
o DENY. |
direction |
string | La direzione a cui si applica la regola firewall VPC.
Può essere INGRESS o EGRESS.
|
source_range[ ] |
string | Elenco degli intervalli di origine a cui si applica la regola firewall VPC. |
destination_range[ ] |
string | Elenco degli intervalli di destinazione a cui si applica la regola firewall VPC. |
ip_port_info[ ] |
string | Elenco dei protocolli IP e degli intervalli di porte applicabili per le regole. |
source_tag[ ] |
string | Elenchi dei tag di rete di origine a cui si applica la regola firewall VPC. |
target_tag[ ] |
string | Elenchi dei tag di rete di destinazione a cui si applica la regola firewall VPC. |
source_service_account[ ] |
string | Elenco di tutti gli account di servizio di origine a cui si applica la regola firewall VPC. |
target_service_account[ ] |
string | Elenco di tutti gli account di servizio di destinazione a cui si applica la regola firewall VPC. |
IpPortDetails
| Campo | Tipo | Descrizione |
|---|---|---|
ip_protocol |
string | Il protocollo IP a cui si applica la regola firewall VPC. Può essere
impostato su ALL se la regola si applica a tutti i protocolli IP. |
port_range[ ] |
string | Elenco degli intervalli di porte applicabili per le regole firewall VPC.
Ad esempio, 8080-9090. |
InstanceDetails
| Campo | Tipo | Descrizione |
|---|---|---|
project_id |
string | ID del progetto contenente la VM. |
vm_name |
string | Nome istanza della VM. |
region |
string | Regione della VM. |
zone |
string | Zona della VM. |
LoadBalancingDetails
| Campo | Tipo | Descrizione |
|---|---|---|
forwarding_rule_project_id |
string | ID progettoGoogle Cloud che contiene la regola di forwarding. Inviato quando il bilanciatore del carico è la destinazione anziché una VM. |
type |
string | Tipo di bilanciatore del carico: APPLICATION_LOAD_BALANCER indica
un bilanciatore del carico delle applicazioni interno. PROXY_NETWORK_LOAD_BALANCER indica un
bilanciatore del carico di rete proxy interno. Inviato quando
il bilanciatore del carico è la destinazione anziché una VM. |
scheme |
string | Schema del bilanciatore del carico, INTERNAL_MANAGED. Inviato quando
il bilanciatore del carico è la destinazione anziché una VM. |
url_map_name |
string | Nome della mappa URL. Compilato solo se type
è APPLICATION_LOAD_BALANCER. Inviato quando
il bilanciatore del carico è la destinazione anziché una VM. |
forwarding_rule_name |
string | Il nome della regola di forwarding. Inviato quando il bilanciatore del carico è la destinazione anziché una VM. |
VpcDetails
| Campo | Tipo | Descrizione |
|---|---|---|
project_id |
string | ID del progetto contenente la rete. |
vpc_name |
string | Rete su cui opera la VM. |
subnetwork_name |
string | La subnet su cui opera la VM. |
GeographicDetails
| Campo | Tipo | Descrizione |
|---|---|---|
continent |
string | Nome del continente. È applicabile se l'endpoint remoto della connessione è esterno al VPC. |
country |
string | Nome del paese. È applicabile se l'endpoint remoto della connessione è esterno al VPC. |
region |
string | Nome della regione. È applicabile se l'endpoint remoto della connessione è esterno al VPC. |
city |
string | Nome della città. È applicabile se l'endpoint remoto della connessione è esterno al VPC. |
Passaggi successivi
- Formato di logging delle regole dei criteri del firewall.
- Panoramica della registrazione delle regole firewall VPC.
- Gestisci il logging delle regole firewall VPC.
- Cloud Logging.