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

  1. Verifica que hayas configurado Gemini Cloud Assist.

  2. (Opcional) Verifica que hayas habilitado las APIs recomendadas:

    • logging.googleapis.com
    • monitoring.googelapis.com
    • cloudresourcemanager.googleapis.com

    Consulta Cómo habilitar e inhabilitar servicios para obtener instrucciones sobre cómo habilitar las APIs.

  3. 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 en tu proyecto. Cuando creas una investigación, se te otorga el rol de IAM de Propietario de la investigación (roles/geminicloudassist.investigationOwner) en ella, lo que te permite revisar sus resultados.

  4. Tener 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.

  5. Si planeas realizar una investigación sobre una aplicación, esta debe estar incluida en una carpeta configurada para la administración de aplicaciones. Gemini Cloud Assist no admite aplicaciones creadas en un proyecto host o un límite de un solo proyecto.

Crea una investigación

Console

  1. 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 Cloud Assist Investigations

  2. Expande el menú desplegable Configurar la investigación.

  3. (Opcional) Ingresa un nombre de investigación para tu investigación.

    El nombre que elijas identificará esta investigación en tu historial de investigaciones. Si omites este paso, se generará automáticamente un nombre para la investigación.

  4. Usa el menú desplegable Seleccionar período para elegir el período que deseas investigar.

    Una hora de inicio precisa permite establecer correlaciones basadas en el tiempo entre eventos aparentemente no relacionados y agrega más peso a los eventos que ocurrieron cerca de la hora de inicio. Si no tienes certeza del período, puedes realizar varias investigaciones de forma simultánea con diferentes períodos.

  5. 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 ambas opciones.

  6. Si tu punto de entrada admite investigaciones de aplicaciones, usa el campo Aplicación para elegir una aplicación que investigar.

  7. (Opcional) Haz clic en + Agregar recurso para seleccionar los recursos afectados por el problema que estás experimentando.

    Puedes agregar recursos con el selector de recursos o ingresarlos manualmente. 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 se encuentran en un proyecto o una aplicación que está fuera del alcance de la investigación.
    • Recursos que no se admiten
    • Son los recursos que no se reconocen.

  8. 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

  1. 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 creará 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.

  2. Obtén un token de acceso:

    TOKEN=$(gcloud auth print-access-token)

  3. Usa el método investigations.create 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 anteriormente. Por ejemplo, Desktop/my-investigation.json.

    • PROJECT_NAME: Ingresa el mismo nombre del proyecto que incluiste en la observación user.project.

  4. En la respuesta, copia el valor del parámetro revision.

  5. Usa el método investigations.revisions.run 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 parámetro name que se devolvió en la respuesta investigations.revisions.run y usa ese valor en el parámetro name de una solicitud operations.get.

Revisa una investigación

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

Una investigación contiene las siguientes secciones:

  1. El Resumen de la investigación

    En esta sección, se incluye un resumen general del problema, la estrategia que usó Gemini para investigarlo y los hallazgos clave de la investigación.

  2. 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 ver los 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 solucionar problemas y, así, confirmar o refutar la hipótesis.

      • Si se admite una corrección para el problema identificado en la hipótesis, se incluye un botón Generar plan en los pasos de corrección. Si haces clic en Generar plan, se creará 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 él.

  3. Los hallazgos

    En esta sección, se incluyen las observaciones que genera la investigación y se enumeran los Google Cloud recursos involucrados en ella. Las observaciones se basan en revisiones de runbooks procedimentales, registros, mensajes de interrupción y alertas.

    En la sección de hallazgos, se muestra la información que usó Gemini para generar las hipótesis, lo que puede ser útil para definir mejor tu investigación.

Puedes revisar la entrada de tu 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 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?