Solucionar problemas

Esta página contiene información para solucionar problemas de Trace.

En este documento se describe cómo solucionar problemas al usar la página Explorador de trazas o la página Explorador de trazas antigua:

Problemas conocidos

En esta sección se enumeran los problemas conocidos:

  • Los intervalos escritos en tu Google Cloud proyecto mediante la API Telemetry no están disponibles en la página antigua Explorador de trazas. Para ver estos intervalos, usa la página Explorador de trazas predeterminada.

  • Los intervalos escritos en tu Google Cloud proyecto mediante la API Telemetry no son accesibles para la API Cloud Trace. Por ejemplo, si intentas enumerar estas trazas, el comando fallará y se mostrará un error 404 Not Found.

Solucionar problemas de la página Explorador de trazas

En esta sección se describe cómo solucionar problemas al usar la página Explorador de trazas.

No hay datos en la página Explorador de rastreo

Estás usando la página Explorador de trazas y no puedes ver ninguna traza en tu proyecto Google Cloud cuando esperas que haya datos de traza.

Prueba estos pasos:

  1. Comprueba que la API Cloud Trace esté habilitada y que se estén escribiendo datos en tu proyecto:

    1. En la Google Cloud consola, ve a la página APIs y servicios habilitados:

      Ve a APIs y servicios habilitados.

    2. Si la API de Cloud Trace aparece en la lista, ve al paso siguiente. 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, a continuación, haz clic en Habilitar.

  2. En la página APIs y servicios habilitados, busca la fila API de Cloud Trace.

  3. Si en la columna Error se muestra un valor distinto de cero, significa que se han producido errores al leer o escribir datos de traza a través de la API Cloud Trace. Para obtener más información sobre el origen de los errores, selecciona API de Cloud Trace, la pestaña Métricas y, a continuación, busca el gráfico Errores por método de API:

    • Si las escrituras fallan, concede a la cuenta de servicio que proporciona las credenciales de autenticación el rol Agente de Cloud Trace (roles/cloudtrace.agent). Este rol incluye el permiso cloudtrace.traces.patch, que permite a las aplicaciones escribir datos de intervalo en un proyecto Google Cloud .

      Para obtener más información, consulta los roles de gestión de identidades y accesos de Cloud Trace.

    • Si las lecturas fallan, asegúrate de que tu rol de gestión de identidades y accesos en el proyecto Google Cloud incluya los permisos del rol de usuario de Cloud Trace (roles/cloutrace.user). Para ver una lista de los permisos de este rol, consulta Roles de gestión de identidades y accesos de Cloud Trace.

  4. En la columna Solicitudes se indica el número de solicitudes enviadas a la API Cloud Trace. Si el valor de esta columna es cero, significa que no se están enviando datos de rastreo a través de esa API.

    App Engine, Cloud Run y las funciones de Cloud Run envían datos de traza sin usar la API Cloud Trace. Si solo usas estos servicios, ve al paso siguiente.

    Si tienes una aplicación que envía datos de traza a través de la API Cloud Trace y la columna de solicitudes es cero, comprueba tus aplicaciones y proxies para verificar que estén configurados para enviar las trazas al proyecto correcto.

  5. En la página Explorador de trazas, comprueba que se ha inicializado el almacenamiento de trazas:

    1. En la Google Cloud consola, ve a la página Explorador de trazas:

      Ir a Explorador de trazas

      También puedes encontrar esta página mediante la barra de búsqueda.

    2. Si el almacenamiento de rastreo no se ha inicializado, la página Explorador de rastreo muestra un banner con el siguiente texto:

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

      Para inicializar el almacenamiento de trazas, en el banner, haz clic en Habilitar. La inicialización suele completarse en unos minutos.

      Si la inicialización se realiza correctamente, se muestra un banner de notificación. Trace ingiere los datos de traza enviados en la última hora, que se almacenaron previamente en un búfer. Puedes actualizar la página en unos minutos cuando los datos empiecen a aparecer en Explorador de trazas.

      Si ves un mensaje de error que indica que la inicialización ha fallado, un miembro del equipo de Asistencia debe resolver el problema manualmente. Google Cloud Haz clic en Enviar una incidencia para iniciar este proceso.

  6. Comprueba que la página Explorador de trazas esté buscando datos de trazas en tu proyecto actual. En la barra de herramientas, ve al elemento Ámbito, despliega el menú Acotar ámbito, selecciona Proyecto actual y, a continuación, Aplicar.

Falla la búsqueda de una traza específica

Introduces un ID de traza en la página Explorador de trazas. 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 solucionar este problema, prueba lo siguiente:

  1. Verifica que la marca de tiempo asociada al ID de traza esté dentro del periodo de conservación.

  2. Identifica el Google Cloud proyecto que almacena el rastreo y asegúrate de que el selector de recursos de la Google Cloud consola lo tenga seleccionado. De forma predeterminada, la página Explorador de trazas solo tiene acceso a los datos de traza almacenados en el proyecto seleccionado.

Faltan datos antiguos en la página Explorador de trazas

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

La página Explorador de trazas no muestra datos de periodos superiores al periodo de conservación de datos de Cloud Trace, que es de 30 días.

Si el selector de periodo es de 30 días o menos, los datos que faltan indican que la base de datos consultada por las consultas de la página Explorador de trazas se creó más recientemente que el periodo que has definido. Por ejemplo, si asignas el valor 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 las trazas que se enviaron a tu Google Cloud proyecto después de que se creara la base de datos.

Para ver y analizar datos de traza antiguos, cambia a la página antigua Explorador de trazas. Esta página lee datos de trazas y de intervalos de una base de datos diferente a la de la página Explorador de trazas.

Ir a Explorador de Trace antiguo

Faltan intervalos en un rastreo

Abre la página Explorador de trazas y selecciona un intervalo para verlo. El menú desplegable Detalles muestra el seguimiento, pero faltan algunos intervalos.

Puede que falten intervalos por los siguientes motivos:

  • La página Explorador de trazas no busca en todos los Google Cloud proyectos que almacenan datos de intervalo de la traza.

  • Tu rol de gestión de identidades y accesos en un Google Cloud proyecto que almacena datos de intervalo de la traza no contiene los permisos necesarios para ver los datos de la traza.

  • Hay un problema de instrumentación. Por ejemplo, solo se han enviado algunos intervalos de una traza a tu proyecto de Google Cloud .

Para solucionar estos problemas, sigue estos pasos:

  1. Determina si el rastreo se ha completado en la página antigua Explorador de rastreos:

    1. En la ventana emergente Detalles del rastreo, copia el ID de rastreo en el portapapeles.

    2. Ve a la página Explorador de trazas antigua:

      Ir a Explorador de Trace antiguo

    3. Pega el ID de seguimiento en el campo ID de seguimiento.

      La página Detalles de traza se actualiza y muestra los proyectos que almacenan los intervalos de la traza.

  2. Si la traza está completa en la página antigua Explorador de trazas, vuelve a la página Explorador de trazas y define el elemento Ámbito en un ámbito de traza que incluya todos los proyectos que hayas identificado en el paso anterior. Estos son los proyectos que almacenan los intervalos del rastreo seleccionado.

    Si no hay ningún ámbito de traza que incluya los proyectos que has identificado en el paso anterior, crea o modifica uno. Para obtener más información, consulta Crear y gestionar ámbitos de traza.

  3. Si el rastreo no se completa en la página Explorador de rastreos antigua, significa que no se han registrado 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 trazas

Estás viendo la página Explorador de trazas 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 que no aparezca este mensaje, sigue estos pasos en la barra de herramientas:

  1. Despliega el elemento Ámbito e identifica el ámbito de la traza seleccionado.
  2. En el menú desplegable Acotar, selecciona Gestionar ámbitos.
  3. Busque el ámbito de la traza que ha identificado en el primer paso y, a continuación, despliegue los detalles para ver la lista de Google Cloud proyectos.
  4. En cada Google Cloud proyecto del ámbito de la traza, comprueba que tienes el rol de usuario de Cloud Trace (roles/cloudtrace.user). Si no tienes ese rol en un proyecto, pide a un administrador o propietario del proyecto que te lo conceda.

Falla la inicialización del almacenamiento de trazas

Intentas inicializar el almacenamiento de trazas haciendo clic en Habilitar en el banner que se muestra en el Explorador de trazas y aparece el siguiente error:

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

Si la inicialización del almacenamiento falla, un miembro del equipo de asistencia de Google Cloud debe resolver el problema manualmente. Para ponerte en contacto con el equipo de Asistencia, haz clic en Abrir incidencia.

Solucionar problemas de la página antigua Explorador de trazas

En esta sección se describe cómo solucionar los problemas que se producen al usar la página antigua Explorador de rastreos.

No hay datos en la interfaz antigua

Estás usando la página antigua Explorador de trazas y no puedes ver ninguna traza en tu Google Cloud proyecto cuando esperas que haya datos de trazas.

Para solucionar este error, prueba a seguir estos pasos:

  1. Enable the Cloud Trace API.

    Enable the API

  2. En la Google Cloud consola, ve a la página APIs & Services (APIs y servicios):

    Ve a APIs y servicios.

    Una vez que hayas encontrado la fila API de Cloud Trace, haz lo siguiente:

    • Si en la columna Solicitudes no aparece ninguna información numérica, significa que no se están enviando datos de seguimiento a su proyecto de Google Cloud .

      Para resolver este caso, compruebe sus aplicaciones y proxies para asegurarse de que estén configurados para enviar las trazas al proyecto correcto.

    • Selecciona API Cloud Trace, la pestaña Métricas y, a continuación, busca el gráfico Errores por método de API:

      • Si las escrituras fallan, asigna a la cuenta de servicio que proporciona las credenciales de autenticación el rol Agente de Cloud Trace (roles/cloudtrace.agent). Este rol incluye el permiso cloudtrace.traces.patch, que permite a las aplicaciones escribir datos de intervalo en un proyecto Google Cloud .

        Para obtener más información, consulta los roles de gestión de identidades y accesos de Cloud Trace.

      • Si las lecturas fallan, asegúrate de que tu rol de gestión de identidades y accesos en el proyecto Google Cloud incluya los permisos del rol Usuario de Cloud Trace (roles/cloutrace.user). Para ver una lista de los permisos de este rol, consulta Roles de gestión de identidades y accesos de Cloud Trace.

No hay datos de traza de la aplicación desplegada en la interfaz antigua

Has implementado una aplicación que envía datos a tu proyecto Google Cloud mediante la API Cloud Trace, pero no se recogen datos de traza.

Prueba a hacer lo siguiente:

  • Si no ves ningún dato en la página Explorador de trazas antigua de la consola de Google Cloud , sigue los pasos de la sección No hay datos en la interfaz antigua de Trace.

  • Si la aplicación no se ha implementado en Google Cloud o si usa una cuenta de servicio para proporcionar credenciales de autenticación, asegúrate de que la cuenta de servicio tenga el rol de agente de Cloud Trace (roles/cloudtrace.agent).

    Este rol incluye el permiso cloudtrace.traces.patch, que permite a las aplicaciones escribir datos de intervalo en un proyecto Google Cloud .

  • Si la aplicación depende de OpenTelemetry, haz lo siguiente:

    • En el caso del servicio raíz, prueba a actualizar las variables de entorno para que OpenTelemetry use el muestreador traceidratio con una frecuencia de muestreo de 0.5:

      export OTEL_TRACES_SAMPLER="traceidratio"
export OTEL_TRACES_SAMPLER_ARG="0.5"

    • En el resto de los servicios, no definas la variable de entorno OTEL_TRACES_SAMPLER para usar el muestreador predeterminado, que es parentbased_always_on. El ajuste predeterminado significa que la decisión de muestreo de un intervalo se hereda de su intervalo superior, si existe. Si no existe un intervalo superior, se toma una muestra del intervalo.

    A menos que tu aplicación siempre muestree cada intervalo, por lo general, no es posible forzar que se trace una solicitud de principio a fin, ya que cada componente de una solicitud de principio a fin toma su propia decisión de muestreo. Sin embargo, puede influir en la decisión añadiendo al encabezado de la traza una marca sampled con el valor true. Este ajuste es una pista 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 de contexto.

Falta el mensaje de ID de intervalo en la traza

Tu traza contiene el mensaje "Missing span ID" (Falta el ID de intervalo).

En los sistemas de monitorización de trazas distribuidas, es normal que haya trazas incompletas. Una traza está incompleta cuando un intervalo muestreado contiene una referencia a otro intervalo que no se ha recibido. La referencia sin resolver puede deberse a los siguientes motivos:

  • No se ha tomado una muestra del intervalo al que se hace referencia.
  • Se ha tomado una muestra del intervalo al que se hace referencia, pero Cloud Trace aún no la ha recibido o se ha recibido, pero no se ha almacenado.

Cuando ves una traza incompleta, Cloud Trace muestra el mensaje "Missing span ID" (Falta el ID de intervalo) en el panel de detalles de la traza.

Si ves el mensaje "Missing span ID" de forma constante, prueba lo siguiente:

  • En el caso de los componentes que gestionas, asegúrate de que respeten y propaguen la marca sampled del encabezado cuando este campo esté presente. Este ajuste es una pista para que los componentes secundarios muestren la solicitud. Para obtener más información sobre los encabezados de seguimiento, consulta Protocolos para la propagación de contexto.

    Los servicios deGoogle Cloud suelen respetar esta sugerencia. Sin embargo, también limitan la frecuencia con la que escriben datos de traza.

  • Si usas Cloud Service Mesh, asegúrate de seguir las directrices para propagar el contexto de la traza en esas configuraciones. Para obtener información sobre Cloud Service Mesh, consulta Propagación del contexto de seguimiento.

No hay datos de traza después de actualizar la aplicación Go para usar OpenTelemetry

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

Como algunas bibliotecas de 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 OpenCensus.

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