En este documento, se describe cómo administrar tus verificaciones de tiempo de actividad con la La consola de Google Cloud, Google Cloud CLI, la API de Cloud Monitoring y el cliente bibliotecas.
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 se revise se muestra si su nombre coincide condefault
oTesting check
.
gcloud
Para enumerar tus verificaciones de tiempo de actividad y monitores sintéticos, ejecuta
el gcloud monitoring uptime list-configs
:
gcloud monitoring uptime list-configs
Entre los datos que se muestran, se incluyen los siguientes:
- Nombre y nombre visible.
- Verifica el identificador.
- Recurso supervisado.
- Período entre verificaciones.
Puedes configurar el comando de Google Cloud CLI para filtrar y ordenar los resultados.
API
Para enumerar tus verificaciones de tiempo de actividad y monitores sintéticos, llama al
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 la verificación de tiempo de actividad, consulta Busca 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, luego, 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. Para las verificaciones de grupo, los valores deS
yT
se suman en todas las miembros 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.El panel Políticas de alertas enumera información sobre y las políticas de alertas. En el panel de muestra, se muestra una política de alertas configurado.
gcloud
Para enumerar los detalles
de una verificación de tiempo de actividad
ejecuta 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. Puedes encontrar la
identificador mediante la ejecución del comando gcloud monitoring uptime list-configs
y
examinar el campo name. Para obtener más información, consulta
Busca el identificador único de una verificación de tiempo de actividad.
Los datos que se muestran para la verificación de tiempo de actividad incluyen lo siguiente:
- Nombre y nombre visible.
- Verifica el identificador.
- Recurso supervisado.
- Período entre verificaciones.
API
Para enumerar los detalles de una verificación de tiempo de actividad o un monitor sintético, llama al
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 la verificación de tiempo de actividad, consulta Busca 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, podrías querer la comprobación se produzca con más frecuencia. También puedes aumentar el tiempo de espera asociado con la validación de la respuesta. Sin embargo, si tus la verificación de tiempo de actividad no está configurada con el protocolo, el tipo de recurso o recurso, borrar la verificación de tiempo de actividad actual y crear una nueva.
Para obtener información sobre cómo editar una política de alertas que supervise un la 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 con la API .
Para editar una verificación de tiempo de actividad pública, puedes usar el proceso en cualquiera de las siguientes opciones 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 fallidas de las posibles causas
Haz clic en Guardar.
gcloud
Para modificar una verificación
de tiempo de actividad o un monitor sintético
ejecuta 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 de tiempo de actividad. monitor sintético. Para encontrar el identificador, ejecuta el comando Comando
gcloud monitoring uptime list-configs
y examinar el campo name. Para obtener más información, consulta Busca el identificador único de una verificación de tiempo de actividad.Define qué campos quieres 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 la verificación de tiempo de actividad, consulta Busca 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 apagues el servicio. o recurso que supervisa. Nota: Antes de borrar una verificación de tiempo de actividad, asegúrate de que no haya alertas. que supervisan 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 evita que se borre de verificación. Sin embargo, la API de Cloud Monitoring no genera un error ni evita o la eliminación del contenido. 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 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. Puedes encontrar la
identificador mediante la ejecución del comando gcloud monitoring uptime list-configs
y
examinar el campo name. Para obtener más información, consulta
Busca 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
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 la verificación de tiempo de actividad, consulta Busca 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 cuando falle la verificación de tiempo de actividad. Para obtener más información, consulta Crea políticas de alertas para las verificaciones de tiempo de actividad.
Encuentra 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 la 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 el campo Tiempo de detalles, consulta la sección Ver detalles de una verificación de tiempo de actividad de este documento.
¿Qué sigue?
- Enumera las direcciones IP de los servidores de verificación de tiempo de actividad
- Crea políticas de alertas para las verificaciones de tiempo de actividad
- Gráfico de las métricas de verificación de tiempo de actividad