Como trabalhar com o Stackdriver Logging

O Stackdriver Logging permite armazenar, pesquisar, analisar, monitorar e alertar sobre eventos e dados de registro do Google Cloud Platform e do Amazon Web Services. Esta página mostra como gerenciar o Stackdriver Logging com o Windows PowerShell. Ela contém um exemplo simples de como criar registros, coletores de registros e métricas de registros.

Leia a referência do cmdlet Cloud Tools for PowerShell para saber mais sobre os cmdlets do Stackdriver Logging. Para saber mais sobre o Stackdriver Logging, leia a Visão geral do Stackdriver 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 pelos serviços do GCP, do AWS, por aplicativos de terceiros ou pelos 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, você pode usar 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."

# 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." `
               -MonitoredResource $resource

Você pode recuperar entradas do 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, você pode criar 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 intervalos do Cloud Storage, conjuntos de dados do BigQuery ou Cloud 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

Para criar métricas que contam o número de entradas de registro que correspondem a determinados critérios, use 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`""
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Cloud Tools for PowerShell