Trabaja con Logging de Google Cloud's operations suite

Logging de Google Cloud's operations suite te permite almacenar, buscar, analizar, supervisar y generar alertas sobre los datos y eventos de registro desde Google Cloud y Amazon Web Services. En esta página, se muestra cómo administrar Logging de Google Cloud's operations suite con PowerShell. Se explica un ejemplo sencillo de cómo crear registros, así como receptores y métricas de registro.

Consulta la referencia del cmdlet de Cloud Tools for PowerShell para obtener más información sobre los cmdlets de Logging de Google Cloud's operations suite. Para obtener más información sobre Logging de Google Cloud's operations suite en general, lee la guía Descripción general de Logging de Google Cloud's operations suite.

Crea registros y entradas de registro

Un registro es una colección de entradas de registro que cuenta con un nombre dentro del proyecto. Con una entrada de registro, se realiza el registro del estado o de un evento. Se puede crear una entrada con servicios de Google Cloud, servicios de AWS, aplicaciones de terceros o tus propias aplicaciones. El “mensaje” que se incluye en la entrada de registro se denomina carga útil y puede ser una string simple o datos estructurados. Cada entrada de registro indica de dónde viene con el nombre de un recurso supervisado.

Se puede usar el cmdlet New‑GcLogEntry para crear una entrada de registro. Deberás especificar el registro al que pertenece la entrada (si el registro no existe, se creará). Para asociar el registro con un recurso supervisado, puedes usar el parámetro -MonitoredResource. Según la configuración predeterminada, la entrada de registro está asociada con el recurso "global". Para crear un recurso supervisado, usa el 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

Puedes recuperar entradas de registro con el 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"

Crea receptores de registro

Para exportar entradas de registro, puedes crear receptores de registro con el cmdlet New‑GcLogSink. Stackdriver Logging hará coincidir las entradas de registro entrantes con tus receptores y todas las entradas de registro que coincidan con cada receptor se copiarán en el destino asociado. Las entradas de registro que existan antes de que se cree el receptor no se exportarán.

Los destinos de los registros exportados pueden ser depósitos de Cloud Storage, conjuntos de datos de BigQuery o temas de 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"

Crea métricas de registro

Usa el cmdlet New‑GcLogMetric para crear métricas de registro que cuenten la cantidad de entradas de registro que coinciden con ciertos criterios. Estas métricas se pueden usar para crear gráficos y políticas de alertas en 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`""