Recopila registros de Apache con el Agente de operaciones

Recopila registros de Apache con el Agente de operaciones

Aprende a recopilar y ver los registros de syslog recopilados de un servidor web Apache instalado en una instancia de máquina virtual (VM) de Compute Engine con el Agente de operaciones. Puedes usar un proceso similar al de esta guía de inicio rápido para supervisar otras aplicaciones de terceros.

En esta guía de inicio rápido, puedes hacer lo siguiente:

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 Apache Web Server
4. Visualizar registros en el Explorador de registros
5. Crear una alerta basada en registros
6. Prueba tu alerta.
7. Realizar una limpieza.

---

Para seguir la guía paso a paso sobre esta tarea de forma directa en la consola de 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 de Google Cloud restringido.

2. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

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

   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

4. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

5. Habilita las API de Compute Engine, Cloud Monitoring, and Cloud Logging.

   Habilita las API

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

   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

7. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

8. Habilita las API de Compute Engine, Cloud Monitoring, and Cloud Logging.

   Habilita las API

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.

3. En el campo Nombre, ingresa un nombre descriptivo.
4. En el campo Tipo de máquina, selecciona e2-small.
5. En la sección Disco de arranque, mantén la configuración predeterminada Debian GNU/Linux.
6. En la sección Firewall, selecciona Permitir tráfico HTTP y Permitir tráfico HTTPS.
7. En la sección Observabilidad: Agente de operaciones, selecciona Instalar el Agente de operaciones para Monitoring y Logging.
8. 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.

   ¿Tienes problemas para conectarte? Consulta Solución de 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... Listo", en la terminal 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, debes configurar 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 and restart Ops Agent.
   
   set -e
   
   # 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
   
   sudo service google-cloud-ops-agent restart
   sleep 60
   

   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. Espera hasta que se muestre el símbolo del sistema, lo que demora al menos 60 segundos.

Visualiza los registros del servidor web Apache

Para ver tus registros en la consola de Google Cloud, usa el Explorador de registros:

1. En la consola de Google Cloud, ve a la página Explorador de registros:

   Ir al Explorador de registros

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

   Los registros más recientes se muestran en el panel Resultados de la consulta.

2. En la barra de herramientas, asegúrate de que esté habilitada la opción Mostrar consulta.

3. Para ver los registros de tu servidor web Apache, crea y ejecuta una consulta:

   1. Expande la lista de proyectos de Google Cloud desde el selector de proyectos de Google Cloud y, luego, copia el ID del proyecto de Google Cloud en tu portapapeles.

   2. En la siguiente expresión, pega el ID copiado en el campo PROJECT_ID y, luego, copia la expresión en el editor de consultas:

      resource.type="gce_instance"
      logName=("projects/PROJECT_ID/logs/apache_access" OR "projects/PROJECT_ID/logs/apache_error")
      

      Cuando se ejecuta la consulta anterior, solo se muestran las entradas de registro apache_access y apache_error.

   3. Haz clic en Ejecutar consulta.

      Los resultados de la consulta se muestran en el panel Resultados de la consulta.

Configuraste el Agente de operaciones para que recopile registros y métricas de tu servidor web Apache y los viste. El siguiente paso es crear una política de alertas para recibir una notificación cuando aparezca un patrón específico en un registro.

Crea un canal de notificaciones por correo electrónico

Antes de crear una política de alertas, configura los canales de notificaciones 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 alerta basada en registros

Si quieres recibir una notificación cuando aparezca un mensaje específico en tus entradas de registro, crea una alerta basada en registros. En esta sección, crearás una alerta basada en registros para que se te notifique cuando aparezca un mensaje 404 Not Found en tus entradas de registro.

1. En la consola de Google Cloud, ve a la página Explorador de registros:

   Ir al Explorador de registros

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

2. En la barra de herramientas Resultados de la consulta, haz clic en Crear alerta. Se abrirá el panel de políticas de alertas basadas en registros.

3. En Detalles de la alerta, ingresa 404 Not Found para el campo Nombre de la política de alertas.

4. En Elige registros para incluir en esta alerta, haz lo siguiente:

   1. Quita cualquier contenido que esté en el cuadro de texto de filtro de registro.

   2. Copia la siguiente consulta y pégala en el cuadro de texto del filtro de registro:

      severity>=DEFAULT /help httpRequest.status=404
      

      El filtro de registro anterior busca entradas de registro con un nivel de severity de al menos DEFAULT que contengan el texto /help y un estado httpRequest de 404

5. En la sección Set notification frequency and autoclose duration, haz lo siguiente:

   1. Establece el campo Tiempo entre notificaciones en 5 min.
   2. Establece el campo Duración del cierre automático de incidentes en 30 min.

6. En ¿Quién debe recibir notificaciones?, selecciona tu correo electrónico en el menú Canales de notificaciones y, luego, haz clic en Guardar.

Prueba la política de alertas

Para probar la política de alertas, haz lo siguiente:

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. Para buscar la página falsa localhost/help en el servidor, ejecuta el siguiente comando:

   curl localhost/help
   

   Cuando veas un mensaje 404 Not Found en la terminal, se enviará una notificación por correo electrónico. Este proceso tardará varios minutos en completarse.

   La notificación por correo electrónico que recibes es similar a la siguiente:

   

3. Para ver las entradas de registro nuevas, haz lo siguiente:

   1. En la consola de Google Cloud, ve a la página Explorador de registros:

      Ir al Explorador de registros

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

   2. En la barra de herramientas, haz clic en Pasar a los más recientes.

Configuraste el Agente de operaciones para que recopile registros y métricas de tu servidor web Apache, pero solo viste registros. Para obtener información sobre cómo ver las métricas del servidor web Apache, consulta Recopila métricas del servidor web Apache con el Agente de operaciones: genera tráfico.

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que se usaron 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. En la consola de Google Cloud, ve a la página Instancias de VM.

      Ir a Instancias de VM

   2. Selecciona tu instancia en la casilla de verificación de es la instancia que deseas borrar.
   3. Para borrar la instancia, haz clic en Más acciones, haz clic en Borrar y, luego, sigue las instrucciones.

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 más información sobre el Agente de operaciones y las integraciones compatibles, consulta:

  • Descripción general del Agente de operaciones.
  • Supervisa aplicaciones de terceros

• Para obtener información sobre cómo ver registros en el Explorador de registros, consulta Visualiza los registros con el Explorador de registros.

• Para obtener información sobre las consultas en el Explorador de registros, visita Crea consultas en el Explorador de registros.

• Para obtener información sobre cómo recopilar y ver las métricas del servidor web Apache, consulta la guía de inicio rápido Recopila métricas del servidor web Apache con el Agente de operaciones.

• Para obtener más información sobre Monitoring y su relación con Cloud Logging, consulta Monitoring.