Configuración de Stackdriver Logging para Go

Ofrecemos un paquete de registros estándar compatible con bibliotecas. La biblioteca de Stackdriver Logging para Go expone una capa de nivel superior a fin de trabajar con Stackdriver Logging.

No hace falta que el agente de Stackdriver Logging esté instalado para poder utilizar la biblioteca de Stackdriver Logging para Go en una instancia de VM de Compute Engine.

Antes de comenzar

1. Accede a tu Cuenta de Google.

   Si todavía no tienes una cuenta, regístrate para obtener una nueva.

2. Selecciona o crea un proyecto de GCP.

   Nota: Si no planeas conservar los recursos de GCP que crees durante este instructivo, crea un proyecto nuevo. Después de terminar, puedes borrar el proyecto y quitar todos los recursos asociados con el proyecto y el instructivo.

   Ir a la página Administrar recursos

3. Asegúrate de tener habilitada la facturación para tu proyecto.

   Aprende a habilitar la facturación

4. Habilita las API de Stackdriver Logging necesarias.

   Habilita las API

Instala el paquete

go get -u cloud.google.com/go/logging

Usa el registrador de Go

Ver en GitHub Comentarios

// Sample stdlogging writes log.Logger logs to the Stackdriver Logging.
package main

import (
	"log"

	// Imports the Stackdriver Logging client package.
	"cloud.google.com/go/logging"
	"golang.org/x/net/context"
)

func main() {
	ctx := context.Background()

	// Sets your Google Cloud Platform project ID.
	projectID := "YOUR_PROJECT_ID"

	// Creates a client.
	client, err := logging.NewClient(ctx, projectID)
	if err != nil {
		log.Fatalf("Failed to create client: %v", err)
	}
	defer client.Close()

	// Sets the name of the log to write to.
	logName := "my-log"

	logger := client.Logger(logName).StandardLogger(logging.Info)

	// Logs "hello world", log entry is visible at
	// Stackdriver Logs.
	logger.Println("hello world")
}

Para obtener más información sobre la instalación, consulta la documentación sobre la biblioteca de Stackdriver Logging para Go. También puedes informar problemas mediante el seguimiento de problemas.

Utiliza la biblioteca cliente de Cloud directamente

A fin de obtener información sobre el uso de la biblioteca cliente de Stackdriver Logging Cloud para Go directamente, consulta Bibliotecas cliente de Stackdriver Logging.

Ejecuta en Google Cloud Platform

El uso de la biblioteca de Stackdriver Logging para Go requiere la Función de escritor de registros de Cloud IAM en GCP. La mayoría de los entornos de GCP proporcionan esta función de forma predeterminada.

App Engine

App Engine otorga la función de escritor de registros de forma predeterminada.

La biblioteca de Stackdriver Logging para Go se puede utilizar sin tener que proporcionar credenciales explícitamente.

Stackdriver Logging está habilitado automáticamente para las aplicaciones de App Engine. No se requiere ninguna configuración adicional.

Nota: Los registros escritos para stdout y stderr se envían automáticamente a Stackdriver Logging por ti, sin necesidad de utilizar la biblioteca de Stackdriver Logging para Go.

Google Kubernetes Engine

En Google Kubernetes Engine, debes agregar el alcance de acceso logging.write cuando creas el clúster:

gcloud container clusters create example-cluster-name --scopes https://www.googleapis.com/auth/logging.write

Compute Engine

Nota: A fin de utilizar la biblioteca de Stackdriver Logging para Go en una instancia de VM de Compute Engine, no hace falta instalar el agente de Stackdriver Logging.

Cuando utilices las instancias de VM de Compute Engine, agrega el alcance de acceso cloud-platform a cada instancia. Cuando crees una instancia nueva mediante Google Cloud Platform Console, hazlo en la sección Identidad y acceso a la API en el panel Crear una instancia: Utiliza la cuenta de servicio predeterminada de Compute Engine o una cuenta de servicio diferente y selecciona Permitir acceso total a las API de Cloud en la sección Identidad y acceso a la API. Sin importar la cuenta de servicio que seleccionaste, asegúrate de haberle otorgado la función de escritor de registros en la sección IAM y Administración de GCP Console.

Ejecuta de forma local y en otros lugares

A fin de utilizar la biblioteca de Stackdriver Logging para Go fuera de GCP, debes proporcionar el ID de tu proyecto de GCP y las credenciales correspondientes de tu cuenta de servicio directamente a la biblioteca. Esto se aplica a la ejecución del agente en tu estación de trabajo, en las computadoras de tus centros de datos o en las instancias de VM de otros proveedores de servicios en la nube. Para obtener más información, consulta Obtén y proporciona las credenciales de la cuenta de servicio de forma manual.

Visualiza los registros

Después de la implementación, podrás ver los registros en el visor de registros de GCP Console.

Ir al visor de registros

Para obtener más información, consulta Visualiza los registros.