1. Configuration autonome #
Tout dans elastic-agent.yml.
Exemple minimal #
outputs:
default:
type: elasticsearch
hosts: ["https://es.exemple.fr:9200"]
api_key: "${ES_API_KEY}"
ssl.certificate_authorities: [/etc/pki/ca.crt]
inputs:
- id: system-logs
type: filestream
use_output: default
data_stream.namespace: prod
streams:
- id: syslog
data_stream.dataset: system.syslog
paths: [/var/log/syslog, /var/log/messages]
- id: system-metrics
type: system/metrics
use_output: default
data_stream.namespace: prod
streams:
- metricsets: [cpu, memory, filesystem, network]
data_stream.dataset: system.cpu
period: 30sÀ savoir : En mode autonome, installez les ressources des intégrations (pipelines, mappings, tableaux de bord) depuis Kibana › Integrations › Settings, sinon les données arrivent sans structure.
2. Sorties Logstash et Kafka #
Quand passer par un intermédiaire.
Choisir #
| Sortie | Quand |
|---|---|
| Elasticsearch | Cas général : simple et le plus performant |
| Logstash | Transformations complexes, enrichissement externe, routage vers plusieurs destinations |
| Kafka | Tampon durable, découplage des producteurs et des consommateurs, très gros volumes |
Logstash #
# Logstash : entrée dédiée aux agents
input {
elastic_agent { port => 5044 ssl_enabled => true ssl_certificate => "/etc/pki/ls.crt" ssl_key => "/etc/pki/ls.key" }
}
output {
elasticsearch { hosts => ["https://es.exemple.fr:9200"] data_stream => true api_key => "${LS_API_KEY}" }
}3. OpenTelemetry avec EDOT #
Le Collector distribué par Elastic.
Le mode otel #
Elastic publie EDOT (Elastic Distribution of OpenTelemetry) : un Collector et des SDK supportés par Elastic. Le binaire Elastic Agent peut lancer ce Collector avec elastic-agent otel : les données sont stockées au format OpenTelemetry natif (champs resource.attributes.*, attributes.*) dans des data streams dédiés.
sudo elastic-agent otel --config /etc/elastic-agent/otel.yml
# ou valider la configuration
elastic-agent otel validate --config /etc/elastic-agent/otel.ymlSelon la version : le mode OpenTelemetry d'Elastic Agent et la gestion d'EDOT par Fleet évoluent rapidement entre les versions 8.x et 9.x : vérifiez la documentation de votre version avant de l'utiliser en production. Le chapitre « OpenTelemetry et Elasticsearch » de la formation Elasticsearch détaille les configurations.
