Cómo crear y administrar permisos de seguimiento

En este documento, se describe cómo puedes crear y administrar un alcance de seguimiento, lo que permite que la página del 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 Google Cloud .

En este documento, no se describe cómo ver tus registros y períodos. Para obtener más información sobre ese tema, consulta Busca y explora seguimientos.

Esta función solo se admite para proyectos Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.

Acerca de los permisos de seguimiento

Los permisos de seguimiento son recursos persistentes a nivel del proyecto que enumeran vistas, las cuales proporcionan acceso a tus datos de seguimiento. Puedes configurar la página Explorador de Trace para que realice búsquedas por permiso de seguimiento, lo que significa que la página buscará las vistas que se enumeran en el permiso seleccionado. Tus roles de Identity and Access Management (IAM) en la vista de búsqueda y la configuración del período determinan qué datos recupera el sistema del almacenamiento y, luego, muestra.

Puedes crear ámbitos de seguimiento, así como modificar y borrar los que crees. Quieres crear un alcance de seguimiento cuando tienes un servicio que escribe datos de intervalos en varios proyectos de Google Cloud .

Un permiso de seguimiento enumera vistas, no proyectos Google Cloud . Aunque selecciones proyectos cuando configures un alcance de seguimiento, el sistema agregará al alcance la vista de seguimiento predeterminada de esos proyectos. La vista de seguimiento predeterminada de un proyecto corresponde a la vista con la ruta _Trace/Spans/_AllSpans, en la que los campos _Trace, Spans y _AllSpans hacen referencia a un bucket, un conjunto de datos y una vista de observabilidad. El conjunto de datos Spans almacena tus datos de seguimiento.

A menos que abras la página del Explorador de seguimiento con una URL que incluya un alcance de seguimiento o un ID de seguimiento y de intervalo, la página del Explorador de seguimiento buscará datos de seguimiento en las vistas que se indican en el alcance de seguimiento predeterminado. Cuando creas tu proyecto, el permiso de seguimiento llamado _Default se establece como el permiso de seguimiento predeterminado. Sin embargo, puedes seleccionar otro alcance de registro para usarlo como el predeterminado.

Acerca del permiso de observabilidad

El alcance de observabilidad especifica cuáles de tus alcances de seguimiento y de registros se deben usar cuando se abran las páginas del explorador correspondientes. Si no configuras el alcance de la observabilidad para enumerar los recursos que almacenan tus datos, es posible que no puedas correlacionar tus datos de registro y seguimiento. Para obtener más información, consulta Configura permisos de observabilidad para consultas de varios proyectos.

Aplicaciones de App Hub y permisos de seguimiento

Tus aplicaciones de App Hub pueden escribir datos de seguimiento en varios proyectos. Para obtener una vista agregada de estos datos, crea un permiso de seguimiento, configúralo para que muestre la vista de seguimiento predeterminada de todos los proyectos que almacenan datos de seguimiento y, luego, configúralo como el permiso de seguimiento predeterminado. Cuando completes esos pasos, la página Trace Explorer mostrará automáticamente los datos que escribió tu aplicación, incluso cuando esos datos se almacenen en diferentes proyectos.

Crea el alcance de seguimiento personalizado en el proyecto desde el que verás tus datos de seguimiento. Este proyecto es tu proyecto host o de administración de App Hub. Por ejemplo, si el nombre visible de una carpeta es My Folder, el nombre visible del proyecto de administración de la carpeta es My Folder-mp.

Antes de comenzar

Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. Para obtener los permisos que necesitas para crear y ver ámbitos de seguimiento, pídele a tu administrador que te otorgue el rol de IAM Editor de ámbitos de observabilidad (roles/observability.scopesEditor) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

   También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

   El rol de editor de Observability Scopes incluye permisos privados que te permiten crear y ver ámbitos de seguimiento. Estos permisos no están disponibles para su inclusión en roles personalizados de IAM.

2. Selecciona la pestaña que corresponda a la forma en que planeas usar las muestras de esta página:

   Console

   Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud , no necesitas configurar la autenticación.

   gcloud

   En la consola de Google Cloud , activa Cloud Shell.

   Activa Cloud Shell

   En la parte inferior de la consola de Google Cloud , se inicia una sesión de Cloud Shell que muestra una ventana emergente con una línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.

   Terraform

   Para usar las muestras de Terraform de esta página en un entorno de desarrollo local, instala e inicializa la gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

   1. Instala Google Cloud CLI.

   2. Si usas un proveedor de identidad (IdP) externo, primero debes acceder a gcloud CLI con tu identidad federada.

   3. Si usas un shell local, crea credenciales de autenticación locales para tu cuenta de usuario:

      gcloud auth application-default login

      No es necesario que lo hagas si usas Cloud Shell.

      Si se devuelve un error de autenticación y usas un proveedor de identidad (IdP) externo, confirma que accediste a la gcloud CLI con tu identidad federada.

   Para obtener más información, consulta Configura ADC para un entorno de desarrollo local en la documentación de autenticación de Google Cloud .

   REST

   Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.

   Instala Google Cloud CLI.

   Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

   Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Google Cloud .

Enumera los permisos de seguimiento

Console

Para enumerar los permisos de seguimiento, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página  Configuración:

   Ir a Configuración

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

2. En la barra de herramientas de la consola de Google Cloud , selecciona tu proyecto Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.

3. Selecciona la pestaña Trace Scopes.

   En la ventana, se muestra una lista de tus permisos de seguimiento. La entrada que incluye un ícono de "Predeterminado", , es el permiso de registro predeterminado.

4. Para ver los detalles de un alcance de seguimiento, expándelo.

   Si expandes un alcance de seguimiento, puedes ver la lista de vistas que incluye el alcance. Cada fila enumera un ID del proyecto junto con una entrada como _Trace/Spans/_AllSpans, que identifica la ubicación de almacenamiento predeterminada para tus datos de seguimiento. Los campos _Trace, Spans y _AllSpans hacen referencia al bucket, el conjunto de datos y la vista de observabilidad de tus datos de seguimiento. La vista _AllSpans corresponde a cada entrada del bucket:

   Nombre	Description	Tipo	Recursos
   _Default		Trace scope	1
   myscope	My description	Trace scope	2
   _Trace/Spans/_AllSpans	myproject	Trace view
   _Trace/Spans/_AllSpans	project-b	Trace view

gcloud

Nota: Debes usar la versión 563.0.0 de gcloud CLI o una posterior.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

• LOCATION: Es la ubicación del alcance del registro. Este campo debe tener un valor de global.
• PROJECT_ID: Es el identificador del proyecto.

Ejecuta el comando gcloud observability trace-scopes list:

Linux, macOS o Cloud Shell

gcloud observability trace-scopes list \
 --location=LOCATION --project=PROJECT_ID

Windows (PowerShell)

gcloud observability trace-scopes list `
 --location=LOCATION --project=PROJECT_ID

Windows (cmd.exe)

gcloud observability trace-scopes list ^
 --location=LOCATION --project=PROJECT_ID

Los datos de respuesta son una lista de alcances de seguimiento. Para cada alcance, se muestran el nombre y la información pertinente. Por ejemplo, la siguiente ilustración muestra el resultado del comando list para un proyecto que tiene dos permisos de seguimiento:

name: projects/my-project/locations/global/traceScopes/_Default
resourceNames:
- projects/my-project
---
createTime: '2026-03-26T13:43:54.772326947Z'
description: a test
name: projects/my-project/locations/global/traceScopes/my-test-scope
resourceNames:
- projects/another-project
- projects/my-project
updateTime: '2026-03-26T13:43:54.772326947Z'

Terraform

Puedes usar Terraform para crear y modificar un alcance de seguimiento. Sin embargo, no puedes usar Terraform para enumerar los alcances de registro.

REST

Vista previa

Este producto o función está sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Para enumerar todos los ámbitos de seguimiento en un proyecto de Google Cloud , usa el comandoprojects.locations.traceScopes.list. Debes especificar un parámetro de ruta de acceso.

El parámetro de ruta de acceso para este extremo tiene la siguiente sintaxis:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes

Los campos de la expresión anterior tienen el siguiente significado:

• PROJECT_ID: Es el identificador del proyecto. Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.
• LOCATION_ID debe establecerse en global.

La respuesta es un array de objetos TraceScope. Cada objeto incluye un nombre y una lista de recursos.

Para obtener información sobre un alcance de registro específico, usa el comando projects.locations.traceScopes.get.

Crea un permiso de seguimiento

Los intervalos que se muestran en la página Explorador de seguimiento dependen de las vistas buscadas, tus roles de IAM en esas vistas, el parámetro de configuración del período y los filtros que apliques.

Advertencia: Asegúrate de que todas las vistas que se enumeran en un alcance de seguimiento almacenen sus datos de seguimiento en la misma ubicación. El sistema almacena tus datos de seguimiento en un bucket de observabilidad llamado _Trace. Para obtener información sobre cómo mostrar la ubicación en la que se almacenan tus datos de seguimiento, consulta Cómo enumerar buckets de observabilidad.

Puedes crear 100 permisos de seguimiento por proyecto. Un alcance de seguimiento puede incluir un total de 20 vistas.

Console

Para crear un alcance de seguimiento, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página  Configuración:

   Ir a Configuración

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

2. En la barra de herramientas de la consola de Google Cloud , selecciona tu proyecto Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.
3. Selecciona la pestaña Trace Scopes y, luego, haz clic en Create trace scope.

4. Haz clic en Agregar proyectos y completa el diálogo.

   Nota: Cuando seleccionas un proyecto, el sistema agrega la vista de seguimiento predeterminada del proyecto al alcance.

5. En la sección Name trace scope, ingresa el nombre y la descripción que deseas que se muestren en la pestaña Trace Scopes.

   El nombre de un alcance de seguimiento no se puede modificar y debe ser único dentro del proyecto.

6. Haz clic en Crear alcance de la traza.

   De forma predeterminada, la tabla Trace scopes enumera tus alcances de seguimiento en formato contraído. En cada alcance, la tabla muestra un nombre, una descripción, un tipo y una cantidad de recursos.

   Si expandes un alcance de seguimiento, puedes ver la lista de vistas que incluye el alcance. Cada fila enumera un ID del proyecto junto con una entrada como _Trace/Spans/_AllSpans, que identifica la ubicación de almacenamiento predeterminada para tus datos de seguimiento. Los campos _Trace, Spans y _AllSpans hacen referencia al bucket, el conjunto de datos y la vista de observabilidad de tus datos de seguimiento. La vista _AllSpans corresponde a cada entrada del bucket:

   Nombre	Description	Tipo	Recursos
   _Default		Trace scope	1
   myscope	My description	Trace scope	2
   _Trace/Spans/_AllSpans	myproject	Trace view
   _Trace/Spans/_AllSpans	project-b	Trace view

gcloud

Nota: Debes usar la versión 563.0.0 de gcloud CLI o una posterior.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

• TRACE_SCOPE_NAME: Es el nombre de un permiso de seguimiento. Por ejemplo, my-trace-scope
• DESCRIPTION: Opcional Es la descripción del alcance del registro. Da formato a la descripción como una cadena.
• RESOURCE_NAMES: Es una lista separada por comas de los nombres completamente calificados de los proyectos. Por ejemplo, projects/my-project
• LOCATION: Es la ubicación del alcance del registro. Este campo debe tener un valor de global.
• PROJECT_ID: Es el identificador del proyecto.

Ejecuta el comando gcloud observability trace-scopes create:

Linux, macOS o Cloud Shell

gcloud observability trace-scopes create TRACE_SCOPE_NAME \
 --description=DESCRIPTION \
 --resource-names=RESOURCE_NAMES \
 --location=LOCATION --project=PROJECT_ID

Windows (PowerShell)

gcloud observability trace-scopes create TRACE_SCOPE_NAME `
 --description=DESCRIPTION `
 --resource-names=RESOURCE_NAMES `
 --location=LOCATION --project=PROJECT_ID

Windows (cmd.exe)

gcloud observability trace-scopes create TRACE_SCOPE_NAME ^
 --description=DESCRIPTION ^
 --resource-names=RESOURCE_NAMES ^
 --location=LOCATION --project=PROJECT_ID

Cuando se completa correctamente, la respuesta del comando create incluye el nombre del nuevo alcance de seguimiento:

Created traceScope [my-test-scope].

Terraform

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform. Para obtener más información, consulta la documentación de referencia del proveedor de Terraform.

Para crear un permiso de seguimiento en un proyecto con Terraform, usa el recurso de Terraform google_observability_trace_scope.

En el comando, configura los siguientes campos:

• project: Es el nombre de tu proyecto, carpeta o organización. Por ejemplo, my-project Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.

  Nota: El sistema no agrega el proyecto al alcance. En su lugar, agrega la vista _AllSpans del proyecto en el conjunto de datos Spans.

• trace_scope_id: Se establece en un ID de alcance. Por ejemplo, my-trace-scope

• location: Configurado como "global".

• resource_names: Es un array de proyectos, en el que cada proyecto se especifica con su nombre completo.

• description: Es una descripción breve. Por ejemplo, "Alcance de los recursos de producción".

REST

Vista previa

Este producto o función está sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Para crear un alcance de seguimiento, usa el comando projects.locations.traceScopes.create. Debes especificar un parámetro de ruta de acceso y proporcionar un objeto TraceScope. La respuesta es un objeto TraceScope.

El parámetro de ruta de acceso para este extremo tiene la siguiente sintaxis:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes

Los campos de la expresión anterior tienen el siguiente significado:

• PROJECT_ID: Es el identificador del proyecto. Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.
• LOCATION_ID debe establecerse en global.

Cómo modificar un permiso de seguimiento

No puedes modificar el alcance de seguimiento llamado _Default. Puedes modificar todos los demás parámetros de seguimiento.

Console

Para modificar un alcance de seguimiento, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página  Configuración:

   Ir a Configuración

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

2. En la barra de herramientas de la consola de Google Cloud , selecciona tu proyecto Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.
3. Selecciona la pestaña Trace Scopes.
4. Busca el alcance del registro que deseas modificar, haz clic en  Más, selecciona Editar alcance y, luego, completa el diálogo.

gcloud

Nota: Debes usar la versión 563.0.0 de gcloud CLI o una posterior.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

• TRACE_SCOPE_NAME: Es el nombre de un permiso de seguimiento. Por ejemplo, my-trace-scope
• DESCRIPTION: Opcional Es la descripción del alcance del registro. Da formato a la descripción como una cadena.
• RESOURCE_NAMES: Es una lista separada por comas de los nombres completamente calificados de los proyectos. Por ejemplo, projects/my-project.
• LOCATION: Es la ubicación del alcance del registro. Este campo debe tener un valor de global.
• PROJECT_ID: Es el identificador del proyecto.

Ejecuta el comando gcloud observability trace-scopes update:

Linux, macOS o Cloud Shell

gcloud observability trace-scopes update TRACE_SCOPE_NAME \
 --description=DESCRIPTION \
 --resource-names=RESOURCE_NAMES \
 --location=LOCATION --project=PROJECT_ID

Windows (PowerShell)

gcloud observability trace-scopes update TRACE_SCOPE_NAME `
 --description=DESCRIPTION `
 --resource-names=RESOURCE_NAMES `
 --location=LOCATION --project=PROJECT_ID

Windows (cmd.exe)

gcloud observability trace-scopes update TRACE_SCOPE_NAME ^
 --description=DESCRIPTION ^
 --resource-names=RESOURCE_NAMES ^
 --location=LOCATION --project=PROJECT_ID

Cuando se ejecuta correctamente, los datos de respuesta de un comando update muestran el alcance del registro actualizado:

Updated traceScope [my-test-scope].
createTime: '2026-03-26T13:43:54.772326947Z'
description: A scope for testing
name: projects/my-project/locations/global/traceScopes/my-test-scope
resourceNames:
- projects/another-project
- projects/my-project
updateTime: '2026-03-26T13:48:05.262142872Z'

Terraform

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform. Para obtener más información, consulta la documentación de referencia del proveedor de Terraform.

Para modificar un alcance de seguimiento en un proyecto con Terraform, usa el recurso de Terraform google_observability_trace_scope.

REST

Vista previa

Este producto o función está sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Para modificar un alcance de seguimiento, usa el comando projects.locations.traceScopes.patch. Debes especificar un parámetro de ruta y parámetros de búsqueda, y proporcionar un objeto TraceScope. Los parámetros de consulta identifican qué campos se modificaron. La respuesta es un objeto TraceScope.

El parámetro de ruta de acceso para este extremo tiene la siguiente sintaxis:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes/TRACE_SCOPE_NAME

Los campos de la expresión anterior tienen el siguiente significado:

• PROJECT_ID: Es el identificador del proyecto. Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.
• LOCATION_ID debe establecerse en global.
• TRACE_SCOPE_NAME: Es el nombre de un permiso de seguimiento. Por ejemplo, my-trace-scope

Borra un alcance de seguimiento

No puedes borrar el alcance de seguimiento llamado _Default. Puedes borrar todos los demás ámbitos de seguimiento.

Console

Para borrar un alcance de seguimiento, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página  Configuración:

   Ir a Configuración

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

2. En la barra de herramientas de la consola de Google Cloud , selecciona tu proyecto Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.
3. Selecciona la pestaña Trace Scopes.
4. Busca el alcance del registro que deseas borrar, haz clic en  Más, selecciona Borrar alcance y, luego, completa el diálogo.

gcloud

Nota: Debes usar la versión 563.0.0 de gcloud CLI o una posterior.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

• TRACE_SCOPE_NAME: Es el nombre de un permiso de seguimiento. Por ejemplo, my-trace-scope
• LOCATION: Es la ubicación del alcance del registro. Este campo debe tener un valor de global.
• PROJECT_ID: Es el identificador del proyecto.

Ejecuta el comando gcloud observability trace-scopes delete:

Linux, macOS o Cloud Shell

gcloud observability trace-scopes delete TRACE_SCOPE_NAME \
 --location=LOCATION --project=PROJECT_ID

Windows (PowerShell)

gcloud observability trace-scopes delete TRACE_SCOPE_NAME `
 --location=LOCATION --project=PROJECT_ID

Windows (cmd.exe)

gcloud observability trace-scopes delete TRACE_SCOPE_NAME ^
 --location=LOCATION --project=PROJECT_ID

Si ejecutas un comando delete, se te solicitará que confirmes la acción. A continuación, se muestra un ejemplo de ejecución:

You are about to delete traceScope [my-test-scope]

Do you want to continue (Y/n)?  Y

Deleted traceScope [my-test-scope].

Terraform

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform. Para obtener más información, consulta la documentación de referencia del proveedor de Terraform.

Para borrar un alcance de seguimiento en un proyecto con Terraform, usa el recurso de Terraform google_observability_trace_scope.

REST

Vista previa

Este producto o función está sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Para borrar un alcance de seguimiento, usa el comando projects.locations.traceScopes.delete. Debes especificar un parámetro de ruta de acceso.

El parámetro de ruta de acceso para este extremo tiene la siguiente sintaxis:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes/TRACE_SCOPE_NAME

Los campos de la expresión anterior tienen el siguiente significado:

• PROJECT_ID: Es el identificador del proyecto. Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.
• LOCATION_ID debe establecerse en global.
• TRACE_SCOPE_NAME: Es el nombre de un permiso de seguimiento. Por ejemplo, my-trace-scope

Configura el alcance de seguimiento predeterminado

Cuando se abre la página Explorador de seguimiento, se buscan datos de seguimiento en las vistas que se indican en el alcance de seguimiento predeterminado. Si no se puede acceder a ese alcance de seguimiento, la página Trace Explorer consulta la vista _AllSpans de tu proyecto en el conjunto de datos predeterminado.

Cuando se crean proyectos, se crea el permiso de seguimiento llamado _Default y se designa como el permiso de seguimiento predeterminado. Sin embargo, puedes crear tu propio alcance de seguimiento y designarlo como el alcance de seguimiento predeterminado.

Console

Para establecer el alcance del registro predeterminado, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página  Configuración:

   Ir a Configuración

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

2. En la barra de herramientas de la consola de Google Cloud , selecciona tu proyecto Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.

3. Selecciona la pestaña Trace Scopes.

   En la pestaña, se muestran tus ámbitos de seguimiento y se incluye un botón para crear un ámbito de seguimiento personalizado. El alcance de seguimiento que se muestra con un ícono "Predeterminado", , es el alcance de seguimiento predeterminado actual.

4. Para cambiar el alcance de seguimiento predeterminado, busca el alcance de seguimiento que quieras designar como predeterminado, haz clic en su  Más y, luego, selecciona Establecer como predeterminado.

   El alcance de la ruta que seleccionaste se muestra con un ícono "Predeterminado", .

gcloud

Nota: Debes usar la versión 563.0.0 de gcloud CLI o una posterior.

Para ver y actualizar el alcance de la observabilidad, haz lo siguiente:

1. Para ver la configuración del alcance de observabilidad, ejecuta el comando gcloud observability scopes describe.

   Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

   • OBSERVABILITY_SCOPE_ID: Es el nombre de un objeto Scope. Este valor debe establecerse en _Default.
   • LOCATION: El campo de ubicación debe establecerse en global.
   • PROJECT_ID: Es el identificador del proyecto.

   Ejecuta el comando gcloud observability scopes describe:

   Linux, macOS o Cloud Shell

   gcloud observability scopes describe OBSERVABILITY_SCOPE_ID \
      --location=LOCATION\
      --project=PROJECT_ID

   Windows (PowerShell)

   gcloud observability scopes describe OBSERVABILITY_SCOPE_ID `
      --location=LOCATION`
      --project=PROJECT_ID

   Windows (cmd.exe)

   gcloud observability scopes describe OBSERVABILITY_SCOPE_ID ^
      --location=LOCATION^
      --project=PROJECT_ID

   La respuesta al comando es similar a la siguiente:

   logScope: logging.googleapis.com/projects/my-project/locations/global/logScopes/_Default
   traceScope: projects/my-project/locations/global/traceScopes/_Default
   name: projects/my-project/locations/global/scopes/_Default
   

2. Para actualizar el alcance de la observabilidad, ejecuta el comando gcloud observability scopes update. En el comando update, puedes incluir la marca --log-scope, la marca --trace-scope o ambas.

   Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

   • OBSERVABILITY_SCOPE_ID: Es el nombre de un objeto Scope. Este valor debe establecerse en _Default.
   • LOG_SCOPE_FQN_ID: Es el nombre de recurso completamente calificado del alcance del registro. Este campo tiene el siguiente formato:

     logging.googleapis.com/projects/PROJECT_ID/locations/LOCATION/logScopes/LOG_SCOPE_ID

     En la expresión anterior, LOG_SCOPE_ID es el ID del alcance del registro. Por ejemplo: my-scope

   • TRACE_SCOPE_FQN_ID: Es el nombre del recurso completamente calificado del alcance del registro. Este campo tiene el siguiente formato:

     projects/PROJECT_ID/locations/LOCATION/traceScopes/TRACE_SCOPE_NAME

     En la expresión anterior, TRACE_SCOPE_NAME es el nombre del alcance del registro. Por ejemplo, my-trace-scope

   • LOCATION: El campo de ubicación debe establecerse en global.
   • PROJECT_ID: Es el identificador del proyecto.

   Ejecuta el comando gcloud observability scopes update:

   Linux, macOS o Cloud Shell

   gcloud observability scopes update OBSERVABILITY_SCOPE_ID \
      --log-scope=LOG_SCOPE_FQN_ID\
      --trace-scope=TRACE_SCOPE_FQN_ID\
      --location=LOCATION\
      --project=PROJECT_ID

   Windows (PowerShell)

   gcloud observability scopes update OBSERVABILITY_SCOPE_ID `
      --log-scope=LOG_SCOPE_FQN_ID`
      --trace-scope=TRACE_SCOPE_FQN_ID`
      --location=LOCATION`
      --project=PROJECT_ID

   Windows (cmd.exe)

   gcloud observability scopes update OBSERVABILITY_SCOPE_ID ^
      --log-scope=LOG_SCOPE_FQN_ID^
      --trace-scope=TRACE_SCOPE_FQN_ID^
      --location=LOCATION^
      --project=PROJECT_ID

   Por ejemplo, si el valor de LOG_SCOPE_ID es my-log-scope y el valor de TRACE_SCOPE_NAME es my-trace-scope, la respuesta será similar a la siguiente:

   Updated scope [_Default].
   logScope: logging.googleapis.com/projects/my-project/locations/global/logScopes/my-log-scope
   traceScope: projects/my-project/locations/global/traceScopes/my-trace-scope
   name: projects/my-project/locations/global/scopes/_Default
   

Terraform

Puedes usar Terraform para crear y modificar un alcance de seguimiento. Sin embargo, no puedes usar Terraform para establecer el alcance predeterminado del registro.

REST

Vista previa

Este producto o función está sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Para obtener y establecer el permiso de registro predeterminado o el permiso de seguimiento predeterminado con una llamada a la API, debes configurar el permiso de observabilidad. En el alcance de observabilidad, se muestran el alcance de registros predeterminado y el alcance de seguimiento predeterminado:

• Para obtener el permiso de observabilidad predeterminado de un proyecto, envía una solicitud al extremo projects.locations.scopes.get. Debes especificar un parámetro de ruta de acceso. La respuesta es un objeto Scope, que enumera el alcance del registro predeterminado y el alcance del registro de seguimiento predeterminado.

• Para actualizar el permiso de observabilidad predeterminado de un proyecto, envía una solicitud al extremo projects.locations.scopes.patch. Debes especificar un parámetro de ruta y parámetros de búsqueda, y proporcionar un objeto Scope. Los parámetros de consulta identifican qué campos se modificaron. La respuesta es un objeto Scope.

El parámetro de ruta de acceso para ambos extremos tiene la siguiente forma:

projects/PROJECT_ID/locations/LOCATION/scopes/OBSERVABILITY_SCOPE_ID

Los campos de la expresión anterior tienen el siguiente significado:

• PROJECT_ID: Es el identificador del proyecto. Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.
• LOCATION: El campo de ubicación debe establecerse en global.
• OBSERVABILITY_SCOPE_ID: Es el nombre de un objeto Scope. Este campo debe establecerse en _Default. El objeto Scope con el nombre _Default, que se crea automáticamente, almacena información sobre el alcance del registro predeterminado y el alcance del registro de seguimiento predeterminado.

Para enviar un comando a un extremo de API, puedes usar el Explorador de APIs, que te permite emitir un comando desde una página de referencia. Por ejemplo, para obtener el alcance predeterminado actual, puedes hacer lo siguiente:

1. Haz clic en projects.locations.scopes.get.

2. En el widget Try this method, ingresa lo siguiente en el campo name:

   projects/PROJECT_ID/locations/global/scopes/_Default
   

   Antes de copiar el campo anterior, reemplaza PROJECT_ID por el nombre de tu proyecto.

3. Selecciona Ejecutar.

4. En el cuadro de diálogo de autorización, completa los pasos necesarios.

   La respuesta es similar a lo que se muestra a continuación:

   {
   "name": "projects/my-project/locations/global/scopes/_Default",
   "logScope": "logging.googleapis.com/projects/my-project/locations/global/logScopes/_Default"
   "traceScope": "projects/my-project/locations/global/traceScopes/_Default"
   }
   

Límites de los permisos de seguimiento

Límites de los permisos de seguimiento	Valor
Cantidad máxima de ámbitos de seguimiento por proyecto	100
Cantidad máxima de vistas por alcance de seguimiento	20

¿Qué sigue?

• Cómo buscar y explorar registros

• Cloud Logging y Cloud Monitoring contienen construcciones similares que te permiten controlar los datos de registro o los datos de métricas que puedes ver o supervisar. Para obtener información sobre esos permisos, consulta los siguientes documentos:

  • Descripción general de los ámbitos de observabilidad
  • Cómo crear y administrar ámbitos de registro
  • Descripción general de los permisos de métricas