En este documento se describe cómo puede crear y gestionar ámbitos de registro, que puede usar para encontrar de forma eficiente las entradas de registro que quiera ver o analizar. Si solo quieres ver y analizar las entradas de registro que proceden de un proyecto, una carpeta o una organización, este documento no es para ti. Sin embargo, si utilizas receptores de registros para enrutar registros a otros proyectos o a segmentos de registros definidos por el usuario, o si usas vistas de registros, la información de este documento puede ayudarte a encontrar entradas de registro específicas de forma eficiente.
En este documento no se explica cómo ver los registros. Para obtener información sobre este tema, consulta el artículo Ver registros con el Explorador de registros.
Acerca de los ámbitos de registro
Los ámbitos de registro son recursos persistentes a nivel de proyecto que incluyen una lista de recursos. Estos recursos pueden ser proyectos, carpetas, organizaciones y vistas de registro. Por ejemplo, puede definir un ámbito de registro que incluya los proyectos que contengan recursos utilizados en producción o uno que incluya las vistas de registro que contengan entradas de registro de un tipo de recurso específico.
Cuando creas un recurso de Google Cloud proyecto, carpeta u organización, Logging crea un ámbito de registro llamado _Default.
Este ámbito incluye el proyecto, la carpeta o la organización que se ha creado.
Cuando el recurso buscado es un Google Cloud proyecto, una carpeta o una organización, los resultados incluyen las entradas de registro que se originan en el recurso y, a continuación, se almacenan en un segmento de registro. El segmento de registros puede estar en cualquier proyecto.
Cuando se busca un proyecto, los resultados también incluyen entradas de registro que se han enrutado al proyecto mediante un receptor de otro proyecto y que se han almacenado en un segmento de registro.
Puedes crear ámbitos de registro. También puedes editar y eliminar los ámbitos de registro que crees. Sin embargo, no puedes editar ni eliminar el ámbito de registro llamado _Default.
Un ámbito de registro te permite controlar en qué recursos busca datos de registro la página Explorador de registros. Cuando abres esa página y seleccionas un ámbito de registro, la página busca los recursos incluidos en ese ámbito y, a continuación, actualiza la pantalla.
También puedes usar un ámbito de registro para controlar en qué recursos busca datos de registro un panel de registros. Un panel de registros es un widget de panel de control personalizado que muestra datos de registro. Cada panel de registros tiene su propia configuración, lo que te permite crear un panel de control que contenga varios paneles de registros en los que se muestren datos de registro diferentes. Para obtener más información, consulta Mostrar registros y errores en un panel de control personalizado.
En el caso de los proyectos, el ámbito de registro predeterminado determina el conjunto de recursos que busca la página Explorador de registros cuando se abre. Sin embargo, los roles de gestión de identidades y accesos (IAM) que tengas en los recursos buscados y el ajuste del periodo determinan qué entradas de registro se obtienen del almacenamiento.
Cuando se crean proyectos, el ámbito de registro llamado _Default se designa como ámbito de registro predeterminado. Puedes definir qué ámbito de registro es el ámbito de registro predeterminado.
Diferencias entre los ámbitos de registro y el almacenamiento de registros centralizado
Tanto el almacenamiento de registros centralizado como los ámbitos de registro te permiten ver los datos de registro que proceden de diferentes proyectos.
Cuando centralizas el almacenamiento de registros, configuras los receptores de una organización o una carpeta para que dirijan las entradas de registro a una única ubicación de almacenamiento. El almacenamiento centralizado proporciona un único lugar para consultar los datos de registro, lo que simplifica las consultas cuando buscas tendencias o investigas problemas. Desde el punto de vista de la seguridad, también tienes una ubicación de almacenamiento, lo que simplifica las tareas de tus analistas de seguridad.
Cuando se envía una consulta a los recursos incluidos en un ámbito de registro, se combinan los resultados de la consulta individual. Un ámbito de registro facilita la agregación en tiempo de lectura de los datos de registro, que pueden almacenarse en diferentes ubicaciones. Sin embargo, también se puede usar un ámbito de registro para proporcionar acceso de lectura a una o más vistas de registro en un contenedor de registro centralizado.
Cuando se abre la página Explorador de registros, se envían consultas a los recursos que se indican en el ámbito de registro predeterminado. Por lo tanto, configure el ámbito predeterminado para que la página le muestre los datos que suele consultar. Por ejemplo, puedes definir el ámbito de registro predeterminado para que muestre una vista de registro que, cuando se consulte, devuelva los datos de registro de una aplicación App Hub.
Prácticas recomendadas
Como los ámbitos de registro te permiten definir y guardar una configuración para usarla en el futuro, te recomendamos que crees ámbitos de registro para configuraciones de búsqueda complejas.
Por ejemplo, supongamos que estás solucionando un problema y quieres ver las entradas de registro de todas las instancias de máquina virtual (VM) propiedad de tu equipo. Para llevar a cabo esta tarea, puedes hacer lo siguiente:
Determinas que las entradas de registro que quieres ver se almacenan en varios segmentos de registro y en varios proyectos. En la mayoría de los segmentos de registro, hay una vista de registro que incluye las entradas de registro que quieres analizar. Si no hay ninguna vista de registro, puedes crear una.
Decides crear un ámbito de registro porque prevés que tendrás que realizar una tarea de solución de problemas similar en el futuro.
Abre la página Explorador de registros en la Google Cloud consola y, a continuación, usa el menú Acotar para seleccionar el nuevo ámbito de registro.
Revisas las entradas del registro y encuentras la información que necesitas para resolver el problema que estabas investigando.
Una vez que hayas resuelto el problema, comparte la causa del fallo con tus compañeros. También nos dices que esperas que se produzcan errores similares en el futuro, por lo que has creado un ámbito de registro que te permitirá a ti o a quien investigue el error encontrar rápidamente las entradas de registro pertinentes.
Aplicaciones y ámbitos de registro de App Hub
Es posible que tus aplicaciones de App Hub escriban datos de registro en varios proyectos. Los datos de registro pueden almacenarse en el proyecto en el que se originan o un administrador de la organización puede haber configurado el almacenamiento centralizado. Para ver los datos de registro de tu aplicación, crea un ámbito de registro, configúralo para que muestre los proyectos o las vistas de registro que almacenan los datos de registro de tu aplicación y, a continuación, configúralo como ámbito de registro predeterminado. Cuando completes estos pasos, la página Explorador de registros mostrará automáticamente los datos escritos por tu aplicación, aunque estén almacenados en diferentes proyectos o en un contenedor de registros centralizado.
Crea el ámbito de registro personalizado en el proyecto desde el que vas a ver tus datos de registro. Este proyecto es el proyecto host de tu centro de aplicaciones o el proyecto de gestión de tu carpeta habilitada para aplicaciones.
Por ejemplo, si el nombre visible de la carpeta es
My Folder, el nombre visible del proyecto de gestión es
My Folder-mp.
Limitaciones
- No puedes eliminar ni modificar el ámbito de registro llamado
_Default. - Solo los proyectos Google Cloud admiten un ámbito de registro predeterminado.
- No puedes añadir carpetas ni organizaciones a un ámbito de registro definido por el usuario.
- Los ámbitos de registro se crean en la ubicación
global.
Antes de empezar
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
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
(
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.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant 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
(
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.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles. -
Para obtener los permisos que necesitas para crear y ver ámbitos de registro, así como para definir el ámbito de registro predeterminado, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en tu proyecto:
-
Editor de configuración de registros (
roles/logging.configWriter) -
Editor de observabilidad (
roles/observability.editor)
Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.
Estos roles predefinidos contienen los permisos necesarios para crear y ver ámbitos de registro, así como para definir el ámbito de registro predeterminado. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:
Permisos obligatorios
Para crear y ver ámbitos de registro, así como para definir el ámbito de registro predeterminado, se necesitan los siguientes permisos:
-
Para definir el ámbito de registro predeterminado, haz lo siguiente:
observability.scopes.{get, update} -
Para crear y gestionar ámbitos de registro, sigue estos pasos:
logging.logScopes.{create, delete, get, list, update}
También puedes obtener estos permisos con roles personalizados u otros roles predefinidos.
-
Editor de configuración de registros (
-
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Terraform
Para usar las muestras de Terraform de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.
-
Install the Google Cloud CLI.
-
Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Para obtener más información, consulta Configurar ADC en un entorno de desarrollo local en la documentación de autenticación Google Cloud .
REST
Para usar las muestras de la API REST de esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la CLI de gcloud.
Instala Google Cloud CLI.
Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .
Mostrar ámbitos de registro
Consola
Para enumerar los ámbitos de registro, haz lo siguiente:
-
En la Google Cloud consola, ve a la página settings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.
- En la barra de herramientas de la Google Cloud consola, selecciona tu proyecto, carpeta u organización. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
Selecciona la pestaña Ámbitos de registro.
En la tabla se muestran los ámbitos de registro. Cuando haya seleccionado un Google Cloud proyecto
, se mostrará una entrada en la tabla con el icono "Predeterminado" Google Cloud , que indica que este ámbito de registro muestra los recursos que el Explorador de registros busca cuando se abre esa página.
gcloud
Para enumerar los ámbitos de registro de un proyecto, usa el comando
gcloud logging scopes list:gcloud logging scopes list --project=PROJECT_IDAntes de ejecutar el comando, actualiza los siguientes campos:
- PROJECT_ID: identificador del proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
Para obtener los detalles de un ámbito de registro de un proyecto, usa el comando
gcloud logging scopes describe:gcloud logging scopes describe LOG_SCOPE_ID --project=PROJECT_IDAntes de ejecutar el comando, actualiza los siguientes campos:
- PROJECT_ID: identificador del proyecto.
- LOG_SCOPE_ID: ID del ámbito del registro. Por ejemplo,
my-scope.
Terraform
Puedes usar Terraform para crear y modificar un ámbito de registro. Sin embargo, no puedes usar Terraform para enumerar los ámbitos de registro.
REST
La API de Cloud Logging contiene comandos que muestran los ámbitos de registro de un recurso o que informan de los detalles de un ámbito de registro específico. Para ver una lista completa de comandos, consulta la documentación de referencia de la API.
En el caso de los proyectos de Google Cloud , usa los siguientes comandos:
En los comandos anteriores, el campo
parenttiene la siguiente sintaxis:projects/PROJECT_ID/locations/LOCATION_IDLos campos de la expresión anterior tienen el siguiente significado:
- PROJECT_ID: identificador del proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
- LOCATION_ID debe establecerse en
global.
Crear un ámbito de registro
Puede crear 100 ámbitos de registro por proyecto. Un ámbito de registro puede incluir un total de 100 vistas de registro y proyectos, pero solo puede incluir 5 proyectos. No puedes añadir carpetas ni organizaciones a un ámbito de registro.
Consola
Para crear un ámbito de registro, sigue estos pasos:
-
En la Google Cloud consola, ve a la página settings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.
- En la barra de herramientas de la Google Cloud consola, selecciona tu proyecto, carpeta u organización. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
- Selecciona la pestaña Ámbitos de registro y, a continuación, haz clic en Crear ámbito de registro.
Para añadir uno o varios proyectos, haz clic en Añadir proyectos y completa el cuadro de diálogo.
Después de añadir un proyecto, tus roles de IAM en ese proyecto determinan qué entradas de registro puedes ver. Por ejemplo, tu rol de gestión de identidades y accesos puede permitirte ver solo las entradas de registro a las que se puede acceder mediante una vista de registro específica en un bucket de registro. Para obtener más información sobre los roles, consulta Roles de registro.
Para añadir una o varias vistas de registro, haga clic en Añadir vistas de registro y complete el cuadro de diálogo.
En el cuadro de diálogo se muestran todas las vistas de registro que tienen entradas de registro que proceden del proyecto actual o que se han enrutado al proyecto actual mediante un receptor de otro proyecto. Por ejemplo, si no has configurado ningún receptor, este cuadro de diálogo mostrará las vistas de registro de tu proyecto actual.
Para ver una lista de las vistas de registro almacenadas en otro Google Cloud proyecto,add_circle Importar proyecto y, a continuación, seleccione el Google Cloud proyecto.
Después de añadir una vista de registro, los roles de gestión de identidades y accesos que tengas en la vista de registro o en el proyecto que la almacena determinan a qué entradas de registro puedes acceder. Para obtener más información, consulta Controlar el acceso a una vista de registro.
En la sección Nombre del ámbito del registro, introduce el nombre y la descripción que quieras que se muestren en la pestaña Ámbitos del registro.
El nombre de un ámbito de registro no se puede modificar y debe ser único en el proyecto.
Haz clic en Crear ámbito de registro.
gcloud
Para crear un ámbito de registro en un proyecto, usa el comando
gcloud logging scopes create:gcloud logging scopes create LOG_SCOPE_ID --project=PROJECT_ID \ --description=DESCRIPTION \ --resource-names=RESOURCE_NAMESAntes de ejecutar el comando, actualiza los siguientes campos:
- PROJECT_ID: identificador del proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
- LOG_SCOPE_ID: ID del ámbito del registro. Por ejemplo,
my-scope. DESCRIPTION: opcional. Descripción del ámbito del registro. Da formato a la descripción como una cadena.
RESOURCE_NAMES: lista separada por comas de los nombres completos de los proyectos o las vistas de registro. Por ejemplo, para incluir
my-projecten el ámbito del registro, especificaprojects/my-project.
Terraform
Para saber 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 Terraform.
Para crear un ámbito de registro en un proyecto, una carpeta o una organización con Terraform, usa el recurso de Terraform
google_logging_log_scope.En el comando, define los siguientes campos:
parent: el nombre completo de tu proyecto, carpeta u organización. Por ejemplo, puedes asignar a este campo el valor"projects/PROJECT_ID", donde PROJECT_ID es el ID de tu proyecto Google Cloud . En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.locations: elija"global".name: se asigna al nombre completo del ámbito del registro. En el caso de los proyectos, el formato de este campo es el siguiente:"projects/PROJECT_ID/locations/global/logScopes/LOG_SCOPE_ID"En la expresión anterior, LOG_SCOPE_ID es el nombre de un ámbito de registro, como "production".
resource_names: un array de proyectos y vistas de registro, donde cada proyecto y vista de registro se especifica mediante su nombre completo.description: una breve descripción. Por ejemplo, "Scope for production resources" (Ámbito de los recursos de producción).
REST
La API Cloud Logging también permite crear ámbitos de registro en una carpeta o una organización. Para obtener más información, consulta la documentación de referencia de la API.
En el caso de los proyectos de Google Cloud , usa el siguiente comando:
En los comandos anteriores, el campo
parenttiene la siguiente sintaxis:projects/PROJECT_ID/locations/LOCATION_IDLos campos de la expresión anterior tienen el siguiente significado:
- PROJECT_ID: identificador del proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
- LOCATION_ID debe establecerse en
global.
Modificar o eliminar un ámbito de registro
Consola
Para modificar o eliminar un ámbito de registro que hayas creado tú o un compañero, haz lo siguiente:
-
En la Google Cloud consola, ve a la página settings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.
- En la barra de herramientas de la Google Cloud consola, selecciona tu proyecto, carpeta u organización. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
- Selecciona la pestaña Ámbitos de registro.
Busca los ámbitos de registro que quieras modificar o eliminar, haz clic en more_vert Más y, a continuación, haz una de las siguientes acciones:
- Para modificarlo, selecciona Editar ámbito y, a continuación, completa el cuadro de diálogo.
- Para eliminarlo, selecciona Eliminar ámbito y, a continuación, completa el cuadro de diálogo.
gcloud
Para modificar la descripción de la lista de recursos de un ámbito de registro de un proyecto, usa el comando
gcloud logging scopes update:gcloud logging scopes update LOG_SCOPE_ID --project=PROJECT_ID \ --description=DESCRIPTION \ --resource-names=RESOURCE_NAMESAntes de ejecutar el comando, actualiza los siguientes campos:
- PROJECT_ID: identificador del proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
- LOG_SCOPE_ID: ID del ámbito del registro. Por ejemplo,
my-scope. DESCRIPTION: la descripción del ámbito del registro. Da formato a la descripción como una cadena. Omite este campo si no quieres cambiar la descripción del ámbito del registro.
RESOURCE_NAMES: lista separada por comas de los nombres completos de los proyectos o las vistas de registro. Omite este campo si no quieres cambiar la lista de recursos.
Para eliminar un ámbito de registro de un proyecto, usa el comando
gcloud logging scopes delete:gcloud logging scopes delete LOG_SCOPE_ID --project=PROJECT_IDAntes de ejecutar el comando, actualiza los siguientes campos:
- PROJECT_ID: identificador del proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
- LOG_SCOPE_ID: ID del ámbito del registro. Por ejemplo,
my-scope.
Terraform
Para saber 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 Terraform.
Para modificar un ámbito de registro en un proyecto, una carpeta o una organización con Terraform, usa el recurso de Terraform
google_logging_log_scope.REST
La API Cloud Logging contiene comandos que pueden modificar o eliminar un ámbito de registro. Para ver una lista completa de comandos, consulta la documentación de referencia de la API.
En el caso de los proyectos de Google Cloud , usa los siguientes comandos:
En los comandos anteriores, el campo
parenttiene la siguiente sintaxis:projects/PROJECT_ID/locations/LOCATION_ID/logScopes/LOG_SCOPE_IDLos campos de la expresión anterior tienen el siguiente significado:
- PROJECT_ID: identificador del proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
- LOCATION_ID debe establecerse en
global. - LOG_SCOPE_ID: ID del ámbito del registro. Por ejemplo,
my-scope.
Configurar el ámbito de registro predeterminado
Esta sección no se aplica a carpetas ni organizaciones. En el caso de las carpetas y las organizaciones, cuando se abre la página Explorador de registros, se buscan las entradas de registro que proceden de la carpeta o la organización.
Cuando se crea un proyecto, se crea un ámbito de registro llamado
_Default. Este ámbito incluye un recurso, que es tu proyecto, y se designa como ámbito de registro predeterminado. Si creas un proyecto y no modificas el ámbito de registro predeterminado, cuando se abra la página Explorador de registros, se buscarán todas las entradas de registro que procedan del proyecto.Puedes crear tu propio ámbito de registro y designarlo como ámbito de registro predeterminado. Esta función le permite configurar los recursos en los que la página Explorador de registros busca entradas de registro.
Consola
Para definir el ámbito de registro predeterminado de un proyecto, haz lo siguiente:
En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones. . Solo puedes definir el ámbito de registro predeterminado de un proyecto.
-
En la Google Cloud consola, ve a la página settings Configuración:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.
La página Configuración contiene varias pestañas. En cada pestaña se muestra la configuración del ámbito de un tipo de telemetría concreto.
Selecciona la pestaña Ámbitos de registro.
En la pestaña se muestran los ámbitos de registro que ya tienes y un botón para crear un ámbito de registro personalizado.
Busca el ámbito de registro que quieras designar como ámbito de registro predeterminado, haz clic en more_vert Más y, a continuación, selecciona Establecer como predeterminado.
El ámbito de registro que has seleccionado se muestra con el icono "Predeterminado"
.
gcloud
Para ver y definir el ámbito de observabilidad, haga lo siguiente:
Para ver los ajustes del ámbito de observabilidad, ejecuta el comando
gcloud observability scopes describe.Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
- OBSERVABILITY_SCOPE_ID: nombre de un objeto
Scope. Este valor debe ser_Default. - LOCATION: el campo de ubicación debe tener el valor
global. - PROJECT_ID: 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: nombre de un objeto
Para actualizar el ámbito de observabilidad, ejecuta el comando
gcloud observability scopes update. En el comandoupdate, puedes incluir la marca--log-scopepara actualizar el ámbito de registro predeterminado.Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
- OBSERVABILITY_SCOPE_ID: nombre de un objeto
Scope. Este valor debe ser_Default. - LOG_SCOPE_FQN_ID: ID completo del ámbito 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 ámbito del registro. Por ejemplo,
my-scope. - LOCATION: el campo de ubicación debe tener el valor
global. - PROJECT_ID: 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\ --location=LOCATION\ --project=PROJECT_ID
Windows (PowerShell)
gcloud observability scopes update OBSERVABILITY_SCOPE_ID ` --log-scope=LOG_SCOPE_FQN_ID` --location=LOCATION` --project=PROJECT_ID
Windows (cmd.exe)
gcloud observability scopes update OBSERVABILITY_SCOPE_ID ^ --log-scope=LOG_SCOPE_FQN_ID^ --location=LOCATION^ --project=PROJECT_ID
Por ejemplo, si el valor de LOG_SCOPE_ID es
my-scope, la respuesta será similar a la siguiente:Updated scope [_Default]. logScope: logging.googleapis.com/projects/my-project/locations/global/logScopes/my-scope name: projects/my-project/locations/global/scopes/_Default
- OBSERVABILITY_SCOPE_ID: nombre de un objeto
Terraform
Puedes usar Terraform para crear y modificar un ámbito de registro. Sin embargo, no puedes usar Terraform para definir el ámbito de registro predeterminado.
REST
Para obtener y definir el ámbito de registro predeterminado o el ámbito de seguimiento predeterminado mediante una llamada a la API, configura el ámbito de observabilidad. En el ámbito de observabilidad se muestran el ámbito de registro predeterminado y el ámbito de traza predeterminado:
Para obtener el ámbito de observabilidad predeterminado de un proyecto, envía una solicitud al punto de conexión
projects.locations.scopes.get. Debe especificar un parámetro de ruta. La respuesta es un objetoScopeque muestra el ámbito de registro predeterminado y el ámbito de seguimiento predeterminado.Para actualizar el ámbito de observabilidad predeterminado de un proyecto, envía una solicitud al endpoint
projects.locations.scopes.patch. Debe especificar un parámetro de ruta, parámetros de consulta y un objetoScope. Los parámetros de consulta identifican qué campos se han modificado. La respuesta es un objetoScope.
El parámetro de ruta de ambos endpoints tiene el siguiente formato:
projects/PROJECT_ID/locations/LOCATION/scopes/OBSERVABILITY_SCOPE_IDLos campos de la expresión anterior tienen el siguiente significado:
- PROJECT_ID: identificador del proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
- LOCATION: el campo de ubicación debe tener el valor
global. - OBSERVABILITY_SCOPE_ID: nombre de un objeto
Scope. Este campo debe tener el valor_Default. El objetoScopecon el nombre_Default, que se crea automáticamente, almacena información sobre el ámbito de registro predeterminado y el ámbito de seguimiento predeterminado.
Para enviar un comando a un endpoint de la API, puedes usar Explorador de APIs, que te permite enviar un comando desde una página de referencia. Por ejemplo, para obtener el ámbito predeterminado actual, puedes hacer lo siguiente:
- Haz clic en
projects.locations.scopes.get. En el widget Prueba este método, introduce lo siguiente en el campo name (nombre):
projects/PROJECT_ID/locations/global/scopes/_DefaultAntes de copiar el campo anterior, sustituye PROJECT_ID por el nombre de tu proyecto.
Selecciona Ejecutar.
En el cuadro de diálogo de autorización, completa los pasos necesarios.
La respuesta es similar a la siguiente:
{ "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" }
Siguientes pasos
- Ver registros con el Explorador de registros
- Configurar vistas de registro en un segmento de registro
A menos que se indique lo contrario, el contenido de esta página está sujeto a la licencia Reconocimiento 4.0 de Creative Commons y las muestras de código están sujetas a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio web de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-09-11 (UTC).
-