En este documento, se muestra cómo resolver errores que pueden ocurrir cuando usas la página Log Analytics de la consola de Google Cloud.
Mensajes de error
En esta sección, se describen los mensajes de error que puedes ver y cómo resolver las correspondientes condiciones de error.
No completion signal within allotted timeframe
mensaje de error
Ingresa una consulta de SQL y selecciona Ejecutar consulta. La consulta no se completa y verás el siguiente mensaje de error:
The query failed to execute and return results due to error: No completion signal within allotted timeframe.
Para resolver este error, realiza una de las siguientes acciones:
Acorta el intervalo durante el cual se consultan los registros y vuelve a realizar la consulta. Por ejemplo, si el intervalo de una consulta es de 14 días, acórtalo a 7 días y, luego, ejecuta la consulta.
Crea un Conjunto de datos de BigQuery vinculado y, luego, ejecuta la consulta desde la interfaz de BigQuery. La interfaz de BigQuery admite consultas que requieren un tiempo de ejecución más largo que la interfaz de Cloud Logging. Para obtener más información, consulta Consulta registros con BigQuery.
Mensaje de error de consultas a buckets con claves CMEK distintas
Ingresas una consulta en SQL que consulta varios buckets de registros y seleccionas Ejecutar consulta. La consulta no se completa y verás el siguiente mensaje de error:
Queries against buckets with distinct CMEK keys must have a key configured in the LogSettings.
Para resolver esta situación, realiza una de las siguientes acciones:
- Configura tus buckets de registros para que usen la misma clave de Cloud Key Management Service (Cloud KMS).
- Cuando los buckets de registro se encuentran en la misma ubicación, puedes configurar una carpeta o una organización que sea un recurso superior para los buckets de registro con una clave predeterminada de Cloud KMS. La clave predeterminada del elemento superior debe estar en la misma ubicación que los buckets de registros. Con esta configuración, la clave predeterminada del elemento encripta todos los datos temporales generados por la consulta del Análisis de registros. Para obtener más información, consulta Restricciones de Log Analytics.
La cláusula FROM debe contener exactamente un mensaje de error de vista.
Ingresas una consulta en SQL en el panel de consultas de la página Análisis de registros en la consola de Google Cloud, pero el analizador de SQL muestra la siguiente información: error:
FROM clause must contain exactly one log view
El error anterior se informa cuando la tabla especificada en la sentencia FROM
no se puede resolver en una vista de registro específica.
Para resolver este error, asegúrate de que el nombre de la tabla tenga la sintaxis correcta:
Asegúrate de que el nombre de la tabla siga la sintaxis que requiere el esquema de nombres de Log Analytics. BigQuery y Log Analytics tienen requisitos diferentes para el nombre de la tabla. Puedes encontrar la sintaxis requerida para el nombre de la tabla si consultas la consulta predeterminada.
Si el ID del proyecto, la región, el ID del bucket o el ID de la vista de un bucket de registros de Google Cloud contiene caracteres de punto,
(.)
, asegúrate de que cada uno de estos campos esté encerrado entre comillas simples,(`)
.Por ejemplo, si el ID de un proyecto de Google Cloud es
example.com:bluebird
, entonces consultar la vista_AllLogs
del bucket de registros_Default
usa la siguiente sintaxis para especificar la tabla:SELECT * FROM `example.com:bluebird`.`global`.`_Default`.`_AllLogs`
En la consulta anterior, se supone que el bucket
_Default
se encuentra en la regiónglobal
.
No se puede guardar una búsqueda
Si ingresas y ejecutas una consulta en SQL y el elemento Save de Establece la configuración predeterminada para las organizaciones y carpetas.
está inhabilitado, entonces la configuración de recursos predeterminada de tu organización o carpeta define una ubicación no están permitidos por la política de la organización. Para resolver este problema, pídele al administrador de tu organización que defina una ubicación en la configuración predeterminada de los recursos que coincida con una ubicación permitida por la política de tu organización. Para obtener más información, consultaSi el botón
Save está habilitado, pero no puedes completar y guarda la consulta. Luego, haz lo siguiente:- Asegúrate de que la consulta no contenga errores de sintaxis. Solo puedes guardar consultas válidas.
- Opcional: Copia la consulta en el portapapeles.
- Vuelve a cargar la página.
- Si copiaste la consulta en el portapapeles, pégala en el panel Consulta, ejecuta la consulta y, luego, realiza la operación de guardado.
Se denegó el acceso a la página Log Analytics
Abres la página Log Analytics en la consola de Google Cloud y se muestra un mensaje de error de permiso denegado.
Para obtener los permisos que necesitas para cargar la página Log Analytics, ejecutar consultas y ver registros, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:
-
Visualiza los registros:
Visor de registros (
roles/logging.viewer
) -
Visualiza registros en buckets de registros personalizados:
Descriptor de acceso de vista de registros (
roles/logging.viewAccessor
)
Es posible que también puedas obtener los permisos necesarios roles personalizados o Logging roles predefinidos.
Los permisos que necesitas para ver entradas de registro y ejecutar consultas en
Análisis de registros sean las mismas que necesitas ver
en la página Explorador de registros. Para obtener información sobre
roles adicionales que necesitas para consultar vistas en buckets definidos por el usuario o
Para consultar la vista _AllLogs
del bucket de registros _Default
, consulta
Roles de Cloud Logging.
La actualización del bucket de registros para usar el Análisis de registros falla
Creas un bucket de registros y seleccionas la opción para usar el Análisis de registros, o bien actualizas un bucket de registros existente para usar el Análisis de registros. La actualización falla con una condición de error similar a la siguiente:
Failed precondition (HTTP 400): Constraint "my-constraint" violated for PROJECT_ID with location global.
El mensaje de error anterior indica que tu organización configuró un
una política de la organización que restrinja
las regiones que se pueden usar. Los buckets de registros que son aptos para actualizarse y usar el Análisis de registros deben usar la región global
. Si puedes quitar la política de la organización que restringe
el uso de la región global
, puedes actualizar tu bucket de registros. De lo contrario,
no podrás actualizar tus buckets de registros.
No se puede crear un conjunto de datos vinculado a BigQuery
Editas un bucket de registros para crear un conjunto de datos de BigQuery vinculado o creas un bucket de registros nuevo y seleccionas la opción para crear un conjunto de datos vinculado. Sin embargo, no se crea el conjunto de datos vinculado.
Para resolver este error, pídele al administrador del sistema del proyecto de Google Cloud que te otorgue un rol de IAM que incluya el siguiente permiso:
logging.links.create
El permiso anterior se incluye en el Administrador de Logging (roles/logging.admin
)
y escritor de configuración de registros (roles/logging.configWriter
).
Para obtener información sobre los roles y permisos, consulta Control de acceso con la IAM.
No se puede borrar un conjunto de datos vinculado de BigQuery
Ya no quieres usar el conjunto de datos vinculado, pero la opción para borrarlo está inhabilitada.
Para resolver este error, pídele al administrador del sistema del proyecto de Google Cloud que te otorgue un rol de IAM que incluya el siguiente permiso:
logging.links.delete
El permiso anterior se incluye en los roles de Administrador de Logging (roles/logging.admin
)
y Escritor de configuración de registros (roles/logging.configWriter
).
Este permiso te permite borrar el conjunto de datos vinculado del Página Almacenamiento de registros de la consola de Google Cloud Para obtener más información sobre las funciones y los permisos, consulta Control de acceso con IAM.
Falta el botón de configuración del motor de consulta
Si no se muestra el botón settings Configuración junto al botón Ejecutar consulta, tu proyecto de Google Cloud no tiene ranuras reservadas de BigQuery habilitadas. Para habilitar el settings Botón Settings, configura las reservadas Ranuras de BigQuery para tu proyecto.
El botón Ejecutar en BigQuery está inhabilitado
Si se muestra el botón Run on BigQuery, pero está inhabilitado, significa que una vista de registro a la que hace referencia tu consulta no tiene un conjunto de datos vinculado. Para ejecutar tu consulta sobre tus reservas de ranura de BigQuery, sigue estos pasos: crear un conjunto de datos vinculado de BigQuery en tu vista de registro.
Sin cuenta de servicio de supervisión
Deseas crear una política de alertas para supervisar los resultados de una consulta en SQL. Los pasos de configuración necesarios que otorgues roles de IAM a la cuenta de servicio de Monitoring, pero esa cuenta no existe.
La cuenta de servicio de supervisión se llama agente de servicio, ya que Google Cloud la crea y administra. La cuenta se crea automáticamente cuando configuras una
recurso o servicio que requiera la cuenta. Por ejemplo, si creas un canal de notificaciones de Pub/Sub, esa acción podría hacer que se cree la cuenta de servicio de Monitoring.
Según el flujo de creación, a la cuenta de servicio de Monitoring se le puede otorgar
el rol de
Función de agente de servicio de Monitoring (monitoring.NotificationServiceAgent
)
en tu proyecto. Puedes modificar los roles otorgados a la cuenta.
Si la cuenta de servicio de Monitoring no existe, crea una alerta política que supervisa el resultado de una consulta en SQL, debes hacer lo siguiente:
Crea un agente de servicio de forma manual. Para obtener información sobre este paso, consulta Crea y otorga funciones a los agentes de servicio.
Otorga los roles necesarios al agente de servicio: Para obtener información sobre estas roles, consulta Supervisa los resultados de tu consulta en SQL: antes de comenzar.