Crea una investigación de Gemini Cloud Assist

En esta página, se muestra cómo crear y revisar investigaciones de Gemini Cloud Assist.

Antes de comenzar

Verifica que hayas configurado Gemini Cloud Assist.
(Opcional) Verifica que hayas habilitado las APIs recomendadas:
- logging.googleapis.com
- monitoring.googelapis.com
- cloudresourcemanager.googleapis.com
Consulta Inhabilita y habilita servicios para obtener instrucciones sobre cómo habilitar las APIs.
Para obtener los permisos necesarios para crear una investigación, pídele a tu administrador que te otorgue el rol de IAM de creador de investigaciones (roles/geminicloudassist.investigationCreator) en el proyecto.

Este rol predefinido contiene el permiso necesario para crear una investigación dentro de tu proyecto. Cuando creas una investigación, se te otorga el rol de propietario de la investigación (roles/geminicloudassist.investigationOwner) de IAM en ella, lo que te permite revisar sus resultados.
Ten acceso al producto que se investiga.

Cuando realizas una investigación, Gemini Cloud Assist usa tus credenciales para acceder a las APIs y a la información. Esto significa que el acceso de la investigación se limita al acceso que tienes.
Si planeas realizar una investigación en una aplicación, esta debe estar contenida en una carpeta configurada para la administración de aplicaciones. Gemini Cloud Assist no admite aplicaciones creadas en un proyecto host ni en un límite de un solo proyecto.

Crea una investigación

Console

Para crear una investigación nueva, haz clic en el botón Investigar asociado con tu punto de entrada. Un punto de entrada típico para crear una investigación es la página Investigaciones de Cloud Assist.

Ir a Investigaciones de Cloud Assist
Expande el menú desplegable Configurar investigación.
(Opcional) Ingresa un Nombre de la investigación para tu investigación.

El nombre que elijas identifica esta investigación en tu historial de investigaciones. Si omites este paso, se generará automáticamente un nombre para la investigación.
Usa el menú desplegable Seleccionar intervalo de tiempo para seleccionar el período que deseas investigar.

Así, permitirás que se establezcan correlaciones temporales entre eventos aparentemente inconexos y se agregue más peso a los eventos que ocurrieron cerca de la hora de inicio. Si no estás seguro del intervalo de tiempo, puedes ejecutar varias investigaciones de forma simultánea con diferentes intervalos de tiempo.
Describe el problema que tienes.

Puedes copiar y pegar el mensaje de error exacto que recibiste, usar lenguaje natural para explicar el problema que tienes o incluir ambos.
Si tu punto de entrada admite investigaciones de aplicaciones, usa el campo Aplicación para elegir una aplicación para investigar.
(Opcional) Haz clic en + Agregar recurso para seleccionar los recursos que están afectados por el problema que tienes.

Puedes agregar recursos con el selector de recursos o ingresarlos de forma manual. Cuando ingreses recursos de forma manual, debes consultar la documentación de referencia del recurso para asegurarte de usar el formato correcto.

No puedes continuar con una investigación si incluyes alguno de los siguientes elementos:
- Recursos que están en un proyecto o una aplicación que está fuera del alcance de la investigación
- Recursos que no son compatibles.
- Recursos que no se reconocen
Haz clic en Crear para comenzar la investigación.

Se abrirá la página Detalles de la investigación y los resultados aparecerán en la página a medida que estén disponibles. La investigación puede tardar varios minutos en completarse. Si sales de la página de detalles de la investigación, puedes verificar su estado haciendo clic en el botón Notificaciones ().

API

Crea un archivo JSON que contenga la siguiente información:
```
{
"title": "INVESTIGATION_NAME",
"observations": {
  "user.project": {
    "id": "user.project",
    "observationType": "OBSERVATION_TYPE_STRUCTURED_INPUT",
    "observerType": "OBSERVER_TYPE_USER",
    "text": "PROJECT_NAME"
  },
  "user.input.text": {
    "id": "user.input.text",
    "observationType": "OBSERVATION_TYPE_TEXT_DESCRIPTION",
    "observerType": "OBSERVER_TYPE_USER",
    "timeIntervals": [
      {
        "startTime": "ISSUE_START_TIME"
      }
    ],
    "text": "ISSUE_DESCRIPTION",
    "relevantResources": [
      "AFFECTED_RESOURCE"
    ],
  },
}
```
Reemplaza lo siguiente:
- INVESTIGATION_NAME: Ingresa un nombre para la investigación. Por ejemplo, Missing Cloud Storage bucket.
- PROJECT_NAME: Ingresa el nombre del proyecto en el que se crea la investigación. Por ejemplo, my-project.
- ISSUE_START_TIME: Ingresa la fecha y la hora en que comenzó el problema que estás investigando. Por ejemplo, 2025-07-08T17:23:00Z.
- ISSUE_DESCRIPTION: Ingresa una descripción del problema que tienes. Puedes incluir el mensaje de error exacto que recibiste, usar lenguaje natural para explicar el problema que tienes o incluir ambos.
- AFFECTED_RESOURCE: Ingresa el nombre del recurso involucrado en el problema que tienes. Por ejemplo, //storage.googleapis.com/my-bucket. Para asegurarte de usar el formato correcto para un recurso, debes consultar la documentación de referencia del recurso.
Para obtener una representación completa de un recurso de investigación, consulta la especificación del recurso.
Obtén un token de acceso:
```
TOKEN=$(gcloud auth print-access-token)
```
Usa el investigations.create método para crear la investigación:
```
curl -X POST --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  "https://geminicloudassist.googleapis.com/v1alpha/projects/PROJECT_NAME/locations/global/investigations"
```
Reemplaza lo siguiente:
- JSON_FILE_NAME: Ingresa la ruta de acceso al archivo JSON que creaste antes. Por ejemplo, Desktop/my-investigation.json.
- PROJECT_NAME: Ingresa el mismo nombre del proyecto que incluiste en la observación user.project.
En la respuesta, copia el valor del parámetro revision.
Usa el investigations.revisions.run método para ejecutar la investigación:
```
curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  "https://geminicloudassist.googleapis.com/v1alpha/projects/REVISION_RESOURCE:run"
```
Reemplaza REVISION_RESOURCE por el valor que copiaste del parámetro revision.

La investigación puede tardar varios minutos en completarse. Para verificar el estado de la investigación, copia el valor del name parámetro que se mostró en la respuesta investigations.revisions.run y usa el valor en el name parámetro de una solicitud operations.get.

Revisa una investigación

Cuando trabajes con investigaciones en la Google Cloud consola, podrás ver los detalles de la investigación desde el punto de entrada en el que la iniciaste o desde el historial de investigacionesde tu proyecto.

Una investigación contiene las siguientes secciones:

El Resumen de la investigación

Esta sección contiene un resumen de alto nivel del problema, la estrategia que usó Gemini para investigar y los hallazgos clave de la investigación.
Las Hipótesis

Esta sección contiene una o más tarjetas de hipótesis basadas en los datos que recopiló la investigación y las observaciones que realizó. Para encontrar detalles de cada hipótesis, haz clic en el botón Ver de la tarjeta correspondiente.
- Los detalles de una hipótesis contienen una sección Qué que describe cuál podría ser el problema y una sección Próximos pasos que describe las acciones que te ayudan a corregir el problema o que te proporcionan pasos adicionales para la solución de problemas para confirmar o refutar la hipótesis.
  - Si se admite una corrección para el problema que se identificó en la hipótesis, se incluye un botón Generar plan en los pasos de corrección. Si haces clic en Generar plan , se crea un plan de corrección paso a paso, que incluye acciones concretas, como comandos gcloud o manifiestos de Kubernetes. Después de revisar el plan, puedes hacer clic en Ejecutar para realizar las acciones descritas en el plan.
Los Hallazgos

Esta sección contiene observaciones que genera la investigación y enumera los Google Cloud recursos involucrados en la investigación. Las observaciones se basan en revisiones de runbooks procedimentales, registros, mensajes de interrupción y alertas.

La sección de hallazgos te muestra qué información usó Gemini para generar las hipótesis y puede ser útil para refinar tu investigación.

Puedes revisar la entrada de la investigación con el botón Editar, que te permite volver a ejecutar la investigación con información actualizada. Cuando una investigación tiene varias ejecuciones asociadas, puedes revisar los resultados de las ejecuciones anteriores de la investigación con el selector desplegable Revisión.

Si tienes un paquete de asistencia, puedes hacer clic en el botón Solicitar asistencia que se encuentra en la página de detalles de la investigación para enviar un caso de asistencia. Cuando lo hagas, podrás completar automáticamente los detalles del caso y compartir los resultados de la investigación con el ingeniero de asistencia.

¿Qué sigue?

Obtén más información sobre las investigaciones.
Visualiza y administra las investigaciones existentes.