Práctica: instalar OpenSearch, indexar y buscar con corrección

Lo que vas a aprender en este TP

• Iniciar OpenSearch
• Declarar los tipos
• Buscar y agregar

Introducción #

Lo que vas a aprender en esta sección

• Iniciar OpenSearch
• Declarar los tipos
• Buscar y agregar

Contexto. Tu equipo quiere un motor de búsqueda de logs con licencia Apache 2.0. Evalúas OpenSearch con una maqueta.

Requisitos: Docker Compose, 4 GB de memoria libre  ·  Duración estimada: 45 min

Un nodo y su consola.

Puesta en marcha #

Pasos guiados, con su corrección.

1. 1. Iniciar la pila

   ¿Por qué? Sin una contraseña fuerte, OpenSearch no arranca.

   Escribe .env y el Compose, ajusta vm.max_map_count y comprueba el estado del clúster.
   Ver la corrección

   OPENSEARCH_INITIAL_ADMIN_PASSWORD=Str0ng!Passw0rd-2026

   services:
     opensearch:
       image: opensearchproject/opensearch:3
       environment:
         discovery.type: single-node
         OPENSEARCH_INITIAL_ADMIN_PASSWORD: ${OPENSEARCH_INITIAL_ADMIN_PASSWORD}
         OPENSEARCH_JAVA_OPTS: -Xms1g -Xmx1g
         path.repo: /usr/share/opensearch/data/snapshots
       ports:
         - "9200:9200"
       volumes:
         - os-data:/usr/share/opensearch/data
   
     dashboards:
       image: opensearchproject/opensearch-dashboards:3
       environment:
         OPENSEARCH_HOSTS: '["https://opensearch:9200"]'
       ports:
         - "5601:5601"
       depends_on: [opensearch]
   
   volumes:
     os-data:

   sudo sysctl -w vm.max_map_count=262144
   docker compose up -d
   curl -sk -u 'admin:Str0ng!Passw0rd-2026' -H 'Content-Type: application/json' https://localhost:9200/_cat/health?v

2. 2. Declarar una plantilla de índice

   ¿Por qué? El tipo de un campo no cambia tras la primera escritura.

   Crea una plantilla para logs-app-*.
   Ver la corrección

   curl -sk -u 'admin:Str0ng!Passw0rd-2026' -H 'Content-Type: application/json' -X PUT https://localhost:9200/_index_template/logs_app -d '{
     "index_patterns": ["logs-app-*"],
     "template": {
       "settings": {"number_of_shards": 1, "number_of_replicas": 0},
       "mappings": {"properties": {
         "@timestamp": {"type": "date"},
         "level": {"type": "keyword"},
         "service": {"type": "keyword"},
         "message": {"type": "text"},
         "duree_ms": {"type": "integer"}
       }}
     }
   }'

3. 3. Indexar por lotes

   ¿Por qué? _bulk es la vía normal de los datos.

   Indexa tres documentos y lee el campo errors de la respuesta.
   Ver la corrección

   cat > lot.ndjson <<'EOF'
   {"index":{"_index":"logs-app-000001"}}
   {"@timestamp":"2026-11-04T10:00:00Z","level":"ERROR","service":"paiement","message":"timeout vers la banque utilisateur=alice","duree_ms":3100}
   {"index":{"_index":"logs-app-000001"}}
   {"@timestamp":"2026-11-04T10:00:01Z","level":"INFO","service":"paiement","message":"paiement accepté","duree_ms":120}
   {"index":{"_index":"logs-app-000001"}}
   {"@timestamp":"2026-11-04T10:00:02Z","level":"INFO","service":"panier","message":"article ajouté","duree_ms":40}
   EOF
   curl -sk -u 'admin:Str0ng!Passw0rd-2026' -H 'Content-Type: application/x-ndjson' \
     -X POST 'https://localhost:9200/_bulk?refresh=true' --data-binary @lot.ndjson

4. 4. Buscar y agregar

   ¿Por qué? filter es más rápido que must cuando la puntuación no importa.

   Busca «banque» en el servicio paiement y calcula el p95 de la duración por servicio.
   Ver la corrección

   curl -sk -u 'admin:Str0ng!Passw0rd-2026' -H 'Content-Type: application/json' -X POST 'https://localhost:9200/logs-app-*/_search' -d '{
     "query": {"bool": {
       "must":   [{"match": {"message": "banque"}}],
       "filter": [{"term": {"service": "paiement"}}]
     }}
   }'

   curl -sk -u 'admin:Str0ng!Passw0rd-2026' -H 'Content-Type: application/json' -X POST 'https://localhost:9200/logs-app-*/_search' -d '{
     "size": 0,
     "aggs": {"par_service": {
       "terms": {"field": "service"},
       "aggs": {"p95": {"percentiles": {"field": "duree_ms", "percents": [95]}}}
     }}
   }'

5. 5. Probar PPL y la consola

   ¿Por qué? PPL es muy legible para explorar logs.

   Cuenta los documentos por nivel en PPL y búscalos en Discover, en http://localhost:5601.
   Ver la corrección

   curl -sk -u 'admin:Str0ng!Passw0rd-2026' -H 'Content-Type: application/json' -X POST https://localhost:9200/_plugins/_ppl \
     -d '{"query":"source=logs-app-* | where service=\"paiement\" | stats count() by level"}'
   
   curl -sk -u 'admin:Str0ng!Passw0rd-2026' -H 'Content-Type: application/json' -X POST https://localhost:9200/_plugins/_sql \
     -d '{"query":"SELECT service, COUNT(*) n FROM logs-app-000001 GROUP BY service"}'

Nivel de dificultad : ●○○○○ (1/5)