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.
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.
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
GET /
GET /_cluster/healthRé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
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.
É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.
- 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.
- 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.
printf '%s\n' 'ADN-FLEET-INITIAL' > /tmp/adn-fleet-lab.log
ls -l /tmp/adn-fleet-lab.logÀ 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.
É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.
- 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.
- 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.
À 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.
É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.
- Exécuter elastic-agent status avec le chemin binaire réellement installé et attendre que l’intégration ait appliqué la policy.
- 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.
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"À 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.
É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.
- 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.
- 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.
À 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).
05 · RECETTE
Comment vérifier que tout fonctionne ?
Un seul agent installé sur l’hôte remonte Healthy.
Des documents datés et tagués sont visibles dans le bon data stream.
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
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