Configura log di flusso VPC

Console

1. Nella console Trusted Cloud , vai alla pagina Reti VPC.

   Vai a Reti VPC

2. Nella scheda Subnet nel progetto corrente, seleziona una o più subnet, quindi fai clic su menuGestisci log di flusso.

3. In menuGestisci log flusso, fai clic su Aggiungi nuova configurazione.

4. Nella sezione Configurazioni - Sottoreti (anteprima), fai clic su Aggiungi una configurazione.

5. In Nome, inserisci un nome per la nuova configurazione dei log di flusso VPC.

6. (Facoltativo) Modifica l'Intervallo di aggregazione e le impostazioni nella sezione Impostazioni avanzate:

   • Se configurare il filtro dei log. Per impostazione predefinita, l'opzione Conserva solo i log che corrispondono a un filtro non è selezionata.
   • Indica se includere i metadati nelle voci di log finali. Per impostazione predefinita, Annotazioni metadati include tutti i campi.
   • La frequenza di campionamento secondaria. 100% indica che tutte le voci generate dal processo di campionamento dei log di flusso principale vengono conservate. La frequenza di campionamento del log di flusso principale non è configurabile. Per saperne di più, consulta Campionamento e elaborazione dei log.

7. Fai clic su Salva.

gcloud

Per attivare i log di flusso VPC per una subnet, utilizza il comando gcloud beta network-management vpc-flow-logs-configs create.

Puoi attivare i log di flusso VPC creando una configurazione dei log di flusso VPC. Puoi creare la configurazione con tutti i relativi parametri impostati sui valori predefiniti oppure puoi personalizzare i valori predefiniti.

In gcloud CLI, imposta il progetto sull' Trusted Cloud ID del progetto della sottorete ed esegui uno dei seguenti comandi:

• Per creare una configurazione predefinita dei log di flusso VPC, esegui il seguente comando:

  gcloud beta network-management vpc-flow-logs-configs create CONFIG_NAME \
      --location=global \
      --subnet=SUBNET
  

• Per creare una configurazione personalizzata dei log di flusso VPC, specifica ogni parametro che vuoi personalizzare.

  Ad esempio, per personalizzare l'intervallo di aggregazione, il filtro, la frequenza di campionamento secondaria e i parametri dei metadati quando crei una configurazione dei log di flusso VPC, esegui il seguente comando:

  gcloud beta network-management vpc-flow-logs-configs create CONFIG_NAME \
      --location=global \
      --subnet=SUBNET \
      --aggregation-interval=AGGREGATION_INTERVAL \
      --filter-expr=FILTER_EXPRESSION \
      --flow-sampling=SAMPLING_RATE \
      --metadata=LOGGING_METADATA
  

  Sostituisci quanto segue:

  • CONFIG_NAME: un nome per la configurazione.
  • SUBNET: la subnet di cui vuoi registrare i dati. Deve essere specificato nel seguente formato: projects/PROJECT_ID/regions/REGION/subnetworks/NAME, dove:
    • PROJECT_ID è l'ID del progetto Trusted Cloud che contiene la subnet. La configurazione deve essere creata in questo progetto.
    • REGION è la regione della subnet.
    • NAME è il nome della subnet.

  Per impostare i parametri facoltativi in una configurazione personalizzata, sostituire quanto segue:

  • AGGREGATION_INTERVAL: l'intervallo di aggregazione per i log di flusso generati da questa configurazione. Questo parametro può essere impostato su interval-5-sec(valore predefinito), interval-30-sec, interval-1-min, interval-5-min,interval-10-min o interval-15-min.
  • FILTER_EXPRESSION: un'espressione che definisce i log da conservare. L'espressione ha un limite di 2048 caratteri. Per ulteriori informazioni, consulta la sezione Filtro dei log.
  • SAMPLING_RATE: la frequenza di campionamento del flusso secondario. Questo parametro può essere impostato su un valore maggiore di 0.0 e fino a 1.0 (tutti i log, predefinito). Per ulteriori informazioni, consulta Campionamento e elaborazione dei log.
  • LOGGING_METADATA: le annotazioni dei metadati da includere nei log:
    • Utilizza include-all-metadata per includere tutte le annotazioni dei metadati (impostazione predefinita).
    • Utilizza exclude-all-metadata per escludere tutte le annotazioni dei metadati.
    • Utilizza custom-metadata per includere un elenco personalizzato di campi di metadati. Per specificare i campi dei metadati, utilizza il flag --metadata-fields:
      • --metadata-fields=METADATA_FIELDS: sostituisci METADATA_FIELDS con un elenco separato da virgole dei campi dei metadati che vuoi includere nei log. Ad esempio: src_instance,dst_instance. Può essere impostato solo se metadata è impostato su custom-metadata.

API

Per abilitare i log di flusso VPC per una subnet, utilizza il metodo projects.locations.vpcFlowLogsConfigs.create.

Puoi attivare i log di flusso VPC creando una configurazione dei log di flusso VPC. Puoi creare la configurazione con tutti i relativi parametri impostati sui valori predefiniti oppure puoi personalizzare i valori predefiniti.

Per creare una configurazione predefinita dei log di flusso VPC, includi i seguenti parametri nella richiesta API:

POST https://networkmanagement.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
{
  "subnet": "SUBNET"
}

Per creare una configurazione personalizzata dei log di flusso VPC, specifica ogni parametro che vuoi personalizzare.

Ad esempio, per personalizzare l'intervallo di aggregazione, i filtri, la frequenza di campionamento secondaria e i parametri dei metadati durante la creazione di una configurazione dei log di flusso VPC, includi i seguenti parametri nella richiesta API:

POST https://networkmanagement.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
{
  "subnet": "SUBNET",
  "aggregationInterval": "AGGREGATION_INTERVAL",
  "filterExpr": "FILTER_EXPRESSION",
  "flowSampling": SAMPLING_RATE,
  "metadata": "LOGGING_METADATA"
}

Sostituisci quanto segue:

• PROJECT_ID: l' Trusted Cloud ID progetto della subnet.
• CONFIG_NAME: un nome per la configurazione.
• SUBNET: la subnet di cui vuoi registrare i dati. Deve essere specificato nel seguente formato: projects/PROJECT_ID/regions/REGION/subnetworks/NAME, dove:
  • PROJECT_ID è l'ID progetto della subnet.
  • REGION è la regione della subnet.
  • NAME è il nome della subnet.

• AGGREGATION_INTERVAL: l'intervallo di aggregazione per i log di flusso generati da questa configurazione. Questo parametro può essere impostato su INTERVAL_5_SEC (valore predefinito), INTERVAL_30_SEC, INTERVAL_1_MIN, INTERVAL_5_MIN, INTERVAL_10_MIN o INTERVAL_15_MIN.
• FILTER_EXPRESSION: un'espressione che definisce i log da conservare. L'espressione ha un limite di 2048 caratteri. Per ulteriori informazioni, consulta la sezione Filtro dei log.
• SAMPLING_RATE: la frequenza di campionamento del flusso secondario. Questo parametro può essere impostato su un valore maggiore di 0.0 e minore di 1.0 (tutti i log, valore predefinito). Per ulteriori informazioni, consulta Campionamento e elaborazione dei log.
• LOGGING_METADATA: le annotazioni dei metadati da includere nei log:
  • Utilizza INCLUDE_ALL_METADATA per includere tutte le annotazioni dei metadati (impostazione predefinita).
  • Utilizza EXCLUDE_ALL_METADATA per escludere tutte le annotazioni dei metadati.
  • Utilizza CUSTOM_METADATA per includere un elenco personalizzato di campi di metadati. Per specificare i campi dei metadati, utilizza il parametro metadataFields:
    • metadataFields: METADATA_FIELDS: sostituisci METADATA_FIELDS con un elenco separato da virgole dei campi dei metadati che vuoi includere nei log. Ad esempio, src_instance,dst_instance. Può essere impostato solo se metadata è impostato su CUSTOM_METADATA.

Console

1. Nella console Trusted Cloud , vai alla pagina Reti VPC.

   Vai a Reti VPC

2. Fai clic sulla rete a cui vuoi aggiungere una sottorete.

3. Fai clic su Aggiungi subnet.

4. Per Log di flusso, seleziona On.

5. (Facoltativo) Modifica l'Intervallo di aggregazione e una delle seguenti impostazioni nella sezione Impostazioni avanzate:

   • Se configurare il filtro dei log. Per impostazione predefinita, l'opzione Conserva solo i log che corrispondono a un filtro non è selezionata.
   • Indica se includere i metadati nelle voci di log finali. Per impostazione predefinita, Annotazioni metadati include tutti i campi.
   • La frequenza di campionamento secondaria. 50% indica che viene conservata la metà delle voci generate dal processo di campionamento primario dei log di flusso. La frequenza di campionamento del log di flusso principale non è configurabile. Per saperne di più, consulta Campionamento e elaborazione dei log.

6. Compila gli altri campi come appropriato.

7. Fai clic su Aggiungi.

gcloud

Esegui questo comando:

gcloud compute networks subnets create SUBNET_NAME \
    --enable-flow-logs \
    [--logging-aggregation-interval=AGGREGATION_INTERVAL] \
    [--logging-flow-sampling=SAMPLING_RATE] \
    [--logging-filter-expr=FILTER_EXPRESSION] \
    [--logging-metadata=LOGGING_METADATA] \
    [--logging-metadata-fields=METADATA_FIELDS] \
    [other flags as needed]

Sostituisci quanto segue:

• AGGREGATION_INTERVAL: l'intervallo di aggregazione per i log di flusso nella subnet. L'intervallo può essere impostato su una delle seguenti opzioni: 5 secondi (impostazione predefinita), 30 secondi, 1 minuto, 5 minuti, 10 minuti o 15 minuti.
• SAMPLING_RATE: la frequenza di campionamento del flusso secondario. Il campionamento dei flussi secondari può essere impostato da 0.0 (nessun campionamento) a 1.0 (tutti i log). Il valore predefinito è 0.5. Per saperne di più, consulta Campionamento e elaborazione dei log.
• FILTER_EXPRESSION: un'espressione che definisce i log da conservare. L'espressione ha un limite di 2048 caratteri. Per maggiori dettagli, consulta la sezione Filtro dei log.

• LOGGING_METADATA: le annotazioni dei metadati che vuoi includere nei log:

  • Utilizza include-all per includere tutte le annotazioni dei metadati.
  • Utilizza exclude-all per escludere tutte le annotazioni dei metadati (valore predefinito).
  • Utilizza custom per includere un elenco personalizzato di campi di metadati specificati in METADATA_FIELDS.

• METADATA_FIELDS: un elenco separato da virgole dei campi dei metadati da includere nei log. Ad esempio, src_instance,dst_instance. Può essere impostato solo se LOGGING_METADATA è impostato su custom.

API

Abilita i log di flusso VPC quando crei una nuova subnet.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks
{
  "logConfig": {
    "aggregationInterval": "AGGREGATION_INTERVAL",
    "flowSampling": SAMPLING_RATE,
    "filterExpr": EXPRESSION,
    "metadata": METADATA_SETTING,
    "metadataFields": METADATA_FIELDS,
    "enable": true
  },
  "ipCidrRange": "IP_RANGE",
  "network": "NETWORK_URL",
  "name": "SUBNET_NAME"
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto in cui verrà creata la subnet.
• REGION: la regione in cui verrà creata la subnet.
• AGGREGATION_INTERVAL: l'intervallo di aggregazione per i log di flusso nella subnet. L'intervallo può essere impostato su uno dei seguenti valori: INTERVAL_5_SEC, INTERVAL_30_SEC, INTERVAL_1_MIN, INTERVAL_5_MIN, INTERVAL_10_MIN o INTERVAL_15_MIN.
• SAMPLING_RATE: la frequenza di campionamento del flusso. Il campionamento dei flussi può essere impostato da 0.0 (nessun campionamento) a 1.0 (tutti i log). Il valore predefinito è .0.5.
• EXPRESSION: l'espressione del filtro che utilizzi per filtrare i log effettivamente scritti. L'espressione ha un limite di 2048 caratteri. Per maggiori dettagli, consulta la sezione Filtro dei log.

• METADATA_SETTING: le annotazioni dei metadati che vuoi includere nei log:

  • Utilizza INCLUDE_ALL_METADATA per includere tutte le annotazioni dei metadati.
  • Utilizza EXCLUDE_ALL_METADATA per escludere tutte le annotazioni dei metadati (valore predefinito).
  • Utilizza CUSTOM_METADATA per includere un elenco personalizzato di campi di metadati specificati in METADATA_FIELDS.

• METADATA_FIELDS: i campi dei metadati che vuoi acquisire quando hai impostato metadata: CUSTOM_METADATA. Si tratta di un elenco di campi dei metadati separati da virgole, ad esempio src_instance, src_vpc.project_id.

• IP_RANGE: l'intervallo di indirizzi IP interni principali della subnet.

• NETWORK_URL: l'URL della rete Virtual Private Cloud dove verrà creata la subnet.

• SUBNET_NAME: un nome per la subnet.

Per ulteriori informazioni, consulta il metodo subnetworks.insert.

Terraform

Puoi utilizzare un modulo Terraform per creare una rete VPC e subnet in modalità personalizzata.

L'esempio seguente crea tre sottoreti come segue:

• subnet-01 ha i log di flusso VPC disabilitati. Quando crei una subnet, i log di flusso VPC sono disabilitati, a meno che tu non li abiliti esplicitamente.
• subnet-02 ha i log di flusso VPC abilitati con le impostazioni predefinite dei log di flusso.
• subnet-03 ha attivato i log di flusso VPC con alcune impostazioni personalizzate.

module "test-vpc-module" {
  source       = "terraform-google-modules/network/google"
  version      = "~> 10.0"
  project_id   = var.project_id # Replace this with your project ID in quotes
  network_name = "my-custom-mode-network"
  mtu          = 1460

  subnets = [
    {
      subnet_name   = "subnet-01"
      subnet_ip     = "10.10.10.0/24"
      subnet_region = "us-west1"
    },
    {
      subnet_name           = "subnet-02"
      subnet_ip             = "10.10.20.0/24"
      subnet_region         = "us-west1"
      subnet_private_access = "true"
      subnet_flow_logs      = "true"
    },
    {
      subnet_name               = "subnet-03"
      subnet_ip                 = "10.10.30.0/24"
      subnet_region             = "us-west1"
      subnet_flow_logs          = "true"
      subnet_flow_logs_interval = "INTERVAL_10_MIN"
      subnet_flow_logs_sampling = 0.7
      subnet_flow_logs_metadata = "INCLUDE_ALL_METADATA"
      subnet_flow_logs_filter   = "false"
    }
  ]
}

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Console

1. Nella console Trusted Cloud , vai alla pagina Reti VPC.

   Vai a Reti VPC

2. Fai clic sulla sottorete che vuoi aggiornare.

3. Fai clic su Modifica.

4. Per Log di flusso, seleziona On.

5. (Facoltativo) Modifica l'Intervallo di aggregazione e una delle seguenti impostazioni nella sezione Impostazioni avanzate:

   • Se configurare il filtro dei log. Per impostazione predefinita, l'opzione Conserva solo i log che corrispondono a un filtro non è selezionata.
   • Indica se includere i metadati nelle voci di log finali. Per impostazione predefinita, Annotazioni metadati include tutti i campi.
   • La frequenza di campionamento secondaria. 50% indica che viene conservata la metà delle voci generate dal processo di campionamento primario dei log di flusso. La frequenza di campionamento del log di flusso principale non è configurabile. Per saperne di più, consulta Campionamento e elaborazione dei log.

6. Fai clic su Salva.

gcloud

Esegui questo comando:

gcloud compute networks subnets update SUBNET_NAME \
    --enable-flow-logs \
    [--logging-aggregation-interval=AGGREGATION_INTERVAL] \
    [--logging-flow-sampling=SAMPLING_RATE] \
    [--logging-filter-expr=FILTER_EXPRESSION] \
    [--logging-metadata=LOGGING_METADATA] \
    [--logging-metadata-fields=METADATA_FIELDS] \
    [other flags as needed]

Sostituisci quanto segue:

• AGGREGATION_INTERVAL: l'intervallo di aggregazione per i log di flusso nella subnet. L'intervallo può essere impostato su una delle seguenti opzioni: 5 secondi (impostazione predefinita), 30 secondi, 1 minuto, 5 minuti, 10 minuti o 15 minuti.
• SAMPLING_RATE: la frequenza di campionamento del flusso secondario. Il campionamento dei flussi secondari può essere impostato da 0.0 (nessun campionamento) a 1.0 (tutti i log). Il valore predefinito è 0.5. Per saperne di più, consulta Campionamento e elaborazione dei log.
• FILTER_EXPRESSION: un'espressione che definisce i log da conservare. L'espressione ha un limite di 2048 caratteri. Per maggiori dettagli, consulta la sezione Filtro dei log.

• LOGGING_METADATA: le annotazioni dei metadati che vuoi includere nei log:

  • Utilizza include-all per includere tutte le annotazioni dei metadati.
  • Utilizza exclude-all per escludere tutte le annotazioni dei metadati (valore predefinito).
  • Utilizza custom per includere un elenco personalizzato di campi di metadati specificati in METADATA_FIELDS.

• METADATA_FIELDS: un elenco separato da virgole dei campi dei metadati da includere nei log. Ad esempio, src_instance,dst_instance. Può essere impostato solo se LOGGING_METADATA è impostato su custom.

API

Abilita i log di flusso VPC per una subnet esistente.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME
{
  "logConfig": {
    "enable": true
    ...other logging fields.
  },
  "fingerprint": "SUBNET_FINGERPRINT"
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto in cui si trova la subnet.
• REGION: la regione in cui si trova la subnet.
• SUBNET_NAME: il nome della subnet esistente.
• SUBNET_FINGERPRINT: l'ID impronta della subnet esistente, fornito quando descrivi una subnet.
• Per gli altri campi di registrazione, consulta Attivare i log di flusso VPC quando crei una subnet.

Per ulteriori informazioni, consulta il metodo subnetworks.patch.

Console

1. Nella Trusted Cloud console, vai alla pagina Interconnessione.

   Vai a Interconnessione

2. Nella scheda Collegamenti VLAN, seleziona uno o più collegamenti VLAN, quindi fai clic su menuGestisci log di flusso nella barra di selezione nella parte superiore dell'elenco.

3. In menuGestisci log flusso, fai clic su Aggiungi nuova configurazione.

4. In Nome, inserisci un nome per la nuova configurazione dei log di flusso VPC.

5. (Facoltativo) Modifica l'Intervallo di aggregazione e le impostazioni nella sezione Impostazioni avanzate:

   • Se configurare il filtro dei log. Per impostazione predefinita, l'opzione Conserva solo i log che corrispondono a un filtro non è selezionata.
   • Indica se includere i metadati nelle voci di log finali. Per impostazione predefinita, Annotazioni metadati include tutti i campi.
   • La frequenza di campionamento secondaria. 100% indica che tutte le voci generate dal processo di campionamento dei log di flusso principale vengono conservate. La frequenza di campionamento del log di flusso principale non è configurabile. Per saperne di più, consulta Campionamento e elaborazione dei log.

6. Fai clic su Salva.

gcloud

Per attivare i log di flusso VPC per un collegamento VLAN, utilizza il comando gcloud network-management vpc-flow-logs-configs create.

Puoi attivare i log di flusso VPC creando una configurazione dei log di flusso VPC. Puoi creare la configurazione con tutti i relativi parametri impostati sui valori predefiniti oppure puoi personalizzare i valori predefiniti.

In gcloud CLI, imposta il progetto sull'Trusted Cloud ID progetto del collegamento VLAN ed esegui uno dei seguenti comandi:

• Per creare una configurazione predefinita dei log di flusso VPC, esegui il seguente comando:

  gcloud network-management vpc-flow-logs-configs create CONFIG_NAME \
      --location=global \
      --interconnect-attachment=VLAN_ATTACHMENT
  

• Per creare una configurazione personalizzata dei log di flusso VPC, specifica ogni parametro che vuoi personalizzare.

  Ad esempio, per personalizzare l'intervallo di aggregazione, il filtro, la frequenza di campionamento secondaria e i parametri dei metadati quando crei una configurazione dei log di flusso VPC, esegui il seguente comando:

  gcloud network-management vpc-flow-logs-configs create CONFIG_NAME \
      --location=global \
      --interconnect-attachment=VLAN_ATTACHMENT \
      --aggregation-interval=AGGREGATION_INTERVAL \
      --filter-expr=FILTER_EXPRESSION \
      --flow-sampling=SAMPLING_RATE \
      --metadata=LOGGING_METADATA
  

  Sostituisci quanto segue:

  • CONFIG_NAME: un nome per la configurazione.
  • VLAN_ATTACHMENT: il collegamento VLAN che vuoi registrare. Deve essere specificato nel seguente formato: projects/PROJECT_ID/regions/REGION/interconnectAttachments/NAME, dove:
    • PROJECT_ID è l'ID del Trusted Cloud progetto contenente il collegamento VLAN. La configurazione deve essere creata in questo progetto.
    • REGION è la regione del collegamento VLAN.
    • NAME è il nome del collegamento VLAN.

  Per impostare i parametri facoltativi in una configurazione personalizzata, sostituire quanto segue:

  • AGGREGATION_INTERVAL: l'intervallo di aggregazione per i log di flusso generati da questa configurazione. Questo parametro può essere impostato su interval-5-sec(valore predefinito), interval-30-sec, interval-1-min, interval-5-min,interval-10-min o interval-15-min.
  • FILTER_EXPRESSION: un'espressione che definisce i log da conservare. L'espressione ha un limite di 2048 caratteri. Per ulteriori informazioni, consulta la sezione Filtro dei log.
  • SAMPLING_RATE: la frequenza di campionamento del flusso secondario. Questo parametro può essere impostato su un valore maggiore di 0.0 e minore di 1.0 (tutti i log, predefinito). Per ulteriori informazioni, consulta Campionamento e elaborazione dei log.
  • LOGGING_METADATA: le annotazioni dei metadati da includere nei log:
    • Utilizza include-all-metadata per includere tutte le annotazioni dei metadati (impostazione predefinita).
    • Utilizza exclude-all-metadata per escludere tutte le annotazioni dei metadati.
    • Utilizza custom-metadata per includere un elenco personalizzato di campi di metadati. Per specificare i campi dei metadati, utilizza il flag --metadata-fields:
      • --metadata-fields=METADATA_FIELDS: sostituisci METADATA_FIELDS con un elenco separato da virgole dei campi dei metadati che vuoi includere nei log. Ad esempio: src_instance,dst_instance. Può essere impostato solo se metadata è impostato su custom-metadata.

Terraform

Puoi utilizzare un modulo Terraform per creare una configurazione dei log di flusso VPC per un collegamento VLAN.

Il seguente blocco di codice crea una configurazione predefinita dei log di flusso VPC.

resource "google_network_management_vpc_flow_logs_config" "vpc_flow_logs_config" {
  vpc_flow_logs_config_id = "vpcflowlogs-config"
  location                = "global"
  interconnect_attachment = google_compute_interconnect_attachment.attachment.id
}

L'esempio precedente presuppone che il nome della risorsa google_compute_interconnect_attachment sia attachment. Per un esempio completo di questa configurazione, consulta il repository terraform-docs-samples.

Il seguente blocco di codice crea una configurazione dei log di flusso VPC dove:

• L'intervallo di aggregazione è impostato su INTERVAL_10_MIN.
• La frequenza di campionamento dei flussi secondari è impostata su 0.7.
• I metadati da includere nei log sono impostati su INCLUDE_ALL_METADATA.
• Lo stato di configurazione sia impostato su ENABLED.

resource "google_network_management_vpc_flow_logs_config" "vpc_flow_logs_config" {
  vpc_flow_logs_config_id = "vpcflowlogs-config"
  location                = "global"
  interconnect_attachment = google_compute_interconnect_attachment.attachment.id
  aggregation_interval    = "INTERVAL_10_MIN"
  description             = "VPC Flow Logs over an Interconnect Attachment."
  flow_sampling           = 0.7
  metadata                = "INCLUDE_ALL_METADATA"
  state                   = "ENABLED"
}

L'esempio precedente presuppone che il nome della risorsa google_compute_interconnect_attachment sia attachment. Per un esempio completo di questa configurazione, consulta il repository terraform-docs-samples.

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

API

Per attivare i log di flusso VPC per un collegamento VLAN, utilizza il metodo projects.locations.vpcFlowLogsConfigs.create.

Puoi attivare i log di flusso VPC creando una configurazione dei log di flusso VPC. Puoi creare la configurazione con tutti i parametri impostati sui valori predefiniti oppure puoi personalizzare i valori predefiniti.

Per creare una configurazione predefinita dei log di flusso VPC, includi i seguenti parametri nella richiesta API:

POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
{
  "interconnectAttachment": "VLAN_ATTACHMENT"
}

Per creare una configurazione personalizzata dei log di flusso VPC, specifica ogni parametro che vuoi personalizzare.

Ad esempio, per personalizzare l'intervallo di aggregazione, i filtri, la frequenza di campionamento secondaria e i parametri dei metadati durante la creazione di una configurazione dei log di flusso VPC, includi i seguenti parametri nella richiesta API:

POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
{
  "interconnectAttachment": "VLAN_ATTACHMENT",
  "aggregationInterval": "AGGREGATION_INTERVAL",
  "filterExpr": "FILTER_EXPRESSION",
  "flowSampling": SAMPLING_RATE,
  "metadata": "LOGGING_METADATA"
}

Sostituisci quanto segue:

• PROJECT_ID: Trusted Cloud l'ID progetto del collegamento VLAN.
• CONFIG_NAME: un nome per la configurazione.
• VLAN_ATTACHMENT: il collegamento VLAN che vuoi registrare. Deve essere specificato nel seguente formato: projects/PROJECT_ID/regions/REGION/interconnectAttachments/NAME, dove:
  • PROJECT_ID è l'ID progetto del collegamento VLAN.
  • REGION è la regione del collegamento VLAN.
  • NAME è il nome del collegamento VLAN.

• AGGREGATION_INTERVAL: l'intervallo di aggregazione per i log di flusso generati da questa configurazione. Questo parametro può essere impostato su INTERVAL_5_SEC (valore predefinito), INTERVAL_30_SEC, INTERVAL_1_MIN, INTERVAL_5_MIN, INTERVAL_10_MIN o INTERVAL_15_MIN.
• FILTER_EXPRESSION: un'espressione che definisce i log da conservare. L'espressione ha un limite di 2048 caratteri. Per ulteriori informazioni, consulta la sezione Filtro dei log.
• SAMPLING_RATE: la frequenza di campionamento del flusso secondario. Questo parametro può essere impostato su un valore maggiore di 0.0 e fino a 1.0 (tutti i log, predefinito). Per ulteriori informazioni, consulta Campionamento e elaborazione dei log.
• LOGGING_METADATA: le annotazioni dei metadati da includere nei log:
  • Utilizza INCLUDE_ALL_METADATA per includere tutte le annotazioni dei metadati (impostazione predefinita).
  • Utilizza EXCLUDE_ALL_METADATA per escludere tutte le annotazioni dei metadati.
  • Utilizza CUSTOM_METADATA per includere un elenco personalizzato di campi di metadati. Per specificare i campi dei metadati, utilizza il parametro metadataFields:
    • metadataFields: METADATA_FIELDS: sostituisci METADATA_FIELDS con un elenco separato da virgole dei campi dei metadati che vuoi includere nei log. Ad esempio, src_instance,dst_instance. Può essere impostato solo se metadata è impostato su CUSTOM_METADATA.

Console

1. Nella Trusted Cloud console, vai alla pagina VPN.

   Vai a VPN

2. Nella scheda Tunnel VPN cloud, seleziona uno o più tunnel Cloud VPN, quindi fai clic su menuGestisci log di flusso nella barra di selezione nella parte superiore dell'elenco.

3. In menuGestisci log flusso, fai clic su Aggiungi nuova configurazione.

4. In Nome, inserisci un nome per la nuova configurazione dei log di flusso VPC.

5. (Facoltativo) Modifica l'Intervallo di aggregazione e le impostazioni nella sezione Impostazioni avanzate:

   • Se configurare il filtro dei log. Per impostazione predefinita, l'opzione Conserva solo i log che corrispondono a un filtro non è selezionata.
   • Indica se includere i metadati nelle voci di log finali. Per impostazione predefinita, Annotazioni metadati include tutti i campi.
   • La frequenza di campionamento secondaria. 100% indica che tutte le voci generate dal processo di campionamento dei log di flusso principale vengono conservate. La frequenza di campionamento del log di flusso principale non è configurabile. Per saperne di più, consulta Campionamento e elaborazione dei log.

6. Fai clic su Salva.

gcloud

Per attivare i log di flusso VPC per un tunnel Cloud VPN, utilizza il comando gcloud network-management vpc-flow-logs-configs create.

Puoi attivare i log di flusso VPC creando una configurazione dei log di flusso VPC. Puoi creare la configurazione con tutti i parametri impostati sui valori predefiniti oppure puoi personalizzare i valori predefiniti.

Nella gcloud CLI, imposta il progetto sull'Trusted Cloud ID progetto del tunnel Cloud VPN ed esegui uno dei seguenti comandi:

• Per creare una configurazione predefinita dei log di flusso VPC, esegui il seguente comando:

  gcloud network-management vpc-flow-logs-configs create CONFIG_NAME \
      --location=global \
      --vpn-tunnel=VPN_TUNNEL
  

• Per creare una configurazione personalizzata dei log di flusso VPC, specifica ogni parametro che vuoi personalizzare.

  Ad esempio, per personalizzare l'intervallo di aggregazione, il filtro, la frequenza di campionamento secondaria e i parametri dei metadati quando crei una configurazione dei log di flusso VPC, esegui il seguente comando:

  gcloud network-management vpc-flow-logs-configs create CONFIG_NAME \
      --location=global \
      --vpn-tunnel=VPN_TUNNEL \
      --aggregation-interval=AGGREGATION_INTERVAL \
      --filter-expr=FILTER_EXPRESSION \
      --flow-sampling=SAMPLING_RATE \
      --metadata=LOGGING_METADATA
  

  Sostituisci quanto segue:

  • CONFIG_NAME: un nome per la configurazione.
  • VPN_TUNNEL: il tunnel Cloud VPN di cui vuoi registrare i log. Deve essere specificato nel seguente formato: projects/PROJECT_ID/regions/REGION/vpnTunnels/NAME, dove:
    • PROJECT_ID è l'ID del progetto Trusted Cloud che contiene il tunnel Cloud VPN. La configurazione deve essere creata in questo progetto.
    • REGION è la regione del tunnel Cloud VPN.
    • NAME è il nome del tunnel Cloud VPN.

  Per impostare i parametri facoltativi in una configurazione personalizzata, sostituire quanto segue:

  • AGGREGATION_INTERVAL: l'intervallo di aggregazione per i log di flusso generati da questa configurazione. Questo parametro può essere impostato su interval-5-sec(valore predefinito), interval-30-sec, interval-1-min, interval-5-min,interval-10-min o interval-15-min.
  • FILTER_EXPRESSION: un'espressione che definisce i log da conservare. L'espressione ha un limite di 2048 caratteri. Per ulteriori informazioni, consulta la sezione Filtro dei log.
  • SAMPLING_RATE: la frequenza di campionamento del flusso secondario. Questo parametro può essere impostato su un valore maggiore di 0.0 e minore di 1.0 (tutti i log, predefinito). Per ulteriori informazioni, consulta Campionamento e elaborazione dei log.
  • LOGGING_METADATA: le annotazioni dei metadati da includere nei log:
    • Utilizza include-all-metadata per includere tutte le annotazioni dei metadati (impostazione predefinita).
    • Utilizza exclude-all-metadata per escludere tutte le annotazioni dei metadati.
    • Utilizza custom-metadata per includere un elenco personalizzato di campi di metadati. Per specificare i campi dei metadati, utilizza il flag --metadata-fields:
      • --metadata-fields=METADATA_FIELDS: sostituisci METADATA_FIELDS con un elenco separato da virgole dei campi dei metadati che vuoi includere nei log. Ad esempio: src_instance,dst_instance. Può essere impostato solo se metadata è impostato su custom-metadata.

Terraform

Puoi utilizzare un modulo Terraform per creare una configurazione dei log di flusso VPC per un tunnel Cloud VPN.

Il seguente blocco di codice crea una configurazione predefinita dei log di flusso VPC.

resource "google_network_management_vpc_flow_logs_config" "vpc_flow_logs_config" {
  vpc_flow_logs_config_id = "vpcflowlogs-config"
  location                = "global"
  vpn_tunnel              = google_compute_vpn_tunnel.tunnel.id
}

L'esempio precedente presuppone che il nome della risorsa google_compute_vpn_tunnel sia tunnel. Per un esempio completo di questa configurazione, consulta il repository terraform-docs-samples.

Il seguente blocco di codice crea una configurazione dei log di flusso VPC dove:

• L'intervallo di aggregazione è impostato su INTERVAL_10_MIN.
• La frequenza di campionamento dei flussi secondari è impostata su 0.7.
• I metadati da includere nei log sono impostati su INCLUDE_ALL_METADATA.
• Lo stato di configurazione sia impostato su ENABLED.

resource "google_network_management_vpc_flow_logs_config" "vpc_flow_logs_config" {
  vpc_flow_logs_config_id = "vpcflowlogs-config"
  location                = "global"
  vpn_tunnel              = google_compute_vpn_tunnel.tunnel.id
  aggregation_interval    = "INTERVAL_10_MIN"
  description             = "VPC Flow Logs over a VPN Gateway."
  flow_sampling           = 0.7
  metadata                = "INCLUDE_ALL_METADATA"
  state                   = "ENABLED"
}

L'esempio precedente presuppone che il nome della risorsa google_compute_vpn_tunnel sia tunnel. Per un esempio completo di questa configurazione, consulta il repository terraform-docs-samples.

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

API

Per abilitare i log di flusso VPC per un tunnel Cloud VPN, utilizza il metodo projects.locations.vpcFlowLogsConfigs.create.

Puoi attivare i log di flusso VPC creando una configurazione dei log di flusso VPC. Puoi creare la configurazione con tutti i parametri impostati sui valori predefiniti oppure puoi personalizzare i valori predefiniti.

Per creare una configurazione predefinita dei log di flusso VPC, includi i seguenti parametri nella richiesta API:

POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
{
  "vpnTunnel": "VPN_TUNNEL"
}

Per creare una configurazione personalizzata dei log di flusso VPC, specifica ogni parametro che vuoi personalizzare.

Ad esempio, per personalizzare l'intervallo di aggregazione, il filtro, la frequenza di campionamento secondaria e i parametri dei metadati durante la creazione di una configurazione dei log di flusso VPC, includi i seguenti parametri nella richiesta API:

POST https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
{
  "vpnTunnel": "VPN_TUNNEL",
  "aggregationInterval": "AGGREGATION_INTERVAL",
  "filterExpr": "FILTER_EXPRESSION",
  "flowSampling": SAMPLING_RATE,
  "metadata": "LOGGING_METADATA"
}

Sostituisci quanto segue:

• PROJECT_ID: l' Trusted Cloud ID progetto del tunnel Cloud VPN.
• CONFIG_NAME: un nome per la configurazione.
• VPN_TUNNEL: il tunnel Cloud VPN di cui vuoi registrare i log. Deve essere specificato nel seguente formato: projects/PROJECT_ID/regions/REGION/vpnTunnels/NAME, dove:
  • PROJECT_ID è l'ID del progetto del tunnel Cloud VPN.
  • REGION è la regione del tunnel Cloud VPN.
  • NAME è il nome del tunnel Cloud VPN.

• AGGREGATION_INTERVAL: l'intervallo di aggregazione per i log di flusso generati da questa configurazione. Questo parametro può essere impostato su INTERVAL_5_SEC (valore predefinito), INTERVAL_30_SEC, INTERVAL_1_MIN, INTERVAL_5_MIN, INTERVAL_10_MIN o INTERVAL_15_MIN.
• FILTER_EXPRESSION: un'espressione che definisce i log da conservare. L'espressione ha un limite di 2048 caratteri. Per ulteriori informazioni, consulta la sezione Filtro dei log.
• SAMPLING_RATE: la frequenza di campionamento del flusso secondario. Questo parametro può essere impostato su un valore maggiore di 0.0 e minore di 1.0 (tutti i log, valore predefinito). Per ulteriori informazioni, consulta Campionamento e elaborazione dei log.
• LOGGING_METADATA: le annotazioni dei metadati da includere nei log:
  • Utilizza INCLUDE_ALL_METADATA per includere tutte le annotazioni dei metadati (impostazione predefinita).
  • Utilizza EXCLUDE_ALL_METADATA per escludere tutte le annotazioni dei metadati.
  • Utilizza CUSTOM_METADATA per includere un elenco personalizzato di campi di metadati. Per specificare i campi dei metadati, utilizza il parametro metadataFields:
    • metadataFields: METADATA_FIELDS: sostituisci METADATA_FIELDS con un elenco separato da virgole dei campi dei metadati che vuoi includere nei log. Ad esempio, src_instance,dst_instance. Può essere impostato solo se metadata è impostato su CUSTOM_METADATA.

Console

1. Nella console Trusted Cloud , vai alla pagina Reti VPC.

   Vai a Reti VPC

2. Nella scheda Reti nel progetto corrente, seleziona una o più reti, quindi fai clic su menuGestisci log di flusso nella parte superiore dell'elenco.

3. In menuGestisci log flusso, fai clic su Aggiungi nuova configurazione.

4. In Nome, inserisci un nome per la nuova configurazione dei log di flusso VPC.

5. (Facoltativo) Modifica l'Intervallo di aggregazione e le impostazioni nella sezione Impostazioni avanzate:

   • Se configurare il filtro dei log. Per impostazione predefinita, l'opzione Conserva solo i log che corrispondono a un filtro non è selezionata.
   • Indica se includere i metadati nelle voci di log finali. Per impostazione predefinita, Annotazioni metadati include tutti i campi.
   • La frequenza di campionamento secondaria. 100% indica che tutte le voci generate dal processo di campionamento dei log di flusso principale vengono conservate. La frequenza di campionamento del log di flusso principale non è configurabile. Per saperne di più, consulta Campionamento e elaborazione dei log.

6. Fai clic su Salva.

gcloud

Per attivare i log di flusso VPC per una rete VPC, utilizza il comando gcloud beta network-management vpc-flow-logs-configs create.

Puoi attivare i log di flusso VPC creando una configurazione dei log di flusso VPC. Puoi creare la configurazione con tutti i relativi parametri impostati sui valori predefiniti oppure puoi personalizzare i valori predefiniti.

In gcloud CLI, imposta il progetto sull'Trusted Cloud ID progetto della rete VPC ed esegui uno dei seguenti comandi:

• Per creare una configurazione predefinita dei log di flusso VPC, esegui il seguente comando:

  gcloud beta network-management vpc-flow-logs-configs create CONFIG_NAME \
      --location=global \
      --network=NETWORK
  

• Per creare una configurazione personalizzata dei log di flusso VPC, specifica ogni parametro che vuoi personalizzare.

  Ad esempio, per personalizzare l'intervallo di aggregazione, il filtro, la frequenza di campionamento secondaria e i parametri dei metadati quando crei una configurazione dei log di flusso VPC, esegui il seguente comando:

  gcloud beta network-management vpc-flow-logs-configs create CONFIG_NAME \
      --location=global \
      --network=NETWORK \
      --aggregation-interval=AGGREGATION_INTERVAL \
      --filter-expr=FILTER_EXPRESSION \
      --flow-sampling=SAMPLING_RATE \
      --metadata=LOGGING_METADATA
  

  Sostituisci quanto segue:

  • CONFIG_NAME: un nome per la configurazione.
  • NETWORK: la rete VPC di cui vuoi registrare i dati. Deve essere specificato nel seguente formato: projects/PROJECT_ID/global/networks/NAME, dove:
    • PROJECT_ID è l'ID del progetto Trusted Cloud che contiene la rete VPC. La configurazione deve essere creata in questo progetto.
    • NAME è il nome della rete VPC.

  Per impostare i parametri facoltativi in una configurazione personalizzata, sostituire quanto segue:

  • AGGREGATION_INTERVAL: l'intervallo di aggregazione per i log di flusso generati da questa configurazione. Questo parametro può essere impostato su interval-5-sec(valore predefinito), interval-30-sec, interval-1-min, interval-5-min,interval-10-min o interval-15-min.
  • FILTER_EXPRESSION: un'espressione che definisce i log da conservare. L'espressione ha un limite di 2048 caratteri. Per ulteriori informazioni, consulta la sezione Filtro dei log.
  • SAMPLING_RATE: la frequenza di campionamento del flusso secondario. Questo parametro può essere impostato su un valore maggiore di 0.0 e fino a 1.0 (tutti i log, predefinito). Per ulteriori informazioni, consulta Campionamento e elaborazione dei log.
  • LOGGING_METADATA: le annotazioni dei metadati da includere nei log:
    • Utilizza include-all-metadata per includere tutte le annotazioni dei metadati (impostazione predefinita).
    • Utilizza exclude-all-metadata per escludere tutte le annotazioni dei metadati.
    • Utilizza custom-metadata per includere un elenco personalizzato di campi di metadati. Per specificare i campi dei metadati, utilizza il flag --metadata-fields:
      • --metadata-fields=METADATA_FIELDS: sostituisci METADATA_FIELDS con un elenco separato da virgole dei campi dei metadati che vuoi includere nei log. Ad esempio: src_instance,dst_instance. Può essere impostato solo se metadata è impostato su custom-metadata.

API

Per attivare i log di flusso VPC per una rete VPC, utilizza il metodo projects.locations.vpcFlowLogsConfigs.create.

Puoi attivare i log di flusso VPC creando una configurazione dei log di flusso VPC. Puoi creare la configurazione con tutti i parametri impostati sui valori predefiniti oppure puoi personalizzare i valori predefiniti.

Per creare una configurazione predefinita dei log di flusso VPC, includi i seguenti parametri nella richiesta API:

POST https://networkmanagement.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
{
  "network": "NETWORK"
}

Per creare una configurazione personalizzata dei log di flusso VPC, specifica ogni parametro che vuoi personalizzare.

Ad esempio, per personalizzare l'intervallo di aggregazione, i filtri, la frequenza di campionamento secondaria e i parametri dei metadati durante la creazione di una configurazione dei log di flusso VPC, includi i seguenti parametri nella richiesta API:

POST https://networkmanagement.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
{
  "network": "NETWORK",
  "aggregationInterval": "AGGREGATION_INTERVAL",
  "filterExpr": "FILTER_EXPRESSION",
  "flowSampling": SAMPLING_RATE,
  "metadata": "LOGGING_METADATA"
}

Sostituisci quanto segue:

• PROJECT_ID: l' Trusted Cloud ID progetto della rete VPC.
• CONFIG_NAME: un nome per la configurazione.
• NETWORK: la rete VPC di cui vuoi registrare i log. Deve essere specificato nel seguente formato: projects/PROJECT_ID/global/networks/NAME, dove:
  • PROJECT_ID è l'ID progetto della rete VPC.
  • NAME è il nome della rete VPC.

• AGGREGATION_INTERVAL: l'intervallo di aggregazione per i log di flusso generati da questa configurazione. Questo parametro può essere impostato su INTERVAL_5_SEC (valore predefinito), INTERVAL_30_SEC, INTERVAL_1_MIN, INTERVAL_5_MIN, INTERVAL_10_MIN o INTERVAL_15_MIN.
• FILTER_EXPRESSION: un'espressione che definisce i log da conservare. L'espressione ha un limite di 2048 caratteri. Per ulteriori informazioni, consulta la sezione Filtro dei log.
• SAMPLING_RATE: la frequenza di campionamento del flusso secondario. Questo parametro può essere impostato su un valore maggiore di 0.0 e minore di 1.0 (tutti i log, predefinito). Per ulteriori informazioni, consulta Campionamento e elaborazione dei log.
• LOGGING_METADATA: le annotazioni dei metadati da includere nei log:
  • Utilizza INCLUDE_ALL_METADATA per includere tutte le annotazioni dei metadati (impostazione predefinita).
  • Utilizza EXCLUDE_ALL_METADATA per escludere tutte le annotazioni dei metadati.
  • Utilizza CUSTOM_METADATA per includere un elenco personalizzato di campi di metadati. Per specificare i campi dei metadati, utilizza il parametro metadataFields:
    • metadataFields: METADATA_FIELDS: sostituisci METADATA_FIELDS con un elenco separato da virgole dei campi dei metadati che vuoi includere nei log. Ad esempio, src_instance,dst_instance. Può essere impostato solo se metadata è impostato su CUSTOM_METADATA.

Console

1. Nella Trusted Cloud console, vai alla pagina Log di flusso VPC.

   Vai a Log di flusso VPC

2. Fai clic su Aggiungi configurazione dei log di flusso VPC e poi su Aggiungi una configurazione per l'organizzazione.

3. In Nome, inserisci un nome per la nuova configurazione dei log di flusso VPC.

4. (Facoltativo) Modifica l'Intervallo di aggregazione e le impostazioni nella sezione Impostazioni avanzate:

   • Se configurare il filtro dei log. Per impostazione predefinita, l'opzione Conserva solo i log che corrispondono a un filtro non è selezionata.
   • Indica se includere le annotazioni tra progetti. Per impostazione predefinita, è selezionata l'opzione Annotazioni dei metadati tra progetti. Per ulteriori informazioni, consulta la sezione Annotazioni tra progetti.
   • Indica se includere i metadati nelle voci di log finali. Per impostazione predefinita, Annotazioni metadati include tutti i campi.
   • La frequenza di campionamento secondaria. 100% indica che tutte le voci generate dal processo di campionamento dei log di flusso principale vengono conservate. La frequenza di campionamento del log di flusso principale non è configurabile. Per saperne di più, consulta Campionamento e elaborazione dei log.

5. Fai clic su Salva.

gcloud

Per attivare i log di flusso VPC per un'organizzazione, utilizza il comando gcloud beta network-management vpc-flow-logs-configs create.

Puoi attivare i log di flusso VPC creando una configurazione dei log di flusso VPC. Puoi creare la configurazione con tutti i parametri impostati sui valori predefiniti oppure puoi personalizzare i valori predefiniti.

• Per creare una configurazione predefinita dei log di flusso VPC, esegui il seguente comando:

  gcloud beta network-management vpc-flow-logs-configs create CONFIG_NAME \
      --location=global \
      --organization=ORGANIZATION
  

• Per creare una configurazione personalizzata dei log di flusso VPC, specifica ogni parametro che vuoi personalizzare.

  Ad esempio, per personalizzare l'intervallo di aggregazione, il filtro, la frequenza di campionamento secondaria e i parametri dei metadati quando crei una configurazione dei log di flusso VPC, esegui il seguente comando:

  gcloud beta network-management vpc-flow-logs-configs create CONFIG_NAME \
      --location=global \
      --organization=ORGANIZATION \
      --aggregation-interval=AGGREGATION_INTERVAL \
      --filter-expr=FILTER_EXPRESSION \
      --flow-sampling=SAMPLING_RATE \
      --metadata=LOGGING_METADATA \
      --cross-project-metadata=CROSS_PROJECT_METADATA
  

  Sostituisci quanto segue:

  • CONFIG_NAME: un nome per la configurazione
  • ORGANIZATION: l'ID dell'organizzazione

  Per impostare i parametri facoltativi in una configurazione personalizzata, sostituire quanto segue:

  • AGGREGATION_INTERVAL: l'intervallo di aggregazione per i log di flusso generati da questa configurazione. Questo parametro può essere impostato su interval-5-sec(valore predefinito), interval-30-sec, interval-1-min, interval-5-min,interval-10-min o interval-15-min.
  • FILTER_EXPRESSION: un'espressione che definisce i log da conservare. L'espressione ha un limite di 2048 caratteri. Per ulteriori informazioni, consulta la sezione Filtro dei log.
  • SAMPLING_RATE: la frequenza di campionamento del flusso secondario. Questo parametro può essere impostato su un valore maggiore di 0.0 e minore di 1.0 (tutti i log, predefinito). Per ulteriori informazioni, consulta Campionamento e elaborazione dei log.
  • LOGGING_METADATA: le annotazioni dei metadati da includere nei log:
    • Utilizza include-all-metadata per includere tutte le annotazioni dei metadati (impostazione predefinita).
    • Utilizza exclude-all-metadata per escludere tutte le annotazioni dei metadati.
    • Utilizza custom-metadata per includere un elenco personalizzato di campi di metadati. Per specificare i campi dei metadati, utilizza il flag --metadata-fields:
      • --metadata-fields=METADATA_FIELDS: sostituisci METADATA_FIELDS con un elenco separato da virgole dei campi dei metadati che vuoi includere nei log. Ad esempio, src_instance,dst_instance. Può essere impostato solo se metadata è impostato su custom-metadata.
  • CROSS_PROJECT_METADATA: annotazioni tra progetti. Può essere impostato su cross-project-metadata-enabled (predefinito) o cross-project-metadata-disabled. Per ulteriori informazioni, consulta Annotazioni tra progetti.

API

Per attivare i log di flusso VPC per un'organizzazione, utilizza il metodo organizations.locations.vpcFlowLogsConfigs.create.

Puoi attivare i log di flusso VPC creando una configurazione dei log di flusso VPC. Puoi creare la configurazione con tutti i relativi parametri impostati sui valori predefiniti oppure puoi personalizzare i valori predefiniti.

Per creare una configurazione predefinita dei log di flusso VPC, includi i seguenti parametri nella richiesta API:

POST -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME

Per creare una configurazione personalizzata dei log di flusso VPC, specifica ogni parametro che vuoi personalizzare.

Ad esempio, per personalizzare l'intervallo di aggregazione, i filtri, la frequenza di campionamento secondaria e i parametri dei metadati durante la creazione di una configurazione dei log di flusso VPC, includi i seguenti parametri nella richiesta API:

POST -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs?vpc_flow_logs_config_id=CONFIG_NAME
{
  "aggregationInterval": "AGGREGATION_INTERVAL",
  "filterExpr": "FILTER_EXPRESSION",
  "flowSampling": SAMPLING_RATE,
  "metadata": "LOGGING_METADATA",
  "crossProjectMetadata": "CROSS_PROJECT_METADATA"
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto quota. Le richieste API vengono conteggiate per questo progetto. Il valore della quota per l'API Network Management è impostato su 1200 richieste al minuto sia per la quota a livello di progetto sia per quella a livello di organizzazione.
• ORGANIZATION_ID: l'ID dell'organizzazione.
• CONFIG_NAME: un nome per la configurazione.

• AGGREGATION_INTERVAL: l'intervallo di aggregazione per i log di flusso generati da questa configurazione. Questo parametro può essere impostato su INTERVAL_5_SEC (valore predefinito), INTERVAL_30_SEC, INTERVAL_1_MIN, INTERVAL_5_MIN, INTERVAL_10_MIN o INTERVAL_15_MIN.
• FILTER_EXPRESSION: un'espressione che definisce i log da conservare. L'espressione ha un limite di 2048 caratteri. Per ulteriori informazioni, consulta la sezione Filtro dei log.
• SAMPLING_RATE: la frequenza di campionamento del flusso secondario. Questo parametro può essere impostato su un valore maggiore di 0.0 e fino a 1.0 (tutti i log, predefinito). Per ulteriori informazioni, consulta Campionamento e elaborazione dei log.
• LOGGING_METADATA: le annotazioni dei metadati da includere nei log:
  • Utilizza INCLUDE_ALL_METADATA per includere tutte le annotazioni dei metadati (impostazione predefinita).
  • Utilizza EXCLUDE_ALL_METADATA per escludere tutte le annotazioni dei metadati.
  • Utilizza CUSTOM_METADATA per includere un elenco personalizzato di campi di metadati. Per specificare i campi dei metadati, utilizza il parametro metadataFields:
    • metadataFields: METADATA_FIELDS: sostituisci METADATA_FIELDS con un elenco separato da virgole dei campi dei metadati che vuoi includere nei log. Ad esempio, src_instance,dst_instance. Può essere impostato solo se metadata è impostato su CUSTOM_METADATA.

• CROSS_PROJECT_METADATA: annotazione tra progetti. Può essere impostato su CROSS_PROJECT_METADATA_ENABLED (predefinito) o CROSS_PROJECT_METADATA_DISABLED. Per ulteriori informazioni, consulta la sezione Annotazioni tra progetti.

Console

Per visualizzare tutte le configurazioni dei log di flusso VPC:

1. Nella Trusted Cloud console, vai alla pagina Log di flusso VPC.

   Vai a Log di flusso VPC

2. Nelle sezioni Configurazioni a livello di organizzazione e Configurazioni a livello di progetto, visualizza le configurazioni attive e in pausa. Se lo stato di una configurazione dei log di flusso VPC per una risorsa è On, significa che la registrazione è attivata.

Puoi anche visualizzare le configurazioni dei log di flusso VPC nella colonna Configurazioni log di flusso della pagina della risorsa. Ad esempio, per visualizzare le reti VPC e le subnet con configurazioni dei log di flusso VPC:

1. Vai alla pagina Reti VPC.

   Vai a Reti VPC

2. Fai clic sulla scheda Reti nel progetto corrente o Subnet nel progetto corrente e nella colonna Configurazioni dei log di flusso visualizza le configurazioni dei log di flusso VPC attive e in pausa.

gcloud

Per visualizzare le configurazioni dei log di flusso VPC, utilizza i comandi gcloud network-management vpc-flow-logs-configs list e gcloud network-management vpc-flow-logs-configs describe.

Visualizza le configurazioni a livello di organizzazione (anteprima)

• Per visualizzare tutte le configurazioni dei log di flusso VPC per un'organizzazione, esegui il seguente comando:

  gcloud beta network-management vpc-flow-logs-configs list --location=global \
      --organization=ORGANIZATION
  

• Per visualizzare una configurazione specifica dei log di flusso VPC, esegui il seguente comando:

  gcloud beta network-management vpc-flow-logs-configs describe CONFIG_NAME \
      --location=global \
      --organization=ORGANIZATION
  

  Sostituisci quanto segue:

  • ORGANIZATION: l'ID dell'organizzazione
  • CONFIG_NAME: il nome della configurazione

Visualizzare le configurazioni a livello di progetto

• Per visualizzare tutte le configurazioni dei log di flusso VPC in un progetto, esegui il seguente comando:

  gcloud network-management vpc-flow-logs-configs list --location=global
  

• Per visualizzare una configurazione specifica dei log di flusso VPC, esegui il seguente comando:

  gcloud network-management vpc-flow-logs-configs describe CONFIG_NAME \
      --location=global
  

  Sostituisci CONFIG_NAME con il nome della configurazione dei log di flusso VPC che vuoi visualizzare.

  Per visualizzare le configurazioni dei log di flusso VPC per le reti e le subnet VPC, utilizza la versione beta di questi comandi.

API

Visualizza le configurazioni a livello di organizzazione (anteprima)

• Per visualizzare tutte le configurazioni dei log di flusso VPC per un'organizzazione, utilizza il metodo organizations.locations.vpcFlowLogsConfigs.list:

  GET -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs
  

• Per visualizzare una configurazione specifica dei log di flusso VPC per un'organizzazione, utilizza il metodo organizations.locations.vpcFlowLogsConfigs.get:

  GET -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME
  

  Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto quota. Le richieste API vengono conteggiate per questo progetto.
  • ORGANIZATION_ID: l'ID dell'organizzazione.
  • CONFIG_NAME: il nome della configurazione.

• Se non disponi delle autorizzazioni necessarie per eseguire le attività precedenti a livello di organizzazione, puoi utilizzare la seguente richiesta per visualizzare tutte le configurazioni dei log di flusso VPC per l'organizzazione:

  GET https://networkmanagement.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs:queryOrgVpcFlowLogsConfigs
  

  Sostituisci PROJECT_ID con l'ID del progetto.

Visualizzare le configurazioni a livello di progetto

• Per visualizzare tutte le configurazioni dei log di flusso VPC in un progetto, utilizza il metodo projects.locations.vpcFlowLogsConfigs.list:

  GET https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs
  

• Per visualizzare una configurazione specifica dei log di flusso VPC, utilizza il metodo projects.locations.vpcFlowLogsConfigs.get:

  GET https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME
  

  Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto
  • CONFIG_NAME: il nome della configurazione dei log di flusso VPC

  Per visualizzare le configurazioni dei log di flusso VPC per le reti e le subnet VPC, utilizza la versione v1beta1 di queste richieste.

Console

1. Nella Trusted Cloud console, vai alla pagina Log di flusso VPC.

   Vai a Log di flusso VPC

2. Nella sezione Configurazioni a livello di progetto, fai clic sulla scheda Subnet (API Compute Engine) e visualizza le subnet nel progetto in cui sono abilitati i log di flusso VPC.

   Queste configurazioni sono gestite dall'API Compute Engine. Le configurazioni gestite dall'API Network Management vengono visualizzate nella scheda Subnet.

gcloud

Per visualizzare le subnet in una rete VPC in cui sono attivati i log di flusso VPC, esegui il seguente comando:

gcloud compute networks subnets list \
    --project PROJECT_ID \
    --network="NETWORK" \
    --format="csv(name,region,logConfig.enable)"

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto su cui stai eseguendo una query
• NETWORK: il nome della rete contenente le sottoreti

Console

1. Nella Trusted Cloud console, vai alla pagina Log di flusso VPC.

   Vai a Log di flusso VPC

2. Nella sezione Configurazioni a livello di organizzazione, seleziona una o più configurazioni da aggiornare e fai clic su Modifica.

3. Modifica una delle seguenti impostazioni:

   • L'intervallo di aggregazione. Per impostazione predefinita, l'intervallo di aggregazione è impostato su 5 sec.
   • Se impostare lo stato della configurazione dei log di flusso VPC su On o Off. Lo stato On indica che la configurazione dei log di flusso VPC selezionata è attiva e genera log di flusso.
   • Se configurare il filtro dei log. Per impostazione predefinita, l'opzione Conserva solo i log che corrispondono a un filtro non è selezionata.
   • Indica se includere le annotazioni tra progetti. Per impostazione predefinita, è selezionata l'opzione Annotazioni dei metadati tra progetti. Per ulteriori informazioni, consulta la sezione Annotazioni tra progetti.
   • Indica se includere i metadati nelle voci di log finali. Per impostazione predefinita, Annotazioni metadati include tutti i campi.
   • La frequenza di campionamento secondaria. 100% indica che tutte le voci generate dal processo di campionamento dei log di flusso principale vengono conservate. La frequenza di campionamento del log di flusso principale non è configurabile. Per saperne di più, consulta Campionamento e elaborazione dei log.

4. Fai clic su Salva.

gcloud

Utilizza il comando gcloud beta network-management vpc-flow-logs-configs update. Le parentesi quadre [] nei seguenti comandi indicano i parametri facoltativi.

Per aggiornare una configurazione dei log di flusso VPC per un'organizzazione, esegui il seguente comando:

gcloud beta network-management vpc-flow-logs-configs update CONFIG_NAME \
    --location=global \
    --organization=ORGANIZATION \
    [--aggregation-interval=AGGREGATION_INTERVAL] \
    [--filter-expr=FILTER_EXPRESSION] \
    [--flow-sampling=SAMPLING_RATE] \
    [--metadata=LOGGING_METADATA] \
    [--cross-project-metadata=CROSS_PROJECT_METADATA] \
    [--state=STATE]

Ad esempio, per aggiornare il parametro dell'intervallo di aggregazione, esegui il seguente comando:

gcloud beta network-management vpc-flow-logs-configs update CONFIG_NAME \
    --location=global \
    --organization=ORGANIZATION \
    --aggregation-interval=AGGREGATION_INTERVAL

Sostituisci quanto segue:

• ORGANIZATION: l'ID dell'organizzazione.
• CONFIG_NAME: il nome della configurazione da aggiornare. La configurazione si trova nello stesso Trusted Cloud progetto della risorsa per la quale viene utilizzata.

Per aggiornare i parametri facoltativi, sostituisci quanto segue:

• AGGREGATION_INTERVAL: l'intervallo di aggregazione per i log di flusso generati da questa configurazione. Questo parametro può essere impostato su interval-5-sec(valore predefinito), interval-30-sec, interval-1-min, interval-5-min,interval-10-min o interval-15-min.
• FILTER_EXPRESSION: un'espressione che definisce i log da conservare. L'espressione ha un limite di 2048 caratteri. Per ulteriori informazioni, consulta la sezione Filtro dei log.
• SAMPLING_RATE: la frequenza di campionamento del flusso secondario. Questo parametro può essere impostato su un valore maggiore di 0.0 e minore di 1.0 (tutti i log, valore predefinito). Per ulteriori informazioni, consulta Campionamento e elaborazione dei log.
• LOGGING_METADATA: le annotazioni dei metadati da includere nei log:
  • Utilizza include-all-metadata per includere tutte le annotazioni dei metadati (impostazione predefinita).
  • Utilizza exclude-all-metadata per escludere tutte le annotazioni dei metadati.
  • Utilizza custom-metadata per includere un elenco personalizzato di campi di metadati. Per specificare i campi dei metadati, utilizza il flag --metadata-fields:
    • --metadata-fields=METADATA_FIELDS: sostituisci METADATA_FIELDS con un elenco separato da virgole dei campi dei metadati che vuoi includere nei log. Ad esempio, src_instance,dst_instance. Può essere impostato solo se metadata è impostato su custom-metadata.
• CROSS_PROJECT_METADATA: annotazioni tra progetti. Può essere impostato su cross-project-metadata-enabled (predefinito) o cross-project-metadata-disabled. Per scoprire di più, consulta la sezione Annotazioni tra progetti.
• STATE: lo stato della configurazione. Può essere enabled (predefinito) o disabled.

API

Utilizza il metodo organizations.locations.vpcFlowLogsConfigs.patch. Per informazioni sui campi che puoi modificare, consulta Risorsa REST: projects.locations.vpcFlowLogsConfigs.

Per aggiornare una configurazione dei log di flusso VPC per un'organizzazione, includere i seguenti parametri nella richiesta API:

PATCH -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME?updateMask=FIELDS
{
  ...fields to modify
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto quota. Le richieste API vengono conteggiate per questo progetto. Il valore della quota per l'API Network Management è impostato su 1200 richieste al minuto sia per la quota a livello di progetto sia per quella a livello di organizzazione.
• ORGANIZATION_ID: l'ID dell'organizzazione per la quale viene utilizzata la configurazione.
• CONFIG_NAME: il nome della configurazione da aggiornare.
• FIELDS: il nome del campo o dei campi da aggiornare, separati da virgole, ad esempio aggregationInterval,flowSampling,metadata.

Ad esempio, per aggiornare il campo aggregationInterval per una configurazione my-config in my-organization, utilizza la seguente richiesta API:

PATCH -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1beta1/organizations/my-organization/locations/global/vpcFlowLogsConfigs/my-config?updateMask=aggregationInterval
{
  aggregationInterval:AGGREGATION_INTERVAL
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto quota. Le richieste API vengono conteggiate per questo progetto.
• AGGREGATION_INTERVAL con uno dei valori supportati per questo parametro.

Console

1. Nella Trusted Cloud console, vai alla pagina Log di flusso VPC.

   Vai a Log di flusso VPC

2. Nella sezione Configurazioni a livello di progetto, seleziona una o più configurazioni da aggiornare e fai clic su Modifica.

3. Modifica una delle seguenti impostazioni:

   • L'intervallo di aggregazione. Per impostazione predefinita, l'intervallo di aggregazione è impostato su 5 sec.
   • Se impostare lo stato della configurazione dei log di flusso VPC su On o Off. Lo stato On indica che la configurazione dei log di flusso VPC selezionata è attiva e genera log di flusso.
   • Se configurare il filtro dei log. Per impostazione predefinita, l'opzione Conserva solo i log che corrispondono a un filtro non è selezionata.
   • Indica se includere i metadati nelle voci di log finali. Per impostazione predefinita, Annotazioni metadati include tutti i campi.
   • La frequenza di campionamento secondaria. 100% indica che tutte le voci generate dal processo di campionamento dei log di flusso principale vengono conservate. La frequenza di campionamento del log di flusso principale non è configurabile. Per saperne di più, consulta Campionamento e elaborazione dei log.

4. Fai clic su Salva.

Puoi anche utilizzare il menu menu Gestisci log di flusso nelle seguenti posizioni per modificare le configurazioni dei log di flusso VPC:

• Le schede Reti nel progetto corrente e Subnet nel progetto corrente nella pagina Reti VPC
• La scheda Collegamenti VLAN nella pagina Interconnect
• La scheda Tunnel VPN nella pagina VPN

gcloud

Utilizza i comandi gcloud network-management vpc-flow-logs-configs update e gcloud beta network-management vpc-flow-logs-configs update. Le parentesi quadre [] nei comandi seguenti indicano i parametri facoltativi.

Per aggiornare una configurazione dei log di flusso VPC per una rete o una subnet VPC (anteprima), esegui il seguente comando:

gcloud beta network-management vpc-flow-logs-configs update CONFIG_NAME \
    --location=global \
    [--network=NETWORK | --subnet=SUBNET] \
    [--aggregation-interval=AGGREGATION_INTERVAL] \
    [--filter-expr=FILTER_EXPRESSION] \
    [--flow-sampling=SAMPLING_RATE] \
    [--metadata=LOGGING_METADATA] \
    [--state=STATE]

Per aggiornare una configurazione dei log di flusso VPC per un collegamento VLAN o un tunnel Cloud VPN, esegui il seguente comando:

gcloud network-management vpc-flow-logs-configs update CONFIG_NAME \
    --location=global \
    [--interconnect-attachment=VLAN_ATTACHMENT | --vpn-tunnel=VPN_TUNNEL] \
    [--aggregation-interval=AGGREGATION_INTERVAL] \
    [--filter-expr=FILTER_EXPRESSION] \
    [--flow-sampling=SAMPLING_RATE] \
    [--metadata=LOGGING_METADATA] \
    [--state=STATE]

Ad esempio, per aggiornare il parametro dell'intervallo di aggregazione per un collegamento VLAN o un tunnel Cloud VPN, esegui il seguente comando:

gcloud network-management vpc-flow-logs-configs update CONFIG_NAME \
    --location=global \
    --aggregation-interval=AGGREGATION_INTERVAL

Sostituisci quanto segue:

• CONFIG_NAME: il nome della configurazione che vuoi aggiornare. La configurazione si trova nello stesso Trusted Cloud progetto della risorsa per la quale viene utilizzata.

Per aggiornare i parametri facoltativi, sostituisci quanto segue:

• NETWORK, SUBNET, VLAN_ATTACHMENT o VPN_TUNNEL: il nome della risorsa target. È possibile specificare una sola risorsa per configurazione. Utilizza questa opzione per aggiornare il nome della risorsa di destinazione. Deve essere specificato nel seguente formato:
  • Rete VPC: projects/PROJECT_ID/global/networks/NAME
  • Subnet: projects/PROJECT_ID/regions/REGION/subnetworks/NAME
  • Collegamento VLAN: projects/PROJECT_ID/regions/REGION/interconnectAttachments/NAME
  • Tunnel Cloud VPN: projects/PROJECT_ID/regions/REGION/vpnTunnels/NAME
  • Sostituisci quanto segue:
    • PROJECT_ID: l'ID del Trusted Cloud progetto che contiene la risorsa.
    • REGION: la regione della risorsa.
    • NAME: il nome della risorsa.
• AGGREGATION_INTERVAL: l'intervallo di aggregazione per i log di flusso generati da questa configurazione. Questo parametro può essere impostato su interval-5-sec(valore predefinito), interval-30-sec, interval-1-min, interval-5-min,interval-10-min o interval-15-min.
• FILTER_EXPRESSION: un'espressione che definisce i log da conservare. L'espressione ha un limite di 2048 caratteri. Per ulteriori informazioni, consulta la sezione Filtro dei log.
• SAMPLING_RATE: la frequenza di campionamento del flusso secondario. Questo parametro può essere impostato su un valore maggiore di 0.0 e minore di 1.0 (tutti i log, predefinito). Per ulteriori informazioni, consulta Campionamento e elaborazione dei log.
• LOGGING_METADATA: le annotazioni dei metadati da includere nei log:
  • Utilizza include-all-metadata per includere tutte le annotazioni dei metadati (impostazione predefinita).
  • Utilizza exclude-all-metadata per escludere tutte le annotazioni dei metadati.
  • Utilizza custom-metadata per includere un elenco personalizzato di campi di metadati. Per specificare i campi dei metadati, utilizza il flag --metadata-fields:
    • --metadata-fields=METADATA_FIELDS: sostituisci METADATA_FIELDS con un elenco separato da virgole dei campi dei metadati che vuoi includere nei log. Ad esempio, src_instance,dst_instance. Può essere impostato solo se metadata è impostato su custom-metadata.
• STATE: lo stato della configurazione. Può essere enabled (predefinito) o disabled.

API

Utilizza i metodi projects.locations.vpcFlowLogsConfigs.patch e projects.locations.vpcFlowLogsConfigs.patch (v1beta1) . Per informazioni sui campi che puoi modificare, consulta Risorsa REST: projects.locations.vpcFlowLogsConfigs.

Per aggiornare una configurazione dei log di flusso VPC per una rete o una subnet VPC (anteprima), includi i seguenti parametri nella richiesta API:

PATCH https://networkmanagement.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME?updateMask=FIELDS
{
  ...fields to modify
}

Per aggiornare una configurazione dei log di flusso VPC per un collegamento VLAN o un tunnel Cloud VPN, includi i seguenti parametri nella richiesta API:

PATCH https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME?updateMask=FIELDS
{
  ...fields to modify
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto Trusted Cloud che contiene la configurazione dei log di flusso VPC. Questo ID corrisponde all'ID progetto della risorsa per la quale viene utilizzata la configurazione.
• CONFIG_NAME: il nome della configurazione da aggiornare.
• FIELDS: il nome del campo o dei campi da aggiornare, separati da virgole, ad esempio aggregationInterval,flowSampling,metadata.

Ad esempio, per aggiornare il campo aggregationInterval per una configurazione my-config in my-project, utilizza la seguente richiesta API:

PATCH https://networkmanagement.googleapis.com/v1/projects/my-project/locations/global/vpcFlowLogsConfigs/my-config?updateMask=aggregationInterval
{
  aggregationInterval:AGGREGATION_INTERVAL
}

Sostituisci AGGREGATION_INTERVAL con uno dei valori supportati per questo parametro.

Console

1. Nella console Trusted Cloud , vai alla pagina Reti VPC.

   Vai a Reti VPC

2. In Subnet nel progetto attuale, fai clic sulla subnet da actualizare.

3. Fai clic su Modifica.

4. (Facoltativo) Modifica una delle seguenti impostazioni:

   • L'intervallo di aggregazione. Per impostazione predefinita, l'intervallo di aggregazione è impostato su 5 sec.
   • Se configurare il filtro dei log. Per impostazione predefinita, l'opzione Conserva solo i log che corrispondono a un filtro non è selezionata.
   • Indica se includere i metadati nelle voci di log finali. Per impostazione predefinita, Annotazioni metadati include tutti i campi.
   • La frequenza di campionamento secondaria. 50% indica che viene conservata la metà delle voci generate dal processo di campionamento primario dei log di flusso. La frequenza di campionamento del log di flusso principale non è configurabile. Per saperne di più, consulta Campionamento e elaborazione dei log.

5. Fai clic su Salva.

In alternativa, puoi aggiornare i parametri di configurazione dei log di flusso VPC utilizzando il menu menu Gestisci log di flusso in Subnet nel progetto corrente nella pagina Reti VPC.

gcloud

Esegui questo comando:

gcloud compute networks subnets update SUBNET_NAME \
    [--logging-aggregation-interval=AGGREGATION_INTERVAL] \
    [--logging-flow-sampling=SAMPLING_RATE] \
    [--logging-filter-expr=FILTER_EXPRESSION] \
    [--logging-metadata=LOGGING_METADATA] \
    [--logging-metadata-fields=METADATA_FIELDS] \

Sostituisci quanto segue:

• AGGREGATION_INTERVAL: l'intervallo di aggregazione per i log dei flussi in quella subnet. L'intervallo può essere impostato su una delle seguenti opzioni: 5 secondi (impostazione predefinita), 30 secondi, 1 minuto, 5 minuti, 10 minuti o 15 minuti.
• SAMPLING_RATE: la frequenza di campionamento del flusso secondario. Il campionamento dei flussi secondari può essere impostato da 0.0 (nessun campionamento) a 1.0 (tutti i log). Il valore predefinito è 0.5. Per saperne di più, consulta Campionamento e elaborazione dei log.
• FILTER_EXPRESSION: un'espressione che definisce i log da conservare. L'espressione ha un limite di 2048 caratteri. Per maggiori dettagli, consulta la sezione Filtro dei log.

• LOGGING_METADATA: le annotazioni dei metadati che vuoi includere nei log:

  • Utilizza include-all per includere tutte le annotazioni dei metadati.
  • Utilizza exclude-all per escludere tutte le annotazioni dei metadati (valore predefinito).
  • Utilizza custom per includere un elenco personalizzato di campi di metadati specificati in METADATA_FIELDS.

• METADATA_FIELDS: un elenco separato da virgole dei campi dei metadati da includere nei log. Ad esempio, src_instance,dst_instance. Può essere impostato solo se LOGGING_METADATA è impostato su custom.

API

Modifica i campi di campionamento dei log per aggiornare i comportamenti dei log di flusso VPC.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME
{
  "logConfig": {
    ...fields to modify
  },
  "fingerprint": "SUBNET_FINGERPRINT"
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto in cui si trova la subnet.
• REGION: la regione in cui si trova la subnet.
• SUBNET_NAME: il nome della subnet esistente.
• SUBNET_FINGERPRINT: l'ID impronta della subnet esistente, fornito quando descrivi una subnet.
• Per i campi che puoi modificare, consulta Abilitare i log di flusso VPC quando crei una subnet.

Per ulteriori informazioni, consulta il metodo subnetworks.patch.

Console

1. Nella Trusted Cloud console, vai alla pagina Log di flusso VPC.

   Vai a Log di flusso VPC

2. Nelle sezioni Configurazioni a livello di organizzazione o Configurazioni a livello di progetto, seleziona una o più configurazioni dei log di flusso VPC che vuoi disattivare e imposta lo stato della configurazione su Disattiva.

   Se la selezione include configurazioni attive e non attive, nel menu Modifica stato configurazione fai clic su Disattiva tutto.

gcloud

Per mettere in pausa la raccolta dei log per una configurazione dei log di flusso VPC, utilizza i comandi gcloud network-management vpc-flow-logs-configs update e gcloud beta network-management vpc-flow-logs-configs update.

Metti in pausa una configurazione a livello di organizzazione (anteprima)

gcloud beta network-management vpc-flow-logs-configs update CONFIG_NAME \
    --location=global \
    --organization=ORGANIZATION \
    --state=disabled

Sostituisci quanto segue:

• CONFIG_NAME: il nome della configurazione
• ORGANIZATION: l'ID dell'organizzazione

Mettere in pausa una configurazione a livello di progetto

gcloud network-management vpc-flow-logs-configs update CONFIG_NAME \
    --location=global \
    --state=disabled

Sostituisci CONFIG_NAME con il nome della configurazione.

Per mettere in pausa una configurazione dei log di flusso VPC per una rete o una subnet VPC, utilizza la versione beta di questo comando.

API

Metti in pausa una configurazione a livello di organizzazione (anteprima)

Per mettere in pausa la raccolta dei log, utilizza il metodo organizations.locations.vpcFlowLogsConfigs.patch.

PATCH -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME?updateMask=state
{
  "state": "DISABLED"
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto quota. Le richieste API vengono conteggiate per questo progetto.
• ORGANIZATION_ID: l'ID dell'organizzazione.
• CONFIG_NAME: il nome della configurazione.

Mettere in pausa una configurazione a livello di progetto

Per mettere in pausa la raccolta dei log, utilizza il metodo projects.locations.vpcFlowLogsConfigs.patch.

PATCH https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME?updateMask=state
{
  "state": "DISABLED"
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del Trusted Cloud progetto che contiene la configurazione. Questo ID è uguale all'ID progetto della risorsa per la quale viene utilizzata la configurazione.
• CONFIG_NAME: il nome della configurazione.

Per mettere in pausa una configurazione dei log di flusso VPC per una rete o una subnet VPC, utilizza la versione v1beta1 di questa richiesta.

Console

1. Nella Trusted Cloud console, vai alla pagina Log di flusso VPC.

   Vai a Log di flusso VPC

2. Nelle sezioni Configurazioni a livello di organizzazione o Configurazioni a livello di progetto, seleziona una o più configurazioni dei log di flusso VPC da eliminare e fai clic su Elimina.

gcloud

Per eliminare una configurazione dei log di flusso VPC, utilizza i comandi gcloud network-management vpc-flow-logs-configs delete e gcloud beta network-management vpc-flow-logs-configs delete.

Eliminare una configurazione a livello di organizzazione (anteprima)

gcloud beta network-management vpc-flow-logs-configs delete CONFIG_NAME \
    --location=global \
    --organization=ORGANIZATION

Sostituisci quanto segue:

• CONFIG_NAME: il nome della configurazione
• ORGANIZATION: l'ID dell'organizzazione

Eliminare una configurazione a livello di progetto

gcloud network-management vpc-flow-logs-configs delete CONFIG_NAME \
    --location=global

Sostituisci CONFIG_NAME con il nome della configurazione che vuoi eliminare.

Per eliminare una configurazione dei log di flusso VPC per una rete o una subnet VPC, utilizza la versione beta di questo comando.

API

Eliminare una configurazione a livello di organizzazione (anteprima)

Per eliminare una configurazione dei log di flusso VPC, utilizza il metodo organizations.locations.vpcFlowLogsConfigs.delete.

DELETE -H "x-goog-user-project:PROJECT_ID" https://networkmanagement.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto quota. Le richieste API vengono conteggiate per questo progetto.
• ORGANIZATION_ID: l'ID dell'organizzazione.
• CONFIG_NAME: il nome della configurazione.

Eliminare una configurazione a livello di progetto

Per eliminare una configurazione dei log di flusso VPC, utilizza il metodo projects.locations.vpcFlowLogsConfigs.delete.

DELETE https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/vpcFlowLogsConfigs/CONFIG_NAME

Sostituisci quanto segue:

• PROJECT_ID: l'ID del Trusted Cloud progetto che contiene la configurazione
• CONFIG_NAME: il nome della configurazione

Per eliminare una configurazione dei log di flusso VPC per una rete o una subnet VPC, utilizza la versione v1beta1 di questa richiesta.

Console

1. Nella console Trusted Cloud , vai alla pagina Reti VPC.

   Vai a Reti VPC

2. Fai clic sulla sottorete che vuoi aggiornare.

3. Fai clic su Modifica.

4. Per Log di flusso, seleziona Off.

5. Fai clic su Salva.

gcloud

Esegui questo comando:

gcloud compute networks subnets update SUBNET_NAME \
    --no-enable-flow-logs

API

Disattiva i log di flusso VPC in una subnet per interrompere la raccolta dei record dei log.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME
{
  "logConfig": {
    "enable": false
  },
  "fingerprint": "SUBNET_FINGERPRINT"
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto in cui si trova la subnet
• REGION: la regione in cui si trova la subnet
• SUBNET_NAME: il nome della subnet esistente
• SUBNET_FINGERPRINT: l'ID impronta della subnet esistente, fornito quando descrivi una subnet

Per ulteriori informazioni, consulta il metodo subnetworks.patch.