Como trabalhar com o Logging

O Cloud Logging permite que você armazene, pesquise, analise, crie alertas e monitore dados de registro e eventos do Google Cloud e da Amazon Web Services. Nesta página, mostramos como gerenciar o Logging usando o PowerShell. Ela contém um exemplo simples de como criar registros, coletores de registros e métricas de registros.

Leia a Referência de cmdlets do Cloud Tools for PowerShell para saber mais. Para saber mais sobre o Logging em geral, leia o guia Visão geral do Logging.

Como criar registros e entradas de registro

Um registro é uma coleção definida de entradas de registro no projeto. Elas registram um status ou evento. A entrada pode ser criada por serviços do Google Cloud, serviços da AWS, aplicativos de terceiros ou seus próprios aplicativos. A "mensagem" carregada pela entrada de registro é chamada de payload e pode ser uma string simples ou dados estruturados. Cada entrada de registro indica o local de que veio, incluindo o nome de um recurso monitorado.

O cmdlet New‑GcLogEntry pode ser usado para criar uma entrada de registro. Você precisará especificar a qual registro ela pertence (se o registro não existir, ele será criado). Para associar o registro a um recurso monitorado, use o parâmetro -MonitoredResource. Por padrão, a entrada do registro é associada ao recurso "global". Para criar um recurso monitorado, use o cmdlet New‑GcLogMonitoredResource.

# Creates a log entry in the log "my-log".
New-GcLogEntry -LogName "my-log" -TextPayload "This is a log entry."

# Creates a log entry associated with a Cloud SQL monitored resource
$resource = New-GcLogMonitoredResource -ResourceType "cloudsql_database" `
                                       -Labels @{"project_id" = "my-project";
                                                 "database_id" = "id"}
New-GcLogEntry -LogName "my-log" `
               -TextPayload "This is a log entry." `
               -MonitoredResource $resource

Você pode recuperar entradas de registro com o cmdlet Get‑GcLogEntry.

# Gets all entries from log "my-log"
Get-GcLogEntry -LogName "my-log"

# Gets all entries associated with Compute Engine instances
Get-GcLogEntry -ResourceName "gce_instance"

Como criar coletores de registros

Para exportar entradas de registro, crie coletores de registros com o cmdlet New‑GcLogSink. O Stackdriver Logging fará a correspondência das novas entradas de registro com seus coletores e todas as entradas correspondentes a cada coletor serão copiadas para o destino associado. As entradas de registro que existem antes da criação do coletor não serão exportadas.

Os destinos dos registros exportados podem ser buckets do Cloud Storage, conjuntos de dados do BigQuery ou Pub/Sub Topics.

# Creates a log sink for log entries in the default project.
# The entries will be sent to the Cloud Storage bucket "my-bucket"
New-GcLogSink -Sink "my-sink" -GcsBucketDestination "my-bucket"

# Creates a log sink for log entries in log "my-log".
# The entries will be sent to the BigQuery data set "my_dataset"
New-GcLogSink -Sink "my-sink" `
              -LogName "my-log" `
              -BigQueryDataSetDestination "my_dataset"

# Creates a log sink for log entries that match the filter.
# The entries will be sent to the Pub/Sub topic "my-topic".
New-GcLogSink -Sink "my-sink" `
              -Filter "textPayload = `"Testing`"" `
              -PubSubTopicDestination "my-topic"

Como criar métricas de registro

É possível criar métricas de registro que contam o número de entradas de registro que correspondem a determinados critérios com o cmdlet New‑GcLogMetric. Essas métricas podem ser usadas para criar gráficos e alertar sobre políticas no Stackdriver Monitoring.

# Creates a metric for entries in log "my-log".
New-GcLogMetric -Metric "my-metric" -LogName "my-log"

# Creates a metric for entries associated with Compute Engine instances
New-GcLogMetric -Metric "my-metric" -ResourceType "gce_instance"

# Creates a metric for entries that match the filter.
New-GcLogMetric -Metric "my-metric" -Filter "textPayload = `"Testing`""