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. Configurar 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.

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.

Cloud Functions

Para obtener información general sobre Cloud Functions, consulta Descripción general de Cloud Functions.

Tipo Recomendación
Métricas La escritura directa de métricas no es compatible con Cloud Functions. 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.

Cloud Functions recopila los registros escritos en stdout y stderr de forma automática. Para obtener más información, consulta Visualiza y escribe registros de Cloud Function.

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