› › ›

Connect to an external monitoring Elasticsearch cluster

IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.

Connect to an external monitoring Elasticsearch cluster

If you want to connect to a monitoring Elasticsearch cluster not managed by ECK, you can reference a Secret instead of an Elastisearch cluster in the monitoring section through the secretName attribute:

apiVersion: elasticsearch.k8s.elastic.co/v1
kind: Elasticsearch
metadata:
  name: monitored-sample
  namespace: production
spec:
  version: 8.19.8
  monitoring:
    metrics:
      elasticsearchRefs:
      - secretName: monitoring-metrics-es-ref 
    logs:
      elasticsearchRefs:
      - name: monitoring-logs
        namespace: observability 
        serviceName: monitoring-logs-es-coordinating-nodes 
  nodeSets:
  - name: default
    count: 1
    config:
      node.store.allow_mmap: false

	The `secretName` and `name` attributes are mutually exclusive, you have to choose one or the other.
	The `namespace` and `serviceName` attributes can only be used in conjunction with `name`, not with `secretName`.

The referenced Secret must contain the following connection information:

url: the URL to reach the Elasticsearch cluster
username: the username of the user to be authenticated to the Elasticsearch cluster
password: the password of the user to be authenticated to the Elasticsearch cluster
ca.crt: the contents of the CA certificate in PEM format to secure communication to the Elasticsearch cluster (optional)

apiVersion: v1
kind: Secret
metadata:
  name: monitoring-metrics-es-ref
stringData:
  url: https://mon1.es.abcd-42.xyz.elastic-cloud.com:9243
  username: monitoring-user
  password: REDACTED

The user referenced in the Secret must have been created beforehand.

« Stack Monitoring When to use it »