Solución de problemas

En esta página, se brinda información para solucionar problemas de Trace.

Problemas conocidos

En esta sección, se enumeran los problemas conocidos:

• Los tramos escritos en tu proyecto Google Cloud con la API de Telemetry no son accesibles para la API de Cloud Trace. Por ejemplo, si intentas enumerar estos registros, el comando fallará con un error 404 Not Found.

Soluciona problemas de Log Analytics

En esta sección, se describe cómo resolver los errores que pueden aparecer cuando usas Log Analytics para consultar tus datos de seguimiento.

Mensaje de error que indica que no existe una vista

Ingresas una consulta en SQL en el panel de consultas de la página Análisis de registros, pero el analizador de SQL muestra el siguiente error:

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/views/OBS_VIEW_ID does not exist

El error anterior se informa cuando no se encuentra la vista especificada en la instrucción FROM.

Para resolver este error, verifica que tu vista tenga la sintaxis correcta:

• Verifica que el nombre completamente calificado de la vista siga la sintaxis requerida por el esquema de nombres de Log Analytics. Para encontrar la sintaxis requerida de una vista, muestra su consulta predeterminada.

• Si el Google Cloud ID del proyecto, la ubicación, el ID de bucket, el ID del conjunto de datos o el ID de la vista contienen caracteres de período, (.), verifica que el campo esté encerrado entre comillas inversas simples, (`).

  Por ejemplo, si el ID de tu proyecto de Google Cloud es example.com:bluebird, la instrucción FROM sería la siguiente:

  FROM `example.com:bluebird`.`us`.`_Trace`.`Spans`.`_AllSpans`
  

No hay datos en la página Explorador de Trace

Tienes una aplicación que envía datos de seguimiento a tu proyecto Google Cloud . Sin embargo, cuando abres la página del Explorador de Trace, no se muestran datos.

Existen varios motivos posibles por los que no puedes ver los datos de seguimiento:

• No se te otorgaron los permisos necesarios para ver los datos.
• No se enviaron intervalos de seguimiento a tu proyecto.
• Tu aplicación no tiene los permisos necesarios para escribir datos de seguimiento.
• No se almacenan tus intervalos de seguimiento.

En las siguientes subsecciones, se proporciona información para solucionar problemas en las situaciones de falla mencionadas.

Verifica que tengas permiso para ver los datos de seguimiento

Para ver los datos de seguimiento, asegúrate de que se te haya otorgado el rol de usuario de Cloud Trace (roles/cloudtrace.user).

Verifica que los intervalos de seguimiento se envíen a tu proyecto

Para verificar que los tramos se envíen a tu proyecto, haz lo siguiente:

1. Enable the Cloud Trace and Telemetry APIs.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the APIs

   Ambas APIs pueden transferir segmentos de seguimiento. Sin embargo, se recomienda la API de Telemetry porque es compatible con el ecosistema de OpenTelemetry y porque tiene límites más generosos que la API de Cloud Trace.

   Nota: Es posible que haya políticas de la organización que inhabiliten la API de Cloud Trace. Estas políticas impiden que habilites la API.

2. Ve a la página APIs y servicios habilitados y busca las filas de la API de Cloud Trace y Telemetry.

   Si el recuento de Solicitudes para estas dos APIs es cero, no se envían datos de seguimiento a tu proyecto.

Verifica que tu aplicación tenga los permisos necesarios para escribir intervalos de seguimiento

Para determinar si tu aplicación tiene permiso para escribir datos de seguimiento en tu proyecto, haz lo siguiente:

1. Ve a la página APIs y servicios habilitados, busca las filas de la API de Cloud Trace y la API de Telemetry, y examina la columna Errores.

2. Si ves un valor distinto de cero en la columna Errores de cualquiera de las APIs, significa que hay errores de lectura o escritura de datos de seguimiento a través de esa API. Para identificar el tipo de error, selecciona la API, elige la pestaña Métricas y consulta la sección Errores por método de API:

   Si las escrituras fallan, otorga los siguientes roles a la cuenta de servicio que proporciona credenciales:

   • API de Cloud Trace: Rol de agente de Cloud Trace (roles/cloudtrace.agent).
   • API de Telemetry: Cloud Telemetry Trace Writer (roles/telemetry.tracesWriter).

Verifica que se almacenen tus datos de seguimiento

Los intervalos de seguimiento se almacenan en un bucket de observabilidad llamado _Trace. Ese bucket se aprovisiona automáticamente cuando tu proyecto de Google Cloud recibe intervalos de seguimiento. Sin embargo, hay varias situaciones en las que falla el aprovisionamiento.

Para determinar si existe un bucket de observabilidad para tus datos de seguimiento, puedes [listar tus buckets de observabilidad][trace-storage-list-buckets] o abrir la página del Explorador de registros. Por ejemplo, puedes hacer lo siguiente:

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

2. Si ves un banner similar al siguiente, significa que no se aprovisionó el almacenamiento para tus datos de registro.

   Trace storage is not initialized for this project. Enable trace storage to begin collecting trace data.
   

   Para aprovisionar un bucket de observabilidad para tus datos de seguimiento, ve al banner y haz clic en Habilitar.

   Cuando haces clic en Habilitar, esa acción hace que se envíe un intervalo a tu proyecto. Cuando el sistema recibe el tramo, emite el comando para crear un bucket de observabilidad llamado _Trace. Este proceso puede tardar varios minutos en completarse.

   Cuando la inicialización se realiza correctamente, se muestra un banner de notificación y Cloud Trace incorpora los datos de seguimiento que se enviaron en la última hora. Estos datos se almacenaron en un búfer temporal. Es posible que los datos tarden unos minutos en aparecer en el Explorador de seguimiento. Si no ves ningún dato, actualiza la ventana.

3. Si falla el comando enable, se muestra el siguiente mensaje:

   Initializing trace storage has failed for an unexpected reason. Please file a support ticket for assistance.
   

   Para resolver el error, comunícate con el equipo de asistencia haciendo clic en Enviar un ticket. Google Cloud

Falla la búsqueda de un registro específico

Ingresa un ID de seguimiento en la página Explorador de seguimiento. No se encuentra el registro y se muestra un mensaje similar al siguiente:

The select trace with ID abcde does not exist or is older than 30 days and has been deleted per our retention policy.

Para resolver este error, intenta lo siguiente:

1. Verifica que la marca de tiempo asociada al ID de seguimiento esté dentro del período de retención.

2. Identifica el proyecto de Google Cloud que almacena el registro y verifica que el selector de recursos de la consola de Google Cloud seleccione este proyecto. De forma predeterminada, la página Trace Explorer solo tiene acceso a los datos de seguimiento almacenados en el proyecto seleccionado.

Faltan datos anteriores en la página Explorador de Trace

Estás usando la página Explorador de registros y puedes ver datos recientes, pero cuando configuras el selector de período en 30 días o en un valor mayor, no se muestran los datos más antiguos.

La página Trace Explorer no muestra datos para períodos superiores al período de retención de datos de Cloud Trace, que es de 30 días.

Si el selector de período es de 30 días o menos, los datos faltantes indican que la base de datos consultada por la página del Explorador de registros se creó más recientemente que tu configuración de período. Por ejemplo, si estableces este valor en 20 días y solo puedes ver los datos de los últimos 10 días, significa que la base de datos se creó hace 10 días. Además, esta base de datos solo contiene registros que se enviaron a tu proyecto Google Cloud después de que se creó la base de datos.

Se muestra un registro incompleto

Abre la página Explorador de Trace y selecciona un intervalo para verlo. El menú desplegable Detalles muestra el registro, pero no está completo. No se muestran algunos intervalos.

Es posible que falten tramos por los siguientes motivos:

• La página Explorador de Trace no busca en todos los proyectos de Google Cloud que almacenan datos de intervalos para el registro.

• Tu rol de IAM en un proyecto Google Cloud que almacena datos de tramo para el registro no contiene los permisos necesarios para ver los datos de registro.

• Hay un problema de instrumentación. Por ejemplo, solo se enviaron algunos intervalos de un registro a tu proyecto de Google Cloud .

Para resolver estos problemas, haz lo siguiente:

1. En la página Explorador de seguimientos, asegúrate de establecer el elemento Alcance en un permiso de seguimiento que muestre los proyectos que almacenan los intervalos del seguimiento seleccionado.

   Si no hay un alcance de seguimiento que incluya los proyectos que identificaste en el paso anterior, crea o modifica un alcance de seguimiento existente. Para obtener más información, consulta Crea y administra ámbitos de seguimiento.

2. Verifica que tengas el rol de usuario de Cloud Trace (roles/cloudtrace.user) en los proyectos que almacenan los datos de intervalo.

No tienes los permisos necesarios para ver los datos de seguimiento

Estás viendo la página Explorador de seguimiento y ves la siguiente notificación:

You don't have the required permissions to view trace data for one or more projects listed in the trace scope.

Para resolver este mensaje, haz lo siguiente en la barra de herramientas:

1. Expande el elemento Alcance e identifica el alcance del registro seleccionado.
2. En el menú desplegable Define mejor el permiso, selecciona Administrar permisos.
3. Ubica el alcance del registro que identificaste en el primer paso y, luego, expande los detalles para ver la lista de proyectos de Google Cloud .
4. Para cada proyecto Google Cloud en el alcance del registro, verifica que tengas el rol de usuario de Cloud Trace (roles/cloudtrace.user). Si no tienes ese rol en un proyecto, pídele a un administrador o propietario del proyecto que te lo otorgue.

Falta el mensaje del ID de intervalo en el registro

Tu registro contiene el mensaje "Missing span ID".

En los sistemas de seguimiento distribuido, se esperan seguimientos incompletos. Un registro es incompleto cuando un intervalo muestreado contiene una referencia a otro intervalo que no se recibió. La referencia no resuelta puede deberse a los siguientes motivos:

• No se muestreó el intervalo al que se hace referencia.
• Se tomó una muestra del intervalo al que se hace referencia, pero Cloud Trace aún no la recibió, o bien se recibió el intervalo, pero no se almacenó.

Cuando visualizas un seguimiento incompleto, Cloud Trace muestra el mensaje "Falta el ID del intervalo" en el panel de detalles del seguimiento.

Si ves el mensaje "Falta el ID de intervalo" de forma constante, prueba lo siguiente:

• En el caso de los componentes que administras, verifica que respeten y propaguen la marca sampled del encabezado cuando este campo esté presente. Este parámetro de configuración es una sugerencia para que los componentes secundarios muestren una muestra de la solicitud. Para obtener más información sobre los encabezados de seguimiento, consulta Protocolos para la propagación del contexto.

  Por lo general, los servicios deGoogle Cloud respetan esta sugerencia. Sin embargo, también limitan la velocidad a la que escriben los datos de seguimiento.

• Si usas Cloud Service Mesh, verifica que sigas la guía para propagar el contexto de seguimiento de esas configuraciones. Para obtener orientación sobre Cloud Service Mesh, consulta Propagación del contexto de seguimiento.

No se pueden correlacionar los datos de registro y de seguimiento

Estás realizando una de las siguientes acciones:

• Estás viendo un intervalo de seguimiento y quieres ver las entradas de registro asociadas. Sin embargo, no se muestra ningún dato de registro o, cuando abres la página del Explorador de registros, no se muestran entradas de registro.

• Estás viendo una entrada de registro y quieres ver los intervalos de seguimiento asociados. Sin embargo, cuando usas las opciones de la entrada de registro para abrir la página del Explorador de Trace, no se muestran datos de seguimiento.

Para resolver estos errores, configura el permiso de observabilidad. Este alcance especifica cuáles de tus alcances de seguimiento y de registros se usarán cuando se abran las páginas del explorador correspondientes. Para obtener más información, consulta Configura permisos de observabilidad para consultas de varios proyectos.

No hay datos de seguimiento después de actualizar la app de Go para usar OpenTelemetry

Tu aplicación depende de la biblioteca cliente para capturar seguimientos y, después de actualizarla para usar OpenTelemetry, ya no ves los datos de Cloud Trace.

Debes usar un puente de OpenCensus, ya que algunas bibliotecas cliente de Cloud para Go están integradas con OpenCensus. Para obtener más información sobre el problema que resuelve el puente, consulta Puente de OpenCensus.

Para obtener información sobre la actualización de las bibliotecas cliente de Cloud para Go, consulta el problema #4237.