Crear comprobaciones de disponibilidad del servicio públicas

En este documento se describe cómo crear una comprobación de disponibilidad pública. Una comprobación de disponibilidad pública puede enviar solicitudes desde varias ubicaciones de todo el mundo a URLs o recursos disponibles públicamente para comprobar si el recurso responde. Google Cloud Para obtener información sobre cómo crear comprobaciones de disponibilidad para redes privadas, consulta Crear comprobaciones de disponibilidad privadas.

Las comprobaciones de disponibilidad públicas pueden determinar la disponibilidad de los siguientes recursos monitorizados:

Para ver enlaces a información sobre cómo gestionar y monitorizar tus verificaciones de tiempo de actividad, consulta la sección Pasos siguientes de este documento.

Esta función solo se admite en proyectos de Google Cloud . En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.

Acerca de las comprobaciones de disponibilidad del servicio

En el caso de HTTP y HTTPS, se siguen todas las redirecciones de URLs y se usa la respuesta final recibida por la comprobación del tiempo de actividad para evaluar los criterios de éxito. En el caso de las comprobaciones HTTPS, el tiempo de vencimiento del certificado SSL se calcula en función del certificado de servidor recibido en la respuesta final.

Para que una comprobación del tiempo de actividad se realice correctamente, deben cumplirse las siguientes condiciones:

  • El estado HTTP debe coincidir con los criterios que especifiques.
  • Los datos de respuesta no tienen el contenido obligatorio o sí lo tienen.

Las comprobaciones de disponibilidad no cargan recursos de la página ni ejecutan JavaScript, y la configuración predeterminada de una comprobación de disponibilidad no incluye la autenticación.

Antes de empezar

Sigue estos pasos en el Google Cloud proyecto que almacenará la comprobación de disponibilidad:

  1. Para obtener los permisos que necesitas para crear comprobaciones de disponibilidad, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en tu proyecto:

    • Editor de Monitoring (roles/monitoring.editor): Google Cloud usuarios de la consola
    • Editor de configuraciones de comprobación de disponibilidad del servicio de Monitoring (roles/monitoring.uptimeCheckConfigEditor): usuarios de la API
    • Editor de políticas de alertas de Monitoring (roles/monitoring.alertPolicyEditor): usuarios de la API
    • Editor de NotificationChannel de Monitoring (roles/monitoring.notificationChannelEditor): usuarios de la API

    Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

    También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

  2. Verifica que el recurso que quieres comprobar tenga un endpoint público o esté detrás de un cortafuegos configurable.

    En el resto de las configuraciones, debes crear una comprobación de tiempo de actividad privada. Para obtener más información, consulta el artículo Crear comprobaciones de disponibilidad privadas.

  3. Si tu recurso está protegido por un cortafuegos, configúralo para que permita el tráfico entrante de las direcciones IP de los servidores de comprobación del tiempo de actividad. Para obtener más información, consulta Mostrar direcciones IP de servidores de comprobaciones de disponibilidad.

  4. Configura los canales de notificaciones que quieras usar para recibir notificaciones. Te recomendamos que crees varios tipos de canales de notificación. Para obtener más información, consulta cómo crear y gestionar canales de notificación.

  5. Identifica al menos tres comprobadores para tu comprobación del tiempo de actividad. La región de comprobación del tiempo de actividad USA incluye las regiones USA_OREGON, USA_IOWA y USA_VIRGINIA. Cada una de las USA_* regiones tiene un verificador, y USA incluye los tres. Las otras regiones de comprobación del tiempo de actividad, EUROPE, SOUTH_AMERICA y ASIA_PACIFIC, tienen cada una un comprobador.

    Si selecciona Global cuando usa la Google Cloud consolaREGION_UNSPECIFIED o REGION_UNSPECIFIED cuando usa la API, las comprobaciones de tiempo de actividad se emiten desde todas las regiones de comprobación de tiempo de actividad.

  6. Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

    Terraform

    Para usar las muestras de Terraform de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

      Instala Google Cloud CLI.

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

      If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

    Para obtener más información, consulta Configurar ADC en un entorno de desarrollo local en la documentación de autenticación Google Cloud .

    C#

    Para usar las .NET muestras de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

      Instala Google Cloud CLI.

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

      If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

    Para obtener más información, consulta Configurar ADC en un entorno de desarrollo local en la documentación de autenticación Google Cloud .

    Go

    Para usar las Go muestras de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

      Instala Google Cloud CLI.

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

      If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

    Para obtener más información, consulta Configurar ADC en un entorno de desarrollo local en la documentación de autenticación Google Cloud .

    Java

    Para usar las Java muestras de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

      Instala Google Cloud CLI.

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

      If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

    Para obtener más información, consulta Configurar ADC en un entorno de desarrollo local en la documentación de autenticación Google Cloud .

    Node.js

    Para usar las Node.js muestras de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

      Instala Google Cloud CLI.

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

      If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

    Para obtener más información, consulta Configurar ADC en un entorno de desarrollo local en la documentación de autenticación Google Cloud .

    PHP

    Para usar las PHP muestras de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

      Instala Google Cloud CLI.

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

      If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

    Para obtener más información, consulta Configurar ADC en un entorno de desarrollo local en la documentación de autenticación Google Cloud .

    Python

    Para usar las Python muestras de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

      Instala Google Cloud CLI.

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

      If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

    Para obtener más información, consulta Configurar ADC en un entorno de desarrollo local en la documentación de autenticación Google Cloud .

    Ruby

    Para usar las Ruby muestras de esta página en un entorno de desarrollo local, instala e inicializa la CLI de gcloud y, a continuación, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

      Instala Google Cloud CLI.

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

      If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

    Para obtener más información, consulta Configurar ADC en un entorno de desarrollo local en la documentación de autenticación Google Cloud .

    REST

    Para usar las muestras de la API REST de esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la CLI de gcloud.

      Instala Google Cloud CLI.

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

    Crear una comprobación de disponibilidad del servicio

    En esta sección se explica cómo crear y configurar comprobaciones de tiempo de actividad.

    Para crear una comprobación de disponibilidad de un balanceador de carga externo que tenga configurado al menos un puerto TCP o HTTP/s, puedes seguir estas instrucciones. Otra opción es ir a la página Detalles del servicio del servicio y hacer clic en Crear comprobación de disponibilidad. Si empiezas desde la página Detalles del servicio, los campos específicos del servicio se rellenarán automáticamente.

    Consola

    Para crear una comprobación de disponibilidad mediante la consola Google Cloud , haz lo siguiente:

    1. En la Google Cloud consola, ve a la página  Comprobaciones de tiempo de actividad:

      Ve a Comprobaciones de disponibilidad del servicio.

      Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

    2. En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.

    3. Haz clic en Crear comprobación de disponibilidad.

      Cuadro de diálogo para crear una comprobación de disponibilidad del servicio.

    4. Especifica el destino de la comprobación de disponibilidad del servicio:

      1. Selecciona el protocolo. Puedes seleccionar HTTP, HTTPS o TCP.

      2. Elige uno de los siguientes tipos de recursos:

        • URL: cualquier dirección IPv4 o nombre de host. La ruta y el puerto se introducen por separado.
        • Servicio LoadBalancer de Kubernetes: servicio de Kubernetes de tipo LoadBalancer.
        • Instancia: instancias de Compute Engine o AWS EC2.
        • App Engine: aplicaciones (módulos) de App Engine.
        • Balanceador de carga de Elastic: balanceador de carga de AWS.

      3. Introduce los campos específicos del protocolo:

        • En el caso de las comprobaciones TCP, introduce el puerto.

        • En el caso de las comprobaciones HTTP y HTTPS, puedes introducir una ruta en tu host o recurso. Todas las comprobaciones de tiempo de actividad que usan estos protocolos envían una solicitud a http://target/path. En esta expresión, para un recurso de URL, target es un nombre de host o una dirección IP. En el caso de un recurso de App Engine, target es un nombre de host derivado del nombre del servicio. En el caso de los recursos de instancias y balanceadores de carga, target es una dirección IP derivada del nombre que has proporcionado para el recurso o el grupo de recursos.

          Si dejas el campo path en blanco o le asignas el valor /, la solicitud se enviará a http://target/.

          Por ejemplo, para emitir una comprobación del tiempo de actividad a la URL del recurso example.com/tester, asigna el valor example.com al campo Nombre de host y el valor /tester al campo Ruta.

          Supongamos que has desplegado un servidor en App Engine con un dispatcher que admite / y /hello. Para emitir la comprobación del tiempo de actividad al controlador "/", deja el campo Ruta vacío. Para emitir la comprobación de tiempo de actividad al controlador /hello, asigna el valor /hello al campo Path.

      4. Introduce los campos específicos del recurso:

        • En el caso de los recursos URL, introduzca el nombre de host en el campo Nombre de host. Por ejemplo, escribe example.com.

        • En el caso de los recursos de App Engine, introduce el nombre del servicio en el campo Servicio.

        • En el caso de los recursos Elastic Load Balancer y Instance, rellena el campo Se aplica a de la siguiente manera:

          • Para emitir una comprobación del tiempo de actividad a una sola instancia o balanceador de carga, selecciona Único y, a continuación, usa el menú para seleccionar la instancia o el balanceador de carga específicos.
          • Para emitir una comprobación de tiempo de actividad a un grupo de monitorización, selecciona Grupo y, a continuación, usa el menú para seleccionar el nombre del grupo.

      5. Opcional: Para definir la frecuencia con la que se ejecuta la comprobación del tiempo de actividad, usa el campo Frecuencia de comprobación.

      6. Opcional: Para seleccionar regiones de comprobación o configurar certificados SSL, autenticación, encabezados y puertos para comprobaciones HTTP y HTTPS, haga clic en Más opciones de destino:

        • Regiones: selecciona las regiones en las que se van a recibir las solicitudes de comprobación de disponibilidad. Una comprobación de tiempo de actividad debe tener al menos tres comprobadores. Hay un verificador en todas las regiones, excepto en Estados Unidos, donde hay tres. El ajuste predeterminado, Global, incluye todas las regiones.
        • Pings ICMP: configura la comprobación de disponibilidad para enviar hasta tres pings. Para obtener más información, consulta Usar pings ICMP.
        • Método de solicitud: en las comprobaciones HTTP, selecciona el método de solicitud.
        • Cuerpo: en las comprobaciones POST de HTTP, introduce el cuerpo codificado en URL. Debes realizar la codificación tú mismo. Para el resto de las comprobaciones, deja este campo en blanco.
        • Encabezado Host: rellena este campo para comprobar los hosts virtuales. Este campo no está disponible para las comprobaciones TCP.
        • Puerto: especifica un número de puerto.
        • Encabezados personalizados: añade encabezados personalizados y encríptalos si quieres. El cifrado oculta los valores del encabezado en el formulario. Encripta los encabezados relacionados con la autenticación que no quieras que vean otros usuarios.

        • Autenticación: estos valores se envían como un encabezado de autorización. Este campo no está disponible para las comprobaciones TCP.

          Elige una de las opciones siguientes:

          • Autenticación básica: proporciona un único nombre de usuario y una contraseña. Las contraseñas siempre se ocultan en el formulario.
          • Autenticación del agente de servicio: cuando se habilita, se genera un token de identidad para el agente de servicio de monitorización. Esta opción solo está disponible para las comprobaciones HTTPS.

        • Validación de certificados SSL: si ha seleccionado HTTPS para un recurso de URL, el servicio intentará conectarse a través de HTTPS y validar el certificado SSL de forma predeterminada. Las comprobaciones de tiempo de actividad fallan cuando una URL tiene un certificado no válido. Estos son algunos de los motivos por los que un certificado puede no ser válido:

          • Un certificado caducado
          • Un certificado autofirmado
          • Un certificado con un nombre de dominio que no coincide
          • Un certificado que usa la extensión de acceso a información de la autoridad (AIA).

          Para forzar una comprobación del tiempo de actividad de HTTPS para validar el certificado SSL, selecciona Validar certificados SSL.

          Para inhabilitar la validación de certificados SSL, desmarca Validar certificados SSL.

          Si tienes certificados SSL con extensiones AIA, debes inhabilitar la validación de certificados SSL. Estos tipos de certificados no se admiten y no superan la secuencia de validación. Normalmente, el mensaje de error es "Responded with SSL handshake Error in 10000 ms".

          Puedes usar la métrica monitoring.googleapis.com/uptime_check/time_until_ssl_cert_expires para crear una política de alertas que te avise antes de que caduque tu certificado. Para obtener más información, consulta las políticas de ejemplo: política de comprobación de disponibilidad del servicio.

          Selecciona la casilla Validar certificados SSL.

    5. Haga clic en Continuar y configure los requisitos de la respuesta. Todos los ajustes de esta sección tienen valores predeterminados:

      • Para cambiar el periodo de tiempo de espera de la comprobación del tiempo de actividad, usa el campo Tiempo de espera de la respuesta. Una comprobación del tiempo de actividad falla cuando no se recibe ninguna respuesta de más de una ubicación durante este periodo.

      • Para configurar la comprobación del tiempo de actividad para que realice la coincidencia con contenido, asegúrate de que la etiqueta del interruptor sea Coincidencia con contenido habilitada:

        • Seleccione el Tipo de coincidencia de contenido de respuesta en el menú de opciones. Este campo determina cómo se compara el contenido de la respuesta con los datos devueltos. Por ejemplo, supongamos que el contenido de la respuesta es abcd y que el tipo de coincidencia de contenido es Contiene. La comprobación del tiempo de actividad solo se realiza correctamente cuando los datos de la respuesta contienen abcd. Para obtener más información, consulta Validar datos de respuesta.
        • Introduce el contenido de la respuesta. El contenido de la respuesta debe ser una cadena que no supere los 1024 bytes. En la API, este campo es el objeto ContentMatcher.

      • Para evitar que se creen entradas de registro debido a las comprobaciones de disponibilidad, desmarca Registrar fallos de comprobación.

      • En el caso de las comprobaciones de disponibilidad HTTP, configura los códigos de respuesta aceptables. De forma predeterminada, las comprobaciones de tiempo de actividad HTTP marcan cualquier respuesta 2xx como correcta.

    6. Haga clic en Continuar y configure las notificaciones.

      Para recibir una notificación cuando falle una comprobación de disponibilidad, crea una política de alertas y configura canales de notificación para esa política:

      1. Opcional: Cambia el nombre de la política de alertas.
      2. Opcional: En el campo Duración, selecciona cuánto tiempo deben fallar las comprobaciones de tiempo de actividad antes de que se envíen las notificaciones. De forma predeterminada, las notificaciones se envían cuando al menos dos regiones informan de errores en la comprobación de disponibilidad durante al menos un minuto.

      3. En el cuadro Canales de notificación, haz clic en Menú, selecciona los canales que quieras añadir y, a continuación, haz clic en Aceptar.

        En el menú, los canales de notificación se agrupan alfabéticamente por tipo de canal.

      Si no quieres crear una política de alertas, asegúrate de que el texto del botón de activación sea No crear una alerta.

    7. Haga clic en Continuar y complete la comprobación del tiempo de actividad:

      1. Introduce un título descriptivo para la comprobación de disponibilidad del servicio.

      2. Opcional: Para añadir etiquetas definidas por el usuario a tu comprobación de tiempo de actividad, haz lo siguiente:

        1. Haz clic en Mostrar etiquetas de usuario.
        2. En el campo Clave, introduce un nombre para la etiqueta. Los nombres de las etiquetas deben empezar por una letra en minúscula y pueden contener letras en minúscula, números, guiones bajos y guiones. Por ejemplo, escribe severity.
        3. En el campo Valor, introduce un valor para la etiqueta. Los valores de etiqueta pueden contener letras en minúscula, números, guiones bajos y guiones. Por ejemplo, escribe critical.
        4. Por cada etiqueta adicional, haz clic en Añadir etiqueta de usuario y, a continuación, introduce la clave y el valor de la etiqueta.

      3. Para verificar la configuración de la comprobación de disponibilidad del servicio, haz clic en Probar. Si el resultado no es el esperado, consulta la sección Comprobar fallos, corrige la configuración y repite el paso de verificación.

      4. Haz clic en Crear. Si selecciona Crear y no se ha rellenado un campo obligatorio, se mostrará un mensaje de error.

    gcloud

    Para crear la comprobación de disponibilidad, ejecuta el comando gcloud monitoring uptime create:

    gcloud monitoring uptime create DISPLAY_NAME REQUIRED_FLAGS OPTIONAL_FLAGS --project=PROJECT_ID

    Antes de ejecutar el comando anterior, sustituya lo siguiente:

    • PROJECT_ID: identificador del proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.

    • DISPLAY_NAME: el nombre de la comprobación de disponibilidad.

    • REQUIRED_FLAGS: configura esta opción para especificar el recurso que sondeará la comprobación de disponibilidad. Por ejemplo, el siguiente comando crea una comprobación de tiempo de actividad que prueba la URL EXAMPLE.com de un proyecto concreto:

      gcloud monitoring uptime create DISPLAY_NAME \
--resource-labels=host=EXAMPLE.com,project_id=PROJECT_ID \
--resource-type=uptime-url

      El comando anterior especifica los valores de cada etiqueta que requiere el tipo de recurso uptime-url.

    • OPTIONAL_FLAGS: configura estas marcas para anular los valores predeterminados. Por ejemplo, debes definir la marca --protocol cuando el protocolo no sea http.

    Terraform

    Para saber cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform. Para obtener más información, consulta la documentación de referencia del proveedor Terraform.

    Para crear una comprobación de disponibilidad y una política de alertas para monitorizarla, haz lo siguiente:

    1. Instala y configura Terraform para tu proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.

    2. Edita el archivo de configuración de Terraform y añade un recurso google_monitoring_uptime_check_config. Después, aplica el archivo de configuración.

      En el ejemplo siguiente se muestra una configuración que comprueba una URL pública:

      resource "google_monitoring_uptime_check_config" "example" {
    display_name = "example"
    timeout      = "60s"

    http_check {
        port = "80"
        request_method = "GET"
    }

    monitored_resource {
        type = "uptime_url"
        labels = {
            project_id = "PROJECT_ID"
            host="EXAMPLE.com"
        }
    }

    checker_type = "STATIC_IP_CHECKERS"
}

      En la expresión anterior:

      • PROJECT_ID es el ID de tu proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
      • EXAMPLE.com es la URL del host.

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

      En los siguientes pasos se usa la consola para crear el canal de notificaciones y la política de alertas. Google Cloud De esta forma, la política de alertas solo monitoriza los datos generados por tu comprobación de disponibilidad.

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

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

          Ve a Alertas.

          Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

        2. En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
        3. Selecciona Gestionar canales de notificaciones.
        4. Vaya al tipo de canal que quiera añadir, haga clic en Añadir y, a continuación, complete el cuadro de diálogo.

      2. Para crear una política de alertas, haz lo siguiente:

        1. En la Google Cloud consola, ve a la página  Comprobaciones de tiempo de actividad:

          Ve a Comprobaciones de disponibilidad del servicio.

          Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

        2. En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
        3. Busca la comprobación de tiempo de actividad, selecciona Más y, a continuación, Añadir política de alertas.
        4. En el cuadro de diálogo, ve a la sección Notificaciones y nombre, despliega Canales de notificaciones y haz las selecciones que quieras.
        5. Ponle un nombre a la política de alertas y haz clic en Crear política.

      Para crear una política de alertas, añade un recurso google_monitoring_alert_policy a tu archivo de configuración y aplica la nueva configuración.

    C#

    Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local. 

    public static object CreateUptimeCheck(string projectId, string hostName,
    string displayName)
{
    // Define a new config.
    var config = new UptimeCheckConfig()
    {
        DisplayName = displayName,
        MonitoredResource = new MonitoredResource()
        {
            Type = "uptime_url",
            Labels = { { "host", hostName } }
        },
        HttpCheck = new UptimeCheckConfig.Types.HttpCheck()
        {
            Path = "/",
            Port = 80,
        },
        Timeout = TimeSpan.FromSeconds(10).ToDuration(),
        Period = TimeSpan.FromMinutes(5).ToDuration()
    };
    // Create a client.
    var client = UptimeCheckServiceClient.Create();
    ProjectName projectName = new ProjectName(projectId);
    // Create the config.
    var newConfig = client.CreateUptimeCheckConfig(
        projectName,
        config,
        CallSettings.FromExpiration(
            Expiration.FromTimeout(
                TimeSpan.FromMinutes(2))));
    Console.WriteLine(newConfig.Name);
    return 0;
}

    Java

    Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local. 

    private static void createUptimeCheck(
    String projectId, String displayName, String hostName, String pathName) throws IOException {
  CreateUptimeCheckConfigRequest request =
      CreateUptimeCheckConfigRequest.newBuilder()
          .setParent(ProjectName.format(projectId))
          .setUptimeCheckConfig(
              UptimeCheckConfig.newBuilder()
                  .setDisplayName(displayName)
                  .setMonitoredResource(
                      MonitoredResource.newBuilder()
                          .setType("uptime_url")
                          .putLabels("host", hostName))
                  .setHttpCheck(HttpCheck.newBuilder().setPath(pathName).setPort(80))
                  .setTimeout(Duration.newBuilder().setSeconds(10))
                  .setPeriod(Duration.newBuilder().setSeconds(300)))
          .build();
  try (UptimeCheckServiceClient client = UptimeCheckServiceClient.create()) {
    UptimeCheckConfig config = client.createUptimeCheckConfig(request);
    System.out.println("Uptime check created: " + config.getName());
  } catch (Exception e) {
    usage("Exception creating uptime check: " + e.toString());
    throw e;
  }
}

    Go

    Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local. 

    
// createGet creates an example uptime check on a GET request.
func createGet(w io.Writer, projectID string) (*monitoringpb.UptimeCheckConfig, error) {
	ctx := context.Background()
	client, err := monitoring.NewUptimeCheckClient(ctx)
	if err != nil {
		return nil, fmt.Errorf("NewUptimeCheckClient: %w", err)
	}
	defer client.Close()
	req := &monitoringpb.CreateUptimeCheckConfigRequest{
		Parent: "projects/" + projectID,
		UptimeCheckConfig: &monitoringpb.UptimeCheckConfig{
			DisplayName: "new GET uptime check",
			Resource: &monitoringpb.UptimeCheckConfig_MonitoredResource{
				MonitoredResource: &monitoredres.MonitoredResource{
					Type: "uptime_url",
					Labels: map[string]string{
						"host": "example.com",
					},
				},
			},
			CheckRequestType: &monitoringpb.UptimeCheckConfig_HttpCheck_{
				HttpCheck: &monitoringpb.UptimeCheckConfig_HttpCheck{
					RequestMethod: monitoringpb.UptimeCheckConfig_HttpCheck_GET,
					Path:          "/",
					Port:          80,
				},
			},
			Timeout: &duration.Duration{Seconds: 10},
			Period:  &duration.Duration{Seconds: 300},
		},
	}
	config, err := client.CreateUptimeCheckConfig(ctx, req)
	if err != nil {
		return nil, fmt.Errorf("CreateUptimeCheckConfig GET: %w", err)
	}
	fmt.Fprintf(w, "Successfully created GET uptime check %q\n", config.GetDisplayName())
	return config, nil
}

// createPost creates an example uptime check on a POST request.
func createPost(w io.Writer, projectID string) (*monitoringpb.UptimeCheckConfig, error) {
	ctx := context.Background()
	client, err := monitoring.NewUptimeCheckClient(ctx)
	if err != nil {
		return nil, fmt.Errorf("NewUptimeCheckClient: %w", err)
	}
	defer client.Close()
	req := &monitoringpb.CreateUptimeCheckConfigRequest{
		Parent: "projects/" + projectID,
		UptimeCheckConfig: &monitoringpb.UptimeCheckConfig{
			DisplayName: "new POST uptime check",
			Resource: &monitoringpb.UptimeCheckConfig_MonitoredResource{
				MonitoredResource: &monitoredres.MonitoredResource{
					Type: "uptime_url",
					Labels: map[string]string{
						"host": "example.com",
					},
				},
			},
			CheckRequestType: &monitoringpb.UptimeCheckConfig_HttpCheck_{
				HttpCheck: &monitoringpb.UptimeCheckConfig_HttpCheck{
					RequestMethod: monitoringpb.UptimeCheckConfig_HttpCheck_POST,
					ContentType:   monitoringpb.UptimeCheckConfig_HttpCheck_URL_ENCODED,
					Path:          "/",
					Port:          80,
					Body:          []byte(base64.URLEncoding.EncodeToString([]byte("key: value"))),
				},
			},
			Timeout: &duration.Duration{Seconds: 10},
			Period:  &duration.Duration{Seconds: 300},
		},
	}
	config, err := client.CreateUptimeCheckConfig(ctx, req)
	if err != nil {
		return nil, fmt.Errorf("CreateUptimeCheckConfig POST: %w", err)
	}
	fmt.Fprintf(w, "Successfully created POST uptime check %q\n", config.GetDisplayName())
	return config, nil
}

    Node.js

    Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local. 

    // Imports the Google Cloud client library
const monitoring = require('@google-cloud/monitoring');

// Creates a client
const client = new monitoring.UptimeCheckServiceClient();

/**
 * TODO(developer): Uncomment and edit the following lines of code.
 */
// const projectId = 'YOUR_PROJECT_ID';
// const hostname = 'mydomain.com';

const request = {
  // i.e. parent: 'projects/my-project-id'
  parent: client.projectPath(projectId),
  uptimeCheckConfig: {
    displayName: 'My Uptime Check',
    monitoredResource: {
      // See the Uptime Check docs for supported MonitoredResource types
      type: 'uptime_url',
      labels: {
        host: hostname,
      },
    },
    httpCheck: {
      path: '/',
      port: 80,
    },
    timeout: {
      seconds: 10,
    },
    period: {
      seconds: 300,
    },
  },
};

// Creates an uptime check config for a GCE instance
const [uptimeCheckConfig] = await client.createUptimeCheckConfig(request);
console.log('Uptime check created:');
console.log(`ID: ${uptimeCheckConfig.name}`);
console.log(`Display Name: ${uptimeCheckConfig.displayName}`);
console.log('Resource: %j', uptimeCheckConfig.monitoredResource);
console.log('Period: %j', uptimeCheckConfig.period);
console.log('Timeout: %j', uptimeCheckConfig.timeout);
console.log(`Check type: ${uptimeCheckConfig.check_request_type}`);
console.log(
  'Check: %j',
  uptimeCheckConfig.httpCheck || uptimeCheckConfig.tcpCheck
);
console.log(
  `Content matchers: ${uptimeCheckConfig.contentMatchers
    .map(matcher => matcher.content)
    .join(', ')}`
);
console.log(`Regions: ${uptimeCheckConfig.selectedRegions.join(', ')}`);

    PHP

    Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local. 

    use Google\Api\MonitoredResource;
use Google\Cloud\Monitoring\V3\Client\UptimeCheckServiceClient;
use Google\Cloud\Monitoring\V3\CreateUptimeCheckConfigRequest;
use Google\Cloud\Monitoring\V3\UptimeCheckConfig;

/**
 * Example:
 * ```
 * create_uptime_check($projectId, 'myproject.appspot.com', 'Test Uptime Check!');
 * ```
 *
 * @param string $projectId Your project ID
 * @param string $hostName
 * @param string $displayName
 */
function create_uptime_check($projectId, $hostName = 'example.com', $displayName = 'New uptime check')
{
    $projectName = 'projects/' . $projectId;
    $uptimeCheckClient = new UptimeCheckServiceClient([
        'projectId' => $projectId,
    ]);

    $monitoredResource = new MonitoredResource();
    $monitoredResource->setType('uptime_url');
    $monitoredResource->setLabels(['host' => $hostName]);

    $uptimeCheckConfig = new UptimeCheckConfig();
    $uptimeCheckConfig->setDisplayName($displayName);
    $uptimeCheckConfig->setMonitoredResource($monitoredResource);
    $createUptimeCheckConfigRequest = (new CreateUptimeCheckConfigRequest())
        ->setParent($projectName)
        ->setUptimeCheckConfig($uptimeCheckConfig);

    $uptimeCheckConfig = $uptimeCheckClient->createUptimeCheckConfig($createUptimeCheckConfigRequest);

    printf('Created an uptime check: %s' . PHP_EOL, $uptimeCheckConfig->getName());
}

    Python

    Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local. 

    def create_uptime_check_config_get(
    project_id: str, host_name: str = None, display_name: str = None
) -> uptime.UptimeCheckConfig:
    """Creates a new uptime check configuration

    Args:
        project_id: Google Cloud project id where the uptime check is created
        host_name: An example label's value for the "host" label
        display_name: A human friendly name of the configuration

    Returns:
        A structure that describes a new created uptime check
    """
    config = monitoring_v3.UptimeCheckConfig()
    config.display_name = display_name or "New GET uptime check"
    config.monitored_resource = {
        "type": "uptime_url",
        "labels": {"host": host_name or "example.com"},
    }
    config.http_check = {
        "request_method": monitoring_v3.UptimeCheckConfig.HttpCheck.RequestMethod.GET,
        "path": "/",
        "port": 80,
    }
    config.timeout = {"seconds": 10}
    config.period = {"seconds": 300}

    client = monitoring_v3.UptimeCheckServiceClient()
    new_config = client.create_uptime_check_config(
        request={"parent": project_id, "uptime_check_config": config}
    )
    pprint.pprint(new_config)
    return new_config


def create_uptime_check_config_post(
    project_id: str, host_name: str = None, display_name: str = None
) -> uptime.UptimeCheckConfig:
    """Creates a new uptime check configuration

    Args:
        project_id: Google Cloud project id where the uptime check is created
        host_name: An example label's value for the "host" label
        display_name: A human friendly name of the configuration

    Returns:
        A structure that describes a new created uptime check
    """
    config = monitoring_v3.UptimeCheckConfig()
    config.display_name = display_name or "New POST uptime check"
    config.monitored_resource = {
        "type": "uptime_url",
        "labels": {"host": host_name or "example.com"},
    }
    config.http_check = {
        "request_method": monitoring_v3.UptimeCheckConfig.HttpCheck.RequestMethod.POST,
        "content_type": monitoring_v3.UptimeCheckConfig.HttpCheck.ContentType.URL_ENCODED,
        "body": "foo=bar".encode("utf-8"),
        "path": "/",
        "port": 80,
    }
    config.timeout = {"seconds": 10}
    config.period = {"seconds": 300}

    client = monitoring_v3.UptimeCheckServiceClient()
    new_config = client.create_uptime_check_config(
        request={"parent": project_id, "uptime_check_config": config}
    )
    pprint.pprint(new_config)
    return new_config

    Ruby

    Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local. 

    gem "google-cloud-monitoring"
require "google/cloud/monitoring"

def create_uptime_check_config project_id: nil, host_name: nil, display_name: nil
  client = Google::Cloud::Monitoring.uptime_check_service
  project_name = client.project_path project: project_id
  config = {
    display_name:       display_name.nil? ? "New uptime check" : display_name,
    monitored_resource: {
      type:   "uptime_url",
      labels: { "host" => host_name.nil? ? "example.com" : host_name }
    },
    http_check:         { path: "/", port: 80 },
    timeout:            { seconds: 10 },
    period:             { seconds: 300 }
  }
  new_config = client.create_uptime_check_config \
    parent:              project_name,
    uptime_check_config: config
  puts new_config.name
  new_config
end

    REST

    Para crear una comprobación de disponibilidad, llama al método projects.uptimeCheckConfigs.create. Define los parámetros del método de la siguiente manera:

    • parent: obligatorio. El proyecto en el que se creará la comprobación de disponibilidad del servicio. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones. Este campo tiene el siguiente formato:

      projects/PROJECT_ID

    • El cuerpo de la solicitud debe contener un objeto UptimeCheckConfig para la nueva comprobación de tiempo de actividad. En esta página se proporciona información sobre algunos campos. Para consultar la documentación completa sobre este objeto y sus campos, consulta UptimeCheckConfig:

      • Deje en blanco el campo name del objeto de configuración. El sistema define este campo cuando crea el objeto de configuración de la respuesta.

      • Si vas a configurar una comprobación HTTP o HTTPS, debes rellenar el campo HttpCheck del objeto UptimeCheckConfig. En este objeto, asigna el valor GET o POST al campo requestMethod. Si se omite este campo o se le asigna el valor METHOD_UNSPECIFIED, se envía una solicitud GET.

        Si estás configurando una solicitud POST, completa los campos contentType, customContentType (opcional) y body.

    El método create devuelve el objeto UptimeCheckConfig de la nueva configuración.

    Si la configuración de tiempo de actividad creada no funciona como esperabas, consulta la sección Comprobar fallos de esta página.

    Puede haber un retraso de hasta 5 minutos antes de que los resultados de la comprobación de disponibilidad empiecen a enviarse a Monitoring. Durante ese tiempo, el panel de control de comprobación de disponibilidad del servicio muestra el estado "No hay datos disponibles".

    Usar pings ICMP

    Para ayudarte a solucionar problemas con las comprobaciones de disponibilidad públicas fallidas, puedes configurar tus comprobaciones de disponibilidad para que envíen hasta 3 pings ICMP durante la comprobación. Los pings pueden ayudarte a distinguir entre los errores causados, por ejemplo, por problemas de conectividad de red y por los tiempos de espera de tu aplicación.

    De forma predeterminada, las comprobaciones de tiempo de actividad no envían pings. Cada ping añade algo de latencia a la comprobación de disponibilidad. Las comprobaciones de tiempo de actividad privadas no pueden enviar pings.

    Cuando falla una comprobación de disponibilidad pública, los resultados de los pings se escriben en los registros de Cloud Logging. Si el ping falla, se añadirán los siguientes campos al campo httpRequest de la entrada de registro:

    • rtt_usec: tiempo de ida y vuelta de cada solicitud de ping fallida.
    • unreachable_count: número de solicitudes de ping que han devuelto el código de estado ICMP_DEST_UNREACH.
    • no_answer_count: número de solicitudes de ping en las que se ha agotado el tiempo de espera y no se ha devuelto ninguna respuesta.

    Los resultados de los pings de las comprobaciones de disponibilidad correctas no se registran.

    Configurar pings

    Cada configuración de comprobación de disponibilidad incluye un objeto HttpCheck o un objeto TcpCheck. Ambos objetos incluyen un campo pingConfig. Use este campo para especificar el número de pings ICMP que se incluirán en cada comprobación (hasta 3). De forma predeterminada, no se envía ningún ping.

    Para configurar los pings, haz una de las siguientes acciones:

    Verificar la comprobación de disponibilidad del servicio

    Cuando creas una comprobación de disponibilidad en la consola Google Cloud , puedes probar la configuración antes de guardarla.

    Comprobaciones correctas

    Una comprobación de tiempo de actividad se realiza correctamente cuando se cumplen las siguientes condiciones:

    • El estado HTTP coincide con los criterios que ha seleccionado.
    • La respuesta no tiene contenido obligatorio o la búsqueda del contenido obligatorio en la respuesta se ha completado correctamente.

    Comprobaciones fallidas

    A continuación, se indican algunas de las posibles causas de un error en la comprobación del tiempo de actividad:

    • Error de conexión: rechazada: si usas el tipo de conexión HTTP predeterminado, comprueba que tengas instalado un servidor web que responda a las solicitudes HTTP. Puede producirse un error de conexión en una instancia nueva si no has instalado un servidor web. Consulta la guía de inicio rápido de Compute Engine. Si utilizas el tipo de conexión HTTPS, es posible que tengas que seguir pasos de configuración adicionales. Si tienes problemas con el cortafuegos, consulta Mostrar direcciones IP de servidores de comprobaciones de disponibilidad del servicio.
    • Nombre o servicio no encontrado: puede que el nombre de host sea incorrecto.
    • 403 Forbidden: el servicio devuelve un código de error al comprobador de tiempo de actividad. Por ejemplo, la configuración predeterminada del servidor web Apache devuelve este código en Amazon Linux, pero devuelve el código 200 (Éxito) en otras versiones de Linux. Consulta el tutorial de LAMP para Amazon Linux o la documentación de tu servidor web.
    • 404 No encontrado: puede que la ruta sea incorrecta.

    • Tiempo de espera agotado de la solicitud (408) o no hay respuesta: es posible que el número de puerto sea incorrecto, que el servicio no se esté ejecutando, que no se pueda acceder al servicio o que el tiempo de espera sea demasiado bajo. Comprueba que tu cortafuegos permita el tráfico de los servidores de comprobación de disponibilidad del servicio. Consulta la lista de direcciones IP de servidores de comprobación de disponibilidad del servicio. El límite de tiempo de espera se especifica en las opciones de validación de respuestas.

      El tiempo de espera de una solicitud puede producirse debido a la congestión de la red. Por ejemplo, debido a una congestión temporal de la red, puede que observes que una comprobación falla, pero todas las demás se completan correctamente. Si falla un solo comprobador, no se envía ninguna notificación cuando tu política de alertas usa la configuración predeterminada.

    Si la comprobación de disponibilidad está configurada para enviar pings, los resultados de los pings de las comprobaciones de disponibilidad fallidas se escriben en Cloud Logging. Para obtener más información, consulta Usar pings ICMP.

    Siguientes pasos