Comment installer l'agent Nginx Amplify sur CentOS 7

Nginx Amplify Agent est un puissant outil de surveillance Nginx écrit en Python. Son rôle est de collecter diverses métriques et métadonnées et de les envoyer en toute sécurité au backend pour le stockage et la visualisation. Après une installation correcte, il vous fournit l'interface Web NGINX Amplify et vous devriez voir des métriques en temps réel pour vos systèmes surveillés. Il vous offre également les fonctionnalités suivantes :

Répertoriez tous les serveurs surveillés et le SLA donne un bilan de 30 secondes de l'état de NGINX.
Un ensemble standard de graphiques pour les métriques Nginx, PHP‑FPM et OS
Un aperçu de votre fichier de configuration NGINX et des alertes en cas de problèmes de configuration courants.
Un tableau de bord facile à gérer pour posséder vos graphiques
Notifications sur le comportement anormal de Nginx.

Cette application est prise en charge dans toutes les distributions de système d'exploitation populaires, à savoir Amazon Linux, CentOS, RHEL, Debian et Ubuntu. Dans cet article, je vais vous expliquer comment installer cette application sur un serveur CentOS 7.

Installation de l'agent Amplify

Avant de procéder aux étapes d'installation, vous devrez vous rendre sur amplify.nginx.com et créer un compte.

Vous pouvez maintenant vous connecter à votre compte en utilisant les informations d'identification créées. Vous recevrez un ensemble d'étapes d'installation pour continuer. En supposant que vous ayez déjà un serveur Nginx installé et en cours d'exécution. Commençons par nos étapes d'installation de l'Agent Amplify ci-dessous :

Étape 1. SSH dans votre serveur dont vous avez besoin pour surveiller et télécharger le script d'installation comme ci-dessous :

#wget https://github.com/nginxinc/nginx-amplify-agent/raw/master/packages/install.sh

Étape 2. Exécutez la commande suivante en tant qu'utilisateur root pour installer le package Amplify Agent. Vous pouvez obtenir cette API_KEY à partir de la fenêtre contextuelle des instructions d'installation du tableau de bord Amplify. Chaque compte individuel a une clé API unique. Pour des raisons de sécurité, j'ai marqué les clés API dans "***"

# API_KEY='***' sh ./install.sh

Installed:
 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!

Étape 3. Vérifiez le statut de l'agent comme ci-dessous :

# ps ax | grep -i 'amplify\-'
13536 ? S 0:01 amplify-agent

Ces commandes peuvent être utilisées pour démarrer/arrêter l'agent.

# service amplify-agent start
# service amplify-agent stop
# service amplify-agent restart

Vous pouvez ajouter de nouveaux systèmes à cet agent en cliquant sur l'option "Nouveau système" dans le coin inférieur droit de la fenêtre principale. Vous pouvez suivre les mêmes instructions pour y installer l'agent.

Mise à jour de l'agent Amplify

Nous devons vérifier périodiquement les mises à jour et installer la dernière version stable de l'agent. Vous pouvez le faire avec une seule commande :

# yum makecache && \
yum update nginx-amplify-agent

Configuration de l'agent

NGINX Amplify Agent a son fichier de configuration situé dans /etc/amplify-agent/agent.conf . Il est très important que l'agent et les instances NGINX en cours d'exécution utilisent le même ID utilisateur, afin que l'agent puisse collecter correctement toutes les métriques NGINX. Par défaut, il utilisera l'ID utilisateur de l'utilisateur nginx pour définir son ID utilisateur effectif qui est créé automatiquement lors de l'installation. Si la directive utilisateur apparaît dans la configuration NGINX, l'agent sélectionnera l'utilisateur spécifié dans la configuration NGINX pour son ID utilisateur effectif (par exemple, www-data).

Vous pouvez même spécifier manuellement l'ID utilisateur que l'agent doit utiliser pour son ID utilisateur effectif dans le fichier de configuration sous la section [nginx] ici.

[nginx]
user =
configfile = /etc/nginx/nginx.conf

Configuration de l'URL pour stub_status ou Extended Status

Lorsque l'agent trouve une instance NGINX en cours d'exécution, il détecte automatiquement les emplacements stub_status à partir de la configuration NGINX. Ou vous pouvez utiliser l'option de configuration stub_status pour remplacer l'URL stub_status comme ci-dessous :

[nginx]
..
stub_status = http://127.0.0.1/nginx_status

Configuration de Syslog

L'agent peut collecter les fichiers journaux NGINX via syslog. Cela peut être utile lorsque vous ne conservez pas les journaux NGINX sur le disque ou lorsque vous surveillez un environnement de conteneur tel que Docker avec NGINX Amplify.

Pour configurer l'agent pour syslog, modifiez la directive suivante dans le fichier /etc/amplify-agent/agent.conf :
[les auditeurs]
keys =syslog-default

[listener_syslog-default]
adresse =*// Spécifiez l' IP :port ici juste comme ça 127.0.0.1:12000 //*

Redémarrez l'agent pour recharger la configuration et commencer à écouter sur l'adresse IP et le port spécifiés. Dans l'installation par défaut, il collecte toutes les informations de journal à partir du fichier de configuration Nginx.

Configuration de métriques Nginx supplémentaires

Cela peut collecter un certain nombre de mesures utiles supplémentaires. Je vous ferai savoir pour activer certaines des mesures importantes pour terminer sa configuration. Nous pouvons ajouter plus de graphiques prédéfinis en ajoutant ces métriques. Avec la configuration de format de journal requise, vous pourrez créer des graphiques personnalisés plus spécifiques. Voyons comment nous pouvons ajouter un ensemble étendu de variables NGINX au format de journal d'accès. Vous pouvez ajouter un nouveau format de journal ou modifier celui existant et l'utiliser avec les directives access_log dans votre configuration NGINX. J'ai modifié les directives access_log dans ma configuration NGINX avec les changements suivants.

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;

Et maintenant, vous pouvez définir le niveau de journal error.log pour avertir comme ci-dessous :

error_log /var/log/nginx/error.log warn;

Vous pouvez soit tuer le processus Nginx existant à l'aide de (kill -HUP `cat /var/run/nginx.pid`) et redémarrer à zéro, soit recharger votre configuration Nginx actuelle (service nginx reload) pour enregistrer ces modifications. Vous pouvez obtenir plus d'informations sur la liste des métriques supplémentaires qui peuvent être collectées à partir des fichiers journaux NGINX ici.

C'est ça!! Nous avons installé avec succès Amplify Agent et configuré notre serveur pour la surveillance. Vous pouvez avoir un aperçu de l'état de notre serveur surveillé (104.237.159.96) dans l'interface Web en vous connectant à votre compte Amplify comme dans l'instantané :

Vous pouvez naviguer dans chaque onglet pour obtenir toutes les informations sur les serveurs ajoutés.

Désinstallation de l'agent Amplify

Nous pouvons supprimer complètement un objet précédemment surveillé en suivant ces étapes :

Étape 1. Désinstallez l'agent à l'aide de cette commande comme ci-dessous :

#yum remove nginx-amplify-agent

Étape 2. Supprimer des objets de l'interface Web

Pour supprimer un serveur de l'interface Web Amplify. Vous pouvez simplement le trouver dans l'inventaire de l'interface Web et choisir le [i] icône. Vous pouvez supprimer les objets requis de la fenêtre contextuelle qui apparaît ensuite comme ceci.

Et enfin, vérifiez la page Alertes et supprimez/ignorez les règles non pertinentes définies pour les objets.

Conclusion

NGINX Amplify Agent est un outil puissant pour une surveillance NGINX complète. Nous pouvons analyser et résoudre de manière proactive les problèmes liés aux applications Web basées sur NGINX. Cela nous aide à garder une trace des systèmes exécutant Nginx. Nous pouvons également l'utiliser aux fins suivantes :

Améliorez et optimisez les performances de Nginx grâce à des conseils et des recommandations intelligents
Visualisez et identifiez les goulots d'étranglement des performances Nginx, les serveurs surchargés ou les attaques DDoS potentielles
Planifier la capacité et les performances des applications Web