Trabalhar com o registo

O Cloud Logging permite-lhe armazenar, pesquisar, analisar, monitorizar e enviar alertas sobre dados de registos e eventos da Google Cloud Google Cloud Platform e da Amazon Web Services. Esta página mostra como gerir o registo através do PowerShell. Explica um exemplo simples de criação de registos, destinos de registos e métricas de registos.

Leia a referência do cmdlet do Cloud Tools for PowerShell para saber mais sobre os cmdlets de registo. Para saber mais sobre o registo em geral, leia o guia Vista geral do registo.

Criar registos e entradas de registos

Um registo é uma coleção de entradas de registo com nome no projeto. Uma entrada de registo regista o estado ou um evento. A entrada pode ser criada por Google Cloud serviços, serviços AWS, aplicações de terceiros ou as suas próprias aplicações. A "mensagem" que a entrada de registo contém chama-se carga útil e pode ser uma string simples ou dados estruturados. Cada entrada de registo indica a respetiva origem através da inclusão do nome de um recurso monitorizado.

O cmdlet New‑GcLogEntry pode ser usado para criar uma entrada de registo. Tem de especificar o registo ao qual a entrada pertence (se o registo não existir, é criado). Para associar o registo a um recurso monitorizado, pode usar o parâmetro -MonitoredResource. Por predefinição, a entrada do registo está associada ao recurso "global". Para criar um recurso monitorizado, 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

Pode obter entradas do registo 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"

Criar destinos de registo

Para exportar entradas de registo, pode criar destinos de registo com o cmdlet New‑GcLogSink. O Stackdriver Logging faz a correspondência entre as entradas de registo recebidas e os seus destinos. Em seguida, todas as entradas de registo que correspondem a cada destino são copiadas para o destino associado. As entradas de registo existentes antes da criação do destino não são exportadas.

Os destinos dos registos exportados podem ser contentores do Cloud Storage, conjuntos de dados do BigQuery ou tópicos do Pub/Sub.

# 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"

Criar métricas de registo

Pode criar métricas de registo que contabilizam o número de entradas de registo que correspondem a determinados critérios com o cmdlet New‑GcLogMetric. Estas métricas podem ser usadas para criar gráficos e políticas de alerta 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`""