Raccogli i log da Apache con Ops Agent

1. I vincoli di sicurezza definiti dalla tua organizzazione potrebbero impedirti di completare i passaggi seguenti. Per informazioni sulla risoluzione dei problemi, vedi Sviluppare applicazioni in un ambiente Google Cloud vincolato.

2. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

3. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Vai al selettore progetti

4. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

5. Abilita le API Compute Engine, Cloud Monitoring, and Cloud Logging.

   Abilita le API

6. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Vai al selettore progetti

7. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

8. Abilita le API Compute Engine, Cloud Monitoring, and Cloud Logging.

   Abilita le API

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 il cui sottotitolo è Compute Engine.

2. Crea una VM facendo clic su Crea istanza.

3. Nel campo Nome, inserisci un nome univoco.
4. Nel campo Tipo di macchina, seleziona e2-small.
5. Nella sezione Disco di avvio, mantieni l'impostazione predefinita di Debian GNU/Linux.
6. Nella sezione Firewall, seleziona entrambe le opzioni Consenti traffico HTTP e Consenti traffico HTTPS.
7. Nella sezione Osservabilità - Ops Agent, seleziona Installa Ops Agent per il monitoraggio e il logging.
8. Fai clic su Crea.

Installare un server web Apache

Per installare un server web Apache sulla tua istanza VM di Compute Engine, segui questi passaggi:

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 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 il cui 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 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
   

   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. Attendi che venga visualizzato il prompt dei comandi. Questa operazione richiederà almeno 60 secondi.

Visualizzare i log del server web Apache

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

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

   Vai a Esplora log

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

   I log più recenti vengono visualizzati nel riquadro Risultati delle 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 progetti Google Cloud dal selettore di progetti Google Cloud e poi copia l'ID progetto Google Cloud negli appunti.

   2. Nella seguente espressione, incolla l'ID copiato nel campo PROJECT_ID, quindi copia l'espressione nell'Editor 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 i log e le metriche dal server web Apache e hai visualizzato questi log. Il passaggio successivo consiste nella creazione di un criterio di avviso in modo da ricevere una notifica quando un pattern specifico viene visualizzato in un log.

Crea un canale di notifica via email

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

   Vai ad Avvisi

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato il cui 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 nelle voci di log viene visualizzato un messaggio specifico, crea un avviso basato su log. In questa sezione creerai un avviso basato su log in modo da ricevere una notifica quando viene visualizzato un messaggio 404 Not Found nelle voci di log.

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

   Vai a Esplora log

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato il cui 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:

   1. Rimuovi tutti i contenuti presenti nella casella di testo del filtro 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 almeno DEFAULT, che contengono il testo /help e che contengono 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 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 il cui 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 del processo richiede diversi minuti.

   La notifica via email che ricevi è simile alla seguente:

   

3. Per visualizzare le nuove voci di log:

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

      Vai a Esplora log

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

   2. Nella barra degli strumenti, fai clic su Vai a ora.

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