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: |
Registros | Configura la app para que genere registros estructurados en JSON en GKE recopila los registros escritos en |
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:
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:
|
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:
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 Cloud Run recopila los registros escritos en |
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 Las funciones de Cloud Run recopilan los registros escritos en |
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 App Engine recopila los registros escritos en |
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:
- Genera seguimientos y métricas con Go.
- Genera seguimientos y métricas con Java.
- Genera seguimientos y métricas con Node.js.
- Genera seguimientos y métricas con Python.
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
- SDK de Go
- Exportador de OTLP de Go
- Exportador de Cloud Trace de Go
- Exportador de Cloud Monitoring de Go
Java
- SDK de Java
- Exportador de OTLP de Java
- Exportador de Cloud Trace de Java
- Exportador de Cloud Monitoring de Java
JavaScript
- SDK de JavaScript
- Exportador de OTLP de JavaScript
- Exportador de Cloud Trace de JavaScript
- Exportador de Cloud Monitoring de JavaScript
Python
- Python SDK
- Exportador de OTLP de Python
- Exportador de Cloud Trace de Python
- Exportador de Cloud Monitoring de Python