Elige un enfoque de instrumentación

En esta página, se incluyen recomendaciones para instrumentar tu app en diferentes plataformas de Google Cloud, como Google Kubernetes Engine (GKE) y Cloud Run. Si tu app aún no está instrumentada, usa estas recomendaciones para obtener orientación sobre cómo instrumentar tu app para enviar datos de telemetría a Google Cloud. Las recomendaciones de esta página no son las únicas soluciones, y otros enfoques pueden funcionar. Para obtener orientación adicional, comunícate con la Asistencia de Google Cloud.

Hay recomendaciones para lo siguiente:

Para obtener más información sobre los ejemplos de instrumentación, consulta los documentos enumerados en la sección Muestras de código.

GKE

Para obtener información general sobre GKE, consulta la Descripción general de GKE.

Tipo Recomendación
Métricas

Te recomendamos usar Google Cloud Managed Service para Prometheus.

Para la instrumentación, realiza una de las siguientes acciones:

Seguimiento

Puedes hacer lo siguiente:

  1. Usa el SDK de OpenTelemetry y el exportador de OTLP para tu lenguaje.
  2. Configura el recopilador de OpenTelemetry para enviar seguimientos de OTLP a Google Cloud.
Registros

Configura la app para que genere registros estructurados en JSON en stdout y stderr. Para obtener una lista de frameworks, consulta frameworks de registro recomendados.

GKE recopila los registros escritos en stdout y stderr de forma automática. Para obtener más información, consulta Acerca de los registros de GKE.

Compute Engine

Para obtener información general sobre Compute Engine, consulta Instancias de máquina virtual.

Tipo Recomendación
Métricas y seguimientos

Puedes hacer lo siguiente:

  1. Usa el SDK de OpenTelemetry y el exportador de OTLP para tu lenguaje.
  2. Usar el agente de operaciones para recopilar métricas y seguimientos Para ver un ejemplo, consulta Recopila métricas y seguimientos del protocolo OpenTelemetry (OTLP).

Como alternativa, si solo deseas configurar la recopilación de métricas de formato Prometheus, puedes usar el receptor de Prometheus del agente de operaciones para recopilar métricas instrumentadas con Bibliotecas cliente de Prometheus o el SDK de OpenTelemetry

Registros

Puedes hacer lo siguiente:

  1. Configura tu aplicación para que envíe registros estructurados JSON a un archivo. Para obtener una lista de frameworks, consulta frameworks de registro recomendados.
  2. Instalar el agente de operaciones y configurar un receptor. Para ver un ejemplo, consulta Receptores de registros.

Cloud Run

Para obtener información general sobre Cloud Run, consulta Qué es Cloud Run.

Tipo Recomendación
Métricas y seguimientos

Puedes hacer lo siguiente:

  1. Usa el SDK de OpenTelemetry y el exportador de OTLP para tu lenguaje.
  2. Configurar el archivo adicional de OpenTelemetry para recopilar métricas y seguimientos. Para ver un ejemplo, consulta Escribe métricas de OTLP mediante un archivo adicional de OpenTelemetry.
  3. Configura la CPU para que se asigne siempre en Cloud Run. Debido a que la instrumentación de OpenTelemetry realiza el procesamiento en segundo plano, recomendamos que los servicios instrumentados de Cloud Run usen una CPU siempre asignada. Para obtener más información, consulta Asignación de CPU (servicios).

Como alternativa, si solo deseas configurar la recopilación de métricas de formato Prometheus, puedes usar el sidecar de Prometheus para Cloud Run para recopilar métricas instrumentadas con Bibliotecas cliente de Prometheus o el SDK de OpenTelemetry.

Registros

Configura la app para que genere registros estructurados en JSON en stdout y stderr. Para obtener una lista de frameworks, consulta frameworks de registro recomendados.

Cloud Run recopila los registros escritos en stdout y stderr de forma automática. Para obtener más información, consulta Escribe registros de contenedores.

Funciones de Cloud Run

Para obtener información general sobre las funciones de Cloud Run, consulta Descripción general de las funciones de Cloud Run.

Tipo Recomendación
Métricas La escritura directa de métricas no es compatible con las funciones de Cloud Run. Para generar métricas, te recomendamos que uses las métricas basadas en registros.
Seguimiento Usa el SDK y el exportador de Cloud Trace para tu lenguaje.
Registros

Configura la app para que genere registros estructurados en JSON en stdout y stderr. Para obtener una lista de frameworks, consulta frameworks de registro recomendados.

Las funciones de Cloud Run recopilan los registros escritos en stdout y stderr de forma automática. Para obtener más información, consulta Visualiza y escribe registros de funciones de Cloud Run.

App Engine

Para obtener información general sobre App Engine, consulta Descripción general de App Engine.

Tipo Recomendación
Métricas Usa el SDK y el exportador de Cloud Monitoring para tu lenguaje.
Seguimiento Usa el SDK y el exportador de Cloud Trace para tu lenguaje.
Registros

Configura la app para que genere registros estructurados en JSON en stdout y stderr. Para obtener una lista de frameworks, consulta frameworks de registro recomendados.

App Engine recopila los registros escritos en stdout y stderr de forma automática. Para obtener más información, consulta Escribe y visualiza registros.

Frameworks de registro recomendados

Para recopilar registros, te recomendamos que uses un framework que se pueda configurar a fin de enviar objetos JSON serializados a stdout, stderr o a un archivo. El agente de Logging, ya sea integrado o instalado, recopila el archivo y escribe registros estructurados para Cloud Logging. Para escribir datos de registro, te recomendamos lo siguiente:

Muestras de código

Para ver muestras de código que ilustran cómo instrumentar tu aplicación para enviar telemetría a Google Cloud, consulta lo siguiente:

Referencias a OpenTelemetry

En esta sección, se proporcionan vínculos al SDK de OpenTelemetry y los exportadores de OTLP, Cloud Trace y Cloud Monitoring.

Referencias generales:

Go

Java

JavaScript

Python