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
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Observability API, if it is not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. 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.-
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 initTerraform
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.
-
Instala Google Cloud CLI.
-
Configura gcloud CLI para usar tu identidad federada.
Para obtener más información, consulta Accede a gcloud CLI con tu identidad federada.
-
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:
-
En la consola de Google Cloud , ve a la página settings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- 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.
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.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,Spansy_AllSpanshacen referencia al bucket, al conjunto de datos y a la vista de observabilidad de tus datos de seguimiento. La vista_AllSpanscorresponde a cada entrada del bucket:Nombre Description Tipo Recursos arrow_right _DefaultTrace scope1arrow_drop_down myscopeMy descriptionTrace scope2_Trace/Spans/_AllSpansmyprojectTrace view_Trace/Spans/_AllSpansproject-bTrace 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:
-
En la consola de Google Cloud , ve a la página settings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- 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.
- Selecciona la pestaña Permisos de seguimiento y, luego, haz clic en Crear permiso de seguimiento.
Haz clic en Agregar proyectos y completa el cuadro de diálogo.
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.
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,Spansy_AllSpanshacen referencia al bucket, al conjunto de datos y a la vista de observabilidad de tus datos de seguimiento. La vista_AllSpanscorresponde a cada entrada del bucket:Nombre Description Tipo Recursos arrow_right _DefaultTrace scope1arrow_drop_down myscopeMy descriptionTrace scope2_Trace/Spans/_AllSpansmyprojectTrace view_Trace/Spans/_AllSpansproject-bTrace 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-projectPara 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-scopelocation: 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:
-
En la consola de Google Cloud , ve a la página settings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- 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.
- Selecciona la pestaña Trace Scopes.
- Busca el permiso de seguimiento que deseas modificar, haz clic en more_vert 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:
-
En la consola de Google Cloud , ve a la página settings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- 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.
- Selecciona la pestaña Trace Scopes.
- Busca el permiso de seguimiento que deseas borrar, haz clic en more_vert 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:
-
En la consola de Google Cloud , ve a la página settings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- 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.
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.Para cambiar el permiso de seguimiento predeterminado, busca el permiso de seguimiento que deseas designar como predeterminado, haz clic en su more_vert 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:
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
- OBSERVABILITY_SCOPE_ID: Es el nombre de un objeto
Para actualizar el permiso de observabilidad, ejecuta el comando
gcloud observability scopes update. En el comandoupdate, puedes incluir la marca--log-scope, la marca--trace-scopeo 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-scopey el valor de TRACE_SCOPE_NAME esmy-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
- OBSERVABILITY_SCOPE_ID: Es el nombre de un objeto
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 objetoScope, 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 objetoScope. Los parámetros de consulta identifican qué campos se modifican. La respuesta es un objetoScope.
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 objetoScopecon 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:
- Haz clic en
projects.locations.scopes.get. - En el widget Prueba este método, ingresa lo siguiente en el campo
name:
projects/PROJECT_ID/locations/global/scopes/_DefaultAntes de copiar el campo anterior, reemplaza PROJECT_ID por el nombre de tu proyecto.
- Selecciona Ejecutar.
- 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?
Cloud Logging y Cloud Monitoring contienen construcciones similares que te permiten controlar los datos de registro o de métricas que puedes ver o supervisar. Para obtener información sobre esos permisos, consulta los siguientes documentos: