Raccogli i log da Apache con Ops Agent

Crea un'istanza VM

1. Nella console Google Cloud , vai alla pagina Istanze VM.

   Vai a Istanze VM

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Compute Engine.

2. Crea una VM facendo clic su Crea istanza. Configura l'istanza utilizzando le opzioni nel menu di navigazione.
3. Nell'opzione Configurazione macchina:
   1. Nel campo Nome, inserisci un nome descrittivo.
   2. Nel menu a discesa preimpostato Tipo di macchina, seleziona Con core condiviso > e2-small.
4. Verifica che l'opzione Sistema operativo e spazio di archiviazione mostri Debian GNU/Linux. In caso contrario, fai clic sull'opzione Sistema operativo e spazio di archiviazione e poi su Cambia. Nella finestra di dialogo Disco di avvio, imposta Versione su Debian GNU/Linux.
5. Nell'opzione Networking, per Firewall, seleziona Consenti traffico HTTP e Consenti traffico HTTPS.
6. Verifica che l'opzione Osservabilità mostri Installa Ops Agent. In caso contrario, fai clic sull'opzione Osservabilità e seleziona Installa Ops Agent per il monitoraggio e il logging.
7. Fai clic su Crea.

Installare un server web Apache

Per installare un server web Apache sull'istanza VM di Compute Engine:

1. Nella pagina Istanze VM, individua la nuova VM, vai alla colonna Connetti e fai clic su SSH.

   Hai problemi con la connessione? Fai riferimento all'articolo Risoluzione dei problemi relativi a SSH.

2. Per aggiornare gli elenchi di pacchetti, copia il seguente comando negli appunti, incollalo nel terminale SSH e premi Invio:

   sudo apt-get update
   

3. Quando viene visualizzato il messaggio "Lettura degli elenchi dei pacchetti in corso... Fine", nel terminale SSH, esegui questo comando per installare un server web Apache2:

   sudo apt-get install apache2 php7.0
   

   Quando ti viene chiesto di continuare l'installazione, inserisci Y. Se il comando di installazione non va a buon fine, utilizza: sudo apt-get install apache2 php.

4. Quando viene restituito il prompt dei comandi, vai alla pagina Istanze VM e copia l'indirizzo IP esterno della VM nel seguente URL:

   http://EXTERNAL_IP
   

5. Per connetterti al server web Apache, apri una nuova scheda del browser e inserisci l'URL dal passaggio precedente.

   Una volta installato correttamente il server web, nella scheda del browser viene visualizzata la pagina predefinita di Apache2 Debian.

   

Raccogli i log e le metriche del server web Apache

1. Vai al terminale SSH per l'istanza VM. Se non hai un terminale aperto, procedi nel seguente modo:

   1. Nella Google Cloud console, vai alla pagina Istanze VM.

      Vai a Istanze VM

      Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Compute Engine.

   2. Individua la nuova VM e fai clic su SSH.

2. Copia il seguente comando, poi incollalo nel terminale per la tua istanza, quindi premi Invio:

   # 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
   

   Il comando precedente crea la configurazione per raccogliere e importare log e metriche dal server web Apache. Per maggiori informazioni, vedi Configura Ops Agent per il server web Apache.

3. Riavvia Ops Agent:
   1. Per riavviare l'agente, esegui il seguente comando sull'istanza:

      sudo systemctl restart google-cloud-ops-agent
      

   2. Per verificare che l'agente sia stato riavviato, esegui il seguente comando e verifica che i componenti "Agente Metriche" e "Agente Logging" siano stati avviati:

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

Visualizzare i log del server web Apache

Per visualizzare i log nella console Google Cloud , utilizza Esplora log:

1. Nella Google Cloud console, vai alla pagina Esplora log:

   Vai a Esplora log

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.

   I log più recenti vengono visualizzati nel riquadro Risultati query.

2. Nella barra degli strumenti, assicurati che l'opzione Mostra query sia attivata.

3. Per visualizzare i log del server web Apache, crea ed esegui una query:

   1. Espandi l'elenco dei Google Cloud progetti dalGoogle Cloud selettore dei progetti e poi copia l'Google Cloud ID progetto negli appunti.

   2. Nella seguente espressione, incolla l'ID copiato nel campo PROJECT_ID, quindi copia l'espressione nell'Editor di query:

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

      Quando viene eseguita la query precedente, vengono mostrate solo le voci di log apache_access e apache_error.

   3. Fai clic su Esegui query.

      I risultati della query vengono visualizzati nel riquadro Risultati query.

Hai configurato Ops Agent per raccogliere log e metriche dal server web Apache e hai visualizzato i log. Il passaggio successivo consiste nel creare una criterio di avviso in modo da ricevere una notifica quando in un log viene visualizzato un pattern specifico.

Crea un canale di notifica via email

1. Nella Google Cloud console, vai alla pagina notifications Avvisi:

   Vai ad Avvisi

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

2. Nella barra degli strumenti, fai clic su Modifica canali di notifica.
3. Nella pagina Canali di notifica, scorri fino a Email e fai clic su Aggiungi nuovo.
4. Inserisci il tuo indirizzo email e un nome visualizzato come My email, quindi fai clic su Salva.

Crea un avviso basato su log

Per ricevere una notifica quando un messaggio specifico viene visualizzato nelle voci di log, crea un avviso basato sui log. In questa sezione, crei un avviso basato sui log per ricevere una notifica quando nelle voci di log viene visualizzato un messaggio 404 Not Found.

1. Nella Google Cloud console, vai alla pagina Esplora log:

   Vai a Esplora log

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.

2. Nella barra degli strumenti Risultati delle query, fai clic su add_alert Crea avviso. Viene visualizzato il riquadro dei criteri di avviso basati su log.

3. In Dettagli avviso, nel campo Nome criterio di avviso, inserisci 404 Not Found.

4. In Scegli i log da includere in questo avviso, procedi nel seguente modo:

   1. Rimuovi tutti i contenuti presenti nella casella di testo del filtro di log.

   2. Copia la seguente query e incollala nella casella di testo del filtro di log:

      severity>=DEFAULT /help httpRequest.status=404
      

      Il filtro di log precedente cerca voci di log con un livello severity di almeno DEFAULT, che contengono il testo /help e uno stato httpRequest pari a 404.

5. Nella sezione Imposta la frequenza delle notifiche e la durata della chiusura automatica, procedi nel seguente modo:

   1. Imposta il campo Tempo tra le notifiche su 5 min.
   2. Imposta il campo Durata chiusura automatica incidenti su 30 min.

6. In Chi dovrebbe ricevere le notifiche?, seleziona l'email dal menu Canali di notifica, quindi fai clic su Salva.

Esegui il test del criterio di avviso

Per testare il criterio di avviso:

1. Vai al terminale SSH per l'istanza VM. Se non hai un terminale aperto, procedi nel seguente modo:

   1. Nella Google Cloud console, vai alla pagina Istanze VM.

      Vai a Istanze VM

      Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Compute Engine.

   2. Individua la nuova VM e fai clic su SSH.

2. Per cercare sul server la pagina falsa localhost/help, esegui questo comando:

   curl localhost/help
   

   Dopo aver visto il messaggio 404 Not Found nel terminale, viene inviata una notifica via email. Il completamento di questo processo richiede vari minuti.

   La notifica via email che ricevi è simile alla seguente:

   

3. Per visualizzare le nuove voci di log:

   1. Nella Google Cloud console, vai alla pagina Esplora log:

      Vai a Esplora log

      Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.

   2. Nella barra degli strumenti, fai clic su Vai a più recenti.

Hai configurato Ops Agent per raccogliere log e metriche dal server web Apache, ma hai visualizzato solo i log. Per informazioni su come visualizzare le metriche del server web Apache, vedi Raccogli le metriche del server web Apache con Ops Agent: genera traffico.