Raccogli i log da Apache con Ops Agent

Raccogli i log da Apache con Ops Agent

Scopri come raccogliere e visualizzare i log syslog raccolti da un server web Apache installato su un'istanza di una macchina virtuale (VM) Compute Engine utilizzando Ops Agent. Puoi utilizzare una procedura simile a quella in questa guida rapida per monitorare altre applicazioni di terze parti.

In questa guida rapida, esegui le seguenti operazioni:

1. Crea un'istanza VM di Compute Engine e installa Ops Agent.
2. Installa un server web Apache.
3. Configura Ops Agent per il server web Apache.
4. Visualizzare i log in Esplora log.
5. Creare un avviso basato su log.
6. Verifica l'avviso.
7. Eseguire la pulizia.

---

Per seguire le indicazioni dettagliate per questa attività direttamente nella console Google Cloud, fai clic su Aiuto:

Aiuto

---

Prima di iniziare

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

2. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   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.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   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. Nel pannello di navigazione della console Google Cloud, seleziona Compute Engine e poi Istanze VM:

   Vai a Istanze VM

2. Crea una VM facendo clic su Crea istanza.

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

Installa 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. Dopo aver visualizzato il messaggio "Lettura degli elenchi di pacchetti in corso... Fatto", 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 riesce, 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 del 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

In questi passaggi, configurerai Ops Agent in modo che raccolga log e metriche dal server web Apache:

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

   1. Nel pannello di navigazione della console Google Cloud, seleziona Compute Engine e poi Istanze VM:

      Vai a Istanze VM

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

2. Copia il seguente comando, quindi 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, consulta Configurare il server web Ops Agent per il server web Apache.

3. Attendi fino alla visualizzazione del prompt dei comandi. L'operazione richiede almeno 60 secondi.

Visualizza i log del server web Apache

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

1. Nel pannello di navigazione della console Google Cloud, seleziona Logging e poi Esplora log:

   Vai a Esplora log

   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, quindi copia l'ID progetto Google Cloud negli appunti.

   2. Nell'espressione seguente, 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 log e metriche dal server web Apache e hai visualizzato i log. Il passaggio successivo consiste nella creazione di un criterio di avviso, in modo da ricevere una notifica quando viene visualizzato un pattern specifico in un log.

Crea un canale di notifica via email

Prima di creare un criterio di avviso, configura i canali di notifica che devono essere utilizzati dal criterio di avviso. Cloud Monitoring supporta numerosi tipi di canali di notifica, tra cui email, Slack, PagerDuty e Pub/Sub. Per maggiori informazioni, consulta Creare e gestire canali di notifica. Per ricevere notifiche via email:

1. Nel pannello di navigazione della console Google Cloud, seleziona Monitoring e poi  Avvisi:

   Vai ad Avvisi

2. Nella barra degli strumenti, fai clic su Modifica canali di notifica.
3. Nella pagina Canali di notifica, scorri fino a Email, quindi fai clic su Aggiungi nuovo.
4. Inserisci il tuo indirizzo email, un nome visualizzato, ad esempio My email, e 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. Nel pannello di navigazione della console Google Cloud, seleziona Logging e poi Esplora log:

   Vai a Esplora log

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

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

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 dei 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 le voci di log con un livello severity di almeno DEFAULT, che contengono il testo /help e uno stato httpRequest pari ad 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.

Testa il 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. Nel pannello di navigazione della console Google Cloud, seleziona Compute Engine e poi Istanze VM:

      Vai a Istanze VM

   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 visualizzato un messaggio 404 Not Found nel terminale, viene inviata una notifica email. Il completamento della procedura richiede diversi minuti.

   La notifica via email che ricevi è simile alla seguente:

   

3. Per visualizzare le nuove voci di log:

   1. Nel pannello di navigazione della console Google Cloud, seleziona Logging e poi Esplora log:

      Vai a Esplora log

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

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, consulta Raccogliere metriche del server web Apache con Ops Agent: generare traffico.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

Se hai creato un nuovo progetto, ma non ne hai più bisogno, elimina il progetto.

Se hai utilizzato un progetto esistente:

1. Se hai creato una VM, eliminala:

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

      Vai a Istanze VM

   2. Seleziona la casella di controllo per l'istanza che vuoi eliminare.
   3. Per eliminare l'istanza, fai clic su Altre azioni, quindi su Elimina e segui le istruzioni.

2. Elimina il criterio di avviso che hai creato:

   1. Nel pannello di navigazione della console Google Cloud, seleziona Monitoring e poi  Avvisi:

      Vai ad Avvisi

   2. Seleziona il criterio di avviso che hai creato, quindi fai clic su Elimina.

Passaggi successivi

• Per saperne di più su Ops Agent e sulle integrazioni supportate, vedi:

  • Panoramica di Ops Agent.
  • Monitorare le applicazioni di terze parti

• Per informazioni su come visualizzare i log in Esplora log, consulta Visualizzare i log utilizzando Esplora log.

• Per informazioni sulle query in Esplora log, vedi Creare query in Esplora log.

• Per informazioni su come raccogliere e visualizzare le metriche del server web Apache, consulta la guida rapida Raccogliere metriche del server web Apache con Ops Agent.

• Per ulteriori informazioni su Monitoring e sulla sua relazione con Cloud Logging, consulta Monitoring.