Soluciona problemas

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

No hay datos en la interfaz de Trace

Si no puedes ver los seguimientos en tu proyecto de Google Cloud cuando deseas que aparezcan los datos de seguimiento, prueba los siguientes pasos:

  1. En Google Cloud Console, en la barra de herramientas, haga clic en Menú de navegación y seleccione API y servicios.

  2. En el panel que enumera todas las API, asegúrate de que la API de Cloud Trace esté en la lista. Si la API de Cloud Trace aparece en la tabla, entonces la API se habilita. Continúa con el siguiente paso numérico.

    Si la API de Cloud Trace no aparece en la lista, entonces la API no está habilitada. Para habilitar la API de Cloud Trace, haz clic en Habilitar API y servicios y, luego, busca la API de Trace. Si ves una entrada para la API de Cloud Trace, selecciónala. De lo contrario, selecciona API de Stackdriver Trace. Después de seleccionar la API, haga clic en Habilitar.

  3. En el panel que enumera todas las API, si la fila deAPI de Cloud Trace no enumera ningún valor numéricoSolicitudes columnaErrores o, para otras columnas, que indica que ninguna solicitud de seguimiento llega a tu proyecto de Google Cloud. Verifica tus aplicaciones y proxies para asegurarte de que estén configurados para enviar los seguimientos al proyecto correcto.

  4. Para obtener detalles sobre el uso de la API, haz clic en API de Cloud Trace y, luego, en Métricas.

    Para limitar la fuente de los errores, usa los filtros Credenciales y Métodos y observa el efecto que tienen tus selecciones en el gráfico Errores por método de API.

    • Si todas las operaciones de escritura fallan, asegúrate de que tu cuenta de servicio tenga acceso a la función de Cloud Trace Agent. Esta función incluye el permiso cloudtrace.traces.patch. Para obtener más información, consulta funciones IAM de Cloud Trace.

    • Si las lecturas fallan, asegúrate de tener acceso a la función de Usuario de Cloud Trace para este proyecto de Google Cloud. A fin de obtener una lista completa de los permisos para esta función, consulta funciones IAM de Cloud Trace.

Falla la carga de intervalos para el exportador de Go OpenCensus

Los siguientes son ejemplos de errores que se producen cuando la biblioteca de agrupador que usa el exportador no puede administrar la cantidad de intervalos que la aplicación genera y sube:

OpenCensus Stackdriver exporter: failed to upload span: buffer full
OpenCensus Stackdriver exporter: failed to upload 183 spans: buffer full

Para resolver esta situación, prueba una o más de las siguientes opciones:

  • En la estructura Options que se pasa al constructor traceExporter, aumenta el valor del campo TraceSpansBufferMaxBytes. Este campo opcional especifica la cantidad máxima de bytes que se usan para los intervalos de almacenamiento en búfer. El valor predeterminado es 8 MB.

  • En el objeto Options que se pasa al constructor traceExporter, disminuye los valores para los siguientes campos:

    • BundleDelayThreshold: Este campo opcional especifica el tiempo máximo que el exportador puede esperar antes de subir intervalos de seguimiento. El valor predeterminado de este campo es de dos segundos.

    • BundleCountThreshold: Este campo opcional especifica la cantidad de intervalos que se pueden almacenar en búfer. El valor predeterminado de este campo es 50.

  • Exportar menos intervalos. Para reducir la cantidad de intervalos que exportas, configura un muestreo global o pasa una muestra a cada StartSpan. Para obtener un código de muestra y más información sobre estas configuraciones, consulta el Muestreo de OpenCensus.