En esta página, se te guiará a través de los siguientes pasos:
- Instala los paquetes de OpenTelemetry.
- Configura la aplicación para exportar intervalos a Cloud Trace.
- Configura tu plataforma.
Para obtener información sobre la versión, consulta los siguientes vínculos:
Para obtener contenido de referencia de OpenTelemetry, consulta lo siguiente:
Si deseas obtener los detalles más recientes de OpenTelemetry para C++, además de documentación y ejemplos adicionales, consulta OpenTelemetry.
Antes de comenzar
Habilita la API necesaria.
Instala los paquetes de OpenTelemetry
- Configura un entorno de desarrollo de C++.
- Instala la biblioteca del exportador de OpenTelemetry de C++ de Google Cloud. Para obtener información de instalación, consulta la guía de inicio rápido de OpenTelemetry.
Configura la exportación de intervalos a Cloud Trace
Para configurar la exportación de datos de seguimiento, llama al método google::cloud::otel::ConfigureBasicTracing(...)
en tu método main()
:
El campo project_id
es el proyecto de Google Cloud en el que quieres almacenar los seguimientos.
El método ConfigureBasicTracing(...)
crea una instancia de un objeto TracerProvider
que implementa un exportador de Cloud Trace. Si el objeto que muestra la llamada a ConfigureBasicTracing(...)
está fuera del alcance, se restablece el objeto TracerProvider
anterior cuando existe uno.
Cómo configurar la tasa de muestreo
Las aplicaciones pueden generar un gran volumen de datos de seguimiento. En el siguiente ejemplo, se ilustra cómo configurar la tasa de muestreo:
Exporta a Cloud Trace con un TracerProvider
personalizado
Es posible que tengas casos de uso que requieran un objeto TracerProvider
personalizado. Por ejemplo, si deseas usar varios exportadores al mismo tiempo, debes crear un objeto TracerProvider
personalizado. En estos casos, puedes usar directamente el exportador de Cloud Trace:
Instrumenta tu propia aplicación
Si deseas obtener información sobre cómo configurar tu aplicación para capturar intervalos de seguimiento, consulta Registro de OpenTelemetry. En esta página, se describe cómo hacer todo lo siguiente:
- Crear un intervalo
- Crear intervalos anidados
- Establecer atributos de intervalo
- Crear intervalos con eventos
- Crear intervalos con vínculos
Aplicación de ejemplo
Para ver una aplicación de muestra, consulta la quickstart.
Configura tu plataforma
Puedes usar Cloud Trace en Google Cloud y otras plataformas.
Ejecuta en Google Cloud
Cuando tu aplicación se ejecuta en Google Cloud, no necesitas proporcionar credenciales de autenticación en el formato de una cuenta de servicio a la biblioteca cliente. Sin embargo, debes asegurarte de que Google Cloud Platform tenga habilitado el permiso de acceso a la API de Cloud Trace.
Para obtener una lista de los entornos de Google Cloud compatibles, consulta Compatibilidad de entornos.
Para las siguientes opciones de configuración, la configuración predeterminada del permiso de acceso habilita la API de Cloud Trace:
- Entorno flexible de App Engine
Entorno estándar de App Engine
Google Kubernetes Engine (GKE)
Compute Engine
Cloud Run
Si usas permisos de acceso personalizados, debes asegurarte de que el permiso de acceso a la API de Cloud Trace esté habilitado:
Si quieres obtener información para configurar los permisos de acceso de tu entorno mediante la consola de Google Cloud, consulta Configura tu proyecto de Google Cloud.
Para los usuarios de
gcloud
, especifica los niveles de acceso con la marca--scopes
y, también, incluye el permiso de acceso a la API de Cloud Tracetrace.append
. Por ejemplo, para crear un clúster de GKE solo con la API de Cloud Trace habilitada, sigue estos pasos:gcloud container clusters create example-cluster-name --scopes=https://www.googleapis.com/auth/trace.append
Ejecuta de forma local y en otros lugares
Si tu aplicación se ejecuta fuera de Google Cloud, debes proporcionar credenciales de autenticación en forma de una cuenta de servicio a la biblioteca cliente. La cuenta de servicio debe contener la función de agente de Cloud Trace. Para obtener más instrucciones, consulta Cómo crear una cuenta de servicio.
Las bibliotecas cliente de Google Cloud usan las credenciales predeterminadas de la aplicación (ADC) para encontrar las credenciales de tu aplicación.
Puedes proporcionar estas credenciales de una de estas tres maneras:
Ejecución
gcloud auth application-default login
Coloca la cuenta de servicio en una ruta de acceso predeterminada para tu sistema operativo. A continuación, se muestran las rutas predeterminadas para Windows y Linux:
Windows:
%APPDATA%/gcloud/application_default_credentials.json
Linux:
$HOME/.config/gcloud/application_default_credentials.json
Establece la variable de entorno
GOOGLE_APPLICATION_CREDENTIALS
en la ruta de acceso a la cuenta de servicio:
Linux/macOS
export GOOGLE_APPLICATION_CREDENTIALS=path-to-your-service-accounts-private-key
Windows
set GOOGLE_APPLICATION_CREDENTIALS=path-to-your-service-accounts-private-key
PowerShell:
$env:GOOGLE_APPLICATION_CREDENTIALS="path-to-your-service-accounts-private-key"
Ver seguimientos
En la consola de Google Cloud, ve a la página Explorador de seguimiento:
Ve al Explorador de seguimiento
También puedes usar la barra de búsqueda para encontrar esta página.
Soluciona problemas
Para obtener información sobre cómo solucionar problemas con Cloud Trace, ve a la página de solución de problemas.
Para depurar el exportador de Cloud Trace de C++, consulta la sección Solución de problemas de la documentación de referencia.
Recursos
- https://opentelemetry.io/
- Repositorio de GitHub open-telemetry/opentelemetry-cpp
- Biblioteca de OpenTelemetry Exporters de google-cloud-cpp en el repositorio de GitHub.