Cloud Logging te permite almacenar, buscar, analizar y supervisar los datos y eventos de registro de Google Cloud y Amazon Web Services, así como emitir alertas sobre ellos. En esta página, se muestra cómo administrar Logging mediante 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 a fin de obtener más información sobre los cmdlets de Logging. Para obtener más información sobre Logging en general, lee la guía Descripción general de Logging.
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 permiso 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 bucket 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`""