Elasticsearch 8.0+ e 9.0+

Elasticsearch è un server di ricerca open source basato sulla libreria di ricerca Lucene. Viene eseguito in una macchina virtuale Java su diversi sistemi operativi. Il ricevitore elasticsearch raccoglie la telemetria a livello di nodo e cluster dalle istanze Elasticsearch.

Per ulteriori informazioni su Elasticsearch, consulta la documentazione di Elasticsearch 8.0+ e 9.0+.

Prerequisiti

Per raccogliere la telemetria di Elasticsearch, devi installare Ops Agent:

• Per le metriche, installa la versione 2.60.0 o successive.
• Per i log, installa la versione 2.60.0 o successive.

Questa integrazione supporta Elasticsearch 8.0+ e 9.0+.

Configura l'istanza Elasticsearch

Se abiliti le funzionalità di sicurezza di Elasticsearch, devi configurare un utente con il privilegio cluster monitor o manage.

Configura Ops Agent per Elasticsearch

Segui la guida per configurare Ops Agent, aggiungi gli elementi richiesti per raccogliere i dati di telemetria dalle istanze Elasticsearch e riavvia l'agente.

Configurazione di esempio

I seguenti comandi creano la configurazione per raccogliere e importare la telemetria per Elasticsearch:

# Configures Ops Agent to collect telemetry from the app. You must restart the agent for the configuration to take effect.

set -e

# Check if the file exists
if [ ! -f /etc/google-cloud-ops-agent/config.yaml ]; then
  # Create the file if it doesn't exist.
  sudo mkdir -p /etc/google-cloud-ops-agent
  sudo touch /etc/google-cloud-ops-agent/config.yaml
fi

# Create a back up of the existing file so existing configurations are not lost.
sudo cp /etc/google-cloud-ops-agent/config.yaml /etc/google-cloud-ops-agent/config.yaml.bak

# Configure the Ops Agent.
sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
metrics:
  receivers:
    elasticsearch:
      type: elasticsearch
      endpoint: https://localhost:9200
      username: elastic
      password: elastic_test_password_123
      insecure_skip_verify: true
      insecure: false
  service:
    pipelines:
      elasticsearch:
        receivers:
          - elasticsearch

logging:
  receivers:
    elasticsearch_gc:
      type: elasticsearch_gc
    elasticsearch_json:
      type: elasticsearch_json
  service:
    pipelines:
      elasticsearch:
        receivers:
          - elasticsearch_gc
          - elasticsearch_json
EOF

Affinché le modifiche diventino effettive, devi riavviare l'Ops Agent:

Configura la raccolta dei log

Per importare i log da Elasticsearch, devi creare un ricevitore per i log prodotti da Elasticsearch e poi creare una pipeline per il nuovo ricevitore.

Per configurare un ricevitore per i log elasticsearch_json, specifica i seguenti campi:

Per configurare un ricevitore per i log elasticsearch_gc, specifica i seguenti campi:

Informazioni registrate nei log

logName deriva dagli ID destinatario specificati nella configurazione. I campi dettagliati all'interno di LogEntry sono i seguenti.

I log elasticsearch_json contengono i seguenti campi in LogEntry: