En este documento, se describe cómo solucionar problemas cuando usas la página del Explorador de registros o la página heredada del Explorador de registros:
- Soluciona problemas de la página Explorador de seguimiento
- Soluciona problemas de la página heredada Explorador de seguimiento
Problemas conocidos
En esta sección, se enumeran los problemas conocidos:
Los intervalos escritos en tu proyecto Google Cloud con la API de Telemetría no están disponibles en la página heredada del Explorador de seguimiento. Para ver estos intervalos, usa la página predeterminada del Explorador de registros.
Los tramos escritos en tu proyecto Google Cloud con la API de Telemetría 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 en la página Explorador de seguimiento
En esta sección, se describe cómo solucionar problemas cuando usas la página Explorador de registros.
No hay datos en la página Explorador de Trace
Estás usando la página Explorador de Trace y no puedes ver ningún registro en tu proyecto Google Cloud cuando esperas que haya datos de registro.
Intenta realizar estos pasos para solucionarlo:
Verifica que la API de Cloud Trace esté habilitada y que se escriban datos en tu proyecto:
En la consola de Google Cloud , ve a la página APIs y servicios habilitados:
Si aparece la API de Cloud Trace, continúa con el siguiente paso. De lo contrario, habilita la API.
Para habilitar la API, haz clic en Habilitar APIs y servicios, busca "API de Cloud Trace", selecciona la opción y, luego, haz clic en Habilitar.
En la página Habilitar APIs y servicios, busca la fila etiquetada como API de Cloud Trace.
En la columna Requests, se indica la cantidad de solicitudes enviadas a la API de Cloud Trace. Cuando esta columna es cero, no se envían datos de seguimiento a través de esa API. Sin embargo, es posible que tengas datos de seguimiento en tu proyecto. Por ejemplo, algunos Google Cloud servicios, como el entorno estándar de App Engine, las funciones de Cloud Run y Cloud Run, envían datos de seguimiento a tu proyecto sin usar la API de Cloud Trace.
Si tienes una aplicación que envía datos de seguimiento a través de la API de Cloud Trace y la columna de solicitudes es cero, revisa tus aplicaciones y proxies para asegurarte de que estén configurados para enviar los seguimientos al proyecto correcto.
Si la columna etiquetada como Error muestra un valor distinto de cero, significa que hay errores de lectura o escritura de datos de seguimiento. Para obtener más información sobre la fuente de los errores, selecciona API de Cloud Trace, selecciona la pestaña Métricas y, luego, busca el gráfico etiquetado como Errores por método de API:
Si las escrituras fallan, otorga a la cuenta de servicio que proporciona las credenciales de autenticación el rol de agente de Cloud Trace (
roles/cloudtrace.agent
). Este rol incluye el permisocloudtrace.traces.patch
, que permite que las aplicaciones escriban datos de intervalos en un proyecto de Google Cloud .Para obtener más información, consulta las funciones de IAM de Cloud Trace.
Si las lecturas fallan, asegúrate de que tu rol de IAM en el proyecto Google Cloud incluya los permisos del rol de usuario de Cloud Trace (
roles/cloutrace.user
). Para obtener una lista de los permisos de este rol, consulta Roles de IAM de Cloud Trace.
Verifica que la página Explorador de seguimiento esté buscando datos de seguimiento en tu proyecto actual:
-
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.
- En la barra de herramientas, ve al elemento Alcance, expande el menú Refinar el alcance, selecciona Proyecto actual y, luego, Aplicar.
-
Prueba una de las siguientes opciones:
Cambia a la página Explorador de seguimiento heredado. Esta página lee los datos de seguimiento y de intervalo de una base de datos diferente de la página del Explorador de registros.
Usa la API de Cloud Trace para enviar un intervalo a tu proyecto Google Cloud . Para obtener más información, consulta Forzar la creación de la base de datos para la página Explorador de seguimiento.
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, prueba lo siguiente:
Asegúrate de que la marca de tiempo asociada al ID de seguimiento esté dentro del período de retención.
Identifica el proyecto de Google Cloud que almacena el registro y asegúrate de que el selector de recursos de la consola de Google Cloud seleccione este proyecto. De forma predeterminada, la página del Explorador de registros solo tiene acceso a los datos de registros almacenados en el proyecto seleccionado.
Faltan datos más antiguos 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.
En la página Explorador de Trace, no se muestran 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.
Para ver y analizar datos de seguimiento anteriores, cambia a la página heredada del Explorador de seguimiento. Esta página lee los datos de seguimiento y de intervalo de una base de datos diferente de la página del Explorador de registros.
Ir al Explorador de seguimiento heredado
Faltan intervalos en un registro
Abre la página Explorador de Trace y selecciona un intervalo para verlo. El menú desplegable Detalles muestra el registro, pero faltan algunos intervalos.
Es posible que falten tramos por los siguientes motivos:
La página Explorador de Trace no busca en todos los proyectos 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:
Determina si el registro está completo en la página heredada del Explorador de registros:
En el menú desplegable Detalles del registro, copia el ID del registro en el portapapeles.
Ve a la página Explorador de seguimiento heredado:
Pega el ID de seguimiento en el campo ID de seguimiento.
Se actualizará la página Detalles del seguimiento y se mostrarán los proyectos que almacenan intervalos para el seguimiento.
Si el registro está completo en la página legada del Explorador de registros, regresa a la página del Explorador de registros y configura el elemento Alcance en un alcance de registro que enumere todos los proyectos que identificaste en el paso anterior. Estos son los proyectos que almacenan los intervalos del registro seleccionado.
Si no hay un alcance de la traza que incluya los proyectos que identificaste en el paso anterior, crea o modifica un alcance de la traza existente. Para obtener más información, consulta Crea y administra ámbitos de seguimiento.
Si el registro no está completo en la página legada del Explorador de registros, significa que no se registraron los intervalos o que no tienes el rol de usuario de Cloud Trace (
roles/cloudtrace.user
) en los proyectos que almacenan los datos de los 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, haz lo siguiente en la barra de herramientas:
- Expande el elemento Alcance e identifica el alcance del registro seleccionado.
- En el menú desplegable Definir mejor el permiso, selecciona Administrar permisos.
- 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 .
- Para cada proyecto Google Cloud en el alcance del registro, asegúrate de tener 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.
Forzar la creación de la base de datos para la página Trace Explorer
Cuando los únicos datos de seguimiento de tu proyecto provienen de servicios Google Cloud que están preconfigurados para Cloud Trace, es posible que no se cree la base de datos que lee la página del Explorador de Cloud Trace para tus datos de seguimiento y de intervalo. Sin embargo, puedes forzar la creación de esta base de datos enviando un seguimiento a tu proyecto Google Cloud con la API de Cloud Trace.
Por ejemplo, puedes hacer lo siguiente:
- Ve a la página de documentación de
patchTraces
. En el panel Try this method, haz lo siguiente:
- En el campo projectId, ingresa tu PROJECT_ID.
Copia el JSON, que define un registro con un solo intervalo, en el portapapeles y, luego, pégalo en el campo Cuerpo de la solicitud.
Antes de copiar el JSON, haz lo siguiente:
- Reemplaza PROJECT_ID por el ID de tu proyecto.
Reemplaza END_TIME por la hora actual y START_TIME por un valor anterior a la hora de finalización. Si usas Linux, ejecuta
date -Isec
para obtener la hora actual en el formato correcto. Por ejemplo, puedes configurar estos campos de la siguiente manera:"startTime": "2024-05-31T15:10:35.398448Z", "endTime": "2024-05-31T15:10:35.574999047Z",
Actualiza los campos
traceId
yspanId
cada vez que ejecutes el comando."traces": [ { "projectId": "PROJECT_ID", "traceId": "33fc0d8c45bb4e5cebb29f047931270d", "spans": [ { "spanId": "17941747227541407973", "name": "/", "startTime": "START_TIME", "endTime": "END_TIME", } ] } ]
Presiona Ejecutar.
Cuando el comando se completa correctamente, el cuerpo de la respuesta está vacío. Si vas al Explorador de seguimiento, podrás ver tu registro. Puede haber un ligero retraso antes de que el registro esté disponible en la consola de Google Cloud .
Soluciona problemas en la página heredada del Explorador de seguimiento
En esta sección, se describe cómo solucionar problemas cuando usas la página heredada del Explorador de registros.
No hay datos en la interfaz heredada
Estás usando la página heredada del Explorador de registros y no puedes ver ningún registro en tu proyecto Google Cloud cuando esperas que haya datos de registro.
Para resolver este error, prueba los siguientes pasos:
-
Enable the Cloud Trace API.
En la consola de Google Cloud , ve a la página APIs & Services:
Después de encontrar la fila etiquetada como API de Cloud Trace, intenta lo siguiente:
Si la columna etiquetada como Solicitudes no muestra ninguna información numérica, no se envían datos de seguimiento a tu proyecto de Google Cloud .
Para resolver este caso, verifica tus aplicaciones y proxies para asegurarte de que estén configurados para enviar los registros al proyecto correcto.
Selecciona API de Cloud Trace, la pestaña Métricas y, luego, busca el gráfico etiquetado como Errores por método de API:
Si las escrituras fallan, otorga a la cuenta de servicio que proporciona las credenciales de autenticación el rol de agente de Cloud Trace (
roles/cloudtrace.agent
). Este rol incluye el permisocloudtrace.traces.patch
, que permite que las aplicaciones escriban datos de intervalo en un proyecto de Google Cloud .Para obtener más información, consulta las funciones de IAM de Cloud Trace.
Si las lecturas fallan, asegúrate de que tu rol de IAM en el proyecto Google Cloud incluya los permisos del rol Usuario de Cloud Trace (
roles/cloutrace.user
). Para obtener una lista de los permisos de este rol, consulta Roles de IAM de Cloud Trace.
No hay datos de seguimiento para la app implementada en la interfaz heredada
Implementaste una app que envía datos a tu proyecto de Google Cloud con la API de Cloud Trace, pero no se recopilan datos de seguimiento.
Pruebe lo siguiente:
Si no ves ningún dato en la página heredada del Explorador de seguimiento de la consola de Google Cloud , sigue los pasos que se indican en la sección No hay datos en la interfaz de Trace heredada.
Si la app no se implementa en Google Cloud o si usa una cuenta de servicio para proporcionar credenciales de autenticación, asegúrate de que se le haya otorgado a la cuenta de servicio el rol de Agente de Cloud Trace (
roles/cloudtrace.agent
).Este rol incluye el permiso
cloudtrace.traces.patch
, que permite que las aplicaciones escriban datos de intervalos en un proyecto de Google Cloud .Si la app depende de OpenTelemetry, haz lo siguiente:
En el servicio raíz, intenta actualizar tus variables de entorno para que OpenTelemetry use el muestreador
traceidratio
con una tasa de muestreo de0.5
:export OTEL_TRACES_SAMPLER="traceidratio" export OTEL_TRACES_SAMPLER_ARG="0.5"
Para todos los demás servicios, deja la variable de entorno
OTEL_TRACES_SAMPLER
sin configurar para usar el muestreador predeterminado, que esparentbased_always_on
. El parámetro de configuración predeterminado significa que la decisión de muestreo para un intervalo se hereda de su intervalo principal, si existe tal intervalo. Si no existe un tramo principal, se muestrea el tramo.
A menos que tu aplicación siempre muestree cada intervalo, en general, no es posible forzar que se realice un seguimiento de una solicitud de extremo a extremo, ya que cada componente de una solicitud de extremo a extremo toma su propia decisión de muestreo. Sin embargo, puedes influir en la decisión si agregas al encabezado de seguimiento una marca
sampled
establecida entrue
. 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.
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, asegúrate de 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, asegúrate de seguir 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 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 OpenCensus Bridge.
Para obtener información sobre la actualización de las bibliotecas cliente de Cloud para Go, consulta el problema #4237.