Registros e métricas

Logging

Com a geração de registros do Cloud NAT, é possível registrar erros e conexões NAT. Quando a geração de registros do Cloud NAT está ativada, uma entrada de registro pode ser gerada para cada um dos seguintes cenários:

• quando uma conexão de rede usando NAT é criada;
• quando um pacote é descartado porque nenhuma porta estava disponível para NAT.

É possível escolher registrar os dois tipos de evento ou apenas um ou outro.

Os registros criados são enviados para o Cloud Logging.

Especificações

As seguintes especificações se aplicam à geração de registros do Cloud NAT:

• A geração de registros do Cloud NAT lida somente com tráfego TCP e UDP.

• A geração de registros do Cloud NAT registra somente pacotes descartados se eles forem pacotes TCP e UDP de saída (egress). Ele não registra pacotes de entrada descartados. Por exemplo, se uma resposta de entrada para uma solicitação de saída for descartada por algum motivo, nenhum erro será registrado.

Cada instância de VM só pode gerar um determinado número de entradas de registro por unidade de tempo, proporcional ao número de vCPUs. A VM pode gerar entre 50 e 100 entradas de registro por segundo por vCPU.

• Esse limite de taxa afeta o número de eventos que podem ser registrados. Mesmo que alguns eventos sejam filtrados, sua ocorrência é contabilizada no número de possíveis entradas de registro. Limitar registros a apenas erros ou apenas conexões de conversão de endereço de rede não aumenta necessariamente o número de entradas de registro visualizadas. Por exemplo, se você optar por registrar somente conexões bem-sucedidas, os períodos de excesso de tentativas de conexão com falha e erros NAT ainda poderão restringir o número de entradas de registro de conexão bem-sucedidas.

• A geração de registros do Cloud NAT não registra todos os pacotes. Mesmo que o limite de taxa da VM não tenha sido atingido, algumas condições podem fazer com que os eventos sejam omitidos do registro. Você deve confiar na presença de entradas na geração de registros do Cloud NAT para tomar decisões conscientes, mas não deve presumir que a ausência de entradas significa que um evento não aconteceu.

Configurar a geração de registros

Para configurar a geração de registros do Cloud NAT, siga estas etapas.

Ativar a geração de registros

Se a geração de registros estiver ativada, todos os registros coletados serão enviados para o Cloud Logging por padrão. Você pode filtrá-los para que somente determinados registros sejam enviados.

Você também pode especificar esses valores ao criar ou editar um gateway NAT. As instruções a seguir mostram como ativar a geração de registros para um gateway NAT existente.

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

Limpar filtros de registro

Se você tiver um filtro definido, poderá limpá-lo. Limpar um filtro de registro significa que os eventos e erros de conversão de endereços de rede são registrados, desde que o registro esteja ativado.

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

Desative a geração de registros

Para desativar a geração de registros, faça o seguinte:

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

Determinar o status da geração de registros

Para determinar o status da geração de registros, faça o seguinte:

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

Ver registros

Para visualizar os registros NAT, faça o seguinte:

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

É possível configurar a exportação de métricas com base em registros para registros de recursos.

O que é registrado

As entradas de registro do Cloud NAT contêm informações úteis para monitorar e depurar seu tráfego NAT. As entradas de registro contêm os seguintes tipos de informação:

• Informações gerais exibidas na maioria dos registros do Google Cloud , como gravidade, ID do projeto, número do projeto e carimbo de data/hora.
• Informações específicas relacionadas ao Cloud NAT. Alguns campos de registro contêm entradas que são campos múltiplos. Essas entradas e descrições de campo são mostradas nas tabelas a seguir.

Campos de registro

Formato de campo NatIpConnection

Formato de campo NatGateway

Formato do campo InstanceDetails

Formato do campo VpcDetails

Formato de campo DestinationDetails

Formato do campo GeographicDetails

Exemplos

Exemplo 1: registro de conexão TCP com NAT de uma instância de VM em uma rede