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:
- Crea una instancia de VM de Compute Engine y, luego, instala el Agente de operaciones.
- Instalar un servidor web Apache
- Configurar el Agente de operaciones para el servidor web Apache
- Visualizar registros en el Explorador de registros
- Crear una alerta basada en registros
- Prueba tu alerta.
- 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:
Antes de comenzar
-
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.
- 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.
-
En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.
-
Comprueba que la facturación esté habilitada en tu proyecto.
-
Habilita las API de Compute Engine, Cloud Monitoring, and Cloud Logging.
-
En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.
-
Comprueba que la facturación esté habilitada en tu proyecto.
-
Habilita las API de Compute Engine, Cloud Monitoring, and Cloud Logging.
Crea una instancia de VM
-
En el panel de navegación de la consola de Google Cloud, elige Compute Engine y, luego, Instancias de VM.
Haz clic en Crear instancia para crear una VM.
- En el campo
Nombre , ingresa un nombre descriptivo. - En el campo
Tipo de máquina , selecciona e2-small. - En la sección
Disco de arranque , mantén la configuración predeterminada de Debian GNU/Linux. - En la sección
Firewall , selecciona Permitir tráfico HTTP y Permitir tráfico HTTPS. - En la sección Observabilidad: Agente de operaciones, selecciona Instalar el Agente de operaciones para Monitoring y Logging.
- 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:
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.
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
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, usasudo apt-get install apache2 php
.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
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.
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:Ve a la terminal SSH de tu instancia de VM. Si no tienes una terminal abierta, haz lo siguiente:
-
En el panel de navegación de la consola de Google Cloud, elige Compute Engine y, luego, Instancias de VM.
- Ubica tu VM nueva y, luego, haz clic en SSH.
-
Copia el siguiente comando, pégalo en la terminal de tu instancia y, luego, presiona Intro:
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.
- 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:
-
En el panel de navegación de la consola de Google Cloud, elige Logging y, luego, Explorador de registros:
Los registros más recientes se muestran en el panel Resultados de la consulta.
En la barra de herramientas, asegúrate de que esté habilitada la opción Mostrar consulta.
Para ver los registros de tu servidor web Apache, crea y ejecuta una consulta:
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.
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
yapache_error
.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:-
En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego, notifications Alertas:
- En la barra de herramientas, haz clic en Edit Notification Channels.
- En la página Canales de notificaciones, desplázate hasta
Correo electrónico y haz clic en Agregar nuevo. - 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.
-
En el panel de navegación de la consola de Google Cloud, elige Logging y, luego, Explorador de registros:
En la barra de herramientas de Resultados de la consulta, haz clic en add_alert Crear alerta. Se abrirá el panel de políticas de alertas basadas en registros.
En Detalles de la alerta, ingresa
404 Not Found
para el campo Nombre de la política de alertas.En Choose logs to include in this alert, haz lo siguiente:
- Quita cualquier contenido que esté en el cuadro de texto de filtro de registro.
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 menosDEFAULT
, que contengan el texto/help
y un estadohttpRequest
de404
.
En la sección Configurar la frecuencia de las notificaciones y la duración del cierre automático, haz lo siguiente:
- Establece el campo Tiempo entre notificaciones en 5 min.
- Establece el campo Duración de cierre automático de incidentes en 30 min.
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:
Ve a la terminal SSH de tu instancia de VM. Si no tienes una terminal abierta, haz lo siguiente:
-
En el panel de navegación de la consola de Google Cloud, elige Compute Engine y, luego, Instancias de VM.
- Ubica tu VM nueva y, luego, haz clic en SSH.
-
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:
Para ver las entradas de registro nuevas, haz lo siguiente:
-
En el panel de navegación de la consola de Google Cloud, elige Logging y, luego, Explorador de registros:
- 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:
Si creaste una VM, bórrala:
- En la consola de Google Cloud, ve a la página Instancias de VM.
-
Selecciona tu instancia
en la casilla de verificación de es la instancia que deseas borrar.
- Para borrar la instancia, haz clic en Más acciones, haz clic en Borrar y, luego, sigue las instrucciones.
Borra la política de alertas que creaste:
-
En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego, notifications Alertas:
- 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:
Para obtener información sobre cómo ver los 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.