Log e metriche

Logging

Il logging Cloud NAT ti consente di registrare log delle connessioni NAT e dei relativi errori. Quando il logging Cloud NAT è abilitato, può essere generata una voce di log per ciascuno degli scenari seguenti:

• Alla creazione di una connessione di rete che utilizza NAT.
• Quando un pacchetto va perso perché non sono disponibili porte per NAT.

Puoi scegliere di registrare log per entrambi i tipi di eventi o per uno dei due.

I log creati vengono inviati a Cloud Logging.

Specifiche

Le seguenti specifiche si applicano al logging di Cloud NAT:

• Il logging di Cloud NAT gestisce solo il traffico TCP e UDP.

• La registrazione di Cloud NAT registra solo i pacchetti eliminati se sono pacchetti TCP e UDP in uscita. Non registra i pacchetti in entrata eliminati. Ad esempio, se una risposta in entrata a una richiesta in uscita viene eliminata per qualsiasi motivo, non viene registrato alcun errore.

Ogni istanza VM può generare solo un determinato numero di voci di log per unità di tempo, proporzionale al numero di vCPUs. La VM può generare 50-100 voci di log al secondo per vCPU.

• Questa soglia di frequenza influisce sul numero di eventi che possono essere registrati. Anche se alcuni eventi vengono filtrati, il loro conteggio delle occorrenze viene conteggiato nel numero di possibili voci di log. La limitazione dei log ai soli errori o alle sole connessioni di conversione degli indirizzi di rete non aumenta necessariamente il numero di voci di log visualizzate. Ad esempio, se scegli di registrare solo le connessioni riuscite, periodi di tentativi di connessione non riusciti eccessivi ed errori NAT possono comunque limitare il numero di voci di log delle connessioni riuscite.

• Il logging Cloud NAT non registra ogni singolo pacchetto. Anche se la soglia di frequenza della VM non è stata raggiunta, alcune condizioni possono causare l'omissione degli eventi dal log. Per prendere decisioni informate, devi fare affidamento sulla presenza di voci nel logging Cloud NAT, ma non devi presumere che l'assenza di voci significhi che un evento non si è verificato.

Configura logging

Per configurare il logging di Cloud NAT, segui questi passaggi.

Abilita il logging

Se il logging è abilitato, tutti i log raccolti vengono inviati a Cloud Logging per impostazione predefinita. Puoi filtrarli in modo che solo alcuni log vengano inviati.

Puoi anche specificare questi valori quando crei o modifichi un gateway NAT. Le indicazioni riportate di seguito mostrano come abilitare i log per un gateway NAT esistente.

gcloud compute routers nats update NAT_GATEWAY \
    --router=ROUTER_NAME \
    --region=REGION \
    --enable-logging

gcloud compute routers nats update NAT_GATEWAY \
    --router=ROUTER_NAME \
    --region=REGION \
    --enable-logging \
    --log-filter=TRANSLATIONS_ONLY

gcloud compute routers nats update NAT_GATEWAY \
    --router=ROUTER_NAME \
    --region=REGION \
    --enable-logging \
    --log-filter=ERRORS_ONLY

Cancella filtri log

Se hai impostato un filtro, puoi cancellarlo. Se cancelli un filtro dei log, vengono registrati sia gli eventi di Network Address Translation sia gli errori, a condizione che la registrazione sia attivata.

gcloud compute routers nats update NAT_GATEWAY \
    --router=ROUTER_NAME \
    --region=REGION \
    --log-filter=ALL

Disabilita logging

Per disattivare la registrazione:

gcloud compute routers nats update NAT_GATEWAY \
    --router=ROUTER_NAME \
    --region=REGION \
    --no-enable-logging

Determinare lo stato del logging

Per determinare lo stato della registrazione, segui questi passaggi:

gcloud compute routers nats describe NAT_GATEWAY \
    --router=ROUTER_NAME \
    --region=REGION

Visualizza i log

Per visualizzare i log NAT:

resource.type="nat_gateway"
logName="projects/{#project_id}/logs/compute.googleapis.com%2Fnat_flows"

gcloud logging read 'resource.type=nat_gateway' \
    --limit=10 \
    --format=json

Puoi configurare l'esportazione delle metriche basate su log per i log delle risorse.

Informazioni registrate nei log

Le voci di log di Cloud NAT contengono informazioni utili per monitorare ed eseguire il debug del traffico NAT. Le voci di log contengono i seguenti tipi di informazioni:

• Informazioni generali mostrate nella maggior parte dei log Google Cloud , come gravità, ID progetto, numero di progetto e timestamp.
• Informazioni specifiche relative a Cloud NAT. Alcuni campi di log contengono voci che a loro volta sono più campi. Queste voci e le descrizioni dei campi sono riportate nelle tabelle seguenti.

Campi log

Formato del campo NatIpConnection

Formato del campo NatGateway

Formato del campo InstanceDetails

Formato del campo VpcDetails