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:

• No se puede acceder a los intervalos escritos en tu Google Cloud proyecto con la API de Telemetry desde la API de Cloud Trace. Por ejemplo, si intentas enumerar estos seguimientos, el comando fallará con un 404 Not Found error.

Soluciona problemas del Análisis de registros

En esta sección, se describe cómo resolver las fallas que puedes ver cuando usas el Análisis de registros 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 puede encontrar la vista especificada en la FROM instrucción.

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

• Verifica que el nombre completo de la vista siga la sintaxis requerida por el esquema de nombres del Análisis de registros. 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 punto, (.), verifica que el campo esté envuelto en comillas invertidas simples, (`).

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

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

Se muestra el mensaje Comienza a usar el Análisis de registros

Abres la página Análisis de registros y se muestra una ventana con un mensaje similar al siguiente:

Get started with Log Analytics

Para usar el Análisis de registros, en la ventana, haz clic en Cerrar.

El mensaje anterior se muestra cuando no tienes buckets de registros que estén actualizados para usar el Análisis de registros. Sin embargo, tus datos de seguimiento no se almacenan en un bucket de registros.

Falla la unión de varias vistas

Escribes una consulta que une varias vistas, pero la consulta se marca como no válida.

No se pueden unir todas las vistas.

Para unir vistas, se aplican las siguientes restricciones:

1. Las ubicaciones de las vistas satisfacen una de las siguientes condiciones:

   • Todas las vistas tienen la misma ubicación.
   • Todas las vistas están en la ubicación global o us.

2. Cuando los recursos de almacenamiento usan claves de encriptación administradas por el cliente (CMEK), se debe cumplir una de las siguientes condiciones:

   • Los recursos de almacenamiento que usan CMEK usan la misma clave de Cloud KMS.
   • Los recursos de almacenamiento que usan CMEK tienen un ancestro común, y ese ancestro especifica una clave de Cloud KMS predeterminada que se encuentra en la misma ubicación que los recursos de almacenamiento.

   Cuando uno o más recursos de almacenamiento usan CMEK, el sistema encripta los datos temporales generados por la unión con la clave de Cloud KMS común o la clave de Cloud KMS predeterminada del ancestro.

Por ejemplo, supongamos que tienes dos vistas que residen en la misma ubicación. Luego, puedes unir estas vistas cuando se cumpla alguna de las siguientes condiciones:

• Los recursos de almacenamiento no usan CMEK.
• Un recurso de almacenamiento usa CMEK y el otro no.
• Ambos recursos de almacenamiento usan CMEK y ambos usan la misma clave de Cloud KMS.

• Ambos recursos de almacenamiento usan CMEK, pero usan claves diferentes. Sin embargo, los recursos comparten un ancestro que especifica una clave de Cloud KMS predeterminada que se encuentra en la misma ubicación que los recursos de almacenamiento.

  Por ejemplo, supongamos que la jerarquía de recursos de un bucket de registros y un bucket de observabilidad incluye la misma organización. Puedes unir vistas en esos buckets cuando, para esa organización, hayas configurado los parámetros de configuración de recursos predeterminados para Cloud Logging y para los buckets de observabilidad con la misma clave de Cloud KMS predeterminada para la ubicación de almacenamiento.

No hay datos en la página Explorador de seguimiento

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

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

• No se te otorgan 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 los problemas de las situaciones de falla enumeradas.

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 intervalos 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 intervalos 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 hayan inhabilitado la API de Cloud Trace. Estas políticas te impiden habilitar la API.

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

   Si el recuento de Solicitudes de estas dos APIs es cero, no se enviarán 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 para 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, selecciona la pestaña Métricas y consulta los Errores por método de API:

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

   • API de Cloud Trace: Rol de agente de Cloud Trace (roles/cloudtrace.agent).
   • API de Telemetry: Escritor de seguimiento de Cloud Telemetry (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 Google Cloud proyecto recibe intervalos de seguimiento. Sin embargo, existen varias situaciones en las que falla el aprovisionamiento.

Para determinar si existe un bucket de observabilidad para tus datos de seguimiento, puedes enumerar tus buckets de observabilidad o puedes abrir la página Explorador de seguimiento. Por ejemplo, puedes hacer lo siguiente:

1. En la Google Cloud consola de, 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, indica que no se aprovisionó el almacenamiento para tus datos de seguimiento.

   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 intervalo, 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 transfiere los datos de seguimiento que se enviaron en la última hora. Estos datos se almacenaron en un búfer temporal. Es posible que pasen unos minutos antes de que aparezcan los datos 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 la falla, comunícate con el equipo de asistencia Google Cloud haciendo clic en Enviar un ticket.

Falla la búsqueda de un seguimiento específico

Ingresas un ID de seguimiento en la página Explorador de seguimiento. No se encuentra el seguimiento 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 esta falla, prueba lo siguiente:

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

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

Faltan datos más antiguos en la página Explorador de seguimiento

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

La página Explorador de seguimiento no muestra datos para períodos más largos que el 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 Explorador de seguimiento se creó más recientemente que la configuración de tu período. Por ejemplo, si estableces este valor en 20 días y tú solo puedes ver los 10 días más recientes de datos, la base de datos se creó hace 10 días. Además, esta base de datos solo contiene seguimientos que se enviaron a tu Google Cloud proyecto después de que se creó la base de datos.

Se muestra un seguimiento incompleto

Abres la página Explorador de seguimiento y seleccionas un intervalo para ver. El menú desplegable Detalles muestra el seguimiento, pero no está completo. No se muestran algunos intervalos.

Es posible que falten intervalos por los siguientes motivos:

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

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

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

Para resolver estos problemas, haz lo siguiente:

1. En la página Explorador de seguimiento, asegúrate de configurar el elemento Alcance en un alcance de seguimiento que enumere 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 alcances de seguimiento.

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

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, en la barra de herramientas, haz lo siguiente:

1. Expande el elemento Alcance y, luego, identifica el alcance de seguimiento seleccionado.
2. En el menú desplegable Refinar alcance, selecciona Administrar alcances.
3. Busca el alcance de seguimiento que identificaste en el primer paso y, luego, expande los detalles para ver la lista de Google Cloud proyectos.
4. Para cada Google Cloud proyecto en el alcance de seguimiento, 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.

No se admiten las consultas interregionales

Abres la página Explorador de seguimiento y se muestra un mensaje similar al siguiente:

Error loading chart data. Cross-regional queries are not supported. The selected scope comprises buckets residing in multiple locations: list of locations.

El mensaje de error indica que la página Explorador de seguimiento debe emitir una consulta para los datos que se almacenan en diferentes ubicaciones.

Para resolver esta falla, haz una de las siguientes acciones:

• Restringe los datos de seguimiento a los que almacena el proyecto seleccionado:

  • Ve a la barra de herramientas de la página Explorador de seguimiento y expande el menú Alcance.
  • En el menú desplegable Refinar alcance, selecciona Proyecto actual.

• Selecciona un alcance de seguimiento que enumere los proyectos cuyos datos se almacenan en la misma ubicación. Para realizar este cambio, usa las opciones del menú Alcance.

• Quita del alcance de seguimiento seleccionado los proyectos cuyos datos se almacenan en una ubicación diferente a la del proyecto seleccionado:

  • Ve a la barra de herramientas de la página Explorador de seguimiento y expande el menú Alcance.
  • En el menú desplegable Refinar alcance, selecciona Administrar alcances.
  • En la página Alcances de seguimiento, puedes editar cualquier alcance de seguimiento.

  Para encontrar la ubicación de almacenamiento de tus datos de seguimiento, ejecuta el comando List observability buckets. En el parámetro de ruta de acceso, especifica tu proyecto y, para la LOCATION, establece el campo en un guion, (-), que actúa como comodín.

Falta el mensaje de ID de intervalo en el seguimiento

Tu seguimiento contiene un mensaje "Missing span ID".

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

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

Cuando ves un seguimiento incompleto, Cloud Trace muestra el mensaje "Missing span ID" en el panel de detalles del seguimiento.

Si ves constantemente el mensaje "Missing span ID", prueba lo siguiente:

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

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

• Si usas Cloud Service Mesh, verifica que sigas las instrucciones para propagar el contexto de seguimiento de esas configuraciones. Para obtener instrucciones de Cloud Service Mesh, consulta Propagación del contexto de seguimiento.

No se pueden correlacionar los datos de registro y de seguimiento

Estás haciendo una de las siguientes acciones:

• Estás viendo un intervalo de seguimiento y quieres ver las entradas de registro asociadas. Sin embargo, no se muestran datos de registro o, cuando abres la página 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 Explorador de seguimiento, no se muestran datos de seguimiento.

Para resolver estas fallas, configura el alcance de observabilidad. Este alcance especifica qué alcances de seguimiento y de registros usar cuando se abren las páginas del explorador correspondientes. Para obtener más información, consulta Configura alcances 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 actualizar la aplicación para usar OpenTelemetry, ya no ves los datos de Cloud Trace.

Debido a que algunas bibliotecas cliente de Cloud para Go están integradas con OpenCensus, debes usar un puente de 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 n.º 4237.