Elegir un enfoque de instrumentación

En esta página se incluyen recomendaciones para instrumentar tu aplicación en diferentesGoogle Cloud plataformas, como Google Kubernetes Engine (GKE) y Cloud Run. Si tu aplicación aún no está instrumentada, sigue estas recomendaciones para saber cómo instrumentarla y enviar datos de telemetría a Google Cloud. Las recomendaciones de esta página no son las únicas soluciones posibles, y hay otros enfoques que también pueden funcionar. Si necesitas más ayuda, ponte en contacto con el equipo de Asistencia deGoogle Cloud .

Hay recomendaciones para lo siguiente:

Para obtener información sobre ejemplos de instrumentación, consulta los documentos que se indican en la sección Fragmentos 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 que uses Google Cloud Managed Service para Prometheus.

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

Sigue estos pasos:

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

Configura tu aplicación para que genere registros estructurados en formato JSON en stdout y stderr. Para ver una lista de los frameworks, consulta Frameworks de registro recomendados.

GKE recoge automáticamente los registros escritos en stdout y stderr. Para obtener más información, consulta el artículo Acerca de los registros de GKE.

Compute Engine

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

Tipo Recomendación
Métricas y trazas

Sigue estos pasos:

  1. Usa el SDK de OpenTelemetry y el exportador OTLP para tu lenguaje.
  2. Usa el agente de operaciones para recoger métricas y trazas. Por ejemplo, consulta Recoger métricas y trazas del protocolo OpenTelemetry (OTLP).

Si solo quieres configurar la recogida de métricas en formato Prometheus, puedes usar el receptor de Prometheus del agente de operaciones para recoger métricas instrumentadas con las bibliotecas de cliente de Prometheus o el SDK de OpenTelemetry.
Registros

Sigue estos pasos:

  1. Configura tu aplicación para que genere registros estructurados en formato JSON en un archivo. Para ver una lista de los frameworks, consulta Frameworks de registro recomendados.
  2. Instala el Agente de operaciones y configura un receptor. Por ejemplo, consulta Receptores de registro.

Cloud Run

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

Tipo Recomendación
Métricas y trazas

Sigue estos pasos:

  1. Usa el SDK de OpenTelemetry y el exportador OTLP para tu lenguaje.
  2. Configura el sidecar de OpenTelemetry para recoger métricas y trazas. Por ejemplo, consulte Escribir métricas de OTLP mediante un sidecar de OpenTelemetry.
  3. Configura la CPU para que siempre esté asignada en Cloud Run. Como la instrumentación de OpenTelemetry realiza el procesamiento en segundo plano, recomendamos que los servicios de Cloud Run instrumentados usen una CPU siempre asignada. Para obtener más información, consulta Asignación de CPU (servicios).

Si solo quieres configurar la recogida de métricas en formato Prometheus, puedes usar el servicio adicional de Prometheus para Cloud Run para recoger métricas instrumentadas con las bibliotecas de cliente de Prometheus o el SDK de OpenTelemetry.
Registros

Configura tu aplicación para que genere registros estructurados en formato JSON en stdout y stderr. Para ver una lista de los frameworks, consulta Frameworks de registro recomendados.

Cloud Run recoge automáticamente los registros escritos en stdout y stderr. Para obtener más información, consulta el artículo sobre cómo escribir registros de contenedores.

Cloud Run Functions

Para obtener información general sobre Cloud Run Functions, consulta la información general sobre Cloud Run Functions.

Tipo Recomendación
Métricas No se admite la escritura directa de métricas en las funciones de Cloud Run. Para generar métricas, te recomendamos que uses métricas basadas en registros.
Trazas Usa el SDK y el exportador de Cloud Trace para tu idioma.
Registros

Configura tu aplicación para que genere registros estructurados en formato JSON en stdout y stderr. Para ver una lista de los frameworks, consulta Frameworks de registro recomendados.

Cloud Run Functions recoge automáticamente los registros escritos en stdout y stderr. Para obtener más información, consulta Ver y escribir registros de funciones de Cloud Run.

App Engine

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

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

Configura tu aplicación para que genere registros estructurados en formato JSON en stdout y stderr. Para ver una lista de los frameworks, consulta Frameworks de registro recomendados.

App Engine recoge automáticamente los registros escritos en stdout y stderr. Para obtener más información, consulta el artículo sobre cómo escribir y ver registros.

Frameworks de registro recomendados

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

Códigos de ejemplo

Para ver ejemplos de código que muestran 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 enlaces al SDK de OpenTelemetry y a los exportadores de OTLP, Cloud Trace y Cloud Monitoring.

Referencias generales:

Go

Java

JavaScript

Python