Se usó la API de Cloud Translation para traducir esta página.

Entradas de registro de transmisión y de transmisión de registros en tiempo real

En este documento, se describe cómo ver tus entradas de registro en tiempo real mediante la transmisión y la transmisión de registros en tiempo real. Los registros de transmisión te permiten ver las entradas de registro en tiempo real y están disponibles en el Explorador de registros. El registro de seguimiento en tiempo real te permite ver entradas de registro en tiempo real y está disponible como el comando de gcloud CLI gcloud alpha logging tail y el método entries.tail de la API de Cloud Logging.

Cuando ves y analizas tus registros con el Explorador de registros, gcloud logging read, o el método de la API entries.list, ves entradas de registro que Cloud Logging almacenó. Cuando transmites o transmites entradas de registro de cola en tiempo real, verás las entradas de registro a medida que tus aplicaciones las escriben en la API de Cloud Logging.

Transmite registros en el Explorador de registros

En el Explorador de registros, puedes ver los datos de tus registros en tiempo real mediante la opción Transmitir registros. Cuando usas Transmitir registros, puedes agregar una consulta para transmitir solo los registros que coinciden con la consulta. Para transmitir registros, haz lo siguiente:

En la consola de Google Cloud, ve a la página Explorador de registros:
Ir al Explorador de registros

Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.
En el cuadro de texto Consulta, ingresa una consulta y, luego, haz clic en Transmitir registros.

A medida que Logging escribe los datos de registro, solo se muestran los registros que coinciden con la consulta en el panel Resultados de la consulta. Si no se proporciona una consulta, Logging muestra las entradas de registro almacenadas recientemente. Los registros continúan transmitiendo hasta que seleccionas la barra de desplazamiento en el panel de registros. Cuando se detiene la transmisión, se muestra el botón Reiniciar transmisión.

Para obtener información sobre las consultas, visita Compila consultas en el Explorador de registros.

Usa la transmisión de registros en tiempo real en Google Cloud CLI

El registro de seguimiento en tiempo real te permite ver tus entradas de registro en tiempo real a medida que Cloud Logging las escribe, mediante Google Cloud CLI o la API de Cloud Logging.

El seguimiento de registros en tiempo real no es compatible con los buckets de registros con controles de acceso a nivel de campo. Sin embargo, puedes transmitir los registros para esos buckets en el Explorador de registros.

Si deseas obtener información sobre el método de la API para el transmisión de registros en tiempo real, consulta el método entries.tail.

Instalando `gcloud alpha logging tail`

Para usar gcloud alpha logging tail, debes tener Python 3 y el paquete de Python grpcio instalados.

Si deseas obtener instrucciones para instalar Python, consulta la página de Python. Si deseas obtener instrucciones para instalar el administrador de paquetes de Python, pip, que se necesita para instalar el paquete grpcio, consulta la página del instalador de paquetes de Python.

Completa los siguientes pasos para instalar gcloud alpha logging tail:

Verifica que tengas Google Cloud CLI instalado. Si quieres obtener instrucciones para instalar Google Cloud CLI, consulta Instala Google Cloud CLI.
Verifica que uses la versión 302.0.0 o superior de la gcloud CLI.
```
gcloud version
```
Si quieres obtener instrucciones para actualizar gcloud CLI, consulta gcloud components update.
Instala los componentes alfa de gcloud CLI:
```
gcloud components install alpha
```
Para usuarios de macOS, Linux y Cloud Shell:
1. Instala las bibliotecas cliente de gRPC:
```
 sudo pip3 install grpcio
```
2. Configura la variable de entorno CLOUDSDK_PYTHON_SITEPACKAGES en cualquier valor:
```
 export CLOUDSDK_PYTHON_SITEPACKAGES=1
```
  Nota: De forma predeterminada, Google Cloud CLI ignora las bibliotecas de Python instaladas en tu sistema local. Para permitir que Google Cloud CLI use la biblioteca grpcio, debes habilitar los paquetes del sitio. Para habilitar los paquetes de sitios, establece la variable de entorno CLOUDSDK_PYTHON_SITEPACKAGES en 1. Con los paquetes de sitios habilitados, gcloud CLI puede usar bibliotecas adicionales fuera del directorio google-cloud-sdk/lib.
Usa los siguientes comandos para configurar el ID del proyecto de Google Cloud y autenticarte:
```
gcloud config set project PROJECT_ID
gcloud auth login
```
Para obtener el ID del proyecto, consulta Crea y administra proyectos.
Para verificar que gcloud alpha logging tail esté instalado, ejecuta el siguiente comando:
```
gcloud alpha logging tail
```
El comando muestra el siguiente mensaje:

Initializing tail session.

Ahora ves las entradas de registro de tu proyecto de Google Cloud a medida que Logging las escribe.

Para obtener más información sobre el uso de la transmisión de registros en tiempo real, consulta la guía de referencia de gcloud alpha logging tail.

Almacenamiento en búfer y pedidos

Debido a que Logging puede recibir entradas de registro desordenadas cronológicamente, el transmisión de registros en tiempo real proporciona una configuración de ventana de búfer para que puedas equilibrar la compensación entre ver las entradas de registro mientras se escriben y visualizarlas en orden ascendente. Puedes configurar la ventana del búfer entre 0 y 60 segundos.

Ten en cuenta las siguientes características de la ventana del búfer:

La ventana del búfer predeterminada es de dos segundos.
Logging retrasa la escritura de las entradas de registro en buckets de registros durante el período del búfer.
Si una entrada de registro se escribe fuera de la ventana del búfer, Logging muestra las entradas de registro a medida que se reciben.

Cuando configuras la ventana del búfer, realizas un intercambio entre la visualización de los registros a medida que están escritos y la visualización de las entradas desordenadas.

Ventana de búfer	Compensación
`0` segundos	Se mostraron las entradas de registro más recientes, pero es más probable que estén desordenadas.
`60` segundos	Un retraso de 60 segundos antes de ver las entradas mostradas, pero la mayoría de los registros se muestran en orden ascendente.

Límites y cuotas

En la siguiente tabla, se enumeran los límites y las cuotas para el transmisión de registros en tiempo real:

Límites y cuotas	Valor
Entradas devueltas por minuto	60,000 Si más de 60,000 entradas coinciden con un filtro, Logging muestra el recuento de entradas en la respuesta.
Sesiones abiertas de registro de registros en tiempo real por proyecto de Google Cloud	10

Limitaciones del cliente

En el caso de un proyecto de Google Cloud en el que se escriben muchas entradas con rapidez, es posible que el cliente no pueda consumirlas tan rápido como se escriben. En este caso, Logging limita la cantidad total de entradas enviadas y prioriza las entradas más recientes. Al final de la sesión final, Logging muestra la cantidad de entradas que no se mostraron debido a los límites del cliente.

Usa el transmisión de registros en tiempo real con bibliotecas cliente

El registro de registros en tiempo real te permite ver tus entradas de registro en tiempo real a medida que Cloud Logging las escribe. Si deseas obtener información sobre el método de la API para el transmisión de registros en tiempo real, consulta el método entries.tail.

En este ejemplo, se muestran las entradas de registro de transmisión de registros en tiempo real de un registrador determinado.

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Logging, consulta Bibliotecas cliente de Logging.

Para autenticarte en Logging, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.

import (
	"context"
	"fmt"
	"io"

	logging "cloud.google.com/go/logging/apiv2"
	loggingpb "google.golang.org/genproto/googleapis/logging/v2"
)

// tailLogs creates a channel to stream log entries that were recently ingested for a project
func tailLogs(projectID string) error {
	// projectID := "your_project_id"

	ctx := context.Background()
	client, err := logging.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("NewClient error: %w", err)
	}
	defer client.Close()

	stream, err := client.TailLogEntries(ctx)
	if err != nil {
		return fmt.Errorf("TailLogEntries error: %w", err)
	}
	defer stream.CloseSend()

	req := &loggingpb.TailLogEntriesRequest{
		ResourceNames: []string{
			"projects/" + projectID,
		},
	}
	if err := stream.Send(req); err != nil {
		return fmt.Errorf("stream.Send error: %w", err)
	}

	// read and print two or more streamed log entries
	for counter := 0; counter < 2; {
		resp, err := stream.Recv()
		if err == io.EOF {
			break
		}
		if err != nil {
			return fmt.Errorf("stream.Recv error: %w", err)
		}
		fmt.Printf("received:\n%v\n", resp)
		if resp.Entries != nil {
			counter += len(resp.Entries)
		}
	}
	return nil
}

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Logging, consulta Bibliotecas cliente de Logging.

import com.google.cloud.logging.LogEntry;
import com.google.cloud.logging.LogEntryServerStream;
import com.google.cloud.logging.Logging;
import com.google.cloud.logging.Logging.TailOption;
import com.google.cloud.logging.LoggingOptions;

public class TailLogEntries {

  public static void main(String[] args) throws Exception {
    // TODO(developer): Optionally provide the logname as an argument.
    String logName = args.length > 0 ? args[0] : "";

    LoggingOptions options = LoggingOptions.getDefaultInstance();
    try (Logging logging = options.getService()) {

      // Optionally compose a filter to tail log entries only from specific log
      LogEntryServerStream stream;

      if (logName != "") {
        stream =
            logging.tailLogEntries(
                TailOption.filter(
                    "logName=projects/" + options.getProjectId() + "/logs/" + logName));
      } else {
        stream = logging.tailLogEntries();
      }
      System.out.println("start streaming..");
      for (LogEntry log : stream) {
        System.out.println(log);
        // cancel infinite streaming after receiving first entry
        stream.cancel();
      }
    }
  }
}

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Logging, consulta Bibliotecas cliente de Logging.

const {Logging} = require('@google-cloud/logging');
const logging = new Logging();

/**
 * TODO(developer): Replace logName with the name of your log.
 */
const log = logging.log(logName);
console.log('running tail log entries test');

const stream = log
  .tailEntries({
    filter: 'timestamp > "2021-01-01T23:00:00Z"',
  })
  .on('error', console.error)
  .on('data', resp => {
    console.log(resp.entries);
    console.log(resp.suppressionInfo);
    // If you anticipate many results, you can end a stream early to prevent
    // unnecessary processing and API requests.
    stream.end();
  })
  .on('end', () => {
    console.log('log entry stream has ended');
  });

// Note: to get all project logs, invoke logging.tailEntries

Entradas de registro de transmisión y de transmisión de registros en tiempo real

Transmite registros en el Explorador de registros

Usa la transmisión de registros en tiempo real en Google Cloud CLI

Instalando gcloud alpha logging tail

Almacenamiento en búfer y pedidos

Límites y cuotas

Limitaciones del cliente

Usa el transmisión de registros en tiempo real con bibliotecas cliente

Go

Java

Node.js

Instalando `gcloud alpha logging tail`