Cómo crear y administrar permisos de seguimiento

Los permisos de seguimiento te permiten buscar y analizar datos de Cloud Trace en varios proyectos desde la página Explorador de seguimiento. Si solo quieres ver y analizar los intervalos que se originan en un solo proyecto de Google Cloud , no necesitas configurar ningún permiso de seguimiento. Para obtener información sobre cómo ver seguimientos y intervalos, consulta Busca y explora seguimientos.

Acerca de los permisos de seguimiento

Los permisos de seguimiento te permiten tener una vista agregada de los datos de seguimiento que se almacenan en varios proyectos. Estos permisos son recursos persistentes a nivel de proyecto que enumeran vistas. Cada vista proporciona acceso a los datos de seguimiento almacenados por un proyecto. En páginas como el Explorador de seguimiento, se usan los permisos de seguimiento para determinar dónde buscar datos. Sin embargo, estas páginas también usan tus roles de Identity and Access Management (IAM) en esos recursos para determinar si tienes permiso para ver los datos que se encuentran.

Cuando creas un permiso de seguimiento, proporcionas un nombre y una lista de proyectos. El sistema incluye automáticamente la vista de seguimiento predeterminada de cada proyecto, que tiene la ruta _Trace/Spans/_AllSpans. Los campos de ruta de acceso _Trace, Spans y _AllSpans hacen referencia a un bucket de observabilidad, el conjunto de datos que almacena los datos y una vista del conjunto de datos. La vista _AllSpans proporciona acceso a todos los datos de seguimiento que almacena el proyecto.

La página Explorador de seguimiento incluye una opción que te permite seleccionar un permiso de seguimiento. Cuando realizas una selección, la página busca las vistas que se indican en el permiso de seguimiento y actualiza la pantalla.

También puedes copiar la URL del navegador para compartir la vista que configuraste. La URL codifica el permiso de seguimiento seleccionado y otros parámetros de configuración de la página, lo que anula las selecciones de permisos predeterminadas para cualquier persona que abra el vínculo. Para obtener más información, consulta Comparte seguimientos y tramos.

Puedes designar un permiso de seguimiento como "predeterminado". Cuando realizas esta designación, ocurre lo siguiente:

  • El sistema actualiza el permiso de observabilidad. Este permiso contiene punteros al permiso de registros predeterminado y al permiso de seguimiento predeterminado, lo que ayuda al sistema a correlacionar los datos de registro y seguimiento cuando esos datos se almacenan en varios proyectos. Para obtener más información, consulta Configura permisos de observabilidad para consultas de varios proyectos.

  • El sistema actualiza el permiso de seguimiento que la página Explorador de seguimiento usa automáticamente para buscar datos de seguimiento. Si la página no puede acceder al permiso de seguimiento predeterminado, busca datos de seguimiento en tu proyecto.

Puedes modificar y borrar cualquier permiso de seguimiento que crees.

Aplicaciones de App Hub y permisos de seguimiento

Es posible que tus aplicaciones de App Hub escriban datos de seguimiento en varios proyectos. Para obtener una vista agregada de estos datos, crea un permiso de seguimiento, configúralo para que enumere 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 Explorador de seguimiento mostrará automáticamente los datos que escribió tu aplicación, incluso cuando esos datos se almacenen en proyectos diferentes.

Crea el permiso de seguimiento personalizado en el proyecto desde el que ves tus datos de seguimiento. Este 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

Configura tu proyecto, tus roles de IAM y selecciona la interfaz que planeas usar.

Configura tu proyecto y tus roles

  1. 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.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. Enable the Observability API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  4. 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 de 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.

    Este rol predefinido contiene los permisos necesarios para crear y ver los permisos de seguimiento. 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 los permisos de seguimiento:

    • observability.traceScopes.{create, delete, get, list, update}
    • observability.scopes.{get, update}

    También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Selecciona la interfaz que planeas usar

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

Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI con el siguiente comando:

gcloud init

Terraform

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

  1. Instala Google Cloud CLI.

  2. Configura gcloud CLI para usar tu identidad federada.

    Para obtener más información, consulta Accede a gcloud CLI con tu identidad federada.

  3. Crea credenciales de autenticación locales para tu cuenta de usuario:

    gcloud auth application-default login

    Si se devuelve un error de autenticación, confirma que accediste a 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 y, luego, accede a 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 de 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 los permisos de seguimiento. La entrada que incluye un ícono "Predeterminado", , es el permiso de seguimiento predeterminado.

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

    Si expandes un permiso de seguimiento, puedes ver la lista de vistas que incluye el permiso. En cada fila, se muestra 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, al conjunto de datos y a 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

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

  • LOCATION: Es la ubicación del permiso de seguimiento. 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 permisos de seguimiento. Para cada permiso, se muestra el nombre y la información pertinente. Por ejemplo, a continuación, se ilustra 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 permiso de seguimiento. Sin embargo, no puedes usar Terraform para enumerar los permisos de seguimiento.

REST

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

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 como 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 permiso de seguimiento 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 intervalo de tiempo y los filtros que aplicas.

Puedes crear 100 alcances de seguimiento por proyecto. Un alcance de seguimiento puede incluir un total de 200 vistas. Si creas un permiso de seguimiento que enumere más de 10 vistas, es posible que experimentes problemas de rendimiento.

Console

Para crear un permiso 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 de 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 Permisos de seguimiento y, luego, haz clic en Crear permiso de seguimiento.
  4. Haz clic en Agregar proyectos y completa el cuadro de diálogo.

  5. En la sección Asigna un nombre al permiso de seguimiento, ingresa el nombre y la descripción que quieres que se muestren en la pestaña Permisos de seguimiento.

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

  6. Haz clic en Crear permiso de seguimiento.

    De forma predeterminada, la tabla Permisos de seguimiento muestra tus permisos de seguimiento de forma contraída. Para cada permiso, en la tabla se indica un nombre, una descripción, un tipo y una cantidad de recursos.

    Si expandes un permiso de seguimiento, puedes ver la lista de vistas que incluye el permiso. En cada fila, se muestra 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, al conjunto de datos y a 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

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 de seguimiento. Asigna el formato de cadena a la descripción.
  • 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 permiso de seguimiento. 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 ejecuta de forma correcta, la respuesta del comando create incluye el nombre del nuevo permiso de seguimiento:

Created traceScope [my-test-scope].

Terraform

Para obtener información sobre cómo aplicar o quitar una configuración de Terraform, consulta 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 u 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.

  • trace_scope_id: Se establece en un ID de permiso. 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 completamente calificado.

  • description: Una descripción breve. Por ejemplo, "Permiso para recursos de producción".

REST

Para crear un permiso de seguimiento, usa el comando projects.locations.traceScopes.create. Debes especificar un parámetro de ruta 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 como global.

Modifica un permiso de seguimiento

No puedes modificar el permiso de seguimiento llamado _Default. Puedes modificar todos los demás permisos de seguimiento.

Console

Para modificar un permiso 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 de 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 permiso de seguimiento que deseas modificar, haz clic en  Más, selecciona Editar permiso y, luego, completa el diálogo.

gcloud

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 de seguimiento. Asigna el formato de cadena a la descripción.
  • 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 permiso de seguimiento. 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 de forma correcta, los datos de respuesta de un comando update muestran el alcance de seguimiento 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

Para obtener información sobre cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform. Para obtener más información, consulta la documentación de referencia del proveedor de Terraform.

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

REST

Para modificar un permiso de seguimiento, usa el comando projects.locations.traceScopes.patch. Debes especificar un parámetro de ruta, parámetros de consulta y proporcionar un objeto TraceScope. Los parámetros de consulta identifican qué campos se modifican. 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 como global.
  • TRACE_SCOPE_NAME: Es el nombre de un permiso de seguimiento. Por ejemplo, my-trace-scope

Borra un permiso de seguimiento

No puedes borrar el permiso de seguimiento llamado _Default. Puedes borrar todos los demás permisos de seguimiento.

Console

Para borrar un permiso 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 de 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 permiso de seguimiento que deseas borrar, haz clic en  Más, selecciona Borrar permiso y, luego, completa el diálogo.

gcloud

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 permiso de seguimiento. 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 emites 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

Para obtener información sobre cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform. Para obtener más información, consulta la documentación de referencia del proveedor de Terraform.

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

REST

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

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 como global.
  • TRACE_SCOPE_NAME: Es el nombre de un permiso de seguimiento. Por ejemplo, my-trace-scope

Configura el permiso 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 al permiso predeterminado, la página busca datos de seguimiento en tu proyecto. Esta búsqueda equivale a consultar 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 permiso de seguimiento y designarlo como el permiso de seguimiento predeterminado.

Console

Para establecer el alcance de seguimiento 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 de 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 los permisos de seguimiento y se incluye un botón para crear un permiso de seguimiento personalizado. El permiso de seguimiento que se muestra con un ícono "Predeterminado", , es el permiso de seguimiento predeterminado actual.

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

    El permiso de seguimiento que seleccionaste se muestra con un ícono "Predeterminado", .

gcloud

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

  1. Para ver la configuración del permiso 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 se debe establecer 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 permiso de 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 se debe establecer en _Default.
    • LOG_SCOPE_FQN_ID: Es el nombre de recurso completamente calificado del ámbito de registros. 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 ámbito de registros. Por ejemplo: my-scope

    • TRACE_SCOPE_FQN_ID: Es el nombre de recurso completamente calificado del permiso de seguimiento. 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 permiso de seguimiento. 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 es 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 permiso de seguimiento. Sin embargo, no puedes usar Terraform para establecer el permiso de seguimiento predeterminado.

REST

Para obtener y establecer el ámbito de registros predeterminado o el ámbito de seguimiento predeterminado con una llamada a la API, configura el ámbito de observabilidad. En el permiso de observabilidad, se enumeran el permiso de registro predeterminado y el permiso 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. La respuesta es un objeto Scope, que enumera el ámbito de registros predeterminado y el ámbito 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, parámetros de consulta y proporcionar un objeto Scope. Los parámetros de consulta identifican qué campos se modifican. La respuesta es un objeto Scope.

El parámetro de ruta para ambos extremos tiene el siguiente formato:

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 se debe establecer en _Default. El objeto Scope con el nombre _Default, que se crea automáticamente, almacena información sobre el ámbito de registros predeterminado y el ámbito 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 permiso predeterminado actual, puedes hacer lo siguiente:

  1. Haz clic en projects.locations.scopes.get.
  2. En el widget Prueba este método, 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 requeridos.

    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 permisos de seguimiento por proyecto 100
Cantidad máxima de vistas por alcance de seguimiento 200

Para obtener un rendimiento óptimo, limita la cantidad de vistas en un permiso de seguimiento a 10.

¿Qué sigue?