Recopila registros de Apache con el Agente de operaciones

Aprende a recopilar y ver los registros syslog recopilados de un servidor web Apache instalado en una instancia de máquina virtual (VM) de Compute Engine mediante 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. Instalar un servidor web Apache
  3. Configurar el Agente de operaciones para el servidor web Apache
  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. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  4. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

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

    Habilita las API

  6. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  7. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

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

    Habilita las API

Crea una instancia de VM

  1. En el panel de navegación de la consola de Google Cloud, elige Compute Engine y, luego, Instancias de VM.

    Ir a Instancias de VM

  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 de 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
    

    Cuando se te solicite continuar la instalación, ingresa Y. Si el comando de instalación 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 pestaña del navegador nueva 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.

    Se muestra la página predeterminada de Apache2.

Recopila registros y métricas del servidor web Apache

En estos pasos, configurarás el Agente de operaciones para que recopile 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 el panel de navegación de la consola de Google Cloud, elige Compute Engine y, luego, Instancias de VM.

      Ir a Instancias de VM

    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 deseas obtener más información, consulta Configura el Agente de operaciones para el servidor web de Apache.

  3. Espera hasta que se muestre el símbolo del sistema, lo que demora al menos 60 segundos.

Ver los registros del servidor web Apache

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

  1. En el panel de navegación de la consola de Google Cloud, elige Logging y, luego, Explorador de registros:

    Ir al Explorador de registros

    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 viste esos registros. El siguiente paso es crear una política de alertas para que recibas una notificación cuando aparezca un patrón específico en un registro.

Cómo crear 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, como 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 el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Alertas:

    Ir a las Alertas

  2. En la barra de herramientas, haz clic en Edit Notification Channels.
  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 y un nombre visible, como My email, y haz clic en Guardar.

Crear una alerta basada en registros

Para recibir notificaciones 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 el panel de navegación de la consola de Google Cloud, elige Logging y, luego, Explorador de registros:

    Ir al Explorador de registros

  2. En la barra de herramientas de 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 Choose logs to include in this alert, 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 Configurar la frecuencia de las notificaciones y la duración del cierre automático, haz lo siguiente:

    1. Establece el campo Tiempo entre notificaciones en 5 min.
    2. Establece el campo Duración de 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 el panel de navegación de la consola de Google Cloud, elige Compute Engine y, luego, Instancias de VM.

      Ir a Instancias de VM

    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:

    La alerta de ejemplo basada en registros da como resultado una notificación por correo electrónico.

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

    1. En el panel de navegación de la consola de Google Cloud, elige Logging y, luego, Explorador de registros:

      Ir al Explorador de registros

    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 los registros. Si quieres obtener información para 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 el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Alertas:

      Ir a las Alertas

    2. Selecciona la política de alertas que creaste y, luego, haz clic en Borrar.

¿Qué sigue?