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. Tú proporcionas pruebas para tu aplicación. El monitor sintético ejecuta esa secuencia de comandos y registra los resultados de las pruebas. 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 de manera periódica un solo propósito Función de Cloud Run de 2a gen. implementada 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 puedes probar 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 usa el editor directo y, luego, puedes comenzar con el 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. Debes proporcionar el canales de notificaciones. 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 una política de alertas para supervisar Tipo de métrica uptime_check/check_passed para el Recurso de Cloud Run al que es la función de Cloud Run en ejecución.

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, tener en cuenta la objetivo de nivel de servicio (SLO) para tu servicio. Para detectar posibles incumplimientos del SLO, debes ejecutar las pruebas con frecuencia. Sin embargo, el SLO para 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 proporciona carga a tu servicio, por lo que cuanto más frecuentemente ejecutes tu función de Cloud Run, mayor será la carga que apliques 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 notificaciones cuando si 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 tu frecuencia de ejecución es de 5 minutos, puede tardar 10 minutos hay 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 estas muestras 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, es posible que se produzcan cambios en la estructura de los datos de seguimiento y registro. Por lo tanto, el seguimiento y los datos de registro solo deben usarse con fines de depuración.

Puedes implementar tu propio enfoque para recopilar datos de registro y seguimiento para llamadas salientes. de las solicitudes HTTP. 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 este parámetro de configuración o una configuración 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 el llamador tenga permiso 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 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 funciones de Cloud Run

• El nombre de tu función de Cloud Run no debe contener un guion bajo.

• 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 de HTTP, consulta Cómo escribir funciones de 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, y la implementación se hará 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 el monitor sintético. Si quieres obtener información para 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 los resultados de la 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.

• 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 a la que está en ejecución. Hay un gráfico de estos datos en la Página de detalles del monitor sintético.

• 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 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 Información para obtener información sobre cómo recopilar estos datos, consulta Latencia de las solicitudes.

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 para las solicitudes HTTP salientes realizadas por tu monitor sintético, debes usar el plantilla genérica. Para obtener más información, consulta Ejemplos de monitores sintéticos.

Antes de comenzar

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

   • Editor de Monitoring (roles/monitoring.editor)
   • Desarrollador de Cloud Functions (roles/cloudfunctions.developer)

   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 instancia predeterminada de Compute Engine cuenta de servicio. Esta cuenta de servicio se crea cuando habilitas el API de Compute Engine y tiene un nombre similar al [e-mail]

   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 la cuenta de servicio predeterminada de Compute Engine no existe, 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 el monitor sintético no aparece en la lista o si No se le otorgó un rol que incluya permisos en el rol del agente de Cloud Trace (roles/cloudtrace.agent), otórgale este rol tu cuenta de servicio.
5. Configura los canales de notificaciones que deseas usar para recibir notificaciones. Te recomendamos crear varios tipos de notificaciones canales. 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

Advertencia: No configures un monitor sintético para probar https://www.google.com. Si usas el código de ejemplo, asegúrate de modificar el campo url antes de implementas el código de muestra.

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 un una función existente de Cloud Run.

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 de 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. Actualiza el Tiempo de espera de respuesta, la Frecuencia de verificación (opcional) y agregar etiquetas definidas por el usuario.

7. Realiza una de las siguientes acciones:

   • Si tienes acceso a Gemini Code Assist en este proyecto y quieres ayuda para escribir tu código, haz clic en Ayúdame a escribir código. Esta función está en versión preliminar pública. Para obtener orientación sobre las instrucciones, consulta Obtén información para escribir instrucciones para supervisores sintéticos.

     Cuando estés conforme con el código, haz clic en Insertar en Cloud Function.

   • Haz clic en Crear función.

8. En el 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 en cada región.

      Nota: incluir un guion bajo en el nombre de la función de Cloud Run.

   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.

        Nota: La configuración predeterminada para la memoria asignada, la CPU y la seguridad podría no ser suficiente. Te recomendamos que configures memoria al menos a 2 GiB.

      • 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, ingresa tu propio código o carga la función predeterminada de muestra, Selecciona Editor intercalado. La función de muestra, que es dependiente en 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 pero no tienes un bucket de Cloud Storage apropiado, crea uno.

        Nota: Cuando creas un bucket de almacenamiento nuevo, este se abre de inmediato, se muestra el mensaje No objects found y las opciones son seleccionar o cancelar. Haz clic en Cancelar para volver al diálogo Crear función. A continuación, para el bucket de destino, selecciona Explorar y, luego, selecciona tu bucket de Cloud Storage.

      • Para cargar un archivo ZIP desde Cloud Storage, selecciona ZIP de 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 supervisa una función existente de Cloud Run.

1. Asegúrate de haber habilitado los las APIs requeridas que contiene tu proyecto una cuenta de servicio predeterminada de Compute Engine tener el rol de editor (roles/editor). Para obtener más información, consulta Antes de comenzar.
2. Escribe e implementa la 2ª gen.. Cloud Run.

   Por ejemplo, para implementar la muestra synthetics-sdk-nodejs en la 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.

        Nota: No incluyas una barra baja en el nombre de tu función de Cloud Run.

      • Incluye la marca --gen2 y configura 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.

      • Configura el campo --ingress-settings cuando no quieras usar el valor predeterminado que permite todo el tráfico.

      Cloud Run Functions compila y, luego, implementa tu función de Cloud Run. Los resultados del comando de Google Cloud CLI incluyen información sobre el función, incluido su nombre completamente calificado:

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

      Para obtener más información sobre la implementación de una función, consulta Implementa una función de Cloud Run.

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

   gcloud functions list
   

   La respuesta de esta llamada es una lista de entradas, cada entrada enumera un 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 Cloud Run.

4. Crea una política de alertas.

   Debido a la complejidad de la política de alertas, de la aplicación, te recomendamos que consultes la página de Monitores sintéticos en la consola de Google Cloud y usarás las opciones para crear una política de alertas. Con este enfoque, la mayoría de los campos de políticas de alertas completado por ti. Para crear la política de alertas con el En la consola de Google Cloud, haz clic en Crear política Página de 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 con el identificador del monitor sintético, y que se incluye en los datos de respuesta de un 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. Escribe e implementa la 2ª gen.. Cloud Run.

   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.

        Nota: No incluyas una barra baja en el nombre de tu función de Cloud Run.

      • Incluye la marca --gen2 y configura 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.

      • Configura el campo --ingress-settings cuando no quieras usar el valor predeterminado que permite todo el tráfico.

      Cloud Run Functions compila y, luego, implementa tu función de Cloud Run. Los resultados del comando de Google Cloud CLI incluyen información sobre el función, incluido su nombre completamente calificado:

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

      Para obtener más información sobre la implementación de una función, consulta Implementa una función de Cloud Run.

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

   gcloud functions list
   

   La respuesta de esta llamada es una lista de entradas, cada entrada enumera un 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. Configura los siguientes campos y, luego, ejecuta el comando.

      • Campo superior: projects/PROJECT_ID.

      • Especifica lo siguiente en el cuerpo de la solicitud:

        • displayName: Se establece como el nombre visible del monitor sintético.
        • syntheticMonitor: Se establece como el nombre completamente calificado de tu 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 política de alertas, de la aplicación, te recomendamos que consultes la página de Monitores sintéticos en la consola de Google Cloud y usarás las opciones para crear una política de alertas. Con este enfoque, la mayoría de los campos de políticas de alertas completado por ti. 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 para supervisar 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.

   El siguiente código 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 una google_storage_bucket_object recurso y, luego, aplicar los cambios.

   El recurso especifica el nombre del objeto en el bucket y la ubicación del archivo ZIP en tu sistema local. Por ejemplo, cuando aplicas el siguiente código, se crea un archivo con el nombre example-function.zip se agrega 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 una google_cloudfunctions2_function recurso y, luego, aplicar los cambios.

   Nota: No incluyas una barra baja en el nombre de tu función de Cloud Run.

   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 crea una función con el nombre Se implementó 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 la notificación y la política de alertas. Este enfoque garantiza que la política de alertas solo supervisa los datos que genera tu monitor sintético.

   1. Para crear un canal de notificaciones, haz lo siguiente:

      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 quieres agregar, haz clic en Agregar y y, luego, completarás 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 cuadro de 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, y las métricas de sistemas, agentes o aplicaciones externos. 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:

• Resumen de precios de Cloud Monitoring.
• Precios de Cloud Monitoring.

Soluciona problemas de 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, aparecerá un mensaje similar al siguiente se muestra:

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, dirígete a la página APIs y de Google Cloud para tu proyecto:

Ir a API y servicios.

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

No se hace un seguimiento de las solicitudes HTTP de salida

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

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

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, selecciona Cuentas de servicio en el menú de navegación.

Estado En curso

En la página Monitores sintéticos, se muestra una lista de monitores sintéticos con un estado de In progress. Un estado de In progress significa que el monitor sintético se creó hace poco y no hay datos para mostrar, o que no se pudo implementar la función.

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

• Asegúrate de que el nombre de tu función de Cloud Run no contenga virgulillas. Si hay un guion bajo, quítalo y vuelve a implementar la función de Cloud Run.

• Abre la página Detalles 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, significa que la función falló. para implementarlo.

  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.

Cuando creas un monitor sintético, el proceso puede tardar varios minutos función que se implementará y ejecutará.

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 error

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, ver 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 solucionar este problema, sigue estos pasos: falla, edita tu función de Cloud Run y, luego, aumenta la memoria en al menos 2 GiB y establece el campo de CPU en 1.

No se puede borrar un monitor sintético

Se usa la API de Cloud Monitoring para borrar un monitor sintético, pero la llamada 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?

• Muestras para supervisores sintéticos
• Cómo administrar monitores sintéticos
• Explora los resultados del monitor sintético