En este documento, se describe cómo administrar las verificaciones de tiempo de actividad con la consola de Google Cloud, Google Cloud CLI, la API de Cloud Monitoring y las bibliotecas cliente.
Enumera todas las verificaciones de tiempo de actividad
Console
-
En la consola de Google Cloud, ve a la página Verificaciones de tiempo de actividad:
Ve a Verificaciones de tiempo de actividad
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
En el siguiente ejemplo, se muestra una página de muestra de verificaciones de tiempo de actividad:
Para restringir las verificaciones de tiempo de actividad que se enumeran, agrega filtros (opcional).
Cada filtro se compone de un nombre y un valor. Puedes configurar que el valor sea una coincidencia exacta para un nombre de verificación de tiempo de actividad o una coincidencia parcial. Las coincidencias no distinguen mayúsculas de minúsculas. Por ejemplo, para ver una lista de todas las verificaciones de tiempo de actividad cuyo nombre contiene
default
, haz lo siguiente:- Haz clic en Filtrar tabla (Filter table) y selecciona Nombre visible (Display name).
- Ingresa
default
y, luego, presiona la tecla Intro.
Si tienes varios filtros, estos se unen de manera automática con un
AND
lógico, a menos que insertes un filtroOR
. En el ejemplo anterior, se usa el filtroOR
para que aparezca una verificación de tiempo de actividad si su nombre coincide condefault
oTesting check
.
gcloud
Para enumerar tus verificaciones de tiempo de actividad y monitores sintéticos, ejecuta el comando gcloud monitoring uptime list-configs
:
gcloud monitoring uptime list-configs
Los datos que se muestran incluyen lo siguiente:
- Nombre y nombre visible
- Verifica el identificador.
- Recurso supervisado
- Es el período entre verificaciones.
Puedes configurar el comando de Google Cloud CLI para filtrar y ordenar los resultados.
API
Para obtener una lista de tus verificaciones de tiempo de actividad y monitores sintéticos, llama al método projects.uptimeCheckConfigs.list
. Especifica los siguientes parámetros:
parent: El proyecto del que se va a verificar el tiempo de actividad. El formato es:
projects/PROJECT_ID
Para obtener una verificación de tiempo de actividad específica, llama al método projects.uptimeCheckConfigs.get
. Especifica el siguiente parámetro:
name: Es el nombre completo de la configuración de verificación de tiempo de actividad.
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Para obtener más información sobre el identificador de verificación de tiempo de actividad, consulta Cómo encontrar el identificador único de una verificación de tiempo de actividad.
C#
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Cómo ver los detalles de una verificación de tiempo de actividad
Console
-
En la consola de Google Cloud, ve a la página Verificaciones de tiempo de actividad:
Ve a Verificaciones de tiempo de actividad
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
Busca la verificación de tiempo de actividad que deseas ver y haz clic en su nombre.
En la siguiente captura de pantalla, se muestran los detalles del tiempo de actividad de una verificación con el nombre "Mi tiempo de actividad":
La página Detalles del tiempo de actividad contiene la siguiente información:
- El intervalo de tiempo seleccionado. De forma predeterminada, el intervalo es de 1 hora.
- El nombre de la verificación de tiempo de actividad. En la muestra, el nombre es Mi verificación de tiempo de actividad.
- Las etiquetas que agregaste a la verificación de tiempo de actividad
El porcentaje de tiempo de actividad y la latencia promedio. El valor Porcentaje de tiempo de actividad (Percent uptime) es un porcentaje calculado como
(S/T)*100
, en el queS
es el número de respuestas correctas yT
es el número total de respuestas de verificación de todas las ubicaciones. En las verificaciones de grupo, se calcula la suma de los valores deS
yT
de todos los miembros actuales del grupo.Por ejemplo, durante un período de 25 minutos, una verificación de tiempo de actividad con un período de un minuto que se ejecute desde todas las regiones obtendrá 25 solicitudes de cada una de las 6 ubicaciones, es decir, un total de 150 solicitudes. Si el panel informa un 83.3% de tiempo de actividad, entonces 125 de 150 solicitudes se completaron correctamente.
En los paneles Aprobado (Passed checks) y Latencia de la verificación de tiempo de actividad (Uptime check latency), se muestra gráficamente la cantidad de verificaciones aprobadas y la latencia de cada verificación como una función de tiempo.
En el panel Estado actual (Current status), se muestra el estado de las verificaciones más recientes. Un círculo verde con una marca de verificación junto a una región indica que la última ejecución de la verificación en esa región se realizó correctamente; un círculo rojo con una x indica falla.
En el panel Configuración (Configuration), se muestra la configuración de la verificación de tiempo de actividad. Estos datos se asignan cuando se crea la verificación de tiempo de actividad. El valor ID de la verificación (Check ID) corresponde al valor
CHECK_ID
en las llamadas a la API.En el panel Políticas de alertas (Alert Policies), se incluye información sobre las políticas de alertas asociadas. En el panel de muestra, se configura una política de alertas.
gcloud
Para enumerar los detalles de una verificación de tiempo de actividad o un monitor sintético,
ejecuta el comando gcloud monitoring uptime describe
:
gcloud monitoring uptime describe CHECK_ID
Antes de ejecutar el comando anterior, reemplaza CHECK_ID por el identificador de la verificación de tiempo de actividad o el monitor sintético. Para encontrar el identificador, ejecuta el comando gcloud monitoring uptime list-configs
y examina el campo name. Para obtener más información, consulta Cómo encontrar el identificador único de una verificación de tiempo de actividad.
Los datos que se muestran para la verificación del tiempo de actividad incluyen lo siguiente:
- Nombre y nombre visible
- Verifica el identificador.
- Recurso supervisado
- Es el período entre verificaciones.
API
Para enumerar los detalles de una verificación de tiempo de actividad o un monitor sintético, llama al método projects.uptimeCheckConfigs.get
. Especifica el siguiente parámetro:
name: Es el nombre completo de la configuración de verificación de tiempo de actividad.
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Para obtener más información sobre el identificador de verificación de tiempo de actividad, consulta Cómo encontrar el identificador único de una verificación de tiempo de actividad.
C#
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Edita una verificación de tiempo de actividad
Puedes modificar algunos campos de una verificación de tiempo de actividad. Por ejemplo, es posible que desees que la verificación se realice con más frecuencia o que desees aumentar el tiempo de espera asociado con la validación de la respuesta. Sin embargo, si la verificación de tiempo de actividad no está configurada con el protocolo, el tipo de recurso o el recurso correctos, borra la verificación de tiempo de actividad actual y crea una nueva.
Para obtener información sobre cómo editar una política de alertas que supervise una verificación de tiempo de actividad, consulta los siguientes documentos:
- Administra las políticas con la consola de Google Cloud.
- Administra las políticas de alertas según la API .
Para editar una verificación de tiempo de actividad pública, puedes usar el proceso en cualquiera de las siguientes pestañas. Para editar una verificación de tiempo de actividad privada, usa la pestaña Console o API:
Console
-
En la consola de Google Cloud, ve a la página Verificaciones de tiempo de actividad:
Ve a Verificaciones de tiempo de actividad
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
Busca la verificación de tiempo de actividad que deseas editar y, luego, realiza una de las siguientes acciones:
- Haz clic en Más more_vert y selecciona Editar.
- Ve los detalles de la verificación de tiempo de actividad y haz clic en Editar.
Cambia los valores de los campos según sea necesario. No puedes modificar todos los campos. Si los valores de encabezado personalizados de una verificación están ocultos, no podrás hacerlos visibles.
Para comprobar si la verificación funciona, haz clic en Probar. Si la prueba falla, consulta Verificaciones que fallaron para ver las posibles causas.
Haz clic en Guardar.
gcloud
Para modificar una verificación de tiempo de actividad o un monitor sintético, ejecuta el comando gcloud monitoring uptime update
:
gcloud monitoring uptime update CHECK_ID OPTIONAL_FLAGS
Antes de ejecutar el comando anterior, haz lo siguiente:
Reemplaza CHECK_ID por el identificador de la verificación del tiempo de actividad o el monitor sintético. Para encontrar el identificador, ejecuta el comando
gcloud monitoring uptime list-configs
y examina el campo name. Para obtener más información, consulta Cómo encontrar el identificador único de una verificación de tiempo de actividad.Define los campos que deseas modificar.
Por ejemplo, para establecer el período de una verificación de tiempo de actividad en 10 minutos, ejecuta el siguiente comando:
gcloud monitoring uptime update CHECK_ID --period=10
API
Realiza una llamada al método projects.uptimeCheckConfigs.patch
. Establece los parámetros en el método de la siguiente manera:
uptimeCheckConfig.name: obligatorio. Esto forma parte de la URL de REST. Es el nombre del recurso de la verificación de tiempo de actividad para editar:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Para obtener más información sobre el identificador de verificación de tiempo de actividad, consulta Cómo encontrar el identificador único de una verificación de tiempo de actividad.
updateMask: opcional. Este es un parámetro de búsqueda:
?updateMask=[FIELD_LIST]
.[FIELD_LIST]
es una lista de campos separados por comas en el objetoUptimeCheckConfig
que se debe cambiar. Por ejemplo:"resource.type,httpCheck.path"
El cuerpo de la solicitud debe contener un
UptimeCheckConfig
con los valores de campo nuevos.
Si se configura updateMask
, solo los campos enumerados en updateMask
reemplazarán los campos correspondientes en la configuración existente. Si un campo tiene subcampos, y el campo aparece en la máscara, pero ninguno de sus subcampos aparece, entonces todos los subcampos de ese campo reemplazan los campos correspondientes.
Si updateMask
no está establecido, la configuración en el cuerpo de la solicitud reemplaza toda la configuración existente.
El método patch
muestra el objeto UptimeCheckConfig
para la configuración modificada.
C#
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Puede haber un retraso de hasta 5 minutos antes de que veas los resultados nuevos de la verificación de tiempo de actividad. Durante ese tiempo, los resultados de la verificación de tiempo de actividad anterior se muestran en los paneles y se usan para política de alertas.
Borrar una verificación de tiempo de actividad
Te recomendamos que borres una verificación de tiempo de actividad cuando desactives el servicio o el recurso que supervisa. Nota: Antes de borrar una verificación de tiempo de actividad, asegúrate de que no haya ninguna política de alertas que supervise la verificación de tiempo de actividad. Cuando una política de alertas supervisa una verificación de tiempo de actividad, la consola de Google Cloud impide que se borre. Sin embargo, la API de Cloud Monitoring no genera un error ni evita la eliminación. No se crea ningún incidente para la verificación faltante.
Para borrar una verificación de tiempo de actividad, sigue los pasos a continuación:
Console
-
En la consola de Google Cloud, ve a la página Verificaciones de tiempo de actividad:
Ve a Verificaciones de tiempo de actividad
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
Busca la verificación de tiempo de actividad que deseas editar y, luego, realiza una de las siguientes acciones:
- Haga clic en Más more_vert y seleccione Borrar.
- Consulte los detalles de la verificación de tiempo de actividad y haga clic en Borrar
gcloud
Para borrar una verificación de tiempo de actividad o un monitor sintético, ejecuta el comando gcloud monitoring uptime delete
:
gcloud monitoring uptime delete CHECK_ID
Antes de ejecutar el comando anterior, reemplaza CHECK_ID por el identificador de la verificación de tiempo de actividad o el monitor sintético. Para encontrar el identificador, ejecuta el comando gcloud monitoring uptime list-configs
y examina el campo name. Para obtener más información, consulta Cómo encontrar el identificador único de una verificación de tiempo de actividad.
API
Para borrar una verificación de tiempo de actividad o un monitor sintético, llama al método projects.uptimeCheckConfigs.delete
. Completa el parámetro de la siguiente manera:
nombre: Obligatorio. Este es el nombre de recurso de la configuración de verificación de tiempo de actividad para borrar:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Para obtener más información sobre el identificador de verificación de tiempo de actividad, consulta Cómo encontrar el identificador único de una verificación de tiempo de actividad.
C#
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Para autenticarte en Monitoring, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Supervisa una verificación de tiempo de actividad
Te recomendamos que crees una política de alertas para que te notifique cuando falle la verificación de tiempo de actividad. Para obtener más información, consulta Crea políticas de alertas para verificaciones de tiempo de actividad.
Cómo encontrar el identificador único de una verificación de tiempo de actividad
Cuando se crea tu verificación de tiempo de actividad, Monitoring le asigna un identificador denominado ID de la verificación de tiempo de actividad. Este identificador está incorporado en el nombre del recurso para la verificación de tiempo de actividad:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
El ID de verificación de tiempo de actividad se incluye en la respuesta de los métodos de la API de Cloud Monitoring que crean o enumeran verificaciones de tiempo de actividad. También puedes encontrar el ID de la verificación de tiempo de actividad en el panel Configuración de la página Detalles del tiempo de actividad en la consola de Google Cloud. Para obtener información sobre cómo ver la página Detalles del tiempo de actividad, consulta la sección Cómo ver los detalles de una verificación de tiempo de actividad de este documento.
¿Qué sigue?
- Enumera las direcciones IP del servidor de verificación de tiempo de actividad
- Crea políticas de alertas para las verificaciones de tiempo de actividad
- Cómo crear gráficos con métricas de verificación del tiempo de actividad