Tutoriel : Surveiller vos applications dans Azure Service Fabric avec ELK

Article
10/15/2024

Ce tutoriel est la quatrième partie de la série. Il montre comment utiliser ELK (Elasticsearch, Logstash et Kibana) pour surveiller les applications Service Fabric s’exécutant dans Azure.

Dans ce quatrième volet, vous apprenez à :

Configurer le serveur ELK dans Azure
Configurer Logstash pour recevoir des journaux d’activité d’Event Hubs
Visualiser la plateforme et les journaux des applications dans Kibana

Cette série de tutoriels vous montre comment effectuer les opérations suivantes :

Générer une application Reliable Services Service Fabric de Java
Déployer et déboguer l’application sur un cluster local
Déployer l’application sur un cluster Azure
Configurer la surveillance et les diagnostics pour l’application
Configurer CI/CD

Prérequis

Avant de commencer ce tutoriel :

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit
Configurez votre application pour publier des journaux d’activité à l’emplacement spécifié dans la deuxième partie.
Terminez la troisième partie et utilisez un cluster Service Fabric en cours d’exécution configuré pour envoyer des journaux d’activité à Event Hubs.
La stratégie dans Event Hubs qui a l’autorisation « Écouter » et la clé primaire associée à partir de la troisième série.

Télécharger l’exemple d’application de vote

Si vous n’avez pas généré l’exemple d’application de vote lors de la première partie de cette série de didacticiels, vous pouvez le télécharger. Dans une fenêtre Commande, exécutez la commande suivante pour cloner le référentiel de l’exemple d’application sur votre ordinateur local.

git clone https://github.com/Azure-Samples/service-fabric-java-quickstart

Créer un serveur ELK dans Azure

Vous pouvez utiliser un environnement ELK préconfiguré pour ce didacticiel. Si vous en avez déjà un, passez à la section Configurer ELK. Toutefois, si vous n’en avez pas, la procédure suivante en crée un dans Azure.

Créez un ELK certifié par Bitnami dans Azure. Pour les besoins de ce tutoriel, il n’y a pas de spécifications particulières à suivre pour la création de ce serveur.
Accédez aux ressources dans le portail Azure, puis à l’onglet Diagnostics de démarrage dans la section Support + Troubleshooting (Support + Dépannage). Ensuite, cliquez sur l’onglet Journal série.

Effectuer une recherche sur les journaux d’activité pour le mot de passe est requis pour accéder à l’instance Kibana. L’extrait de code se présente comme suit :

[   25.932766] bitnami[1496]: #########################################################################
[   25.948656] bitnami[1496]: #                                                                       #
[   25.962448] bitnami[1496]: #        Setting Bitnami application password to '[PASSWORD]'           #
[   25.978137] bitnami[1496]: #        (the default application username is 'user')                   #
[   26.004770] bitnami[1496]: #                                                                       #
[   26.029413] bitnami[1496]: #########################################################################

Appuyez sur le bouton de connexion sur la page Vue d’ensemble du serveur dans le portail Azure pour obtenir les informations de connexion.
Établissez une connexion SSH sur le serveur qui héberge l’image ELK à l’aide de la commande suivante
```
ssh [USERNAME]@[CONNECTION-IP-OF-SERVER]

Example: ssh testaccount@104.40.63.157
```

Configurer ELK

La première étape consiste à charger l’environnement ELK
```
sudo /opt/bitnami/use_elk
```
Si vous utilisez un environnement existant, vous devez exécuter la commande suivante pour arrêter le service Logstash
```
sudo /opt/bitnami/ctlscript.sh stop logstash
```
Exécutez la commande suivante pour installer le plug-in Logstash pour Event Hubs.
```
logstash-plugin install logstash-input-azureeventhub
```

Créez ou modifiez votre fichier config Logstash existant avec le contenu suivant : si vous créez le fichier, il doit être créé à l’emplacement /opt/bitnami/logstash/conf/access-log.conf si vous utilisez l’image ELK Bitnami dans Azure.

input
{
    azureeventhub
    {
        key => "[RECEIVER-POLICY-KEY-FOR-EVENT-HUB]"
        username => "[RECEIVER-POLICY-NAME]"
        namespace => "[EVENTHUB-NAMESPACENAME]"
        eventhub => "[EVENTHUB-NAME]"
        partitions => 4
    }
}

output {
     elasticsearch {
         hosts => [ "127.0.0.1:9200" ]
     }
 }

Pour vérifier la configuration, exécutez la commande suivante :

/opt/bitnami/logstash/bin/logstash -f /opt/bitnami/logstash/conf/ --config.test_and_exit

Démarrer le service Logstash

sudo /opt/bitnami/ctlscript.sh start logstash

Vérifiez votre Elasticsearch pour vous assurer que vous recevez des données
```
curl 'localhost:9200/_cat/indices?v'
```
Accédez à votre tableau de bord Kibana à l’adresse http://SERVER-IP et entrez le nom d’utilisateur et un mot de passe pour Kibana. Si vous avez utilisé l’image ELK dans Azure, le nom d’utilisateur par défaut est « user » et le mot de passe est celui obtenu dans Diagnostics de démarrage.

Étapes suivantes

Dans ce didacticiel, vous avez appris à :

Obtenir un serveur ELK s’exécutant dans Azure
Configurer le serveur pour recevoir des informations de diagnostic de votre cluster Service Fabric

Passez au tutoriel suivant :

Configurer l’intégration continue/le déploiement continu avec Jenkins

Partage via