En este documento se describe cómo crear y gestionar un ámbito de traza, lo que permite que la página Explorador de trazas encuentre los intervalos de traza que quieras ver o analizar. Si solo quiere ver y analizar los intervalos que se originan en su Google Cloud proyecto, no tiene que configurar ningún ámbito de traza. Sin embargo, si los datos de la traza se almacenan en varios proyectos, como puede ocurrir cuando se usa una arquitectura de microservicios, debe realizar algunas actividades de configuración para ver todos los intervalos de un solo proyecto. Google Cloud
En este documento no se describe cómo ver tus trazas y spans. Para obtener información sobre este tema, consulta Buscar y explorar trazas.
Esta función solo se admite en proyectos de Google Cloud . En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
Acerca de los permisos de trazas
Los ámbitos de traza son recursos persistentes a nivel de proyecto que enumeran un conjunto de proyectos. Google Cloud Puede configurar la página Explorador de trazas para buscar por ámbito de traza, lo que significa que la página busca los proyectos que se incluyen en el ámbito seleccionado. Los roles de Gestión de Identidades y Accesos (IAM) que tengas en los proyectos buscados y el ajuste del periodo determinan qué datos se obtienen del almacenamiento y se muestran.
Cuando creas un Google Cloud proyecto, se crea un ámbito de traza llamado _Default. Este ámbito solo incluye el proyecto Google Cloud . No puedes añadir proyectos a este ámbito ni eliminarlo.
Puedes crear ámbitos de traza, así como modificar y eliminar los que crees. Quieres crear un ámbito de seguimiento cuando tienes un servicio que escribe datos de intervalo en varios proyectos de Google Cloud .
A menos que abras la página Explorador de rastreo con una URL que incluya un ámbito de rastreo o un ID de rastreo y de intervalo, la página Explorador de rastreo buscará datos de rastreo en los proyectosGoogle Cloud que se incluyan en el ámbito de rastreo predeterminado.
Cuando creas un proyecto, el ámbito de traza llamado _Default se define como el ámbito de traza predeterminado. Sin embargo, puede seleccionar otro ámbito de seguimiento para usarlo como ámbito de seguimiento predeterminado.
Aplicaciones y ámbitos de rastreo de App Hub
Es posible que tus aplicaciones de App Hub escriban datos de traza en varios proyectos. Para obtener una vista agregada de estos datos, crea un ámbito de traza, configúralo para que muestre todos los proyectos que almacenan tus datos de traza y, a continuación, configúralo como ámbito de traza predeterminado. Cuando completes estos pasos, la página Explorador de trazas mostrará automáticamente los datos escritos por tu aplicación, aunque estén almacenados en proyectos diferentes.
Crea el ámbito de seguimiento personalizado en el proyecto desde el que vas a ver tus datos de registro. Este proyecto es el proyecto host de tu centro de aplicaciones o el proyecto de gestión de tu carpeta habilitada para aplicaciones.
Por ejemplo, si el nombre visible de la carpeta es
My Folder, el nombre visible del proyecto de gestión es
My Folder-mp.
Antes de empezar
Para obtener los permisos que necesitas para crear y ver ámbitos de traza,
pide a tu administrador que te conceda el rol de gestión de identidades y accesos
Usuario de Cloud Trace (roles/cloudtrace.user)
en tu proyecto.
Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.
Este rol predefinido contiene los permisos necesarios para crear y ver ámbitos de traza. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:
Permisos obligatorios
Se necesitan los siguientes permisos para crear y ver ámbitos de traza:
-
Para crear y gestionar ámbitos de seguimiento, sigue estos pasos:
cloudtrace.traceScopes.{create, delete, get, list, update}
También puedes obtener estos permisos con roles personalizados u otros roles predefinidos.
Se necesitan permisos adicionales para definir el ámbito de la traza predeterminado. Estos permisos se describen en la sección Configurar el ámbito de la traza predeterminado de este documento.
Mostrar ámbitos de traza
Consola
Para enumerar los ámbitos de seguimiento, haz lo siguiente:
-
En la Google Cloud consola, ve a la página settings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.
- En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
Selecciona la pestaña Ámbitos de traza.
En la tabla se muestran los ámbitos de seguimiento. Cuando hayas seleccionado un Google Cloud proyecto, se mostrará una entrada con el icono "Predeterminado",
,
que indica que es el ámbito de seguimiento predeterminado.
La página Explorador de trazas busca datos de trazas en los proyectos que se incluyen en el
ámbito de trazas predeterminado cuando se abre la página.
Crear un ámbito de rastreo
Los intervalos que se muestran en la página Explorador de trazas dependen de los proyectos buscados, de tus roles de gestión de identidades y accesos en esos proyectos, del periodo y de los filtros que apliques.
Puedes crear 100 ámbitos de traza por proyecto. Un ámbito de traza puede incluir un total de 20 proyectos.
Consola
Para crear un ámbito de traza, haz lo siguiente:
-
En la Google Cloud consola, ve a la página settings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.
- En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
- Selecciona la pestaña Ámbitos de traza y, a continuación, haz clic en Crear ámbito de traza.
Haz clic en Añadir proyectos y completa el cuadro de diálogo.
Cuando añades un proyecto, los intervalos almacenados en ese proyecto se incluyen en el ámbito del rastreo. Si no sabes qué proyectos incluir en un ámbito, puedes usar la página antigua Explorador de trazas para identificarlos. Para obtener más información, consulta la sección Migrar a ámbitos de seguimiento de este documento.
En la sección Nombre del ámbito de la traza, introduce el nombre y la descripción que quieras que se muestren en la pestaña Ámbitos de la traza.
El nombre de un ámbito de traza no se puede modificar y debe ser único en el proyecto.
Haz clic en Crear ámbito de traza.
Migrar a ámbitos de traza
En la página Explorador de trazas, debe especificar los Google Cloud proyectos en los que buscar datos de trazas, lo que supone un cambio en el comportamiento respecto a la página Explorador de trazas anterior. La página antigua Explorador de trazas busca en todos los proyectos de una organización. Debido a estas diferencias, es posible que la página Explorador de trazas no muestre los intervalos que sí muestra la página Explorador de trazas antigua.
Puedes usar la sección del panel Detalles del rastreo de la página antigua Explorador de rastreo para compilar una lista deGoogle Cloud proyectos que almacenan tus datos de rastreo:
Ve a la página antigua Explorador de trazas:
En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
Selecciona una traza.
Puedes probar lo siguiente:
- Ver un rastreo introduciendo su ID en el campo ID de rastreo.
- Añadir filtros.
En el panel Detalles del rastreo, selecciona el rastreo y, a continuación, ve a la pestaña Proyectos.
En esta pestaña se muestran los proyectos que almacenan los intervalos de la traza.
Para crear un ámbito de rastreo que contenga los proyectos de la lista, vaya a la barra de herramientas de la pestaña Proyectos y seleccione Crear ámbito con estos proyectos. A continuación, complete el cuadro de diálogo.
Repite los pasos anteriores hasta que hayas creado una lista de proyectos.
Una vez que hayas compilado una lista de proyectos, crea un ámbito de traza. También puedes definirlo como el ámbito de seguimiento predeterminado.
Modificar o eliminar un ámbito de traza
No puedes eliminar ni modificar el ámbito de
seguimiento llamado _Default. Puedes modificar o eliminar todos los demás ámbitos de traza.
Consola
Para modificar o eliminar un ámbito de seguimiento, haz lo siguiente:
-
En la Google Cloud consola, ve a la página settings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.
- En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
- Selecciona la pestaña Ámbitos de traza.
Busca el ámbito de la traza que quieras modificar o eliminar, haz clic en more_vert Más y, a continuación, haz una de las siguientes acciones:
- Para modificarlo, selecciona Editar ámbito y, a continuación, completa el cuadro de diálogo.
- Para eliminarlo, selecciona Eliminar ámbito y, a continuación, completa el cuadro de diálogo.
Configurar el ámbito de la traza predeterminado
Cuando se abre la página Explorador de trazas, se buscan datos de trazas en los proyectos que se muestran en el ámbito de trazas predeterminado. Si no se puede acceder a ese ámbito de seguimiento, se buscarán datos de seguimiento en tu proyecto.
Cuando se crean proyectos, se crea el ámbito de traza _Default y se designa como ámbito de traza predeterminado. Sin embargo, puedes crear tu propio ámbito de traza y designarlo como ámbito de traza predeterminado.
Antes de empezar
-
Enable the Observability API.
Antes de habilitar la API, asegúrese de que esté seleccionado el proyecto correcto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
-
Para obtener los permisos que necesitas para crear y ver ámbitos de traza, así como para definir el ámbito de traza predeterminado, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en tu proyecto:
-
Usuario de Cloud Trace (
roles/cloudtrace.user) -
Editor de observabilidad (
roles/observability.editor)
Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.
Estos roles predefinidos contienen los permisos necesarios para crear y ver ámbitos de traza, así como para definir el ámbito de traza predeterminado. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:
Permisos obligatorios
Se necesitan los siguientes permisos para crear y ver ámbitos de traza, así como para definir el ámbito de traza predeterminado:
-
Para crear y gestionar ámbitos de seguimiento, sigue estos pasos:
cloudtrace.traceScopes.{create, delete, get, list, update} -
Para definir el ámbito de la traza predeterminado, sigue estos pasos:
observability.scopes.{get, update}
También puedes obtener estos permisos con roles personalizados u otros roles predefinidos.
-
Usuario de Cloud Trace (
Definir el ámbito predeterminado
Consola
Para definir el ámbito de la traza predeterminado, haz lo siguiente:
-
En la Google Cloud consola, ve a la página settings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.
- En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
Selecciona la pestaña Ámbitos de traza.
En la pestaña se muestran los ámbitos de seguimiento y se incluye un botón para crear un ámbito de seguimiento personalizado.
Busca el ámbito de la traza que quieras designar como ámbito de la traza predeterminado, haz clic en more_vert Más y, a continuación, selecciona Definir como predeterminado.
El ámbito de la traza que has seleccionado se muestra con un icono "Predeterminado",
.
Limitaciones
No se puede usar la API Cloud Trace ni la CLI de Google Cloud para crear o gestionar ámbitos de traza.
Límites de los ámbitos de los rastreos
| Límites de los ámbitos de los rastreos | Valor |
|---|---|
| Número máximo de ámbitos de traza por proyecto | 100 |
| Número máximo de proyectos por ámbito de traza | 20 |
Siguientes pasos
Cloud Logging y Cloud Monitoring contienen estructuras similares que te permiten controlar los datos de registro o los datos de métricas que puedes ver o monitorizar. Para obtener información sobre esos ámbitos, consulta los siguientes documentos: