Recopila métricas del servidor web Apache con el Agente de operaciones

Recopila métricas del servidor web Apache con el Agente de operaciones

Obtén información para recopilar y supervisar métricas de un servidor web Apache instalado en una instancia de máquina virtual (VM) de Compute Engine mediante el Agente de operaciones:

1. Crea una instancia de VM de Compute Engine y, luego, instala el Agente de operaciones.
2. Instala un servidor web Apache.
3. Configura el agente de operaciones para el servidor web Apache.
4. Genera tráfico que se dirija al servidor web Apache.
5. Visualiza las métricas en el panel de Apache predefinido.
6. Crear una política de alertas.
7. Prueba la política de alertas.
8. Realizar una limpieza

---

Para seguir la guía paso a paso sobre esta tarea directamente en la consola Google Cloud , haz clic en Guiarme:

GUIARME

---

Antes de comenzar

1. Es posible que las restricciones de seguridad que define tu organización no te permitan completar los siguientes pasos. Para obtener información sobre la solución de problemas, consulta Desarrolla aplicaciones en un entorno Google Cloud restringido.

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, Cloud Monitoring, and Cloud Logging APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, Cloud Monitoring, and Cloud Logging APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Crea una instancia de VM

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

   Ir a Instancias de VM

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

2. Haz clic en Crear instancia para crear una VM. Configura tu instancia con las opciones del menú de navegación.
3. En la opción Configuración de la máquina, haz lo siguiente:
   1. En el campo Nombre, ingresa un nombre descriptivo.
   2. En el menú desplegable predeterminado Tipo de máquina, selecciona Con núcleo compartido > e2-small.
4. Verifica que la opción SO y almacenamiento muestre Debian GNU/Linux. Si no es así, haz clic en la opción SO y almacenamiento y, luego, en Cambiar. En el diálogo Disco de arranque, establece Versión en Debian GNU/Linux.
5. En la opción Redes, en Firewall, selecciona Permitir tráfico HTTP y Permitir tráfico HTTPS.
6. Verifica que la opción Observabilidad muestre Instalar el Agente de operaciones. De lo contrario, haz clic en la opción Observabilidad y selecciona Instalar el Agente de operaciones para supervisión y registros.
7. Haz clic en Crear.

Instala un servidor web Apache

Para instalar un servidor web Apache en tu instancia de VM de Compute Engine, haz lo siguiente:

1. En la página Instancias de VM, ubica tu VM nueva, ve a la columna Conectar y, luego, haz clic en SSH.

   Si tienes problemas para conectarte, consulta Soluciona problemas de SSH.

2. Para actualizar las listas de paquetes, copia el siguiente comando al portapapeles, pega el comando en la terminal SSH y, luego, presiona Intro:

   sudo apt-get update
   

3. Cuando veas el mensaje "Reading package lists… Done", en la terminal de SSH, ejecuta el siguiente comando para instalar un servidor web Apache2:

   sudo apt-get install apache2 php7.0
   

   Si se te solicita continuar la instalación, ingresa Y. Si el comando anterior falla, usa: sudo apt-get install apache2 php.

4. Cuando aparezca el símbolo del sistema, ve a la página Instancias de VM y copia la dirección IP externa de la VM en la siguiente URL:

   http://EXTERNAL_IP
   

5. Para conectarte a tu servidor web Apache, abre una nueva pestaña del navegador y, luego, ingresa la URL del paso anterior.

   Cuando el servidor web se instale de forma correcta, la pestaña del navegador mostrará la página predeterminada de Apache2 Debian.

   

Recopila registros y métricas del servidor web Apache

En estos pasos, configurarás el Agente de operaciones para recopilar registros y métricas de tu servidor web Apache:

1. Ve a la terminal SSH de tu instancia de VM. Si no tienes una terminal abierta, haz lo siguiente:

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

      Ir a Instancias de VM

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

   2. Ubica tu VM nueva y, luego, haz clic en SSH.

2. Copia el siguiente comando, pégalo en la terminal de tu instancia y, luego, presiona Intro:

   # Configures Ops Agent to collect telemetry from the app. You must restart the agent for the configuration to take effect.
   
   set -e
   
   # Check if the file exists
   if [ ! -f /etc/google-cloud-ops-agent/config.yaml ]; then
     # Create the file if it doesn't exist.
     sudo mkdir -p /etc/google-cloud-ops-agent
     sudo touch /etc/google-cloud-ops-agent/config.yaml
   fi
   
   # Create a back up of the existing file so existing configurations are not lost.
   sudo cp /etc/google-cloud-ops-agent/config.yaml /etc/google-cloud-ops-agent/config.yaml.bak
   
   # Configure the Ops Agent.
   sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
   metrics:
     receivers:
       apache:
         type: apache
     service:
       pipelines:
         apache:
           receivers:
             - apache
   logging:
     receivers:
       apache_access:
         type: apache_access
       apache_error:
         type: apache_error
     service:
       pipelines:
         apache:
           receivers:
             - apache_access
             - apache_error
   EOF
   

   El comando anterior crea la configuración para recopilar y transferir registros y métricas del servidor web Apache. Si quieres obtener más información, consulta Configura el Agente de operaciones para el servidor web Apache.

3. Reinicia el Agente de operaciones:
   1. Para reiniciar el agente, ejecuta el siguiente comando en tu instancia:

      sudo systemctl restart google-cloud-ops-agent
      

   2. Para confirmar que el agente se haya reiniciado, ejecuta el siguiente comando y verifica que los componentes “Agente de métricas” y “Agente de Logging” se hayan iniciado:

      sudo systemctl status "google-cloud-ops-agent*"
      

Genera tráfico

Para generar tráfico que se dirija a tu servidor web Apache, sigue estos pasos:

1. Ve a la terminal SSH de tu instancia de VM. Si no tienes una terminal abierta, haz lo siguiente:

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

      Ir a Instancias de VM

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

   2. Ubica tu VM nueva y, luego, haz clic en SSH.

2. En la terminal de SSH, ejecuta el siguiente comando, que genera solicitudes para tu servidor web Apache:

   timeout 120 bash -c -- 'while true; do curl localhost; sleep $((RANDOM % 4)) ; done'

3. Espera dos minutos hasta que aparezca el símbolo del sistema o que se cierre la terminal. Mientras se ejecuta el comando, el texto HTML se muestra en la terminal.

Consulta las métricas de Apache

Para ver el panel Descripción general de Apache, que se crea automáticamente, haz lo siguiente:

1. En la consola de Google Cloud , accede a la página Paneles :

   Acceder a Paneles

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

2. En el panel Mis paneles, selecciona el panel Apache Overview de la lista.

   

Configuraste el Agente de operaciones para recopilar registros y métricas de tu servidor web Apache, y visualizaste las métricas. El siguiente paso es crear una política de alertas para que recibas una notificación cuando la carga en tu servidor web Apache supere un límite.

Crea un canal de notificaciones por correo electrónico

Antes de crear una política de alertas, configura los canales de notificación que deseas que use la política de alertas. Cloud Monitoring admite muchos tipos diferentes de canales de notificación, incluidos el correo electrónico, Slack, PagerDuty y Pub/Sub. Para obtener más información, consulta Cómo crear y administrar canales de notificaciones. Para recibir notificaciones por correo electrónico, 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. En la barra de herramientas, haz clic en Editar canales de notificaciones.
3. En la página Canales de notificaciones, desplázate hasta Correo electrónico y haz clic en Agregar nuevo.
4. Ingresa tu dirección de correo electrónico, un nombre visible como My email y, luego, haz clic en Guardar.

Crea una política de alertas

En esta sección, crearás una política de alertas para que se te notifique cuando el tráfico a tu servidor web Apache supere un umbral definido:

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. Haz clic en Crear política.

3. Selecciona las series temporales que deseas supervisar:

   1. Haz clic en Seleccionar una métrica y elige Instancia de VM.
   2. En la lista Categorías de métricas activas, selecciona Apache.
   3. En la lista Métricas activas, selecciona workload/apache.traffic.
   4. Haz clic en Aplicar.

   Se mostrará el gráfico del tráfico de Apache.

4. Avanza a los campos Configurar activador y, luego, establece el campo Valor del umbral en 1500.

   El gráfico muestra el umbral como una línea punteada. Asegúrate de que la línea punteada sea mucho menor que el nivel de tráfico máximo.

5. Ve a los campos Notificaciones y nombre y, luego, usa el menú Canales de notificaciones para seleccionar tu dirección de correo electrónico.

6. En el nombre de la política, ingresa Apache traffic above threshold.

7. Ve a los campos Revisar alerta, revisa la política de alertas y, luego, haz clic en Crear política.

Prueba la política de alertas

Para probar la política de alertas, genera tráfico que supere el umbral:

1. Ve a la terminal SSH de tu instancia de VM. Si no tienes una terminal abierta, haz lo siguiente:

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

      Ir a Instancias de VM

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

   2. Ubica tu VM nueva y, luego, haz clic en SSH.

2. En la terminal de SSH, ejecuta el siguiente comando, que genera solicitudes para tu servidor web Apache:

   timeout 120 bash -c -- 'while true; do curl localhost; sleep $((RANDOM % 4)) ; done'

3. Espera dos minutos hasta que aparezca el símbolo del sistema o que se cierre la terminal. Mientras se ejecuta el comando, el texto HTML se muestra en la terminal.

4. Cuando aparezca el símbolo del sistema, busca en tu correo electrónico un mensaje cuya línea de asunto comience con [ALERT].

   Si no ves un correo electrónico, examina el gráfico en la política de alertas para verificar que el nivel de tráfico haya superado el umbral. Es posible que debas volver a ejecutar el comando anterior. De lo contrario, espera uno o dos minutos para que llegue el correo electrónico.

   La notificación proporciona un resumen de la política de alertas y un vínculo a un incidente. Cada incidente contiene un registro de la falla, y estos suelen ser útiles para solucionar problemas.

   

Configuraste el Agente de operaciones para recopilar registros y métricas de tu servidor web Apache, pero solo visualizaste métricas. Para obtener información sobre cómo ver los registros del servidor web Apache, consulta la guía de inicio rápido Visualiza los registros del servidor web Apache.

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.

Si creaste un proyecto nuevo y ya no lo necesitas, bórralo.

Si usaste un proyecto existente, haz lo siguiente:

1. Si creaste una VM, bórrala:

   1. In the Google Cloud console, go to the VM instances page.

      Go to VM instances

   2. Select the checkbox for the instance that you want to delete.
   3. To delete the instance, click More actions, click Delete, and then follow the instructions.

2. Borra la política de alertas que creaste:

   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 la política de alertas que creaste y, luego, haz clic en Borrar.

¿Qué sigue?

• Para obtener información sobre el agente de operaciones y las integraciones compatibles, consulta los siguientes recursos:

  • Descripción general del agente de operaciones
  • Supervisa aplicaciones de terceros

• Para obtener información sobre cómo probar si una URL responde a las solicitudes y simular una falla, consulta la guía de inicio rápido Recibe notificaciones si tu aplicación deja de responder.

• Para ver los registros de tu servidor web Apache, consulta la guía de inicio rápido Cloud Logging para VMs de Compute Engine.

• Para obtener información sobre cómo crear gráficos y ver datos de rendimiento, consulta Descripción general de los paneles.

• Para obtener una lista de las métricas compatibles con Google Cloud, consulta la Lista de métricas.

• Para crear tus propias métricas de Monitoring, consulta Métricas personalizadas.