Instalar Fleet Server e inscribir agentes

1. Fleet Server #

El punto de control de los agentes.

Opciones de despliegue #

En Elastic Cloud, Fleet Server está incluido (Integrations Server). En autoalojado, se instala en un host dedicado (o en varios, detrás de un balanceador de carga), con una política que contiene la integración Fleet Server.

# Kibana › Fleet › Settings : Fleet Server hosts = https://fleet.exemple.fr:8220
# Kibana › Fleet › Add Fleet Server génère la commande, par exemple :
sudo ./elastic-agent install \
  --fleet-server-es=https://es.exemple.fr:9200 \
  --fleet-server-service-token=<jeton de service> \
  --fleet-server-policy=fleet-server-policy \
  --fleet-server-port=8220 \
  --certificate-authorities=/etc/pki/ca.crt \
  --fleet-server-cert=/etc/pki/fleet.crt --fleet-server-cert-key=/etc/pki/fleet.key

Certificados #

Error común: Usar --insecure en producción: la conexión deja de verificarse. Proporciona la autoridad de certificación (--certificate-authorities) a los agentes y un certificado válido a Fleet Server.

2. Inscribir agentes #

Linux, Windows, Docker.

Los pasos #

Cada política tiene tokens de inscripción. El agente presenta el token una sola vez; después recibe su propia clave de API y la política asociada.

Linux #

curl -L -O https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-9.x.y-linux-x86_64.tar.gz
tar xzf elastic-agent-9.x.y-linux-x86_64.tar.gz && cd elastic-agent-9.x.y-linux-x86_64
sudo ./elastic-agent install --url=https://fleet.exemple.fr:8220 --enrollment-token=<jeton>
sudo elastic-agent status

Windows #

# PowerShell en administrateur
.\elastic-agent.exe install --url=https://fleet.exemple.fr:8220 --enrollment-token=<jeton>

Docker #

docker run -d --name elastic-agent --user root \
  -e FLEET_ENROLL=1 -e FLEET_URL=https://fleet.exemple.fr:8220 \
  -e FLEET_ENROLLMENT_TOKEN=<jeton> \
  docker.elastic.co/elastic-agent/elastic-agent:9.x.y

Paquetes DEB y RPM #

Los paquetes instalan el servicio sin inscribirlo: ejecuta después elastic-agent enroll y arranca el servicio.

Según la versión: sustituye 9.x.y por la versión exacta de tu stack: la versión del agente no debe superar la de Kibana y Elasticsearch.

3. Modo autónomo #

Sin Fleet.

Instalar sin inscripción #

sudo ./elastic-agent install --non-interactive   # répondre « non » à l'enrôlement
sudo vi /opt/Elastic/Agent/elastic-agent.yml        # politique exportée depuis Kibana ou écrite à la main
sudo elastic-agent restart && sudo elastic-agent status

Buena práctica: En Kibana, «Add agent › Run standalone» genera un elastic-agent.yml completo a partir de una política: punto de partida ideal para versionarlo.