En este documento, se describe cómo puedes crear y administrar un alcance de seguimiento, que permite que la página Explorador de seguimiento encuentre los intervalos de seguimiento que deseas ver o analizar. Si solo deseas ver y analizar los intervalos que se originan en tu proyecto de Google Cloud, no necesitas configurar ningún permiso de seguimiento. Sin embargo, si tus datos de seguimiento se almacenan en varios proyectos, como podría ocurrir cuando usas una arquitectura de microservicios, debes realizar algunas actividades de configuración para ver todos los intervalos de un solo proyecto de Google Cloud.
En este documento, no se describe cómo ver tus seguimientos y tramos. Para obtener más información sobre ese tema, consulta Busca y explora seguimientos.
Acerca de los permisos de seguimiento
Los permisos de seguimiento son recursos persistentes a nivel del proyecto que enumeran un conjunto de proyectos de Google Cloud. Puedes configurar la página del Explorador de seguimientos para que realice búsquedas por permiso de seguimiento, lo que significa que la página busca los proyectos que se enumeran en el permiso seleccionado. Tus roles de Identity and Access Management (IAM) en los proyectos buscados y la configuración del período determinan qué datos se recuperan del almacenamiento y, luego, se muestran.
Cuando creas un proyecto de Google Cloud, se crea un permiso de seguimiento llamado _Default. Este alcance solo incluye el proyecto de Google Cloud. No puedes agregar proyectos a este permiso ni borrarlo.
Puedes crear alcances de seguimiento y modificarlos y borrarlos. Quieres crear un alcance 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 seguimientos con una URL que incluya un
permiso de seguimiento o un ID de seguimiento y de intervalo,
la página Explorador de seguimientos busca datos de seguimiento en los
proyectos de Google Cloud que se enumeran en el permiso de seguimiento predeterminado.
Cuando creas tu proyecto, el ámbito de seguimiento llamado _Default se
establece como el ámbito de seguimiento predeterminado. Sin embargo, puedes seleccionar un ámbito de seguimiento diferente para usarlo como el predeterminado.
Antes de comenzar
Para obtener los permisos que necesitas para crear y ver ámbitos de seguimiento, y establecer el ámbito de seguimiento predeterminado, pídele a tu administrador que te otorgue los siguientes roles de IAM:
-
Para crear y ver ámbitos de seguimiento y obtener el ámbito de seguimiento predeterminado, obtén el rol de usuario de Cloud Trace (
roles/cloudtrace.user) en tu proyecto. -
Para configurar el ámbito de seguimiento predeterminado, usa el rol de editor de observabilidad (
roles/observability.editor) en tu proyecto.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Estos roles predefinidos contienen los permisos necesarios para crear y ver ámbitos de seguimiento, y para establecer el ámbito de seguimiento predeterminado. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para crear y ver ámbitos de seguimiento, y para establecer el ámbito de seguimiento predeterminado:
-
Para crear y administrar alcances de seguimiento, haz lo siguiente:
cloudtrace.traceScopes.[create, delete, get, list, update] -
Para establecer el alcance de seguimiento predeterminado, haz lo siguiente:
observability.scopes.[get, update]
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Enumera los permisos de Trace
Para enumerar los permisos de seguimiento, haz lo siguiente:
-
En la consola de Google Cloud, ve a la páginasettings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
Selecciona la pestaña Trace Scopes.
En la tabla, se enumeran tus alcances de seguimiento. Cuando seleccionas un proyecto de Google Cloud, se muestra una entrada con el ícono "Predeterminado",
,
que indica que es el alcance de registro predeterminado.
Cuando se abre la página del Explorador de seguimientos, esta busca datos de seguimiento en los proyectos que se enumeran en el
alcance de seguimiento predeterminado.
Crea un permiso de seguimiento
Los intervalos que muestra la página Explorador de seguimientos dependen de los proyectos que se buscaron, tus roles de IAM en esos proyectos, la configuración del período y los filtros que apliques.
Puedes crear 100 permisos de seguimiento por proyecto. Un alcance de seguimiento puede incluir un total de 20 proyectos.
Para crear un alcance de seguimiento, haz lo siguiente:
-
En la consola de Google Cloud, ve a la páginasettings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- Selecciona la pestaña Trace Scopes y, luego, haz clic en Create trace scope.
Haz clic en Agregar proyectos y completa el cuadro de diálogo.
Cuando agregas un proyecto, los intervalos almacenados en ese proyecto se incluyen en el alcance del seguimiento. Si no sabes qué proyectos incluir en un permiso, puedes usar la página heredada del Explorador de seguimientos para ayudarte a identificarlos. Para obtener más información, consulta la sección Cómo migrar a los alcances de seguimiento de este documento.
En la sección Nombre del alcance de seguimiento, ingresa el nombre y la descripción que quieres que aparezcan en la pestaña Alcances de seguimiento.
El nombre de un alcance de seguimiento no se puede modificar y debe ser único dentro del proyecto.
Haz clic en Crear alcance de seguimiento.
Migra a permisos de seguimiento
La página Explorador de seguimientos requiere que especifiques los proyectos de Google Cloud para buscar datos de seguimiento, lo que representa un cambio en el comportamiento de la página heredada Explorador de seguimientos. La página heredada del Explorador de seguimientos busca todos los proyectos de una organización. Debido a estas diferencias, es posible que la página Explorador de seguimiento no muestre los intervalos que muestran las páginas heredadas del Explorador de seguimiento.
Puedes usar la sección del panel Detalles del seguimiento de la página heredada del Explorador de seguimientos para compilar una lista de los proyectos de Google Cloud que almacenan tus datos de seguimiento:
Ve a la página heredada del Explorador de seguimiento:
Selecciona un seguimiento.
Puedes probar lo siguiente:
- Visualizar un seguimiento ingresando su ID en el campo ID de seguimiento
- Agrega filtros.
En el panel Detalles de seguimiento, selecciona el seguimiento y, luego, ve a la pestaña Proyectos.
En esta pestaña, se enumeran los proyectos que almacenan intervalos para el seguimiento.
Para crear un alcance de seguimiento que contenga los proyectos enumerados, ve a la barra de herramientas de la pestaña Projects y selecciona Create scope with these projects y, luego, completa el diálogo.
Repite los pasos anteriores hasta que compiles una lista de proyectos.
Después de compilar una lista de proyectos, crea un permiso de seguimiento. También puedes establecerlo como el alcance de seguimiento predeterminado.
Establece el alcance de seguimiento predeterminado
Cuando se abre la página Explorador de seguimientos, busca datos de seguimiento en los proyectos que se enumeran en el ámbito de seguimiento 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 seguimiento llamado _Default
y se designa como el ámbito de seguimiento predeterminado. Sin embargo, puedes crear tu propio alcance de seguimiento y designarlo como el predeterminado.
Para establecer el alcance de seguimiento predeterminado, haz lo siguiente:
-
En la consola de Google Cloud, ve a la páginasettings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- Selecciona la pestaña Trace Scopes.
Busca el alcance de seguimiento que deseas designar como el alcance de seguimiento predeterminado, haz clic en su more_vert Más y, luego, selecciona Establecer como predeterminado.
El ámbito de seguimiento que seleccionaste se muestra con el ícono "Predeterminado",
.
Modifica o borra el alcance de un registro
No puedes borrar ni modificar el
alcance de seguimiento llamado _Default. Puedes modificar o borrar todos los demás
alcances de seguimiento.
Para modificar o borrar un alcance de registro, haz lo siguiente:
-
En la consola de Google Cloud, ve a la páginasettings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- Selecciona la pestaña Trace Scopes.
Busca el alcance de seguimiento que deseas modificar o borrar, haz clic en more_vert Más y, luego, realiza una de las siguientes acciones:
- Para modificarlo, selecciona Editar alcance y, luego, completa el diálogo.
- Para borrarlo, selecciona Borrar alcance y, luego, completa el cuadro de diálogo.
Limitaciones
No hay compatibilidad con la API de Cloud Trace ni con Google Cloud CLI para crear o administrar alcances de seguimiento.
¿Qué sigue?
Cloud Logging y Cloud Monitoring contienen construcciones similares que te permiten controlar los datos de registro o las métricas que puedes ver o supervisar. Para obtener información sobre esos alcances, consulta los siguientes documentos: