Aller au contenu

GUIDE TECHNIQUE · ELASTIC STACK (ELK)

Collecter les logs avec Elastic Agent et Fleet

Créer une Agent Policy, installer Elastic Agent sur un hôte de recette et démontrer que les journaux Linux arrivent dans des data streams consultables.

Niveau Débutant5 min de lecture— vuesElastic Stack (ELK)

L’ESSENTIEL EN BREF

Les étapes clés

Ce guide présente 4 étapes, de « Préparer la policy et le fichier de recette » à « Terminer la collecte de recette ».

Avant de commencer : Disposer d’un environnement de recette autorisé, distinct de la production.

01 · CADRAGE

Périmètre et résultat visé

Résultat attendu : Un seul agent installé sur l’hôte remonte Healthy.

Public concerné : Ingénieurs observabilité, administrateurs Elastic Stack et équipes RUN.

Environnement et versions

Elastic Agent Fleet-managed et Fleet Server configuré. Adapter les commandes d’installation à la version proposée par Kibana.

02 · AVANT DE COMMENCER

Prérequis et points de contrôle

Kibana/Fleet et Fleet Server opérationnels, un Linux de recette avec sudo, une policy et ses endpoints autorisés ; un fichier fictif à collecter.

  • Disposer d’un environnement de recette autorisé, distinct de la production.
  • Contrôler compatibilité des versions, TLS, droits minimaux et flux réseau.
  • Préparer des données fictives et un protocole de retour arrière.

Votre environnement de départ

Environnement
Elasticsearch et Kibana de même version, ou le laboratoire Docker créé dans le guide d’installation.
Outils
Navigateur/Dev Tools, curl ; Docker pour l’installation locale ; Logstash pour le guide Grok.
Comptes et droits
Installation Docker pour le premier guide ; droits index, templates, ILM, Fleet ou règles selon la tâche ; conserver l’administration hors des identités applicatives.
Réseau et accès
Poste vers Elasticsearch HTTPS 9200 et Kibana 5601 selon le déploiement ; agents vers Fleet/Elasticsearch selon leurs endpoints publiés.

Contrôles avant de commencer

Où effectuer le contrôle : Kibana Dev Tools

Commandes et configuration
GET /
GET /_cluster/health

Résultat attendu : La version et le cluster sont ceux de recette ; l’état red doit être diagnostiqué avant les exercices qui en dépendent.

03 · VUE D’ENSEMBLE

Comprendre l’architecture et les flux

ARCHITECTURE TECHNIQUEComprendre la chaîne de bout en bout
01Linux de recette
02Elastic Agent
03Fleet Server
04Elasticsearch
05Discover
Parcours de bout en bout pour Elastic Stack : tester chaque maillon de la chaîne avant de valider le résultat global.

04 · TUTORIEL

Procédure complète, étape par étape

Suivez les étapes dans l’ordre et contrôlez chaque résultat avant de poursuivre. Renseignez les paramètres adaptés à votre environnement.

01

ÉTAPE 1 / 4

Préparer la policy et le fichier de recette

Une policy sans intégration de logs ne collecte pas arbitrairement tous les fichiers.

  1. Dans Fleet, vérifier que Fleet Server est Healthy. Créer une policy de recette puis ajouter l’intégration Custom Logs adaptée à la version de votre Stack.
  2. Sur le Linux cible, créer un fichier fictif lisible par le compte de l’Agent ; définir son chemin exact dans l’intégration et vérifier l’output de la policy.
Commandes et configuration
printf '%s\n' 'ADN-FLEET-INITIAL' > /tmp/adn-fleet-lab.log
ls -l /tmp/adn-fleet-lab.log
Ce qui se passe à cette étape
1Préparer
2Préparer la policy et le fichier de recette
3Contrôler

À vérifier : Policy, intégration, output et chemin du fichier sont définis avant l’installation.

Point de vigilance : Arrêter cette étape si le contrôle échoue ; diagnostiquer avant de poursuivre.

02

ÉTAPE 2 / 4

Installer avec la commande de votre Fleet

La commande d’enrôlement dépend du Fleet Server, de sa confiance TLS et de la policy.

  1. Dans Fleet > Add agent, sélectionner la policy créée, Linux et l’architecture réelle de la machine. Copier les étapes complètes de téléchargement/extraction puis d’installation générées par votre propre environnement.
  2. Exécuter ces étapes sur le Linux avec les droits demandés. Les jetons d’enrôlement et certificats restent dans le canal privé de l’opérateur ; ne pas utiliser un token trouvé dans un exemple public. En présence d’une CA privée, fournir le paramètre de confiance généré ou prévu par votre Fleet.
Ce qui se passe à cette étape
1Préparer
2Installer avec la commande de votre Fleet
3Contrôler

À vérifier : L’Agent apparaît dans Fleet avec la bonne policy et passe Healthy.

Point de vigilance : Arrêter cette étape si le contrôle échoue ; diagnostiquer avant de poursuivre.

03

ÉTAPE 3 / 4

Vérifier l’état puis l’arrivée d’un marqueur

Healthy prouve l’état de l’Agent ; l’événement reçu prouve la collecte du fichier.

  1. Exécuter elastic-agent status avec le chemin binaire réellement installé et attendre que l’intégration ait appliqué la policy.
  2. Ajouter le marqueur ci-dessous au fichier. Dans Discover, sélectionner le data stream de l’intégration, une période récente et rechercher la valeur exacte affichée ; vérifier agent.id et le chemin source.
Commandes et configuration
sudo elastic-agent status
MARKER="ADN-FLEET-$(date -u +%Y%m%dT%H%M%SZ)"
printf '%s\n' "$MARKER" >> /tmp/adn-fleet-lab.log
printf '%s\n' "$MARKER"
Ce qui se passe à cette étape
1Préparer
2Vérifier l’état puis l’arrivée d’un marqueur
3Contrôler

À vérifier : Le marqueur du bon hôte est retrouvé dans le data stream attendu.

Point de vigilance : Arrêter cette étape si le contrôle échoue ; diagnostiquer avant de poursuivre.

04

ÉTAPE 4 / 4

Terminer la collecte de recette

La policy et les jetons de recette doivent être traités séparément des données déjà indexées.

  1. Retirer l’intégration du fichier ou désenrôler l’Agent de recette selon le but du test. Révoquer le token d’enrôlement réservé à cet exercice si celui-ci ne doit plus servir.
  2. Retirer le fichier fictif seulement après arrêt de sa collecte. Les événements déjà indexés restent soumis à la politique de rétention du data stream ; ne pas supprimer un stream partagé pour nettoyer un seul test.
Ce qui se passe à cette étape
1Préparer
2Terminer la collecte de recette
3Contrôler

À vérifier : Le flux de recette est arrêté et le statut Fleet ainsi que les jetons correspondent à l’état de fin prévu.

Point de vigilance : Arrêter cette étape si le contrôle échoue ; diagnostiquer avant de poursuivre.

RÉFÉRENCES TECHNIQUES

Documentation officielle

Retrouvez les fonctionnalités, les paramètres et les matrices de compatibilité de Elastic Stack (ELK).

Consulter la documentation officielle

05 · RECETTE

Comment vérifier que tout fonctionne ?

Résultat attenduContrôles avant de considérer la procédure terminée
01

Un seul agent installé sur l’hôte remonte Healthy.

02

Des documents datés et tagués sont visibles dans le bon data stream.

03

Aucun jeton d’enrôlement ni donnée sensible ne figure dans le guide ou les captures.

06 · DIAGNOSTIC

Problèmes fréquents et résolution

Agent Offline

Cause probable : Endpoint Fleet inaccessible ou certificat invalide

Que faire : Tester DNS, port Fleet Server et CA.

Aucune donnée

Cause probable : Intégration System absente ou chemin non lisible

Que faire : Examiner les inputs et le journal Elastic Agent.

Données dans un autre index

Cause probable : Dataset ou namespace imprévu

Que faire : Filtrer data_stream.namespace et la policy utilisée.

07 · QUESTIONS PRATIQUES

Questions fréquentes

Peut-on appliquer cet exemple directement en production ?

Non. Valider versions, permissions, capacités et plan de retour arrière en recette avant toute décision de déploiement.

Comment prouver que la procédure fonctionne ?

Conserver la sortie des commandes non sensibles, le périmètre des données et les critères de validation.

Quand escalader au support éditeur ?

Lorsque les prérequis et logs d’erreur ont été vérifiés et qu’une incompatibilité ou un comportement non documenté persiste.

AUTRES TECHNOLOGIES

Guides complémentaires

Tous les guides Elastic Stack (ELK)

VOTRE ENVIRONNEMENT

Besoin d’aller plus loin sur votre environnement ?

Échangeons sur votre environnement Elastic Stack (ELK) : pratiques, sécurité et exploitation.

Découvrir nos offres d’observabilité

Échanger avec ADN Consulting

Pour aller plus loin