Crea un monitor sintético

En este documento, se describe cómo puedes crear monitores sintéticos para probar la disponibilidad, coherencia y rendimiento de tus servicios, aplicaciones, páginas web y APIs. Proporcionas pruebas para tu aplicación. El monitor sintético ejecuta esa secuencia de comandos y registra los resultados de las pruebas y datos adicionales, como la latencia. Para recibir una notificación cuando falle una prueba, puedes configurar una política de alertas para supervisar los resultados de la prueba.

Información acerca de los monitores sintéticos

Un monitor sintético ejecuta periódicamente una función de Cloud Run de 2ª gen. de un solo propósito que se implementa en Cloud Run. Cuando creas el monitor sintético, defines la función de Cloud Run, que debe escribirse en Node.js, y la frecuencia de ejecución. Por ejemplo, puedes configurar tu función de Cloud Run para que interactúe con una página web con Puppeteer. También puedes configurar tu función de Cloud Run para que interactúe con una API con el módulo Axios. También te recomendamos que pruebes los recursos que se encuentran dentro de una red de VPC.

Para crear tu función de Cloud Run, puedes usar un editor intercalado o subir un archivo ZIP. Si eliges usar el editor intercalado, puedes comenzar con un esqueleto proporcionado. Después de crear un monitor sintético, Cloud Monitoring usa un sistema de programación que programa la ejecución periódica de tu función de Cloud Run. Si bien especificas la región en la que existe tu función de Cloud Run, los comandos que activan la ejecución pueden provenir de cualquier región compatible con los servidores de verificación de estado. Para obtener más información, consulta Cómo enumerar las direcciones IP del servidor de verificación del tiempo de actividad.

Puedes crear una política de alertas para que se te notifique cuando haya fallas en las pruebas:

  • Cuando creas un monitor sintético con la consola de Google Cloud, el comportamiento predeterminado es crear una política de alertas. Tú proporcionas los canales de notificación. La política de alertas predeterminada está configurada para notificarte cuando haya dos o más fallas de prueba consecutivas.

  • Cuando creas un monitor sintético con la API de Cloud Monitoring, debes crear la política de alertas para supervisar el tipo de métrica uptime_check/check_passed del recurso de Cloud Run en el que se ejecuta la función de Cloud Run.

Consideraciones sobre la frecuencia de ejecución

Tú configuras la frecuencia con la que se ejecuta tu función de Cloud Run. Para determinar la frecuencia de las ejecuciones, considera el objetivo de nivel de servicio (SLO) de tu servicio. Para detectar posibles incumplimientos de los SLO, debes ejecutar las pruebas con frecuencia. Sin embargo, el ANS de tu servicio no es la única consideración. También debes considerar cómo la tasa de ejecuciones se traduce en carga en tu servicio y en tus costos. Cada ejecución genera carga en tu servicio, por lo que, cuanto más frecuentemente ejecutes tu función de Cloud Run, mayor carga aplicarás a tu servicio. A modo de referencia, el intervalo de ejecución predeterminado para las verificaciones de tiempo de actividad es de un minuto.

La frecuencia de ejecución también determina la rapidez con la que puedes recibir una notificación cuando falla la prueba. La supervisión abre un incidente y envía una notificación después del segundo error consecutivo de una prueba. Por ejemplo, si la frecuencia de ejecución es de 5 minutos, pueden transcurrir 10 minutos antes de que haya dos pruebas fallidas. Recibirás una notificación después de la segunda prueba fallida.

Código de muestra de la función de Cloud Run

Para ver plantillas y muestras, consulta Muestras de supervisores sintéticos. Puedes usar estos ejemplos como punto de partida para tu función de Cloud Run. Si eres un desarrollador con experiencia, considera usar Gemini para generar código para monitores sintéticos y, así, reducir el tiempo de desarrollo. El uso de Gemini para generar código está en versión preliminar pública.

La plantilla genérica, que puedes seleccionar cuando creas un monitor sintético con la consola de Google Cloud, está configurada para recopilar datos de registro y seguimiento de las solicitudes HTTP salientes. La solución aprovecha el módulo auto-instrumentation-node de OpenTelemetry y el registrador winston. Debido a la dependencia de los productos de código abierto, debes esperar cambios en la estructura de los datos de seguimiento y registro. Por lo tanto, los datos de registro y seguimiento recopilados deben usarse solo con fines de depuración.

Puedes implementar tu propio enfoque para recopilar datos de seguimiento y registro de las solicitudes HTTP salientes. Para ver un ejemplo de un enfoque personalizado, consulta la clase SyntheticAutoInstrumentation.

Configuración de la función de Cloud Run

Cuando configures tu función de Cloud Run, debes especificar el entorno de ejecución, la compilación, las conexiones y la configuración de seguridad, o aceptar la configuración predeterminada:

  • Es posible que el valor predeterminado de la memoria asignada no sea suficiente. Te recomendamos que configures este campo en, al menos, 2 GiB.

  • El valor predeterminado de la configuración de transferencia de datos entrantes de tu función de Cloud Run es permitir todo el tráfico. Puedes usar esta configuración o una más restrictiva.

    Cuando permites todo el tráfico, siempre se aprueba la primera fase de validación que realizan las funciones de Cloud Run, que se realiza a nivel de la red. La segunda fase de validación determina si se le otorgó permiso al llamador para ejecutar la función de Cloud Run. La autorización depende del rol de Identity and Access Management (IAM) del llamador. De forma predeterminada, Cloud Monitoring tiene permiso para ejecutar tu función de Cloud Run. Para obtener información sobre cómo ver o modificar la configuración de transferencia de datos entrantes, consulta Configuración de entrada.

Restricciones de las funciones de Cloud Run

  • El nombre de la función de Cloud Run no debe contener guiones bajos.

  • Puedes recopilar datos de seguimiento y registro de solicitudes HTTP salientes solo cuando usas la plantilla genérica.

  • Solo se admiten funciones HTTP. Si usas la consola de Google Cloud para crear tu monitor sintético, se te proporciona una función predeterminada que consulta una URL. La fuente de la función predeterminada, que se puede modificar, está disponible en el repositorio de Git de generic-synthetic-nodejs.

    Para obtener información sobre las funciones HTTP, consulta Escribe funciones HTTP.

  • Si usas la API, el comando de implementación debe especificar que la función de Cloud Run es de 2ª generación. Si usas la consola de Google Cloud, la implementación se controla por ti. Para obtener más información, consulta Cómo implementar una función de Cloud Run.

  • El entorno de ejecución está restringido a Node.js. Para obtener más información, consulta Nodo. Las siguientes versiones de Node.js son compatibles: 12, 14, 16, 18 y 20.

Datos recopilados por los monitores sintéticos

En esta sección, se describen los datos que se recopilan para tu monitor sintético. Para obtener información sobre cómo ver los resultados de la ejecución, consulta Explora los resultados del monitor sintético.

Historial de ejecuciones

Para cada monitor sintético, se recopila un historial de resultados de ejecución. Estos datos incluyen lo siguiente:

  • Es una serie temporal que registra el éxito o el fracaso de las ejecuciones a lo largo del tiempo.

  • Es una serie temporal que registra la duración de la ejecución del código. No se registra el tiempo de ejecución de la función. Los datos de latencia se escriben como una serie temporal de uptime_check/request_latency para el recurso de Cloud Run en el que se ejecuta la función de Cloud Run. En la página Detalles del monitor sintético, se proporciona un gráfico de estos datos.

  • Registros que contienen información sobre ejecuciones de monitores sintéticos, como información sobre la prueba y los detalles de fallas. Los registros disponibles dependen de tu función de Cloud Run. Por ejemplo, si usas la plantilla Mocha, los registros incluyen información sobre si la prueba se aprobó o no, y su duración. Cuando se incluye, el seguimiento de pila enumera la línea de código que falló, los tipos de error y los mensajes de error.

  • De manera opcional, seguimientos y registros de solicitudes HTTP salientes Para obtener información sobre cómo recopilar estos datos, consulta Latencia de la solicitud.

Métricas y registros de las funciones de Cloud Run

Métricas y registros de tu función de Cloud Run Estos datos, que recopilan las funciones de Cloud Run, incluyen información sobre la cantidad de ejecuciones por segundo, el tiempo de ejecución y el uso de memoria de tu función.

Latencia de la solicitud

Cloud Trace recopila y almacena automáticamente los datos de latencia de la solicitud HTTP que realiza el monitor sintético.

Para recopilar datos de seguimiento, registro y latencia de las solicitudes HTTP salientes que realiza tu monitor sintético, debes usar la plantilla genérica. Para obtener más información, consulta Ejemplos de monitores sintéticos.

Antes de comenzar

  1. Para obtener los permisos que necesitas para ver y modificar monitores sintéticos con la consola de Google Cloud, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

    Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

    También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

  2. Enable the Cloud Monitoring API, Artifact Registry API, Cloud Build API, Cloud Functions API, Cloud Logging API, Pub/Sub API, and Cloud Run Admin API APIs.

    Enable the APIs

  3. Verifica que tu proyecto de Google Cloud contenga la cuenta de servicio predeterminada de Compute Engine. Esta cuenta de servicio se crea cuando habilitas la API de Compute Engine y tiene un nombre similar a 12345-compute@developer.gserviceaccount.com.

    En la consola de Google Cloud, ve a la página Cuentas de servicio:

    Ve a Cuentas de servicio.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es IAM y administrador.

    Si no existe la cuenta de servicio predeterminada de Compute Engine, haz clic en Crear cuenta de servicio y completa el cuadro de diálogo.

  4. Asegúrate de que se le haya otorgado el rol de editor (roles/editor) a la cuenta de servicio predeterminada de Compute Engine o a la que creaste.

    Para ver los roles otorgados a tu cuenta de servicio, haz lo siguiente:

    1. En la consola de Google Cloud, ve a la página IAM:

      Ir a IAM

      Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es IAM y administrador.

    2. Selecciona Incluir asignaciones de roles proporcionadas por Google.
    3. Si la cuenta de servicio que usa tu monitor sintético no aparece en la lista o si no se le otorgó un rol que incluya los permisos del rol de agente de Cloud Trace (roles/cloudtrace.agent), otorga este rol a tu cuenta de servicio.
  5. Configura los canales de notificaciones que deseas usar para recibir notificaciones. Te recomendamos que crees varios tipos de canales de notificaciones. Para obtener más información, consulta Cómo crear y administrar canales de notificaciones y Cómo crear y administrar canales de notificaciones con la API.

Crea un monitor sintético

Console

Cuando creas un monitor sintético con la consola de Google Cloud, se implementa una función de Cloud Run (2ª gen.) nueva y se crea el monitor para esa función de Cloud Run. No puedes crear un monitor sintético que supervise una función de Cloud Run existente.

  1. Asegúrate de haber habilitado las APIs requeridas, de que tu proyecto contenga una cuenta de servicio predeterminada de Compute Engine y de que a esta cuenta se le haya otorgado el rol de editor (roles/editor). Para obtener más información, consulta Antes de comenzar.

  2. En la consola de Google Cloud, ve a la página  Synthetic monitoring:

    Ve a Supervisión sintética.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

  3. Selecciona Crear monitor sintético.

  4. Selecciona la plantilla para tu función de Cloud Run:

    • Monitor sintético personalizado: Usa esta plantilla cuando quieras recopilar datos de registro o de seguimiento para solicitudes HTTP salientes.

    • Supervisor sintético de Mocha: Usa esta plantilla cuando escribas conjuntos de pruebas de Mocha.

    • Verificador de vínculos rotos: Usa esta plantilla para probar un URI y una cantidad configurable de vínculos que se encuentran en ese URI. Para obtener información sobre los campos de este verificador, consulta Crea un verificador de vínculos rotos.

  5. Ingresa un nombre para el monitor.

  6. Opcional: Actualiza el tiempo de espera de la respuesta, la frecuencia de verificación y agrega etiquetas definidas por el usuario.

  7. Realiza una de las siguientes acciones:

  8. En el cuadro de diálogo de la función de Cloud Run, haz lo siguiente:

    1. Ingresa un nombre visible y selecciona una región. Los nombres deben ser únicos dentro de una región.

    2. En la sección Configuración del entorno de ejecución, la compilación, las conexiones y la seguridad, haz lo siguiente:

      • Revisa la configuración predeterminada y actualízala cuando sea necesario.

      • En el campo Cuenta de servicio del entorno de ejecución, selecciona una cuenta de servicio.

    3. Edita el código generado, o bien escribe o sube código para tu función de Cloud Run:

      • Para editar el código generado, ingresar tu propio código o cargar la función de muestra predeterminada, selecciona Editor directo. La función de ejemplo, que depende de la plantilla que seleccionaste anteriormente, envía una solicitud a una URL específica. Puedes modificar la función predeterminada.

      • Para cargar un archivo ZIP desde tu sistema local, selecciona Subir ZIP.

        Si subes un archivo ZIP desde tu sistema local, también debes especificar un bucket de Cloud Storage para el archivo ZIP. Si no tienes un bucket de Cloud Storage adecuado, crea uno.

      • Para cargar un archivo ZIP desde tu cuenta de Cloud Storage, selecciona ZIP desde Cloud Storage, selecciona el bucket de almacenamiento y, luego, selecciona el archivo ZIP que deseas cargar.

        También puedes crear una función de Cloud Run con las páginas de funciones de Cloud Run en la consola de Google Cloud. Para crear un supervisor sintético que supervise una copia de esa función de Cloud Run, ve a la pestaña Fuente y haz clic en Descargar archivo ZIP. Luego, puedes subir el archivo ZIP.

    4. Haz clic en Aplicar función.

  9. Configura la política de alertas:

    1. Opcional: Actualiza el nombre de la política de alertas y la duración de la falla antes de que se envíen las notificaciones.

    2. Agrega los canales de notificaciones.

  10. Haz clic en Crear.

    La función de Cloud Run que definiste se compila y se implementa como 2ª gen., y se crea el monitor sintético.

gcloud

Cuando creas un monitor sintético con Google Cloud CLI o la API de Cloud Monitoring, pasas el nombre de la función a la llamada a la API. Por lo tanto, solo puedes crear un monitor sintético que supervise una función de Cloud Run existente.

  1. Asegúrate de haber habilitado las APIs requeridas, de que tu proyecto contenga una cuenta de servicio predeterminada de Compute Engine y de que a esta cuenta se le haya otorgado el rol de editor (roles/editor). Para obtener más información, consulta Antes de comenzar.
  2. Escribir e implementar tu función de Cloud Run de 2ª gen.

    Por ejemplo, para implementar la muestra de synthetics-sdk-nodejs en el repositorio Google Cloud/synthetics-sdk-nodejs, haz lo siguiente:

    1. Clona el repositorio y ve a la ubicación del código fuente:

      git clone https://github.com/GoogleCloudPlatform/synthetics-sdk-nodejs.git
cd synthetics-sdk-nodejs/samples/generic-synthetic-nodejs

    2. Implementa la función de Cloud Run con el comando gcloud functions deploy:

      gcloud functions deploy FUNCTION_NAME \
--gen2 --region="us-west2" --source="." \
--entry-point=SyntheticFunction --trigger-http --runtime=nodejs18

      En el comando gcloud functions deploy, haz lo siguiente:

      • Asegúrate de que el valor del campo FUNCTION_NAME sea único en su región de implementación.

      • Incluye la marca --gen2 y establece la región de implementación.

      • Configura el campo --entry-point de la siguiente manera:

        • Mocha: SyntheticMochaSuite
        • No es Mocha: SyntheticFunction.

      • Configura el campo --runtime como nodejs18.

      • Incluye la marca --trigger-http.

      • Establece el campo --ingress-settings cuando no quieras usar la configuración predeterminada, que permite todo el tráfico.

      Las funciones de Cloud Run compilan y, luego, implementan tu función de Cloud Run. Los resultados del comando de Google Cloud CLI incluyen información sobre la función, incluido su nombre completamente calificado:

      name: projects/PROJECT_ID/locations/REGION/functions/FUNCTION_NAME

      Para obtener más información sobre cómo implementar una función, consulta Cómo implementar una función de Cloud Run.

    Para enumerar las funciones de Cloud Run en tu proyecto de Google Cloud, usa el comando gcloud functions list:

    gcloud functions list

    La respuesta de esta llamada es una lista de entradas, cada una de las cuales enumera una función de Cloud Run:

    NAME: function-1
STATE: ACTIVE
TRIGGER: HTTP Trigger
REGION: us-west2
ENVIRONMENT: 2nd gen

    Para encontrar el nombre completamente calificado de una función de Cloud Run específica, ejecuta el comando gcloud monitoring uptime describe.

  3. Para crear el monitor sintético, ejecuta el comando gcloud monitoring uptime create:

    gcloud monitoring uptime create DISPLAY_NAME --synthetic-target=TARGET

    Antes de ejecutar el comando anterior, haz lo siguiente:

    • Reemplaza DISPLAY_NAME por el nombre de tu monitor sintético.
    • Reemplaza TARGET por el nombre completamente calificado de tu función de Cloud Run.

  4. Crea una política de alertas.

    Debido a la complejidad de la configuración de la política de alertas, te recomendamos que vayas a la página Supervisores sintéticos en la consola de Google Cloud y uses las opciones para crear una política de alertas. Con este enfoque, la mayoría de los campos de la política de alertas se propagan automáticamente. Para crear la política de alertas con la consola de Google Cloud, haz clic en Crear política en la página Supervisores sintéticos.

    Si planeas usar Google Cloud CLI o la API de Cloud Monitoring, configura el filtro de la condición de la siguiente manera:

    "filter": "resource.type = \"cloud_run_revision\" AND
            metric.type = \"monitoring.googleapis.com/uptime_check/check_passed\" AND
            metric.labels.check_id = \"CHECK_ID\"",

    La condición supervisa las series temporales de uptime_check/check_passed que escribe tu monitor sintético. Asegúrate de reemplazar CHECK_ID por el identificador del monitor sintético, que se incluye en los datos de respuesta de un comando create.

    Si deseas obtener información para crear una política de alertas, consulta Crea políticas de alertas con la API.

API

Cuando creas un monitor sintético con Google Cloud CLI o la API de Cloud Monitoring, pasas el nombre de la función a la llamada a la API. Por lo tanto, solo puedes crear un monitor sintético que supervise una función de Cloud Run existente.

  1. Asegúrate de haber habilitado las APIs requeridas, de que tu proyecto contenga una cuenta de servicio predeterminada de Compute Engine y de que a esta cuenta se le haya otorgado el rol de editor (roles/editor). Para obtener más información, consulta Antes de comenzar.
  2. Escribir e implementar tu función de Cloud Run de 2ª gen.

    Por ejemplo, para implementar la muestra de synthetics-sdk-nodejs en el repositorio Google Cloud/synthetics-sdk-nodejs, haz lo siguiente:

    1. Clona el repositorio y ve a la ubicación del código fuente:

      git clone https://github.com/GoogleCloudPlatform/synthetics-sdk-nodejs.git
cd synthetics-sdk-nodejs/samples/generic-synthetic-nodejs

    2. Implementa la función de Cloud Run con el comando gcloud functions deploy:

      gcloud functions deploy FUNCTION_NAME \
--gen2 --region="us-west2" --source="." \
--entry-point=SyntheticFunction --trigger-http --runtime=nodejs18

      En el comando gcloud functions deploy, haz lo siguiente:

      • Asegúrate de que el valor del campo FUNCTION_NAME sea único en su región de implementación.

      • Incluye la marca --gen2 y establece la región de implementación.

      • Configura el campo --entry-point de la siguiente manera:

        • Mocha: SyntheticMochaSuite
        • No es Mocha: SyntheticFunction.

      • Configura el campo --runtime como nodejs18.

      • Incluye la marca --trigger-http.

      • Establece el campo --ingress-settings cuando no quieras usar la configuración predeterminada, que permite todo el tráfico.

      Las funciones de Cloud Run compilan y, luego, implementan tu función de Cloud Run. Los resultados del comando de Google Cloud CLI incluyen información sobre la función, incluido su nombre completamente calificado:

      name: projects/PROJECT_ID/locations/REGION/functions/FUNCTION_NAME

      Para obtener más información sobre cómo implementar una función, consulta Cómo implementar una función de Cloud Run.

    Para enumerar las funciones de Cloud Run en tu proyecto de Google Cloud, usa el comando gcloud functions list:

    gcloud functions list

    La respuesta de esta llamada es una lista de entradas, cada una de las cuales enumera una función de Cloud Run:

    NAME: function-1
STATE: ACTIVE
TRIGGER: HTTP Trigger
REGION: us-west2
ENVIRONMENT: 2nd gen

    Para encontrar el nombre completamente calificado de una función de Cloud Run específica, ejecuta el comando gcloud monitoring uptime describe.

  3. Para crear un monitor sintético, haz lo siguiente:

    1. Haz clic en projects.uptimeCheckConfigs.create para abrir la página de referencia de la API del método.
    2. Haz clic en Probar para abrir el Explorador de APIs.

    3. Establece los siguientes campos y, luego, ejecuta el comando.

      • Campo superior: projects/PROJECT_ID.

      • Especifica lo siguiente en el cuerpo de la solicitud:

        • displayName: Establece el nombre visible de tu monitor sintético.
        • syntheticMonitor: Establece el nombre completamente calificado de tu función de Cloud Run.

      Si se realiza correctamente, la respuesta de la llamada a la API es similar a la siguiente:

      {
"name": "projects/myproject/uptimeCheckConfigs/17272586127463315332",
"displayName": "MyMonitor",
...
"syntheticMonitor": {
 "cloudFunctionV2": {
    "name": "projects/myproject/locations/us-west2/functions/function-1",
    "cloudRunRevision": {
    "type": "cloud_run_revision",
    "labels": {
       "project_id": "myproject",
       "configuration_name": "",
       "location": "us-west2",
       "revision_name": "",
       "service_name": "function-1"
    }
    }
 }
}
}

  4. Crea una política de alertas.

    Debido a la complejidad de la configuración de la política de alertas, te recomendamos que vayas a la página Supervisores sintéticos en la consola de Google Cloud y uses las opciones para crear una política de alertas. Con este enfoque, la mayoría de los campos de la política de alertas se propagan automáticamente. Para crear la política de alertas con la consola de Google Cloud, haz clic en Crear política en la página Supervisores sintéticos.

    Si planeas usar Google Cloud CLI o la API de Cloud Monitoring, configura el filtro de la condición de la siguiente manera:

    "filter": "resource.type = \"cloud_run_revision\" AND
            metric.type = \"monitoring.googleapis.com/uptime_check/check_passed\" AND
            metric.labels.check_id = \"CHECK_ID\"",

    La condición supervisa las series temporales de uptime_check/check_passed que escribe tu monitor sintético. Asegúrate de reemplazar CHECK_ID por el identificador del monitor sintético, que se incluye en los datos de respuesta de un comando create.

    Si deseas obtener información para crear una política de alertas, consulta Crea políticas de alertas con la API.

Terraform

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform. Para obtener más información, consulta la documentación de referencia del proveedor de Terraform.

Para crear un monitor sintético y una política de alertas que supervisen esa verificación, haz lo siguiente:

  1. Asegúrate de haber habilitado las APIs requeridas, de que tu proyecto contenga una cuenta de servicio predeterminada de Compute Engine y de que a esta cuenta se le haya otorgado el rol de editor (roles/editor). Para obtener más información, consulta Antes de comenzar.

  2. Edita el archivo de configuración de Terraform y agrega un recurso google_storage_bucket. Luego, aplica los cambios.

    Con el siguiente código, se define un bucket de Cloud Storage en la ubicación US:

    resource "google_storage_bucket" "gcf_source" {
   name = "gcf-v2-source-9948673986912-us"
   location = "US"
   uniform_bucket_level_access = true
}

  3. Edita tu archivo de configuración de Terraform y agrega un recurso google_storage_bucket_object y, luego, aplica los cambios.

    El recurso especifica el nombre del objeto en tu bucket y la ubicación del archivo ZIP en tu sistema local. Por ejemplo, cuando aplicas el siguiente código, se agrega un archivo con el nombre example-function.zip a tu bucket de almacenamiento:

    resource "google_storage_bucket_object" "object" {
   name = "example-function.zip"
   bucket = google_storage_bucket.gcf_source.name
   source = "generic-synthetic-node.js.zip"
}

  4. Edita tu archivo de configuración de Terraform y agrega un recurso google_cloudfunctions2_function y, luego, aplica los cambios.

    Asegúrate de que tu recurso google_cloudfunctions2_function especifique un entorno de ejecución de Node.js y el punto de entrada que usan los monitores sintéticos. Por ejemplo, cuando aplicas el siguiente código, se implementa una función con el nombre sm-central1:

    resource "google_cloudfunctions2_function" "central1" {
   name = "sm-central1"
   location = "us-central1"

   build_config {
      runtime = "nodejs20"
      entry_point = "SyntheticFunction"
      source {
            storage_source {
               bucket = google_storage_bucket.gcf_source.name
               object = google_storage_bucket_object.object.name
            }
      }
   }

   service_config {
      max_instance_count = 1
      available_memory = "256Mi"
      timeout_seconds  = 60
   }
}

  5. Para crear un monitor sintético, edita tu archivo de configuración de Terraform, agrega un recurso google_monitoring_uptime_check_config y, luego, aplica los cambios.

    Para este recurso, especifica el bloque synthetic_monitor:

    resource "google_monitoring_uptime_check_config" "synthetic" {
   display_name = "sm-central1"
   timeout = "30s"

   synthetic_monitor {
      cloud_function_v2 {
            name = google_cloudfunctions2_function.central1.id
      }
   }
}

  6. Opcional: Crea un canal de notificaciones y una política de alertas.

    En los siguientes pasos, se usa la consola de Google Cloud para crear el canal de notificaciones y la política de alertas. Este enfoque garantiza que la política de alertas solo supervise los datos que genera tu monitor sintético.

    1. Para crear un canal de notificaciones, sigue estos pasos:

      1. En la consola de Google Cloud, ve a la página  Alertas.

        Ir a las Alertas

        Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

      2. Selecciona Administrar canales de notificaciones.
      3. Ve al tipo de canal que deseas agregar, haz clic en Agregar y, luego, completa el cuadro de diálogo.

    2. Para crear una política de alertas, sigue estos pasos:

      1. En la consola de Google Cloud, ve a la página  Synthetic monitoring:

        Ve a Supervisión sintética.

        Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

      2. Busca el monitor sintético, selecciona Más y, luego, Agregar política de alertas.
      3. En el diálogo, ve a la sección Notificaciones y nombre, expande Canales de notificaciones y realiza tus selecciones.
      4. Asigna un nombre a la política de alertas y, luego, haz clic en Crear política.

Precios

En general, las métricas del sistema de Cloud Monitoring son gratuitas, mientras que las métricas de sistemas, agentes o aplicaciones externos no lo son. Las métricas facturables se facturan según la cantidad de bytes o la cantidad de muestras transferidas.

Para obtener más información sobre los precios de Cloud Monitoring, consulta los siguientes documentos:

Cómo solucionar problemas de los monitores sintéticos

En esta sección, se proporciona información que puedes usar para solucionar problemas de tus monitores sintéticos.

Mensaje de error después de habilitar las APIs

Abres el flujo de creación de un monitor sintético y se te solicita que habilites al menos una API. Después de habilitar las APIs, se muestra un mensaje similar al siguiente:

An error occurred during fetching available regions: Cloud Functions API has
not been used in project PROJECT_ID before or it is disabled.

El mensaje de error te recomienda que verifiques que la API esté habilitada y, luego, te aconseja que esperes y vuelvas a intentar la acción.

Para verificar que la API esté habilitada, ve a la página APIs y servicios de tu proyecto:

Ir a API y servicios.

Después de verificar que la API esté habilitada, puedes continuar con el flujo de creación. La condición se resuelve automáticamente después de que la habilitación de la API se propaga a través del backend.

No se realiza un seguimiento de las solicitudes HTTP salientes

Configuras tu monitor sintético para recopilar datos de seguimiento de las solicitudes HTTP de salida. Tus datos de seguimiento solo muestran un intervalo, similar a la siguiente captura de pantalla:

Cloud Trace muestra solo un seguimiento.

Para resolver esta situación, asegúrate de que a tu cuenta de servicio se le haya otorgado el rol de agente de Cloud Trace (roles/cloudtrace.agent). También es suficiente con el rol de editor (roles/editor).

Para ver los roles otorgados a tu cuenta de servicio, haz lo siguiente:

  1. En la consola de Google Cloud, ve a la página IAM:

    Ir a IAM

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es IAM y administrador.

  2. Selecciona Incluir asignaciones de roles proporcionadas por Google.

  3. Si la cuenta de servicio que usa tu monitor sintético no aparece en la lista o si no se le otorgó un rol que incluya los permisos del rol de agente de Cloud Trace (roles/cloudtrace.agent), otórgale este rol a tu cuenta de servicio.

    Si no conoces el nombre de tu cuenta de servicio, en el menú de navegación, selecciona Cuentas de servicio.

Estado en curso

En la página Supervisión sintética, se muestra un monitor sintético con el estado In progress. Un estado de In progress significa que el monitor sintético se creó recientemente y no hay datos para mostrar, o que no se pudo implementar la función.

Para determinar si la función no se implementó, prueba lo siguiente:

  • Asegúrate de que el nombre de tu función de Cloud Run no contenga virgulillas. Si hay una línea baja, quítala y vuelve a implementar la función de Cloud Run.

  • Abre la página Detalles del monitor sintético del monitor sintético.

    Si ves el siguiente mensaje, borra el monitor sintético.

    Cloud Function not found for this Synthetic monitor. Please confirm it exists or delete this monitor.

    El mensaje de error indica que se borró la función y, por lo tanto, el monitor sintético no puede ejecutarla.

  • Abre la página de funciones de Cloud Run de la función. Para abrir esta página desde la página Detalles del monitor sintético, haz clic en Código y, luego, en el nombre de la función.

    Si ves un mensaje similar al siguiente, la función no se pudo implementar.

    This function has failed to deploy and will not work correctly. Please edit and redeploy

    Para resolver esta falla, revisa el código de la función y corrige los errores que impiden que se compile o implemente la función.

Cuando creas un monitor sintético, la función puede tardar varios minutos en implementarse y ejecutarse.

Estado de advertencia

En Supervisión sintética, se muestra un monitor sintético con el estado Warning. Un estado de Warning significa que los resultados de la ejecución son incoherentes. Esto podría indicar un problema de diseño con la prueba o que lo que se está probando tiene un comportamiento incoherente.

Estado de rechazo

En Monitores sintéticos, se muestra un monitor sintético con el estado Failing. Para obtener más información sobre el motivo de la falla, consulta el historial de ejecución más reciente.

  • Si se muestra el mensaje de error Request failed with status code 429, significa que el destino de la solicitud HTTP rechazó el comando. Para resolver esta falla, debes cambiar el objetivo de tu monitor sintético.

    El extremo https://www.google.com rechaza las solicitudes que realizan los monitores sintéticos.

  • Si la falla muestra un tiempo de ejecución de 0ms, es posible que la función de Cloud Run se esté quedando sin memoria. Para resolver esta falla, edita tu función de Cloud Run y, luego, aumenta la memoria a, al menos, 2 GiB y establece el campo de CPU en 1.

No se puede borrar un monitor sintético

Usas la API de Cloud Monitoring para borrar un monitor sintético, pero la llamada a la API falla con una respuesta similar a la siguiente:

{
  "error": {
    "code": 400,
    "message": "Request contains an invalid argument.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.DebugInfo",
        "detail": "[ORIGINAL ERROR] generic::invalid_argument: Cannot delete check 1228258045726183344. One or more alerting policies is using it.Delete the alerting policy with id projects/myproject/alertPolicies/16594654141392976482 and any other policies using this uptime check and try again."
      }
    ]
  }
}

Para resolver la falla, borra las políticas de alertas que supervisen los resultados del monitor sintético y, luego, borra el monitor sintético.

¿Qué sigue?