Soluciona problemas de transferencia de datos
En este documento, se explican los errores que puedes encontrar durante la transferencia y la normalización de datos en Google Security Operations, y se describe cómo corregirlos. Usa las siguientes tablas para diagnosticar fallas en la transferencia, identificar registros descartados y evaluar el impacto en los sistemas posteriores.
En este documento, se describen los errores de los siguientes métodos de transferencia: retransmisor de Google SecOps, API de transferencia de Google SecOps, feed de la API de Google SecOps y socios tecnológicos externos.
Errores de fuente y transferencia
Es posible que encuentres los siguientes errores en los siguientes casos:
- Recuperar datos de los sistemas fuente
- El reenviador de Google SecOps o un feed de terceros intentan comunicarse con una API o un recurso externos.
| Código de estado HTTP | Motivo del error | Código de error canónico | Mensaje de error | Descripción del error | Soluciona problemas |
|---|---|---|---|---|---|
| 206 | Contenido parcial | REMOTE_ |
Error del servidor remoto debido a contenido parcial. | El servidor upstream devuelve contenido parcial en lugar del conjunto de datos completo para los feeds de MICROSOFT_GRAPH_ALERT. |
Este es un problema de la API upstream. Google SecOps vuelve a intentar la transferencia automáticamente. No se pierden datos y No es necesario que realices ninguna acción. |
| 400 | Solicitud incorrecta | INVALID_ |
Los parámetros de la solicitud no son válidos. | El sistema estableció una conexión con la fuente, pero el feed falló debido a argumentos no válidos. | Verifica las autorizaciones de la fuente, los roles obligatorios y que todos los campos obligatorios estén completados correctamente. Verifica que no haya caracteres ilegales en los IDs, las regiones o los nombres, y asegúrate de que los parámetros, como los intervalos de sondeo, estén dentro de los límites. Revisa la configuración del feed y consulta la documentación de los feeds. Si el problema persiste, comunícate con el equipo de asistencia de SecOps de Google. |
| 401 | Sin autorización | LOGIN_ |
No se pudo realizar la autenticación. Verifica tus credenciales y vuelve a intentarlo. | El sistema estableció una conexión, pero falló la autorización debido a que faltan credenciales o son incorrectas. | Verifica y vuelve a ingresar las credenciales de la fuente para confirmar que sean correctas y no hayan vencido. |
| 403 | Prohibido | ACCESS_ |
Acceso denegado. Las credenciales no tienen permisos para acceder a este recurso. | El sistema estableció una conexión con la fuente, pero las credenciales no tienen los permisos necesarios para el recurso. | Asegúrate de que la cuenta de servicio o de autenticación, o la clave de API, tenga los roles o permisos de Identity and Access Management (IAM) necesarios para el recurso. Consulta la configuración del feed para obtener más detalles. Por ejemplo, vuelve a verificar la cadena de conexión de Azure Event Hub en el portal de Azure. También puedes consultar la documentación de los feeds para conocer los permisos necesarios. Para obtener información sobre los permisos, consulta Configuración por tipo de fuente. |
| 404 | No se encontró la URL | FILE_ |
No se encontró el extremo. Verifica la URL y los detalles del recurso. | El sistema no pudo ubicar el archivo o extremo específico. | Verifica lo siguiente:
Si el problema persiste, comunícate con el equipo de asistencia de SecOps de Google. |
| 429 | ACCESS_ |
Se agotó el tiempo de espera del feed. | La fuente está limitando la frecuencia de las solicitudes. El feed falló porque hubo demasiados intentos para acceder a la fuente. | Por lo general, este es un problema transitorio. Si persiste, comunícate con el equipo de asistencia de Google SecOps. | |
| 500 | Se estableció una conexión con la fuente, pero esta no respondió con datos. | Asegúrate de que la fuente esté disponible y responda. Si el problema persiste, comunícate con el equipo de asistencia de Operaciones de seguridad de Google. | |||
| 502 | El feed detectó un error de puerta de enlace. | Este error es transitorio y la aplicación volverá a intentar la solicitud. Si el problema persiste, comunícate con el equipo de asistencia de SecOps de Google. | |||
| 503 | Problema de conexión transitorio. | La fuente o la puerta de enlace no respondieron o se agotó el tiempo de espera. | Asegúrate de que la fuente esté disponible y responda. Usa la retirada exponencial con fluctuaciones si llamas a la API de forma programática. | ||
| 504 | Google SecOps no puede conectarse a la dirección IP y al puerto de origen. | Este error es transitorio y la aplicación volverá a intentar la solicitud. Verifica lo siguiente:
Si el problema persiste, comunícate con el equipo de asistencia de SecOps de Google. |
|||
| Credencial genérica | No se pudieron validar las credenciales. Verifica los detalles de tu configuración. | Verifica los detalles de configuración generales del conjunto de credenciales en la consola de Google SecOps. | |||
| CONNECTION_ |
El sistema estableció una conexión con la fuente, pero la conexión se cerró antes de que se completara el feed. | Este error es transitorio y la aplicación volverá a intentar la solicitud. Si el problema persiste, comunícate con el equipo de asistencia de SecOps de Google. | |||
| CONNECTION_ |
No se puede establecer conexión con la fuente. | El sistema no puede establecer una conexión de red. La aplicación no puede conectarse a la dirección IP y al puerto de origen. | Verifica que la fuente esté disponible, que ningún firewall bloquee la conexión y que la dirección IP sea correcta. Verifica lo siguiente:
Si el problema persiste, comunícate con el equipo de asistencia de SecOps de Google. |
||
| DNS_ |
Error de DNS. | El sistema no puede resolver el nombre de host de origen. | Verifica las URLs en los parámetros del feed y la configuración del servidor de nombres de origen. Verifica si hay errores ortográficos en el nombre de host del servidor. | ||
| FILE_ |
El sistema estableció una conexión con la fuente, pero se produjo un problema con el archivo o el recurso. | Verifica lo siguiente:
Si el problema persiste, comunícate con el equipo de asistencia de SecOps de Google. |
|||
| GATEWAY_ |
La API devolvió un error de puerta de enlace a la llamada que realizó Google SecOps. | Verifica los detalles de la fuente del feed. La aplicación volverá a intentar la solicitud. | |||
| INTERNAL_ |
No se pueden transferir datos debido a un error interno. | Si el problema persiste, comunícate con el equipo de asistencia de SecOps de Google. | |||
| INVALID_ |
La configuración del feed contiene valores no válidos. | Revisa la configuración del feed para detectar parámetros incorrectos. Consulta la documentación de los feeds para conocer la sintaxis correcta. | |||
| INVALID_ |
Se estableció una conexión con la fuente, pero la respuesta fue incorrecta. | Verifica la configuración del feed. Obtén más información para configurar feeds. Si el problema persiste, comunícate con el equipo de asistencia de SecOps de Google. | |||
| INVALID_ |
No coincide la clave secreta. | Verifica si hay una discrepancia entre la clave secreta configurada en el feed y la clave que Google SecOps recibió en el encabezado HTTP. Por ejemplo, cuando se usa la transferencia push por HTTPS. | |||
| INVALID_ |
Certificado SSL no válido. | El sistema no pudo validar el certificado SSL de la fuente. | Verifica las autorizaciones de la fuente y asegúrate de que el certificado del servidor sea válido y de confianza. | ||
| NO_ |
Se estableció una conexión con la fuente, pero esta no respondió. | Asegúrate de que la fuente pueda admitir solicitudes de Google SecOps. Si el problema persiste, comunícate con el equipo de asistencia de SecOps de Google. | |||
| REMOTE_ |
Se estableció una conexión con la fuente, pero esta no respondió con datos. | Asegúrate de que la fuente esté disponible y responda con datos. Si el problema persiste, comunícate con el equipo de asistencia de SecOps de Google. | |||
| REMOTE_ |
Se estableció una conexión con la fuente, pero esta rechazó la solicitud. | Verifica la configuración del feed. Consulta la documentación de los feeds para obtener más detalles. Si el problema persiste, comunícate con el equipo de asistencia de SecOps de Google. | |||
| RESOURCE_ |
Se superó la cuota o el límite de frecuencia. | Verifica si los rechazos de cuota se deben a un volumen alto de solicitudes o a límites de datos. La fuente envía solicitudes con demasiada frecuencia. Supervisa el uso de la cuota y comunícate con el equipo de asistencia si es necesario. Por ejemplo, cuando se usa la API de Ingestion o Google Workspace. | |||
| SOCKET_ |
Se estableció una conexión con la fuente, pero se agotó el tiempo de espera de la conexión antes de que se completara la transferencia de datos. | Este error es transitorio y la aplicación volverá a intentar la solicitud. Si el problema persiste, comunícate con el equipo de asistencia de SecOps de Google. | |||
| TOO_ |
Se agotó el tiempo de espera del feed porque se encontraron varios errores en la fuente. | Comunícate con el equipo de asistencia de Google SecOps. | |||
| TRANSIENT_ |
Se produjo un error interno temporal en el feed. | Este error es transitorio y la aplicación volverá a intentar la solicitud. Si el problema persiste, comunícate con el equipo de asistencia de SecOps de Google. | |||
| UNSAFE_ |
La aplicación no pudo establecer una conexión porque la dirección IP estaba restringida. | Este error es transitorio, y Google SecOps volverá a intentar la solicitud. Si el problema persiste, comunícate con el equipo de asistencia de SecOps de Google. |
Errores de análisis y normalización
Estos errores se producen después de la transferencia, durante el proceso de asignación de registros sin procesar al modelo de datos unificado (UDM). Si se producen errores aquí, es posible que Google SecOps descarte registros o que no puedas buscar registros con los campos de UDM.
| Tipo de error del analizador | Descripción del error | Soluciona problemas |
|---|---|---|
| Regex | El analizador tiene un problema con una expresión regular. | Verifica la lógica del analizador. Para los analizadores sintácticos prediseñados, comunícate con el equipo de asistencia de Google SecOps. |
| Invalid_config | El archivo de configuración del analizador tiene un problema. | Valida y corrige el archivo de configuración del analizador. |
| Error de validación del lote de eventos de indexación | Los datos normalizados no pasan las verificaciones del esquema. | Revisa la asignación del analizador a los campos del UDM para asegurarte de que cumplan con los requisitos. |
| Tareas pendientes | El sistema retrasó la normalización. | Los registros sin procesar están en la cola a la espera de procesamiento. Si la demora continúa, comunícate con el equipo de asistencia. |
| LOG_PARSING_DROPPED_NO_EVENTS | El analizador no produjo ningún evento, lo que provocó que se descartara el registro. | Verifica los registros sin procesar para asegurarte de que contengan datos que realmente deberían generar eventos. |
| LOG_PARSING_DROPPED_BY_FILTER | Un filtro de descarte explícito en el analizador hizo que el sistema descartara el registro. | Revisa las condiciones del filtro en el código del analizador. Esto suele ser intencional para los registros que no tienen valor de seguridad. |
| LOG_PARSING_DROPPED_BY_FILTER: TAG_MALFORMED_ENCODING | La codificación incorrecta de JSON o XML provocó un error en el análisis. | Asegúrate de que la fuente de registro use una codificación compatible y bien formada. |
| LOG_PARSING_NO_PARSER_FOUND | El sistema no tiene un analizador para este tipo de registro. | Verifica que hayas configurado el LogType correcto y que haya un analizador activo para ese tipo. |
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.