Nginx Amplify Agent è un potente strumento di monitoraggio Nginx scritto in Python. Il suo ruolo è raccogliere varie metriche e metadati e inviarli in modo sicuro al back-end per l'archiviazione e la visualizzazione. Dopo una corretta installazione, ti fornisce l'interfaccia web NGINX Amplify e dovresti vedere le metriche in tempo reale per i tuoi sistemi monitorati. Ti offre anche le seguenti funzionalità:
- Elenca tutti i server monitorati e lo SLA fornisce un controllo di 30 secondi dello stato di NGINX.
- Un set standard di grafici per le metriche Nginx, PHP‑FPM e OS.
- Una panoramica del tuo file di configurazione NGINX e avvisi in caso di problemi di configurazione comuni.
- Una dashboard facilmente gestibile per possedere i tuoi grafici
- Notifiche sul comportamento anomalo di Nginx.
Questa applicazione è supportata in tutte le distribuzioni di sistemi operativi più diffusi, ovvero Amazon Linux, CentOS, RHEL, Debian e Ubuntu. In questo articolo spiegherò come installare questa applicazione su un server CentOS 7.
Installazione di Amplify Agent
Prima di procedere con i passaggi di installazione, dovrai andare su amplify.nginx.com e creare un account.
Ora puoi accedere al tuo account utilizzando le credenziali create. Ti verrà fornita una serie di passaggi di installazione per procedere ulteriormente. Supponendo che tu abbia già un server Nginx installato e in esecuzione. Iniziamo con i passaggi di installazione dell'Amplify Agent di seguito:
Passaggio 1. SSH nel tuo server che devi monitorare e scaricare lo script di installazione come di seguito:
#wget https://github.com/nginxinc/nginx-amplify-agent/raw/master/packages/install.shPassaggio 2. Eseguire il comando seguente come root per installare il pacchetto Amplify Agent. Puoi ottenere questa API_KEY dalla finestra popup delle istruzioni di installazione dal dashboard di Amplify. Ogni singolo account ha una chiave API univoca. Per motivi di sicurezza, ho contrassegnato le chiavi API in "***"
# API_KEY='***' sh ./install.shInstalled:
nginx-amplify-agent.x86_64 0:0.47-1.el7
Complete!
8. Installing nginx-amplify-agent package ... done.
9. Building configuration file ... done.
10. Checking if sudo -u nginx -g nginx can be used for tests ... done.
11. Checking if euid 997(nginx) can find root processes ... ok.
12. Checking if euid 997(nginx) can access I/O counters for nginx ... ok.
13. Checking connectivity to the receiver ... ok.
14. Checking system time ... ok.
OK, everything went just fine!Passaggio 3. Verifica lo stato dell'agente come di seguito:
# ps ax | grep -i 'amplify\-'
13536 ? S 0:01 amplify-agentQuesti comandi possono essere utilizzati per avviare/arrestare l'agente.
# service amplify-agent start
# service amplify-agent stop
# service amplify-agent restartPuoi aggiungere nuovi sistemi a questo agente facendo clic sull'opzione "Nuovo sistema" nell'angolo in basso a destra della finestra principale. Puoi seguire le stesse istruzioni per installare l'agente lì.
Aggiornamento dell'Amplify Agent
È necessario verificare periodicamente la presenza di aggiornamenti e installare l'ultima versione stabile dell'agente. Puoi farlo con un solo comando:
# yum makecache && \
yum update nginx-amplify-agentConfigurazione dell'agente
NGINX Amplify Agent ha il suo file di configurazione che si trova in/etc/amplify-agent/agent.conf . È molto importante che l'agente e le istanze NGINX in esecuzione utilizzino lo stesso ID utente, in modo che l'agente sia in grado di raccogliere correttamente tutte le metriche NGINX. Per impostazione predefinita, utilizzerà l'ID utente dell'utente nginx per impostare il suo ID utente effettivo che viene creato automaticamente durante l'installazione. Se la direttiva utente viene visualizzata nella configurazione NGINX, l'agente preleverà l'utente specificato nella configurazione NGINX per il suo ID utente effettivo (ad es. www-data).
Puoi anche specificare manualmente l'ID utente che l'agente dovrebbe utilizzare per il suo ID utente effettivo nel file di configurazione nella sezione [nginx] qui.
[nginx]
user =
configfile = /etc/nginx/nginx.confConfigurazione dell'URL per stub_status o Stato esteso
Quando l'agente trova un'istanza NGINX in esecuzione, rileva automaticamente le posizioni stub_status dalla configurazione NGINX. Oppure puoi utilizzare l'opzione di configurazione stub_status per sovrascrivere l'URL stub_status come di seguito:
[nginx]
..
stub_status = http://127.0.0.1/nginx_statusConfigurazione Syslog
L'agente può raccogliere i file di registro NGINX tramite syslog. Questo potrebbe essere utile quando non mantieni i log di NGINX su disco o quando monitori un ambiente container come Docker con NGINX Amplify.
Per configurare l'agente per syslog, modificare la seguente direttiva in /etc/amplify-agent/agent.conf:
[ascoltatori]
chiavi =syslog-predefinito
[lister_syslog-predefinito]
indirizzo =*// Specificare l' IP:porta qui proprio così 127.0.0.1:12000 //*
Riavviare l'agente per ricaricare la configurazione e avviare l'ascolto sull'indirizzo IP e sulla porta specificati. Nell'installazione predefinita raccoglie tutte le informazioni di registro dal file di configurazione di Nginx.
Configurazione di metriche Nginx aggiuntive
Questo può raccogliere una serie di metriche utili aggiuntive. Ti farò sapere per abilitare alcune delle metriche importanti per completare la sua configurazione. Possiamo aggiungere più grafici predefiniti aggiungendo queste metriche. Con la configurazione del formato di registro richiesta, sarai in grado di creare grafici personalizzati più specifici. Vediamo come possiamo aggiungere un insieme esteso di variabili NGINX al formato del registro di accesso. Puoi aggiungere un nuovo formato di log o modificare quello esistente e usarlo con le direttive access_log nella tua configurazione NGINX. Ho modificato le direttive access_log nella mia configurazione NGINX con le seguenti modifiche.
http {
log_format main_ext '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for" '
'"$host" sn="$server_name" '
'rt=$request_time '
'ua="$upstream_addr" us="$upstream_status" '
'ut="$upstream_response_time" ul="$upstream_response_length" '
'cs=$upstream_cache_status' ;
access_log /var/log/nginx/access.log main_ext;E ora puoi impostare il livello di registro error.log per avvisare come di seguito:
error_log /var/log/nginx/error.log warn;Puoi terminare il processo Nginx esistente usando (kill -HUP `cat /var/run/nginx.pid`) e riavviarlo o ricaricare la tua attuale configurazione Nginx (servizio nginx reload) per salvare queste modifiche. Puoi ottenere maggiori informazioni sull'elenco delle metriche aggiuntive che possono essere raccolte dai file di registro NGINX qui.
Questo è tutto!! Abbiamo installato con successo Amplify Agent e configurato il nostro server per il monitoraggio. Puoi visualizzare lo stato del nostro server monitorato (104.237.159.96) nell'interfaccia Web accedendo al tuo account Amplify come nell'istantanea:
Puoi navigare attraverso ciascuna scheda per ottenere tutte le informazioni sui server aggiunti.
Disinstallazione di Amplify Agent
Possiamo eliminare completamente un oggetto precedentemente monitorato utilizzando questi passaggi seguenti:
Passaggio 1. Disinstallare l'agente utilizzando questo comando come di seguito:
#yum remove nginx-amplify-agentPassaggio 2. Elimina oggetti dall'interfaccia web
Per eliminare un server dall'interfaccia web di Amplify. Puoi semplicemente trovarlo nell'Inventario nell'interfaccia Web e scegliere [i] icona. Puoi rimuovere gli oggetti richiesti dalla finestra popup che appare accanto proprio in questo modo.
Infine, controlla la pagina Avvisi e rimuovi/disattiva l'audio delle regole irrilevanti impostate per gli oggetti.
 Conclusione
NGINX Amplify Agent è un potente strumento per il monitoraggio completo di NGINX. Siamo in grado di analizzare e risolvere in modo proattivo i problemi relativi alle applicazioni Web basate su NGINX. Ci aiuta a tenere traccia dei sistemi che eseguono Nginx. Possiamo anche usarlo per i seguenti scopi:
- Migliora e ottimizza le prestazioni di Nginx con consigli e suggerimenti intelligenti
- Visualizza e identifica colli di bottiglia delle prestazioni di Nginx, server sovraccarichi o potenziali attacchi DDoS
- Pianificare la capacità e le prestazioni delle applicazioni web